ENH: better verbosity

verbose=1 should simply give us an idea of how the progress is doing
DOC: complete the docstring
MISC: avoid deprecation with new numpy
MISC: minor improvement in example