Received: by 2002:a25:824b:0:0:0:0:0 with SMTP id d11csp8257413ybn; Tue, 1 Oct 2019 05:43:07 -0700 (PDT) X-Google-Smtp-Source: APXvYqyzTSUWdCeKoh9TyHsbQxlrDEYBLEtP8Mtwtdu6bJqSoCa9QKfNyGJRL7gJ/0nPytPjQmKL X-Received: by 2002:a17:906:57ce:: with SMTP id u14mr23455512ejr.184.1569933786988; Tue, 01 Oct 2019 05:43:06 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1569933786; cv=none; d=google.com; s=arc-20160816; b=VEV5XA1zTDPoxbRksGAqfpZNNdOo6F5kDtisnGTvG1mkDuI8Jaj/q10yZr2uQyGV7w BRuWbXdQXSeyIF1W5ZgGweOHUIBoH0d386W5Q6W7duFBcHcE/4lnOb+EzBRvo1eqwFZs D57VkdteCrUnLYUtjMuvM1i5FTnOjVUyrPYiU+p0BbcCr+GTo7ULVV2LFYfi8QMDpGcX ns+/AhXHxu1MCHyy7JrOlYK+Oy2oZQExc8N7lfu12mKxpJLMM7z1Hvt+jdpjnXe+6hLN byzCqLBRK/YdJHQ4LWBDW25tgefXT7cFJcPN53zp9aGO9Hzfrx9494u5lWtxpmG86O2w coVw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :organization:references:in-reply-to:message-id:subject:cc:to:from :date; bh=5MS/6uWNtbai5tbm1fT5/VMdvY9U7hDp2iCnG6NWBjk=; b=gB2klkmzzBQ8WVNgCE/IjdikB0kkB+LQzKhEOaH0YieqbZr+rsuexI4sAeOkqoH0ba k1AvFe+8X9D+vwl39AAaRAjHV2UjKd3++2cEyCWWldq3gkm8bPMc0e8PSfhk4hUy/cGS 3Q4Cvj/hm9EzrP4HJBqQDqkbDr+isNQvrQ9WrgtgKojQ/BP5n7YHtS+cxAx3QNeR7Mea OQfgi//HG8ZVhigZ+88/kKuZsh2vxvLit4DRagUky6i2EkhwjzRFXQ0XFQFEHXXGl9ck dLJWBa1M5Zfpb7CLslE+qkjsjL/WVr7oN0vWGq2LwD5JfvUd3EQJ7WTkzI+gcxwwTlSJ r5zQ== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id t7si8916213ejo.302.2019.10.01.05.42.42; Tue, 01 Oct 2019 05:43:06 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2387909AbfJAMjv (ORCPT + 99 others); Tue, 1 Oct 2019 08:39:51 -0400 Received: from ms.lwn.net ([45.79.88.28]:36350 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725821AbfJAMjv (ORCPT ); Tue, 1 Oct 2019 08:39:51 -0400 Received: from lwn.net (localhost [127.0.0.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id A94F52CF; Tue, 1 Oct 2019 12:39:50 +0000 (UTC) Date: Tue, 1 Oct 2019 06:39:49 -0600 From: Jonathan Corbet To: Kees Cook Cc: Mauro Carvalho Chehab , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH v3] docs: Use make invocation's -j argument for parallelism Message-ID: <20191001063949.1b5e87dc@lwn.net> In-Reply-To: <201909241627.CEA19509@keescook> References: <201909241627.CEA19509@keescook> Organization: LWN.net MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Tue, 24 Sep 2019 16:29:58 -0700 Kees Cook wrote: > 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 available > parallelism from "make"'s job server (since it is not exposed in any > special variables) and use that for the "sphinx-build" run. Now things > work correctly for builds where -j is specified at the top-level: > > make -j16 htmldocs > > If -j is not specified, continue to fallback to "-jauto" if available. > > Signed-off-by: Kees Cook I finally messed with this a bit; it seems to do exactly what's written on the box. It seems to me that The Real Solution™ here is to send a patch to the Sphinx folks adding a "-jgmake" (or some such) option. It also seems to me that none of us is likely to get around to that in the near future. So I just applied this, thanks for dealing with all my picky comments... jon