DOC : top_level doc-string clean up

 - remove import * examples
 - remove pylab
DOC : tweaked import style
Merge pull request #3228 from tacaswell/top_level_docstring

DOC : top_level doc-string clean up