Fix the rest of the Sphinx documentation errors.

Review Request #7597 — Created Aug. 17, 2015 and submitted — Latest diff uploaded

Information

Djblets
release-0.9.x

Reviewers

This goes through and fixes all remaining documentation warnings for
syntax errors, broken references, conflicting types, files missing from
the Table of Contents, and more.

One change that's annoying but necessary to work around a Sphinx bug is
that we had to filter out any functions named "list" on classes. This
is because Sphinx will prioritize references to those instead of falling
back on the intersphinx mapping in the Python docs for the type. This
means our docs are incomplete, but in practice, the only time we name a
function "list" is when subclassing a Django template loader.

Added a build step to the Travis CI rules to ensure our docs are
generating without warnings or errors.

Docs built without any warnings or errors.

Checked that the "list" references pointed to the Python docs.