Re: [PATCH v2 00/39] Translate sphinx-pre-install to Python

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

Em Fri, 11 Jul 2025 19:49:41 +0900
Akira Yokosawa <akiyks@gmail.com> escreveu:

> [most CCs dropped]
> 
> On Wed,  9 Jul 2025 15:51:32 +0200, Mauro Carvalho Chehab wrote:
> [...]
> 
> > Please notice that my goal here is to test just this tool.
> > I didn't try to actually build the docs on every distro.  
> 
> I tested the docs build against opensuse/leap:15.6 for you, and
> the install completed. One step forward.
> 
> However, running "make latexdocs" ended up with the following error:
> 
> -----------------------------------------------------------------------------
> Exception occurred:
>   File "/usr/lib/python3.11/site-packages/sphinx/builders/latex/__init__.py", line 405, in copy_support_files
>     for filename in os.listdir(staticdirname):
>                     ^^^^^^^^^^^^^^^^^^^^^^^^^
> FileNotFoundError: [Errno 2] No such file or directory: '/usr/lib/python3.11/site-packages/sphinx/texinputs'
> -----------------------------------------------------------------------------
> 
> That "texinputs" directory is supposed to hold files to be copied along
> with latex sources Sphinx will generate.
> 
> openSUSE is unique in that those files don't belong to its base Sphinx
> package.  They are provided in "python3-Sphinx-latex" (or
> "python311-Sphinx-latex", or any appropriate one for your base Sphinx
> package).
> 
> Is this news to you?

Yes, but it should be easy to add it at the tool. I'll address it, test
on Leap and submit it.

> By the way, 33/39 contains diff of test_script.py and can't be applied.
> I needed to remove the hunk manually and apply the remaining patches.

Sorry for that. I'll drop the hunk. I may eventually submit in separate
a patch series with the scripts I used for testing, but before that,
I guess we need first to move doc-related stuff to tools/docs, as
Jon suggested.

> Anyway, your translation of sphinx-pre-install into python is now at
> the bottom of my to-test/review list.  So no need to respin this.
> 
> As a matter of fact, I'm seeing weird performance regression of empty
> documentation builds when the O=<somedir> option is used.
> 
> It appeared in v6.15, which has your conversion of get_abi.pl into
> get_abi.py.  Will send a report once the time-consuming bisection
> completes.

Did you try with docs-next instead? I remember Jon caught one
issue causing the doctree cache to expire. Can't remember if this
was on 6.15 or at docs-next, but the fixes should be applied there.

Regards,
Mauro