DOC : top_level doc-string clean up

 - remove import * examples
 - remove pylab
Ditto to Nelle.  I wish the `matplotlib.pyplot` convention wasn't adopted, but it was...