]> git.apps.os.sepia.ceph.com Git - ceph.git/commit
admin/doc-requirements: pin sphinx-autodoc-typehints to 1.10.3
authorKefu Chai <kchai@redhat.com>
Mon, 22 Jun 2020 00:28:37 +0000 (08:28 +0800)
committerKefu Chai <kchai@redhat.com>
Mon, 22 Jun 2020 02:37:57 +0000 (10:37 +0800)
commit83d03234efe08ab5b7b0e10eb85ca56ea2e22463
tree81870b116f3c1975f367a5a6fad887ccfcf8c25d
parent89ad6c8e5d789975ae995ed2ca413d19d3f3d7cd
admin/doc-requirements: pin sphinx-autodoc-typehints to 1.10.3

to silence following error:

ERROR: sphinx-autodoc-typehints 1.11.0 has requirement Sphinx>=3.0, but you'll have sphinx 2.4.3 which is incompatible.

* update breathe to the latest release, 4.14.2, which supports sphinx <
  3.0
* pin sphinx to 2.4.4 the last sphinx before 3.0.0. as if sphinx >= 3.0
is used, we have errors like:

Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 18]
  CEPH_RADOS_API int rados_aio_append (rados_ioctx_t io, const char *oid, rados_completion_t completion, const char *buf, size_t len)
  ------------------^

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