update sphinx

Update to a newer version of sphinx and remove the version caps.

Ignore warnings for non-local images.

Stop using pbr's deprecated sphinx integration, and have tox call
sphinx-build directly instead.

Change-Id: I9363265647ad84cc06c499858acddab2a0b84940
Signed-off-by: Doug Hellmann <doug@doughellmann.com>

doc/source/conf.py

@@ -37,6 +37,10 @@ exclude_patterns = [
     '**/**/template.rst'
 ]
 
+suppress_warnings = [
+    'image.nonlocal_uri',
+]
+
 # Optionally allow the use of sphinxcontrib.spelling to verify the
 # spelling of the documents.
 try:

requirements.txt

@@ -1,11 +1,10 @@
 # The order of packages is significant, because pip processes them in the order
 # of appearance. Changing the order has an impact on the overall integration
 # process, which may cause wedges in the gate later.
-pbr<2.0,>=1.3
+pbr>=1.3
 doc8 # Apache-2.0
-docutils>=0.11,!=0.13.1  # OSI-Approved Open Source, Public Domain
 oslosphinx>=2.5.0 # Apache-2.0
-sphinx!=1.2.0,!=1.3b1,<1.3,>=1.1.2
+sphinx>=1.8.1
 testrepository>=0.0.18
 testtools>=1.4.0
 yasfb>=0.5.1

setup.cfg

@@ -15,11 +15,6 @@ classifier =
     Programming Language :: Python :: 2
     Programming Language :: Python :: 2.7
 
-[build_sphinx]
-source-dir = doc/source
-build-dir = doc/build
-all_files = 1
-
 [pbr]
 warnerrors = True
 

tox.ini

@@ -19,4 +19,4 @@ commands = {posargs}
 [testenv:docs]
 commands =
   doc8 -e .rst specs/ doc/ README.rst
-  python setup.py build_sphinx
+  sphinx-build -a -W -b html doc/source doc/build/html {posargs}