Fix sphinx builds

Change the files requirements-{docs,dev}.txt to fix sphinx builds.
Change the file docs/conf.py to fix sphinx build.
Add the flag -W at Makefile to break if appear some warning in sphinx builds.

Author: macartur

docs/Makefile

@@ -2,7 +2,7 @@
 #
 
 # You can set these variables from the command line.
-SPHINXOPTS    =
+SPHINXOPTS    = -W
 SPHINXBUILD   = sphinx-build
 PAPER         =
 BUILDDIR      = _build

docs/conf.py

@@ -377,10 +377,8 @@
 # Note: links to Python doc only work if you are online or have python.inv
 #     file. To download it, run:
 #     curl https://docs.python.org/3/objects.inv >python.inv
-intersphinx_mapping = {'python': ('https://docs.python.org/3',
-                                  (None, 'python.inv')),
-                       'kytos': ('http://docs.kytos.io/kytos',
-                                 (None, 'kytos.inv'))}
+intersphinx_mapping = {'python': ('https://docs.python.org/3', None),
+                       'kytos': ('http://docs.kytos.io/kytos', None)}
 
 # Napoleon settings from http://www.sphinx-doc.org/en/stable/ext/napoleon.html
 napoleon_google_docstring = True

requirements-dev.txt

@@ -2,8 +2,8 @@
 tox ~= 2.7
 
 # For running doctests (during "python setup.py test")
-Sphinx >= 1.4.5
-sphinx_bootstrap_theme
+Sphinx == 1.5.6
+sphinx_bootstrap_theme == 0.4.14
 
 # Linters
 pydocstyle ~= 1.1

requirements-docs.txt

@@ -2,9 +2,9 @@
 # are required:
 
 # Sphinx is required for running doctests (and building documentation)
-Sphinx >= 1.4.5
+Sphinx == 1.5.6
 # To run "make livehtml", build docs and refresh browser automatically when
 # files change
 sphinx-autobuild >= 0.6.0
 sphinx-rtd-theme >= 0.1.9
-sphinx_bootstrap_theme
+sphinx_bootstrap_theme == 0.4.14

tox.ini

@@ -2,12 +2,16 @@
 envlist = py36
 
 [testenv]
-whitelist_externals = rm
+whitelist_externals=
+  rm
+  make
+
 commands=
     ; Force packaging even if setup.{py,cfg} haven't changed
     rm -rf ./python_openflow.egg-info/
     coverage run setup.py test
-    sphinx-build -b doctest -d docs/_build/doctrees docs/ docs/_build/doctest
+    make -C docs/
+    make -C docs/ doctest
     pylama tests setup.py pyof
 
 deps=