Re: [PATCH 0/2] docs, python: bump sphinx preferred version

[Thomas Huth <thuth@redhat.com>]

On 16/07/2025 00.20, John Snow wrote:
> fwiw, I think this is important enough / harmless enough to sneak into
> the rc releases, if possible.

Yes, sounds like a good idea to avoid breakage with the latest Python versions.

Series
Reviewed-by: Thomas Huth <thuth@redhat.com>


> On Tue, Jul 15, 2025 at 5:28 PM John Snow <jsnow@redhat.com> wrote:
>>
>> CI: https://gitlab.com/jsnow/qemu/-/pipelines/1928836481
>>
>> Unlike the previous series, this series only adjusts the *preferred*
>> sphinx version to be higher, leaving the accepted version at 3.4.3, the
>> version that CentOS Stream 9 still ships with.
>>
>> Unfortunately, this means we can't cut out the compatibility code for
>> sphinx we're still carrying around just yet, but we'll await that
>> glorious moment to arrive on some future day.
>>
>> Sphinx 6.2.1 is being chosen as the new default because it still offers
>> support for Python 3.8+, but is new enough to support Python 3.13+.
>>
>> Distro version information for supported platforms as of 2025-07-15:
>>
>> distro              python3  pip     setuptools  sphinx
>> -------------------------------------------------------
>> alpine_3_19         3.11.13  23.3.1  70.3.0      6.2.1
>> alpine_3_20         3.12.11  24.0    70.3.0      7.2.6
>> alpine_3_21         3.12.11  24.3.1  70.3.0      8.1.3
>> alpine_3_22         3.12.11  25.1.1  80.9.0      8.2.3
>> centos_stream_9     3.9.23   21.3.1  53.0.0      3.4.3
>> centos_stream_10    3.12.11  23.3.2  69.0.3      7.2.6
>> debian_12           3.11.2   23.0.1  66.1.1      5.3.0
>> fedora_41           3.13.5   24.2    69.2.0      7.3.7
>> fedora_42           3.13.5   24.3.1  74.1.3      8.1.3
>> freebsd             3.11.13  23.3.2  63.1.0      5.3.0
>> homebrew            3.13.5   ---     80.9.0      8.2.3
>> macports            3.13.5   25.1.1  78.1.1      8.2.3
>> openbsd             3.12.11  25.1.1  79.0.1      8.2.3
>> pkgsrc_current      3.12.11  25.1.1  80.9.0      8.2.3
>> ubuntu_22_04        3.10.12  22.0.2  59.6.0      4.3.2
>> ubuntu_24_04        3.12.3   24.0    68.1.2      7.2.6
>> ubuntu_24_10        3.12.7   24.2    74.1.2      7.4.7
>> ubuntu_25_04        3.13.3   25.0    75.8.0      8.1.3
>>
>> Akihiko Odaki (2):
>>    docs: Bump sphinx to 6.2.1
>>    MAINTAINERS: Add docs/requirements.txt
>>
>>   MAINTAINERS           | 1 +
>>   docs/requirements.txt | 4 ++--
>>   pythondeps.toml       | 4 ++--
>>   3 files changed, 5 insertions(+), 4 deletions(-)
>>
>> --
>> 2.50.0
>>
>>
> 
>