DOC: add parameters, returns and an example to fftpack.rfftfreq docstring.
DOC: add parameters, returns and an example to fftpack.rfftfreq docstring.

Also some style fixes and code clean-up.

Reviewed at https://github.com/scipy/scipy/pull/321

Eric89GXL/scipy,gfyoung/scipy,jseabold/scipy,mortonjt/scipy,sonnyhu/scipy,surhudm/scipy,jakevdp/scipy,minhlongdo/scipy,befelix/scipy,minhlongdo/scipy,jonycgn/scipy,andim/scipy,larsmans/scipy,njwilson23/scipy,ogrisel/scipy,jseabold/scipy,mhogg/scipy,ales-erjavec/scipy,jsilter/scipy,chatcannon/scipy,anielsen001/scipy,pyramania/scipy,Dapid/scipy,Kamp9/scipy,anntzer/scipy,zxsted/scipy,gef756/scipy,pyramania/scipy,aman-iitj/scipy,sonnyhu/scipy,pyramania/scipy,raoulbq/scipy,njwilson23/scipy,sriki18/scipy,scipy/scipy,witcxc/scipy,niknow/scipy,njwilson23/scipy,sonnyhu/scipy,jonycgn/scipy,gef756/scipy,pnedunuri/scipy,josephcslater/scipy,WillieMaddox/scipy,gdooper/scipy,maniteja123/scipy,cpaulik/scipy,chatcannon/scipy,nonhermitian/scipy,sonnyhu/scipy,vanpact/scipy,woodscn/scipy,nmayorov/scipy,Gillu13/scipy,FRidh/scipy,felipebetancur/scipy,zaxliu/scipy,apbard/scipy,rmcgibbo/scipy,gertingold/scipy,kleskjr/scipy,witcxc/scipy,nonhermitian/scipy,endolith/scipy,Dapid/scipy,giorgiop/scipy,pnedunuri/scipy,efiring/scipy,raoulbq/scipy,Dapid/scipy,Kamp9/scipy,e-q/scipy,jor-/scipy,Stefan-Endres/scipy,andyfaff/scipy,WillieMaddox/scipy,zxsted/scipy,chatcannon/scipy,juliantaylor/scipy,person142/scipy,maciejkula/scipy,vhaasteren/scipy,cpaulik/scipy,sargas/scipy,surhudm/scipy,mortonjt/scipy,jor-/scipy,tylerjereddy/scipy,befelix/scipy,lhilt/scipy,lhilt/scipy,mhogg/scipy,argriffing/scipy,matthewalbani/scipy,kalvdans/scipy,perimosocordiae/scipy,rmcgibbo/scipy,ilayn/scipy,befelix/scipy,andim/scipy,zerothi/scipy,sonnyhu/scipy,raoulbq/scipy,hainm/scipy,richardotis/scipy,mtrbean/scipy,grlee77/scipy,zxsted/scipy,futurulus/scipy,mortonjt/scipy,rmcgibbo/scipy,bkendzior/scipy,apbard/scipy,argriffing/scipy,trankmichael/scipy,sriki18/scipy,lhilt/scipy,fredrikw/scipy,matthewalbani/scipy,vhaasteren/scipy,jjhelmus/scipy,newemailjdm/scipy,maniteja123/scipy,anntzer/scipy,aarchiba/scipy,pizzathief/scipy,dch312/scipy,apbard/scipy,mortada/scipy,aman-iitj/scipy,arokem/scipy,anielsen001/scipy,grlee77/scipy,pyramania/scipy,ales-erjavec/scipy,perimosocordiae/scipy,Shaswat27/scipy,mhogg/scipy,lukauskas/scipy,njwilson23/scipy,person142/scipy,WarrenWeckesser/scipy,e-q/scipy,jsilter/scipy,mingwpy/scipy,sauliusl/scipy,andyfaff/scipy,endolith/scipy,vberaudi/scipy,larsmans/scipy,jjhelmus/scipy,dch312/scipy,ales-erjavec/scipy,behzadnouri/scipy,endolith/scipy,mdhaber/scipy,pbrod/scipy,giorgiop/scipy,aeklant/scipy,vigna/scipy,felipebetancur/scipy,Shaswat27/scipy,scipy/scipy,jjhelmus/scipy,mdhaber/scipy,mingwpy/scipy,behzadnouri/scipy,maciejkula/scipy,person142/scipy,ndchorley/scipy,mortada/scipy,rgommers/scipy,ndchorley/scipy,dch312/scipy,mdhaber/scipy,ChanderG/scipy,aarchiba/scipy,larsmans/scipy,vigna/scipy,dominicelse/scipy,mtrbean/scipy,nvoron23/scipy,person142/scipy,endolith/scipy,mikebenfield/scipy,juliantaylor/scipy,mgaitan/scipy,anielsen001/scipy,minhlongdo/scipy,vberaudi/scipy,newemailjdm/scipy,maciejkula/scipy,cpaulik/scipy,perimosocordiae/scipy,Dapid/scipy,andim/scipy,gfyoung/scipy,anntzer/scipy,minhlongdo/scipy,gef756/scipy,maniteja123/scipy,bkendzior/scipy,haudren/scipy,argriffing/scipy,haudren/scipy,efiring/scipy,Newman101/scipy,arokem/scipy,witcxc/scipy,rgommers/scipy,WarrenWeckesser/scipy,woodscn/scipy,scipy/scipy,trankmichael/scipy,futurulus/scipy,person142/scipy,pizzathief/scipy,mdhaber/scipy,sriki18/scipy,haudren/scipy,mtrbean/scipy,petebachant/scipy,piyush0609/scipy,jseabold/scipy,trankmichael/scipy,FRidh/scipy,matthew-brett/scipy,nvoron23/scipy,mikebenfield/scipy,kalvdans/scipy,niknow/scipy,FRidh/scipy,perimosocordiae/scipy,vanpact/scipy,rmcgibbo/scipy,Gillu13/scipy,WillieMaddox/scipy,Shaswat27/scipy,vberaudi/scipy,ndchorley/scipy,ChanderG/scipy,vberaudi/scipy,ilayn/scipy,nonhermitian/scipy,perimosocordiae/scipy,Srisai85/scipy,dominicelse/scipy,arokem/scipy,sauliusl/scipy,mortada/scipy,e-q/scipy,cpaulik/scipy,Stefan-Endres/scipy,efiring/scipy,nmayorov/scipy,Shaswat27/scipy,grlee77/scipy,scipy/scipy,teoliphant/scipy,Gillu13/scipy,WillieMaddox/scipy,surhudm/scipy,ChanderG/scipy,scipy/scipy,ChanderG/scipy,vanpact/scipy,jonycgn/scipy,nmayorov/scipy,newemailjdm/scipy,piyush0609/scipy,cpaulik/scipy,woodscn/scipy,vberaudi/scipy,zxsted/scipy,ortylp/scipy,efiring/scipy,richardotis/scipy,maniteja123/scipy,ortylp/scipy,mortonjt/scipy,petebachant/scipy,kleskjr/scipy,vhaasteren/scipy,gdooper/scipy,richardotis/scipy,ogrisel/scipy,piyush0609/scipy,mtrbean/scipy,chatcannon/scipy,sauliusl/scipy,pnedunuri/scipy,gef756/scipy,aarchiba/scipy,behzadnouri/scipy,mgaitan/scipy,pschella/scipy,befelix/scipy,Gillu13/scipy,nonhermitian/scipy,zaxliu/scipy,rmcgibbo/scipy,piyush0609/scipy,ortylp/scipy,argriffing/scipy,sargas/scipy,ales-erjavec/scipy,vigna/scipy,ilayn/scipy,mortonjt/scipy,FRidh/scipy,surhudm/scipy,ndchorley/scipy,nmayorov/scipy,mgaitan/scipy,gfyoung/scipy,lukauskas/scipy,jamestwebber/scipy,trankmichael/scipy,mikebenfield/scipy,minhlongdo/scipy,pyramania/scipy,anntzer/scipy,piyush0609/scipy,aman-iitj/scipy,pizzathief/scipy,gertingold/scipy,apbard/scipy,newemailjdm/scipy,witcxc/scipy,jsilter/scipy,hainm/scipy,rgommers/scipy,futurulus/scipy,petebachant/scipy,Kamp9/scipy,gdooper/scipy,mhogg/scipy,Eric89GXL/scipy,hainm/scipy,jor-/scipy,argriffing/scipy,lhilt/scipy,zxsted/scipy,zerothi/scipy,nvoron23/scipy,niknow/scipy,matthewalbani/scipy,behzadnouri/scipy,Shaswat27/scipy,newemailjdm/scipy,jsilter/scipy,pschella/scipy,vanpact/scipy,gfyoung/scipy,richardotis/scipy,giorgiop/scipy,lukauskas/scipy,mgaitan/scipy,nmayorov/scipy,zaxliu/scipy,futurulus/scipy,fredrikw/scipy,mhogg/scipy,josephcslater/scipy,behzadnouri/scipy,pnedunuri/scipy,mortada/scipy,nvoron23/scipy,kalvdans/scipy,vanpact/scipy,Eric89GXL/scipy,aman-iitj/scipy,fernand/scipy,zerothi/scipy,jor-/scipy,ilayn/scipy,jonycgn/scipy,raoulbq/scipy,mingwpy/scipy,WarrenWeckesser/scipy,gdooper/scipy,endolith/scipy,gfyoung/scipy,WarrenWeckesser/scipy,zaxliu/scipy,woodscn/scipy,cpaulik/scipy,maciejkula/scipy,kleskjr/scipy,aarchiba/scipy,fernand/scipy,pizzathief/scipy,mortada/scipy,ortylp/scipy,gertingold/scipy,ortylp/scipy,hainm/scipy,bkendzior/scipy,matthewalbani/scipy,Dapid/scipy,pnedunuri/scipy,fernand/scipy,WillieMaddox/scipy,zerothi/scipy,ales-erjavec/scipy,sriki18/scipy,Newman101/scipy,perimosocordiae/scipy,richardotis/scipy,fredrikw/scipy,jamestwebber/scipy,trankmichael/scipy,dch312/scipy,tylerjereddy/scipy,mhogg/scipy,matthew-brett/scipy,FRidh/scipy,jonycgn/scipy,vhaasteren/scipy,Stefan-Endres/scipy,sargas/scipy,aeklant/scipy,anielsen001/scipy,niknow/scipy,rmcgibbo/scipy,jseabold/scipy,sargas/scipy,jamestwebber/scipy,ndchorley/scipy,anntzer/scipy,mikebenfield/scipy,lhilt/scipy,FRidh/scipy,pnedunuri/scipy,ales-erjavec/scipy,mgaitan/scipy,matthew-brett/scipy,felipebetancur/scipy,arokem/scipy,e-q/scipy,Srisai85/scipy,mingwpy/scipy,rgommers/scipy,WillieMaddox/scipy,Newman101/scipy,dominicelse/scipy,felipebetancur/scipy,surhudm/scipy,sriki18/scipy,anielsen001/scipy,lukauskas/scipy,kleskjr/scipy,juliantaylor/scipy,dominicelse/scipy,argriffing/scipy,sauliusl/scipy,pschella/scipy,giorgiop/scipy,apbard/scipy,sonnyhu/scipy,lukauskas/scipy,Srisai85/scipy,teoliphant/scipy,Kamp9/scipy,vhaasteren/scipy,haudren/scipy,zerothi/scipy,larsmans/scipy,kalvdans/scipy,WarrenWeckesser/scipy,zaxliu/scipy,mortonjt/scipy,Srisai85/scipy,Eric89GXL/scipy,petebachant/scipy,vhaasteren/scipy,Eric89GXL/scipy,vigna/scipy,efiring/scipy,vberaudi/scipy,Dapid/scipy,jakevdp/scipy,andyfaff/scipy,jseabold/scipy,maniteja123/scipy,sargas/scipy,aman-iitj/scipy,ogrisel/scipy,andyfaff/scipy,gertingold/scipy,Srisai85/scipy,giorgiop/scipy,njwilson23/scipy,teoliphant/scipy,woodscn/scipy,newemailjdm/scipy,Srisai85/scipy,nvoron23/scipy,juliantaylor/scipy,andyfaff/scipy,gertingold/scipy,Newman101/scipy,teoliphant/scipy,jor-/scipy,futurulus/scipy,pbrod/scipy,felipebetancur/scipy,juliantaylor/scipy,tylerjereddy/scipy,andim/scipy,teoliphant/scipy,mdhaber/scipy,piyush0609/scipy,Gillu13/scipy,Stefan-Endres/scipy,ogrisel/scipy,andim/scipy,Newman101/scipy,vanpact/scipy,zaxliu/scipy,mikebenfield/scipy,larsmans/scipy,jakevdp/scipy,raoulbq/scipy,lukauskas/scipy,e-q/scipy,haudren/scipy,richardotis/scipy,kleskjr/scipy,larsmans/scipy,aeklant/scipy,mortada/scipy,mgaitan/scipy,rgommers/scipy,jjhelmus/scipy,pbrod/scipy,pschella/scipy,gef756/scipy,Stefan-Endres/scipy,chatcannon/scipy,bkendzior/scipy,minhlongdo/scipy,Newman101/scipy,zxsted/scipy,tylerjereddy/scipy,kleskjr/scipy,maciejkula/scipy,tylerjereddy/scipy,vigna/scipy,mtrbean/scipy,matthewalbani/scipy,fredrikw/scipy,haudren/scipy,Eric89GXL/scipy,kalvdans/scipy,petebachant/scipy,nonhermitian/scipy,sauliusl/scipy,fredrikw/scipy,futurulus/scipy,pbrod/scipy,jseabold/scipy,jamestwebber/scipy,hainm/scipy,petebachant/scipy,aeklant/scipy,sauliusl/scipy,pbrod/scipy,bkendzior/scipy,anntzer/scipy,pbrod/scipy,aeklant/scipy,giorgiop/scipy,behzadnouri/scipy,zerothi/scipy,ogrisel/scipy,grlee77/scipy,surhudm/scipy,mingwpy/scipy,woodscn/scipy,WarrenWeckesser/scipy,gef756/scipy,jamestwebber/scipy,fernand/scipy,matthew-brett/scipy,mtrbean/scipy,Kamp9/scipy,trankmichael/scipy,gdooper/scipy,mingwpy/scipy,matthew-brett/scipy,niknow/scipy,fernand/scipy,ortylp/scipy,nvoron23/scipy,hainm/scipy,mdhaber/scipy,scipy/scipy,witcxc/scipy,Gillu13/scipy,jonycgn/scipy,josephcslater/scipy,dch312/scipy,ChanderG/scipy,anielsen001/scipy,ilayn/scipy,Stefan-Endres/scipy,sriki18/scipy,pizzathief/scipy,grlee77/scipy,dominicelse/scipy,aman-iitj/scipy,niknow/scipy,jsilter/scipy,aarchiba/scipy,felipebetancur/scipy,josephcslater/scipy,efiring/scipy,jakevdp/scipy,fernand/scipy,raoulbq/scipy,fredrikw/scipy,andim/scipy,arokem/scipy,josephcslater/scipy,ndchorley/scipy,ChanderG/scipy,andyfaff/scipy,maniteja123/scipy,Kamp9/scipy,jakevdp/scipy,ilayn/scipy,endolith/scipy,jjhelmus/scipy,chatcannon/scipy,njwilson23/scipy,Shaswat27/scipy,pschella/scipy,befelix/scipy