Comment 11 for bug 1260495

Here is the bug in action!

With an invalid exclude path set the documentation built correctly, but included the setup module: http://docs-draft.openstack.org/67/121667/1/check/gate-python-keystoneclient-docs/7f9b0f3/doc/build/html/api/modules.html

When I corrected the commit to use api/setup.rst as recommended I get an error because Keystone we turn warnings into errors. From https://jenkins04.openstack.org/job/gate-python-keystoneclient-docs/570/console :
    2014-09-23 22:59:46.925 | raise SphinxWarning(warntext)
    2014-09-23 22:59:46.926 | sphinx.errors.SphinxWarning: /home/jenkins/workspace/gate-python-keystoneclient-docs/doc/source/api/modules.rst:4: WARNING: toctree contains reference to nonexisting document u'api/setup'
    2014-09-23 22:59:46.926 |
    2014-09-23 22:59:47.066 | ERROR: InvocationError: '/home/jenkins/workspace/gate-python-keystoneclient-docs/.tox/venv/bin/python setup.py build_sphinx'