bpo-45618: Fix documentation build by pinning Docutils version#29230
bpo-45618: Fix documentation build by pinning Docutils version#29230ned-deily merged 2 commits intopython:mainfrom
Conversation
|
cc. @pablogsal |
73fbce7 to
8f9cf29
Compare
Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
ned-deily
left a comment
There was a problem hiding this comment.
This should be OK as at least a temporary measure. I would like @JulienPalard as the documentation release expert to review the situation for a permanent solution. Other things will need to be updated one way or another.
|
Thanks @m-aciek for the PR, and @ned-deily for merging it 🌮🎉.. I'm working now to backport this PR to: 3.9, 3.10. |
…7.1 (pythonGH-29230) Co-authored-by: Maciej Olko <maciej.olko@yougov.com> Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no> (cherry picked from commit bcee6aa) Co-authored-by: m-aciek <m-aciek@users.noreply.github.com>
|
Sorry, @m-aciek and @ned-deily, I could not cleanly backport this to |
|
GH-29240 is a backport of this pull request to the 3.10 branch. |
…7.1 (pythonGH-29230) Co-authored-by: Maciej Olko <maciej.olko@yougov.com> Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
|
GH-29241 is a backport of this pull request to the 3.9 branch. |
|
Thanks @m-aciek and @ned-deily for acting fast on this! The docutils release also broke pospell we use python-docs-fr side, I should have suspected it would broke Sphinx too, but I did not. |
|
3.8 is not EOL yet, so I guess we have to backport to 3.8 as well, @ambv? |
…to 0.17.1 (pythonGH-29230) (pythonGH-29241) Co-authored-by: Maciej Olko <maciej.olko@yougov.com> Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>
|
Yes, thanks, I've just submitted a 3.8 PR. Also, 3.7 and 3.6 are affected as well, since we build documentation for security-fix branches. But the backport is a little more complicated for them because the changes that introduced the use of |
Since the release of Docutils 0.18 today building Python documentation fails.
In CPython repository we have Sphinx pinned to 3.2.1, which has too loose requirement for Docutils version in install_requires – docutils>=0.12.
Example of failing build: https://github.com/python/python-docs-pl/runs/4009459257.
The pin can be removed after bumping Sphinx to at least 3.5.4, which introduced upper limit for docutils version.
sphinx-doc/sphinx@9263eea
https://bugs.python.org/issue45618