filled in docstrings for package - refs #1