DOC : whole bunch of documentation clean up

As a side note, there are 578 places in the code base where we have `from pylab import *` (most of those are in pylab_examples`).