ceph/admin/doc-requirements.txt

Sphinx == 2.3.0
git+https://github.com/ceph/sphinx-ditaa.git@py3#egg=sphinx-ditaa
breathe == 4.14.0
pyyaml >= 5.1.2
Cython
admin/doc-requirements.txt: bump Sphinx and breathe * use the latest Sphinx * use the latest breathe. also, since there is no need to be compatible with python2. we can move to 4.14.0 which is python3 only. Signed-off-by: Kefu Chai <kchai@redhat.com> 2019-12-17 14:27:28 +00:00			`Sphinx == 2.3.0`
doc: install build-doc deps without git clone With `-e` the repository is cloned, leading to `git clean` skipping the cloned dependencies due to the `.git` directory, and forcing manual removal. [nwatkins@daq ceph]$ git clean -dxf Skipping repository build-doc/virtualenv/src/breathe Skipping repository build-doc/virtualenv/src/sphinx-ditaa Signed-off-by: Noah Watkins <nwatkins@redhat.com> 2018-10-03 22:48:10 +00:00			`git+https://github.com/ceph/sphinx-ditaa.git@py3#egg=sphinx-ditaa`
admin/doc-requirements.txt: bump Sphinx and breathe * use the latest Sphinx * use the latest breathe. also, since there is no need to be compatible with python2. we can move to 4.14.0 which is python3 only. Signed-off-by: Kefu Chai <kchai@redhat.com> 2019-12-17 14:27:28 +00:00			`breathe == 4.14.0`
admin/build-doc: use python3 to address https://github.com/sphinx-doc/sphinx/issues/3620, we need to use sphinx with its fix at https://github.com/sphinx-doc/sphinx/commit/e049f86b2de1cfdf8a74c88dc9593d047c85d5cb in other words, we need to use sphinx v2.0.0 and up. but sphinx 2.0 requires python >= 3.5, so we have to use python3 for building the documents. in this change: * doc-requirements.txt: install python3 packages on debian derivatives * build-doc: install python3.6 packages from EPEL7, and use python3 venv for using sphinx2 * doc-requirements.txt: bump up all python packages to latest stable. Signed-off-by: Kefu Chai <kchai@redhat.com> 2019-08-07 09:46:13 +00:00			`pyyaml >= 5.1.2`
admin/build-doc: do not use system site-packages Don't use site-packages, since the host might have the same version, and it won't have the ditaa and breathe. Require Cython to make the venv sufficient. Signed-off-by: Sage Weil <sage@redhat.com> 2019-12-16 23:21:30 +00:00			`Cython`