Re: [PATCH v2] docs: Use make invocation's -j argument for parallelism
From: Jani Nikula <jani.nikula@linux.intel.com>
Date: 2019-09-25 08:35:25
Also in:
lkml
On Tue, 24 Sep 2019, Kees Cook [off-list ref] wrote:
On Tue, Sep 24, 2019 at 10:12:22AM +0300, Jani Nikula wrote:quoted
On Mon, 23 Sep 2019, Kees Cook [off-list ref] wrote:quoted
On Sun, Sep 22, 2019 at 02:03:31PM -0600, Jonathan Corbet wrote:quoted
On Thu, 19 Sep 2019 14:44:37 -0700 Kees Cook [off-list ref] wrote:quoted
While sphinx 1.7 and later supports "-jauto" for parallelism, this effectively ignores the "-j" flag used in the "make" invocation, which may cause confusion for build systems. Instead, extract the availableWhat sort of confusion might we expect? Or, to channel akpm, "what are the user-visible effects of this bug"?When I run "make htmldocs -j16" with a pre-1.7 sphinx, it is not parallelized. When I run "make htmldocs -j8" with 1.7+ sphinx, it uses all my CPUs instead of 8. :)To be honest, part of the solution should be to require Sphinx 1.8 or later. Even Debian stable has it. If your distro doesn't have it (really?), using the latest Sphinx in a virtual environment should be a matter of: $ python3 -m venv .venv $ . .venv/bin/activate (.venv) $ pip install sphinx sphinx_rtd_theme (.venv) $ make htmldocsI don't mind having sphinx 1.8 (I did, in fact, already update it), but that still doesn't solve the whole problem: my -j argument is being ignored...
I meant, *part* of the solution should be to not have to deal with ancient Sphinx. BR, Jani. -- Jani Nikula, Intel Open Source Graphics Center