DOC: general docstring formatting fixes
Some general formatting fixes (+ fix example in DatetimeIndex.strftime to actually use that method and not Timestamp.strftime). 

Merging directly as it contains some PEP8 issues I merged in master.