Correcting docs (based on sphinx output)

see #725 and http://docs.obspy.org/master/log.txt