sphinx 1.6.1 introduces an TypeError error

[zhongjun]

http://logs.openstack.org/36/465436/4/check/gate-manila-specs-docs-ubuntu-xenial/b5244bc/console.html#_2017-05-18_02_56_08_812683

2017-05-18 02:56:08.711677 | preparing documents... done
2017-05-18 02:56:08.712041 | writing output... [ 3%] contributing
2017-05-18 02:56:08.811019 |
2017-05-18 02:56:08.811113 | Exception occurred:
2017-05-18 02:56:08.812570 | File "/home/jenkins/workspace/gate-manila-specs-docs-ubuntu-xenial/.tox/venv/local/lib/python2.7/site-packages/sphinx/themes/basic/../basic/layout.html", line 108, in template
2017-05-18 02:56:08.812638 | {%- for css in css_files %}
2017-05-18 02:56:08.812683 | TypeError: 'NoneType' object is not iterable
2017-05-18 02:56:08.814946 | The full traceback has been saved in /tmp/sphinx-err-22VVJl.log, if you want to report the issue to the developers.
2017-05-18 02:56:08.815099 | Please also report this if it was a user error, so that a better error message can be provided next time.
2017-05-18 02:56:08.815208 | A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!
2017-05-18 02:56:08.895474 | ERROR: InvocationError: '/home/jenkins/workspace/gate-manila-specs-docs-ubuntu-xenial/.tox/venv/bin/python setup.py build_sphinx'
2017-05-18 02:56:08.895668 | ___________________________________ summary ____________________________________
2017-05-18 02:56:08.895694 | ERROR: venv: commands failed

[Rodolfo Alonso (rodolfo-alonso-hernandez)]

Actually, according to [1], the version introducing this error is sphinx 1.6.1

[1] http://logs.openstack.org/36/465436/4/check/gate-manila-specs-docs-ubuntu-xenial/b5244bc/tox/venv-1.log

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/465978

[OpenStack Infra (hudson-openstack)]

Change abandoned by Rodolfo Alonso Hernandez (<email address hidden>) on branch: master
Review: https://review.openstack.org/465978

[Rodolfo Alonso (rodolfo-alonso-hernandez)]

requirements/test-requirements.txt excludes sphinx 1.6.1 version.

commit: 91f7a4fd14b70f7e4c6995cd2a838892b34d4618

[OpenStack Infra (hudson-openstack)]

Change abandoned by Rodolfo Alonso Hernandez (<email address hidden>) on branch: master
Review: https://review.openstack.org/465978
Reason: Superseed by https://review.openstack.org/#/c/466133/

BTW, this patch was submitted before 466133.

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/465436
Committed: https://git.openstack.org/cgit/openstack/manila-specs/commit/?id=d5dc5b51fa45f2a7ba947b844c769cf3a7e733ea
Submitter: Jenkins
Branch: master

commit d5dc5b51fa45f2a7ba947b844c769cf3a7e733ea
Author: zhongjun <email address hidden>
Date: Wed May 17 15:39:30 2017 +0800

    Fix sphinx version to !=1.6.1,>=1.5.1

    Since then the jenkins job of gate-manila-specs-docs-ubuntu-xenial
    always failed. Let's set sphinx version to !=1.6.1,>=1.5.1 to fix
    the failure in test-requirements. As the same as manila project does.

    https://review.openstack.org/#/c/465263/2/test-requirements.txt.

    Partial-Bug: #1691622
    Change-Id: Ic411bb789deaf3b71c4b94d465dd673d6f5cfd5e

[Jason Grosso (jgrosso)]

zhongjun are you still seeing this issue, can we assist anyone helping you address this?