On Tue, Feb 27, 2024 at 7:57 AM Akira Yokosawa <akiyks@xxxxxxxxx> wrote: > > [dropping most CCs] > > Hello Lukas, > > This is a friendly notice for filling in some contexts. > > On Mon, 26 Feb 2024 10:38:54 +0100, Lukas Bulwahn wrote: > [...] > > Akira-san Yokosawa reported this already in January 2023 and Jani Nikula > > was fast in providing a fix (see Link). This however remained as a thread > > on the linux-doc mailing and was never turned into a patch for Jonathan to > > pick up. > > Have you read Jon's message in the thread archived at: > > https://lore.kernel.org/linux-doc/874jf4m384.fsf@xxxxxxxxxxxx/ > > I think you can see why there had been no submission of a proper patch > in your patch's direction nor others. > > If you still want your patch applied soon, you need to convince Jon. > > A patch that helps us to go in the direction of 1) in Jon's message is > most welcome! > > Be aware that if you simply remove ==2.4.4 from requirements.txt, > sphinx-pre-install will prevent you from running "make htmldocs". > > You'll see this error: > > Can't get default sphinx version from ./Documentation/sphinx/requirements.txt at ./scripts/sphinx-pre-install line 305. > Yes, I have seen Jonathan's message. I also read that updating to recent versions---despite the slight performance issues---is the way forward. I will try out if I can make a proper patch to get that setup working. However, I also read: Jonathan is "happy to not break 2.4.4 for now, though I suspect that day may come". Hence, as the current sphinx 2.4.4 setup is broken and still the one and only way that is documented on how to set up the kernel documentation build, I thought we will need to at least get that back into the working state until the documentation for how to use the new versions is in place. Hence, I proposed this patch here. It works (for me). But I do not care if it is picked or not---because I am just continuing the whack-a-mole game. As of now, I do not know how much work the better solution for "updating to recent versions" needs. I will spend half a day and hopefully I can then present a good working patch. But let us see. Lukas
