Merge pull request #302 from michr/1.0-branch

Chris McDonough

2011-10-01 4dcab7f8e10315b7bccf3ae41c4d3e457970170c

Merge pull request #302 from michr/1.0-branch

make sphinx compile strictly by turning all warnings into errors and fix up existing warnings

 docs/Makefile

@@ -2,7 +2,7 @@
#

# You can set these variables from the command line.
SPHINXOPTS    =
SPHINXOPTS    = -W
SPHINXBUILD   = sphinx-build
PAPER         =


 docs/conf.py

@@ -11,7 +11,8 @@
# All configuration values have a default value; values that are commented out
# serve to show the default value.

import sys, os
import sys
import os
import datetime
import inspect
import warnings

 docs/index.rst

@@ -201,3 +201,13 @@
* :ref:`glossary`
* :ref:`genindex`
* :ref:`search`

.. add glossary, foreword, and latexindex in a hidden toc to avoid warnings

.. toctree::
   :hidden:

   glossary
   foreword.rst
   latexindex.rst