more documentation

per Mary's comments, the type of some parameters as been moved to the :param tag. Additional documentation has been added as well a Sphinx generated TeX file.