Re: [PATCH v3 15/15] docs: conf.py: Check Sphinx and docutils version

[Mauro Carvalho Chehab <mchehab+huawei@kernel.org>]

Em Sun, 22 Jun 2025 20:19:52 +0900
Akira Yokosawa <akiyks@gmail.com> escreveu:

> > After check Sphinx release notes, it seems that the
> > version compatibility is given by:
> > 
> >         =======  ============   ============
> >         Sphinx   Min Docutils   Max Docutils
> >         Version  Version        Version
> >         -------  ------------   ------------
> >         3.4.3    >= 0.12.0      < 0.18.0
> >         4.0.0    >= 0.12.0      < 0.19.0
> >         6.0.0    >= 0.18.0      < 0.20.0
> >         7.0.0    >= 0.18.1      < 0.21.0
> >         7.2.0    >= 0.18.1      < 0.20.0
> >         7.4.0    >= 0.18.1      < 0.21.0
> >         8.0.0    >= 0.20.0      < 0.22.0
> >         8.2.3    >= 0.20.0      < 0.22.0
> >         =======  ============   ============
> >   
> 
> <nitpick>
> So this is what I see in the changelog (not looked into < 6.0.0):
> 
>          ================= ====================
>           Sphinx version     docutils version
>           (since)              min       max
>          ----------------- ------------ -------
>          6.0.0             >= 0.18      < 0.20
>          6.2.0             >= 0.18.1    < 0.20
> 	 7.0.1             >= 0.18.1    < 0.21
>          7.3.0             >= 0.18.1    < 0.22
> 	 7.4.0             >= 0.20      < 0.22
> 	 (up to 8.2.3)
>          ================= ====================
> 
> This Looks quite different from yours ...
> </nitpick>

Thanks for your feedback!

Getting this right is not too easy, specially since not all
changelog mentions docutil version. Btw, one of the factors I 
used when building my table were to check the release dates 
of Sphinx and docutils. So, I manually adjusted some entries,
as changelog usually say something like:

	Release 5.0.0 (released May 30, 2022)¶
	Dependencies

	5.0.0 b1

	    #10164: Support Docutils 0.18. Patch by Adam Turner.

But doesn't mention minimal supported version.

I'll re-check and adjust it as needed, if Jon decides to pick it.

Thanks,
Mauro