From 83d03234efe08ab5b7b0e10eb85ca56ea2e22463 Mon Sep 17 00:00:00 2001 From: Kefu Chai Date: Mon, 22 Jun 2020 08:28:37 +0800 Subject: [PATCH] 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 --- admin/doc-requirements.txt | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/admin/doc-requirements.txt b/admin/doc-requirements.txt index 787817c7fbb1a..29db8cfe61b62 100644 --- a/admin/doc-requirements.txt +++ b/admin/doc-requirements.txt @@ -1,11 +1,11 @@ -Sphinx == 2.4.3 +Sphinx == 2.4.4 git+https://github.com/ceph/sphinx-ditaa.git@py3#egg=sphinx-ditaa -breathe == 4.14.0 +breathe == 4.14.2 pyyaml >= 5.1.2 Cython prettytable -sphinx-autodoc-typehints +sphinx-autodoc-typehints == 1.10.3 typed-ast pcpp -e../src/python-common -Jinja2 \ No newline at end of file +Jinja2 -- 2.39.5