yahoo-eng-team team mailing list archive
-
yahoo-eng-team team
-
Mailing list archive
-
Message #32649
[Bug 1260495] Re: Setting autodoc_tree_index_modules makes documentation builds fail
** Changed in: pbr
Status: Fix Committed => Fix Released
--
You received this bug notification because you are a member of Yahoo!
Engineering Team, which is subscribed to Keystone.
https://bugs.launchpad.net/bugs/1260495
Title:
Setting autodoc_tree_index_modules makes documentation builds fail
Status in OpenStack Identity (Keystone):
Confirmed
Status in Python Build Reasonableness:
Fix Released
Status in Python client library for Keystone:
Confirmed
Bug description:
The arguments originally being passed into sphinx.apidoc specified '.'
as the path to index. Unfortunately this includes the setup.py module.
Sphinx dies while trying to process the setup.rst likely because the
setup.py module calls setuptools.setup() when imported causing some
sort of recursion. The final result is something like:
2013-12-08 21:08:12.088 | reading sources... [ 80%] api/setup
2013-12-08 21:08:12.100 | /usr/lib/python2.7/distutils/dist.py:267: UserWarning: Unknown distribution option: 'setup_requires'
2013-12-08 21:08:12.101 | warnings.warn(msg)
2013-12-08 21:08:12.102 | /usr/lib/python2.7/distutils/dist.py:267: UserWarning: Unknown distribution option: 'pbr'
2013-12-08 21:08:12.102 | warnings.warn(msg)
2013-12-08 21:08:12.103 | usage: setup.py [global_opts] cmd1 [cmd1_opts] [cmd2 [cmd2_opts] ...]
2013-12-08 21:08:12.103 | or: setup.py --help [cmd1 cmd2 ...]
2013-12-08 21:08:12.104 | or: setup.py --help-commands
2013-12-08 21:08:12.104 | or: setup.py cmd --help
2013-12-08 21:08:12.104 |
2013-12-08 21:08:12.105 | error: invalid command 'build_sphinx'
2013-12-08 21:08:12.622 | ERROR: InvocationError: '/home/jenkins/workspace/gate-keystone-docs/.tox/venv/bin/python setup.py build_sphinx'
To manage notifications about this bug go to:
https://bugs.launchpad.net/keystone/+bug/1260495/+subscriptions