Make docs build without warnings or errors. Minor additional cleanup.

Got rid of *"WARNING: document isn't included in any toctree"* for the remote API docs (they are included by reference elsewhere than a TOC).

Cleaned up some regex expressions so they don't look like RST references (e.g. *foo_*).

Wrapped a few long lines.