Fix bad Sphinx references

Closes #73.

Author: mgedmin

CHANGES.rst

@@ -135,10 +135,10 @@ Changes
 - :func:`show_refs` and :func:`show_backrefs` now accept a file-like object
   (via the new ``output`` argument) as an alternative to a filename.
 
-- Made internal helper methods private. This includes :func:`find_chain`,
-  :func:`show_graph`, :func:`obj_node_id`, :func:`obj_label`, :func:`quote`,
-  :func:`long_typename`, :func:`safe_repr`, :func:`short_repr`,
-  :func:`gradient`, :func:`edge_label`, and :func:`_program_in_path`.
+- Made internal helper methods private. This includes ``find_chain``,
+  ``show_graph``, ``obj_node_id``, ``obj_label``, ``quote``,
+  ``long_typename``, ``safe_repr``, ``short_repr``,
+  ``gradient``, ``edge_label``, and ``_program_in_path``.
 
 - Correctly determine the name of old-style classes in :func:`count`,
   :func:`by_type`, and graph drawing functions.

Makefile

@@ -5,7 +5,7 @@ FILE_WITH_CHANGELOG = CHANGES.rst
 
 VCS_DIFF_IMAGES = git diff docs/*.png
 
-SPHINXOPTS      = -n
+SPHINXOPTS      = -Wn
 SPHINXBUILD     = sphinx-build
 SPHINXBUILDDIR  = docs/_build
 ALLSPHINXOPTS   = -d $(SPHINXBUILDDIR)/doctrees $(SPHINXOPTS) docs/

docs/index.txt

@@ -97,7 +97,7 @@ and see what changes after we call it
     MyBigFatObject        2        +2
     dict                797        +1
 
-It's easy to see :class:`MyBigFatObject` instances that appeared and were
+It's easy to see ``MyBigFatObject`` instances that appeared and were
 not freed.  I can pick one of them at random and trace the reference chain
 back to one of the garbage collector's roots.
 
@@ -121,7 +121,7 @@ you've any examples where that isn't true, I'd love to hear about them
 
 It is perhaps surprising to find :mod:`linecache` at the end of that chain
 (apparently :mod:`doctest` monkey-patches it), but the important things --
-:func:`computate_something` and its cache dictionary -- are in there.
+``computate_something`` and its cache dictionary -- are in there.
 
 There are other tools, perhaps better suited for memory leak hunting:
 `heapy <https://pypi.python.org/pypi/guppy>`_,

tox.ini

@@ -21,7 +21,7 @@ commands =
 deps =
     Sphinx
 commands =
-    sphinx-build -n -b html -d docs/_build/doctrees docs/ docs/_build/html
+    sphinx-build -Wn -b html -d docs/_build/doctrees docs/ docs/_build/html
 
 [testenv:livedocs]
 deps =