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

[Vegard Nossum]

On 18/03/2024 17:44, Donald Hunter wrote:
> With Sphinx 2.4.4 I always get timings in this ballpark:
>
> % time make htmldocs
> ...
> real	4m5.417s
> user	17m0.379s
> sys	1m11.889s
>
> With Sphinx 7.2.6 it's typically over 9 minutes:
>
> % time make htmldocs
> ...
> real	9m0.533s
> user	15m38.397s
> sys	1m0.907s

Was this running 'make cleandocs' (or otherwise removing the output
directory) in between? Sphinx is known to be slower if you already have
an output directory with existing-but-obsolete data, I believe this is
the case even when switching from one Sphinx version to another. Akira
also wrote about the 7.x performance:

https://lore.kernel.org/linux-doc/6e4b66fe-dbb3-4149-ac7e-8ae333d6fc9d@xxxxxxxxx/

> I have an experimental fix that uses a dict for lookups. With the fix, I
> consistently get times in the sub 5 minute range:

Fantastic!

There is a github issue for the C++ domain but I believe it's the same
issue for both C and C++ domains:

https://github.com/sphinx-doc/sphinx/issues/10966


Vegard