DOC: fix warning + some stylistic corrections
DOC: fix warning + some stylistic corrections

jmmease/pandas,jmmease/pandas,datapythonista/pandas,jmmease/pandas,kdebrab/pandas,zfrenchee/pandas,zfrenchee/pandas,louispotok/pandas,GuessWhoSamFoo/pandas,GuessWhoSamFoo/pandas,rs2/pandas,DGrady/pandas,TomAugspurger/pandas,winklerand/pandas,jmmease/pandas,DGrady/pandas,cython-testbed/pandas,toobaz/pandas,nmartensen/pandas,nmartensen/pandas,MJuddBooth/pandas,dsm054/pandas,MJuddBooth/pandas,winklerand/pandas,jorisvandenbossche/pandas,cython-testbed/pandas,dsm054/pandas,winklerand/pandas,rs2/pandas,nmartensen/pandas,cbertinato/pandas,jmmease/pandas,amolkahat/pandas,linebp/pandas,datapythonista/pandas,zfrenchee/pandas,jorisvandenbossche/pandas,pandas-dev/pandas,jreback/pandas,rs2/pandas,amolkahat/pandas,cython-testbed/pandas,winklerand/pandas,louispotok/pandas,rs2/pandas,harisbal/pandas,harisbal/pandas,cython-testbed/pandas,linebp/pandas,MJuddBooth/pandas,pratapvardhan/pandas,harisbal/pandas,jorisvandenbossche/pandas,amolkahat/pandas,gfyoung/pandas,jorisvandenbossche/pandas,Winand/pandas,jreback/pandas,jreback/pandas,TomAugspurger/pandas,kdebrab/pandas,louispotok/pandas,GuessWhoSamFoo/pandas,toobaz/pandas,cbertinato/pandas,toobaz/pandas,DGrady/pandas,DGrady/pandas,MJuddBooth/pandas,linebp/pandas,pratapvardhan/pandas,TomAugspurger/pandas,nmartensen/pandas,DGrady/pandas,kdebrab/pandas,toobaz/pandas,pandas-dev/pandas,zfrenchee/pandas,jreback/pandas,kdebrab/pandas,winklerand/pandas,cbertinato/pandas,gfyoung/pandas,datapythonista/pandas,dsm054/pandas,dsm054/pandas,dsm054/pandas,Winand/pandas,kdebrab/pandas,amolkahat/pandas,Winand/pandas,GuessWhoSamFoo/pandas,louispotok/pandas,MJuddBooth/pandas,DGrady/pandas,linebp/pandas,gfyoung/pandas,louispotok/pandas,cbertinato/pandas,amolkahat/pandas,harisbal/pandas,pratapvardhan/pandas,nmartensen/pandas,GuessWhoSamFoo/pandas,TomAugspurger/pandas,cython-testbed/pandas,pandas-dev/pandas,Winand/pandas,winklerand/pandas,pandas-dev/pandas,gfyoung/pandas,nmartensen/pandas,zfrenchee/pandas,jmmease/pandas,jreback/pandas,pratapvardhan/pandas,cbertinato/pandas,Winand/pandas,linebp/pandas,linebp/pandas,gfyoung/pandas,Winand/pandas,pratapvardhan/pandas,harisbal/pandas,toobaz/pandas,datapythonista/pandas