What is the goal for Sphinx 2.4? From: Dmitry Tantsur <dtantsur@redhat.com> Sent: Sunday, March 29, 2020 8:34 AM To: openstack-discuss Subject: Re: OpenStack should be buildable with sphinx 2.4: FTBFS in many packages [EXTERNAL EMAIL] On Sat, Mar 28, 2020 at 10:08 PM Akihiro Motoki <amotoki@gmail.com<mailto:amotoki@gmail.com>> wrote: Hi, Find my comments on several repositories. On Sat, Mar 28, 2020 at 6:34 PM Thomas Goirand <zigo@debian.org<mailto:zigo@debian.org>> wrote:
Hi,
Sphinx 2.4 has been uploaded to Experimental. I just received bug reports against the OpenStack packages because some of them cannot be built with Sphinx 2.4. Here's the list:
- ironic - os-api-ref
I can build the document with sphinx 2.4.4.
- aodh - cloudkitty - kombu
This is not part of OpenStack and is not found in opendev.org<http://opendev.org>.
- panko - ceilometerclient - ceilometermiddleware - doc8
doc8 was retired Jul 2019. For those like me who just nearly had a heart attack: it wasn't fully retired, it was moved (?) to https://github.com/PyCQA/doc8
- dracclient - glareclient - murano-pkg-check - os-xenapi - scciclient - sahara - sphinxcontrib-programoutput
This is not part of OpenStack and is not found in opendev.org<http://opendev.org>.
- tempest-horizon
sphinx document is not actually used and the content was not changed under the initial cookiecutter commit. I proposed a patch to drop sphinx related stuffs. Hope it works for you.
It'd be nice if those affected could be fixed for Ussuri. IMO, it's just the doc, so fixing it wouldn't hurt code quality. In other words: help would be more than welcome writing patch or reviewing them, and testing Sphinx 2.4 compatibility.
Cheers,
Thomas Goirand (zigo)