DOC : whole bunch of documentation clean up

I do think that from ``pylab import *`` is better than ``--pylab`` (thought I use the --pylab option daily). But it is still a very bad practice, so I wouldn't mention it in the documentation, nor teach it.