]> git-server-git.apps.pok.os.sepia.ceph.com Git - ceph.git/commit
admin/doc-requirements.txt: pin Sphinx at 3.5.4 43748/head
authorKefu Chai <tchaikov@gmail.com>
Sat, 30 Oct 2021 03:18:17 +0000 (11:18 +0800)
committerKefu Chai <tchaikov@gmail.com>
Sat, 30 Oct 2021 03:24:51 +0000 (11:24 +0800)
commit6362b554e2e57227c9fda51c7703f14674da8358
tree2e875030778e48efa6030cd6c745c9ab6592273e
parentb4a6984d2b094e41a7fbbfa2acb694f7ec5d0603
admin/doc-requirements.txt: pin Sphinx at 3.5.4

* pin Sphinx at 3.5.4
* pin docutils at 0.18

at least the combination of these two versions
is known to compile.

to address the bug reported at
https://sourceforge.net/p/docutils/bugs/431/

the backtrace looks like:

/home/jenkins-build/build/workspace/ceph-pr-docs/build-doc/virtualenv/lib/python3.8/site-packages/sphinx/util/docutils.py:285:
RemovedInSphinx30Warning: function based directive support is now
deprecated. Use class based directive instead.
  warnings.warn('function based directive support is now deprecated. '

Exception occurred:
  File
"/home/jenkins-build/build/workspace/ceph-pr-docs/build-doc/virtualenv/lib/python3.8/site-packages/docutils/writers/html5_polyglot/__init__.py",
line 445, in section_title_tags
    if (ids and self.settings.section_self_link
AttributeError: 'Values' object has no attribute 'section_self_link'

please note this change is not cherry-picked from
master, because master already bumped Sphinx to 3.5.4
in 4968baa2523bd2a5ca6be147b26bc28906a864c9.

Signed-off-by: Kefu Chai <tchaikov@gmail.com>
admin/doc-requirements.txt