Require that sphinx issue no warnings in CI

Author: jnothman

.travis.yml

@@ -23,5 +23,5 @@ script:
   - nosetests numpydoc
   - |
     cd ../doc
-    make html
-    make latexpdf
+    make SPHINXOPTS='-W' html
+    make SPHINXOPTS='-W' latexpdf

doc/conf.py

@@ -41,7 +41,7 @@
     'sphinx.ext.autosummary',
     'sphinx.ext.doctest',
     'sphinx.ext.intersphinx',
-    'sphinx.ext.pngmath',
+    'sphinx.ext.imgmath',
     'sphinx.ext.todo',
     'numpydoc',
     'sphinx.ext.ifconfig',
@@ -149,13 +149,12 @@
     html_sidebars = {}
 
 html_title = "%s v%s Manual" % (project, version)
-html_static_path = ['_static']
 html_last_updated_fmt = '%b %d, %Y'
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
+html_static_path = []  # ['_static']
 
 # Add any extra paths that contain custom files (such as robots.txt or
 # .htaccess) here, relative to this directory. These files are copied

doc/format.rst

@@ -374,7 +374,7 @@ The sections of a function's docstring are:
          and neural-network techniques," Computers & Geosciences, vol. 22,
          pp. 585-588, 1996.
 
-    which renders as
+    which renders as [1]_:
 
     .. [1] O. McNoleg, "The integration of GIS, remote sensing,
        expert systems and adaptive co-kriging for environmental habitat