Re: [PATCH] docs: drop the version constraints for sphinx and dependencies

From: Akira Yokosawa
Date: Thu Feb 29 2024 - 21:33:32 EST


On Thu, 29 Feb 2024 15:39:31 +0100, Vegard Nossum wrote:
> [...]
>
> $ scripts/sphinx-pre-install
> Detected OS: Ubuntu 22.04.3 LTS.
> Sphinx version: 4.3.2
>
>
> All optional dependencies are met.
> Needed package dependencies are met.
>
>
> One remark I have is that it didn't encourage me to upgrade to 7.2.6 in
> the last one (using the system Sphinx 4.3.2) although it did for the
> 2.4.4 virtualenv. Maybe that's expected. I didn't look into it. Anyway,

Yes, it's expected.

Sphinx 3.4.3 provided as distro packages of Debian 11 (bullseye),
RHEL 9, and so on is good enough for kernel documentation.
Suggesting upgrade to a latest release would be noisy.

The version is assigned to $rec_version in sphinx-pre-install.

As a fix to requirements.txt for v6.8, this looks to me like a nice
minimal change.

Lukas, many thanks for doing this.

Reviewed-by: Akira Yokosawa <akiyks@xxxxxxxxx>

Thanks, Akira