Changed sphinx conf.py to show warnings in the html.
Minor doctring changes to fix sphinx warnings.