Updated a lot of docstrings and added lots more examples.  Also added Sphinx documentation (pre-built HTML).
Updated README.rst with the latest docstring.