Skip to content

Increase minimum supported Sphinx to 7.2.6 #125277

Closed
@AA-Turner

Description

@AA-Turner

Documentation

Python 3.13 has been released, so I looked to review the minimum Sphinx version.

Using the same survey as #109209 (comment) and #117928:

Distro CPython Sphinx
Debian 13 Trixie (testing) 3.12.6 7.4.7
Debian Sid (unstable) 3.12.6 7.4.7
Debian (experimental) 3.12.6 N/A
Fedora 39 (EOL 12/11/2024) 3.12.6 6.2.1
Fedora 40 3.12.6 7.2.6
Fedora 41 3.13.0 7.3.7
Fedora rawhide 3.13.0 7.3.7
Gentoo N/A N/A
openSUSE Leap   8.0.2
openSUSE Tumbleweed   8.0.2
RHEL N/A N/A
Minimum Sphinx version for 3.12 3.12 7.2.6

† The blocker to updating is Fedora 39, which is end-of-life in a month's time. cc @hroncok -- would you prefer we wait until November until the actual EOL date?

Sphinx 7.2 has support for documenting generic classes and :no-typesetting:. Sadly .. py:type:: is new in Sphinx 7.4, so we need to wait for Fedora 40's end-of-life (13 May 2025) to use it.

References:

cc:

Linked PRs

Metadata

Metadata

Assignees

No one assigned

    Labels

    docsDocumentation in the Doc dir

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions