Update sphinx library and treat warnings as errors

This commit updates sphinx library and treats warnings as errors. We
often miss doc warnings. So this commit makes them errors to build a
better html document.

Change-Id: I86fc23761ec24b0fdaae234cf37737dbc1bddd29

doc/source/conf.py

@@ -303,3 +303,6 @@ epub_copyright = u'2014, OpenStack QA Team'
 
 # Allow duplicate toc entries.
 #epub_tocdup = True
+
+# Do not warn about non-local image URI
+suppress_warnings = ['image.nonlocal_uri']

setup.cfg

@@ -15,6 +15,7 @@ classifier =
 all_files = 1
 build-dir = doc/build
 source-dir = doc/source
+warning-is-error = 1
 
 [pbr]
 warnerrors = True

specs/other/implemented/placeholder.rst

@@ -0,0 +1,12 @@
+..
+  This work is licensed under a Creative Commons Attribution 3.0 Unported
+  License.
+
+  http://creativecommons.org/licenses/by/3.0/legalcode
+
+===========
+Placeholder
+===========
+
+This is just a placeholder file to avoid sphinx errors. Please remove this
+file when you add a new rst file.

specs/other/placeholder.rst

@@ -0,0 +1,12 @@
+..
+  This work is licensed under a Creative Commons Attribution 3.0 Unported
+  License.
+
+  http://creativecommons.org/licenses/by/3.0/legalcode
+
+===========
+Placeholder
+===========
+
+This is just a placeholder file to avoid sphinx errors. Please remove this
+file when you add a new rst file.

specs/patrole/implemented/rbac-policy-testing.rst

@@ -91,7 +91,6 @@ List the qa projects that this spec effects. For example:
 Implementation
 ==============
 Assignee(s)
-
 -----------
 Primary assignees:
   david-purcell [david.purcell@att.com]

specs/patrole/placeholder.rst

@@ -0,0 +1,12 @@
+..
+  This work is licensed under a Creative Commons Attribution 3.0 Unported
+  License.
+
+  http://creativecommons.org/licenses/by/3.0/legalcode
+
+===========
+Placeholder
+===========
+
+This is just a placeholder file to avoid sphinx errors. Please remove this
+file when you add a new rst file.

specs/tempest/implemented/api-microversions-testing-support.rst

@@ -11,9 +11,9 @@ Tempest support for API microversions testing
 
 https://blueprints.launchpad.net/tempest/+spec/api-microversions-testing-support
 
-Since Kilo, nova has implemented API microversions and the other components (Ironic, etc)
-also implemented it now. However, currently Tempest does not have any support for microversions
-and doesn't test it at all.
+Since Kilo, nova has implemented API microversions and the other components
+(Ironic, etc) also implemented it now. However, currently Tempest does not
+have any support for microversions and doesn't test it at all.
 This proposal is to add microversions testing support in Tempest.
 
 Problem description

specs/tempest/implemented/reintegrate-tempest-lib.rst

@@ -134,8 +134,8 @@ Target Milestone for completion:
 Work Items
 ----------
 
- * Take ownership of tempest on pypi [1]
- * Enable publishing tempest to pypi [2]
+ * Take ownership of tempest on pypi [1]_
+ * Enable publishing tempest to pypi [2]_
  * Add reno release notes to both tempest and tempest-lib
  * Iterate through reintegration:
    * Move all the code from tempest-lib to tempest.lib in the tempest repo

specs/tempest/implemented/tempest-library.rst

@@ -154,4 +154,4 @@ library conversion.
 References
 ==========
 
-.. [1] http://lists.openstack.org/pipermail/openstack-dev/2014-March/028920.html
+- http://lists.openstack.org/pipermail/openstack-dev/2014-March/028920.html

tox.ini

@@ -15,7 +15,7 @@ commands = {posargs}
 
 [testenv:docs]
 basepython = python3
-commands = python setup.py build_sphinx
+commands = sphinx-build -W -b html doc/source doc/build/html
 
 [testenv:spelling]
 deps =