update sphinx and treat warnings as errors

Sphinx 1.5.0 and pbr 2.0 include a feature to let us pass the flag to
treat warnings as errors through setup.cfg. Update the version of Sphinx
we're using explicitly, and rely on an unbounded pbr specification to
give us the latest version on every run.

Also fix the one warning that caused the build to fail.

Change-Id: Ie93a3adf82b8f568a3cc4357c1e78da22ddc92c0
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
This commit is contained in:
Doug Hellmann 2017-03-15 17:15:02 -04:00
parent 1c98c456b5
commit 42a2de44e0
3 changed files with 3 additions and 2 deletions

View File

@ -429,7 +429,7 @@ nova
Planning Artifacts:
`https://blueprints.launchpad.net/nova/+spec/goal-python35`_
* https://blueprints.launchpad.net/nova/+spec/goal-python35
Completion Artifacts:

View File

@ -12,6 +12,7 @@ home-page = http://www.openstack.org/
all_files = 1
build-dir = doc/build
source-dir = doc/source
warning-is-error = 1
[pbr]
warnerrors = True

View File

@ -1,6 +1,6 @@
# needed for doc build
docutils>=0.11,!=0.13.1 # OSI-Approved Open Source, Public Domain
sphinx>=1.1.2,!=1.2.0,<1.3
sphinx>=1.5.0
PyYAML>=3.1.0
yamllint>=0.5.2
requests-cache