Bug 1823898
Summary: | python3-docs fails to build with Sphinx 3.0.0 | ||
---|---|---|---|
Product: | [Fedora] Fedora | Reporter: | Charalampos Stratakis <cstratak> |
Component: | python3-docs | Assignee: | Victor Stinner <vstinner> |
Status: | CLOSED ERRATA | QA Contact: | Fedora Extras Quality Assurance <extras-qa> |
Severity: | unspecified | Docs Contact: | |
Priority: | low | ||
Version: | 33 | CC: | cstratak, julien, mhroncok, mplch, pviktori, shcherbina.iryna, slavek.kabrda, thrnciar, torsava |
Target Milestone: | --- | Keywords: | Reopened |
Target Release: | --- | ||
Hardware: | Unspecified | ||
OS: | Unspecified | ||
Whiteboard: | |||
Fixed In Version: | python3-docs-3.9.0~rc2-1.fc33 | Doc Type: | If docs needed, set a value |
Doc Text: | Story Points: | --- | |
Clone Of: | Environment: | ||
Last Closed: | 2020-09-26 00:14:40 UTC | Type: | Bug |
Regression: | --- | Mount Type: | --- |
Documentation: | --- | CRM: | |
Verified Versions: | Category: | --- | |
oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
Cloudforms Team: | --- | Target Upstream Version: | |
Embargoed: | |||
Bug Depends On: | 1867294 | ||
Bug Blocks: | 1783776 |
Description
Charalampos Stratakis
2020-04-14 18:38:20 UTC
Let's bring that upstream? There is already an issue, which apparently the 3.0.1 release should have fixed, but possibly it didn't: https://bugs.python.org/issue40204 Upstream PR under review: https://github.com/python/cpython/pull/19397 > Upstream PR under review: https://github.com/python/cpython/pull/19397 It only solves a small part of the problems raised by Sphinx 3. -- The issue is being discussed at https://bugs.python.org/issue40204 There are many problems and multiple blockers issues. I don't know who can take decisions on blocker issues nor who can. The best that I can do is to ping a few people who might be able to take decisions. Examples of blocker issues: * Fixing compatibility for Sphinx 3 drops support for Sphinx 2 * So far, I don't think that any Linux distribution uses Sphinx 3: otherwise, they would not be able to build the Python documentation. I don't think that Python can break Sphinx 2 support for all these Linux distributions. * If the issue is solved in the Python master branch, should it be backported to 3.8 and 3.9 branches? Again, backporting would break Python distributions which are stuck at Sphinx 2. Not backporting will not fix python3-docs in Rawhide which is Python 3.9. We'll update Sphinx to 3 and see what happens. We can ship pre-built docs or tag in Sphinx 2.2 for an updated build. Thanks for the update. Sphinx was updated to 3.1.1. You can also try building Python documentation with Sphinx 3 by disabling warnings: make autobuild-dev-html SPHINXERRORHANDLING= at first glance it looks to build OK, but a few cross-references are dropped, which is not optimal. Sphinx pull request that should restore backwards compatibility: https://github.com/sphinx-doc/sphinx/pull/7905 A workaround: $ git switch master $ fedpkg request-side-tag $ koji tag f33-build-side-XXXXX python-sphinx-2.2.2-4.fc33 $ koji wait-repo f33-build-side-XXXXX --build python-sphinx-2.2.2-4.fc33 $ fedpkg build --target=f33-build-side-XXXXX $ koji untag f33-build-side-25703 python-sphinx-2.2.2-4.fc33 $ bodhi updates new --from-tag f33-build-side-XXXXX -> https://bodhi.fedoraproject.org/updates/FEDORA-2020-1a01b4e135 The following builds were made after this report was opened: python3-docs-3.9.0~b1-1.fc33 python3-docs-3.9.0~b5-1.fc33 Unblocking F33FTBFS to prevent my script from closing this again. This bug appears to have been reported against 'rawhide' during the Fedora 33 development cycle. Changing version to 33. Should be fixed in rc2 and the new Sphinx FEDORA-2020-78bb031321 has been submitted as an update to Fedora 33. https://bodhi.fedoraproject.org/updates/FEDORA-2020-78bb031321 FEDORA-2020-78bb031321 has been pushed to the Fedora 33 testing repository. In short time you'll be able to install the update with the following command: `sudo dnf upgrade --enablerepo=updates-testing --advisory=FEDORA-2020-78bb031321` You can provide feedback for this update here: https://bodhi.fedoraproject.org/updates/FEDORA-2020-78bb031321 See also https://fedoraproject.org/wiki/QA:Updates_Testing for more information on how to test updates. FEDORA-2020-78bb031321 has been pushed to the Fedora 33 stable repository. If problem still persists, please make note of it in this bug report. |