RF: stop API generation duplicating docstrings

Stop api generation tool generating docs for things that are not defined
in the module being documented.
DOC: add to the API topic lists
DOC: clean up docstrings for API docs

Clean up various RST formatting issues in docstrings to make the API
docs look nicer.