[Doc] Handle Sphinx warnings as errors

We should be treating warnings from Sphinx as
errors as they usually result in bad HTML output.

Now that we have all of the existing warnings resolved we
want to turn on this option so that more bad docstrings, etc.
do not get merged.

One last bad docstring appears to have snuck in.  This patch
also fixes that docstring problem in cinder/volume/qos_specs.py .

We have a requirement on graphviz that was never handled and is
actually causing one of our web pages to be improperly rendered.
The patch adds the dependency to bindep.txt so that we do not
see a check failure and so the documentation builds properly.

Change-Id: I66a9282b63d884a390534b0c777be8433a7e9bb3
This commit is contained in:
Jay S. Bryant 2017-08-28 23:43:47 -05:00
parent bd22a5d61e
commit 888dcd4372
3 changed files with 8 additions and 6 deletions

View File

@ -4,6 +4,7 @@ build-essential [platform:dpkg test]
gcc [platform:rpm test] gcc [platform:rpm test]
gettext [!platform:suse] gettext [!platform:suse]
gettext-runtime [platform:suse] gettext-runtime [platform:suse]
graphviz [test]
libffi-dev [platform:dpkg] libffi-dev [platform:dpkg]
libffi-devel [platform:redhat] libffi-devel [platform:redhat]
libffi48-devel [platform:suse] libffi48-devel [platform:suse]

View File

@ -40,13 +40,13 @@ def create(context, name, specs=None):
Expected format of the input parameter: Expected format of the input parameter:
.. code-block:: json .. code-block:: python
{ {
'consumer': 'front-end', 'consumer': 'front-end',
'total_iops_sec': 1000, 'total_iops_sec': 1000,
'total_bytes_sec': 1024000 'total_bytes_sec': 1024000
} }
""" """
# Validate the key-value pairs in the qos spec. # Validate the key-value pairs in the qos spec.

View File

@ -75,6 +75,7 @@ tempest.test_plugins =
[build_sphinx] [build_sphinx]
all_files = 1 all_files = 1
warning-is-error = 1
build-dir = doc/build build-dir = doc/build
source-dir = doc/source source-dir = doc/source