Title: Require Sphinx 6.2 to build Python 3.13 documentation · Issue #104818 · python/cpython · GitHub
Open Graph Title: Require Sphinx 6.2 to build Python 3.13 documentation · Issue #104818 · python/cpython
X Title: Require Sphinx 6.2 to build Python 3.13 documentation · Issue #104818 · python/cpython
Description: I propose to require Sphinx 6.2.0 to build Python 3.13 documentation. PEP 594 scheduled the removal of the imghdr module in Python 3.13. Problem: Sphinx EPUB builder used it until Sphinx 6.2. Sphinx 6.2 got fixed: it no longer uses this ...
Open Graph Description: I propose to require Sphinx 6.2.0 to build Python 3.13 documentation. PEP 594 scheduled the removal of the imghdr module in Python 3.13. Problem: Sphinx EPUB builder used it until Sphinx 6.2. Sphin...
X Description: I propose to require Sphinx 6.2.0 to build Python 3.13 documentation. PEP 594 scheduled the removal of the imghdr module in Python 3.13. Problem: Sphinx EPUB builder used it until Sphinx 6.2. Sphin...
Opengraph URL: https://github.com/python/cpython/issues/104818
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Require Sphinx 6.2 to build Python 3.13 documentation","articleBody":"I propose to require Sphinx 6.2.0 to build Python 3.13 documentation.\r\n\r\nPEP 594 scheduled the removal of the imghdr module in Python 3.13. Problem: Sphinx EPUB builder used it until Sphinx 6.2.\r\n\r\nSphinx 6.2 got fixed: it no longer uses this deprecated module:\r\n\r\n* https://github.com/sphinx-doc/sphinx/issues/10440#issuecomment-1556180835\r\n* https://github.com/sphinx-doc/sphinx/commit/a502e7523376e0344c1c9cc8a9d128143cd98b2d\r\n* https://github.com/sphinx-doc/sphinx/releases/tag/v6.2.0\r\n\r\nThis change is [ok for Fedora and RHEL will follow Fedora](https://github.com/python/cpython/pull/104777#issuecomment-1558943517), and it's [ok for OpenSuSE](https://github.com/python/cpython/pull/104777#issuecomment-1559386924).\r\n\r\nIn May 2022, [Debian Stable used Sphinx 3.4 and Ubuntu LTS used Sphinx 3.5](https://github.com/python/cpython/issues/86986#issuecomment-1140493331).\r\n\r\nIn May 2022, Python was modified to require Sphinx 3.2 or newer: see issue #86986.\r\n\r\nSee also details in the [imghdr module removal PR](https://github.com/python/cpython/pull/104777#issuecomment-1558943517).\r\n\r\n---\r\n\r\nAlternatives:\r\n\r\n* Run Sphinx with Python older than 3.13 (ex: Python 3.12) which still had the imghdr module\r\n* Don't remove the imghdr module in Python 3.13\r\n* Provide the imghdr module on PyPI, as it was done with [nntplib (on PyPI)](https://pypi.org/project/nntplib/) -- old Sphinx versions would still be supported in this case\r\n* For Linux distributions: backport the Sphinx 6.2 change to older Sphinx version to support Python 3.13 without imghdr.\n\n\u003c!-- gh-linked-prs --\u003e\n### Linked PRs\n* gh-104819\n\u003c!-- /gh-linked-prs --\u003e\n","author":{"url":"https://github.com/vstinner","@type":"Person","name":"vstinner"},"datePublished":"2023-05-23T20:40:45.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":10},"url":"https://github.com/104818/cpython/issues/104818"}
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:83c0fa3f-271f-3f3e-80a1-3c30fca8ad96 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | DCA2:A5047:887EDE:BCBC43:6968A360 |
| html-safe-nonce | e2415b5d96a6f960d75c037ba58b18dd91ee53c83a5eeef634deaabb8999c11c |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJEQ0EyOkE1MDQ3Ojg4N0VERTpCQ0JDNDM6Njk2OEEzNjAiLCJ2aXNpdG9yX2lkIjoiMjQ5NDg2MzkzNzU2MzU2Njk0NCIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | 91f595dd59a78e9abc389a75ee2c1e849a5955b520b157dc15f0c01256505c57 |
| hovercard-subject-tag | issue:1722757235 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/python/cpython/104818/issue_layout |
| twitter:image | https://opengraph.githubassets.com/64add51de41e45dd68d3d833d836f12ccb20d998edb7052e00fdbd402831b933/python/cpython/issues/104818 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/64add51de41e45dd68d3d833d836f12ccb20d998edb7052e00fdbd402831b933/python/cpython/issues/104818 |
| og:image:alt | I propose to require Sphinx 6.2.0 to build Python 3.13 documentation. PEP 594 scheduled the removal of the imghdr module in Python 3.13. Problem: Sphinx EPUB builder used it until Sphinx 6.2. Sphin... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | vstinner |
| hostname | github.com |
| expected-hostname | github.com |
| None | fdc7c66bd36a6c12eb8e771e806db863266e573fc299e77f27505a768d4f8a98 |
| turbo-cache-control | no-preview |
| go-import | github.com/python/cpython git https://github.com/python/cpython.git |
| octolytics-dimension-user_id | 1525981 |
| octolytics-dimension-user_login | python |
| octolytics-dimension-repository_id | 81598961 |
| octolytics-dimension-repository_nwo | python/cpython |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 81598961 |
| octolytics-dimension-repository_network_root_nwo | python/cpython |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 3223a6503d318917691422cdadfbe16cd8fb21e5 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
Links:
Viewport: width=device-width