updated the doc to match the module docstring, fixed a couple of errors in the doc markup and in the module