yahoo-eng-team team mailing list archive

[Gage Hugo <gagehugo@xxxxxxxxx>]

This is probably more of an issue with sphinx then, as the current
solution is to block it on upper constraints[0].

[0] https://review.openstack.org/#/c/534779/

** Changed in: keystone
       Status: Confirmed => Invalid

-- 
You received this bug notification because you are a member of Yahoo!
Engineering Team, which is subscribed to OpenStack Identity (keystone).
https://bugs.launchpad.net/bugs/1742648

Title:
  Doc build(both html and man) failing with sphinx 1.6.6

Status in OpenStack Identity (keystone):
  Invalid

Bug description:
  There seems to be some issue when building docs with sphinx 1.6.6. Current u-c for sphinx is 1.6.5.
  Filing bug so that it can be fixed in keystone(if it's a keystone issue) or sphinx==1.6.6 can be blacklisted if issue is confirmed in sphinx.

  Reproduction steps:-
  git clone https://github.com/openstack/keystone
  cd keystone
  tox -edocs   #SUCCESS

  .tox/docs/bin/pip install sphinx==1.6.6
  tox -edocs    #FAILS with below Error

  Expected result: Doc build should pass

  Actual result: Doc build fails
  ERROR log:-
  looking for now-outdated files... none found
  pickling environment... done
  checking consistency... 
  Warning, treated as error:
  /home/ykarel/work/keystone/doc/source/api/keystone.assignment.backends.rst:document isn't included in any toctree
  ERROR: InvocationError: '/home/ykarel/work/keystone/.tox/docs/bin/python setup.py build_sphinx'

To manage notifications about this bug go to:
https://bugs.launchpad.net/keystone/+bug/1742648/+subscriptions