Updated package docstrings.

Consistent use of sphinx referencing and more complete docstrings.
Merge pull request #17 from ajdawson/update-docstrings

Updated package docstrings.