DOC: Documentation fixes

Clean up documentation. Fix many problems that have crept in in new code. Closes all outstanding documentation issues for 0.6.
why double back-ticks ?
I thought code is single.
(I paid little attention to this on the scipy issue discussion)