Fix up syntax errors and invalid references in docstrings.

Review Request #7366 — Created June 2, 2015 and submitted — Latest diff uploaded

Information

Review Board
release-2.5.x
29cb2c8...

Reviewers

We had a number of non-ReST-compliant docstrings, which caused rendering
errors and warnings when processing docstrings. This fixes most of them
up. There are still some we're likely to hit, some errors resolving some
properties, and some functions that aren't showing up, but most of the
docs can now generate.

Generated the docs. I no longer saw these errors, and the results rendered
as expected.