Comment 0 for bug 1778603

Sphinx 1.7.5 apparently includes a new warning that is causing our documentation builds to fail.

$ .tox/docs/bin/pip list | grep Sphinx
Sphinx 1.7.5
$ git log -n1
commit 057c59f16fc04e5d4e63f408ac5810ebe6d5ac99
Merge: f5a83da 50fd693
Author: Zuul <email address hidden>
Date: Fri Jun 22 11:48:39 2018 +0000

    Merge "Fix duplicate role names in trusts bug"

The following is the trace when doing `tox -e docs` or `tox -re docs`

reading sources... [ 99%] install/keystone-verify-ubuntu
reading sources... [ 99%] install/shared/note_configuration_vary_by_distribution
reading sources... [ 99%] user/application_credentials
reading sources... [ 99%] user/index
reading sources... [100%] user/json_home

Warning, treated as error:
/home/lbragstad/keystone/keystone/oauth1/validator.py:docstring of keystone.oauth1.validator.OAuthValidator.save_verifier:4:Field list ends without a blank line; unexpected unindent.
ERROR: InvocationError: '/home/lbragstad/keystone/.tox/docs/bin/sphinx-build -W -b html doc/source doc/build/html'

Full trace: http://paste.openstack.org/show/724266/