Re: [PATCH] docs: Build kernel docs deterministically

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hi,

On Fri, 6 Sep 2024 15:56:10 +0200, Bernhard M. Wiedemann wrote:
[...]
> On 06/09/2024 11.11, Vegard Nossum wrote:
> > On 05/09/2024 13:35, bernhard+linux-doc@xxxxxxxx wrote:
> >> From: "Bernhard M. Wiedemann" <bwiedemann@xxxxxxx>
>
> > If you need reproducibility and the solution/workaround is to limit it
> > to 1 concurrent sphinx-build invocation, why can't you just run
> > 'make -j1 htmldocs ...' explicitly?
> > 
> I had tried that and it did not help.
> 

I think 'make SPHINXOPTS="-q -j1" htmldocs' should work for you.

This is more of a happens-to-work kind of hack, which assumes that
sphinx-build picks up a final -j option in the command line if there
are several.

Actual command line invoked from parallel-wrapper.sh will look something
like (wrapping by me):

    sphinx-build -jauto -b html -c /<abspath>/linux/Documentation \
	-d /<abspath>/linux/Documentation/output/.doctrees \
	-D version=6.11.0-rc6 -D release= -D kerneldoc_srctree=. \
	-D kerneldoc_bin=./scripts/kernel-doc -q -j1 \
	/<abspath>/linux/Documentation \
	/<abspath>/linux/Documentation/output

You see, -jauto (from $PARALLELISM) will be superseded by the -j1
(from $SPHINXOPTS).

Hope this helps.

        Akira




[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux