Received: by 2002:ac0:c50a:0:0:0:0:0 with SMTP id y10csp1050628imi; Fri, 1 Jul 2022 01:51:59 -0700 (PDT) X-Google-Smtp-Source: AGRyM1s81mtXPjYXAZYfbVBa4Z+Du2NvrG2J0ky110MR5Nsph3s9IlLcks0VwqpzZCFVbu0UEMR9 X-Received: by 2002:a05:6402:5c9:b0:420:aac6:257b with SMTP id n9-20020a05640205c900b00420aac6257bmr17363132edx.128.1656665519517; Fri, 01 Jul 2022 01:51:59 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1656665519; cv=none; d=google.com; s=arc-20160816; b=MlxZgUxcbat/wdyKuoUbEldS+bmtGhi2UTs7cuk9alnNbstpMcHubmRf19S+4AgXrY AW4fFbCeKdFCsnsnjM1n6iyn38MnFe7AFbWdATlol13sM5Y/uiugMuZaujOxdAN44wN4 ADR3lt1VUHpUq/6G9s+2pr8pu63GZhxcg3aS59K7DuUiYbzMKnyWZzwtHZSwiC1FwnrM gAJSdemf5VdmQ/QVH2xa2tk2TmcePrPifh3EvGt6G/rbHhBsdRVHvke+SZnA0helfoIK Owb7pxUi4SIx3hQok02h27r0JT1ouQhdaX2BZPo9N0iEmOnv5mKqZAPlOW64fslveLhY RlAA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=40Ctum/kSlhHBkSoKzbB5sQ+aeV+73Rz0DVWUtvPUas=; b=GlDyj8ZTTQgA+b/uKZAq6EltWBoCCZw04CH88OQnZvuH1WJQ/0Vh6/zzOfsf/5SVtg SXyEN69g0KbNaOYtgrCYZMeL3EUfFv6tbVofXpel8ZFboflBvAJF/jAoq2m+nFUb+XqY p1N/SlGzQZhlKZZH+5D7UJGq9lNqJeR/ITdIo0bAI27aDypVNfWK9UkBg56EShGcTHA8 pxuS0UcpZRMrWtMNv4qeP38WQ+5rHkeM9NKRxTND8VlH8HSBOvXHkT4gxZLV/GzvP5cz 3sXeHFhrRNhbu1ZHWFCnc7PIuHfMaJS7RbSQt7sCqkAFt+IZFr+nJp+YHbhSPPMEkc3V zNuw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=qF6GHEaL; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id w12-20020a056402128c00b004356ab67849si4833477edv.520.2022.07.01.01.51.33; Fri, 01 Jul 2022 01:51:59 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=qF6GHEaL; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235364AbiGAIt2 (ORCPT + 99 others); Fri, 1 Jul 2022 04:49:28 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:56154 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233418AbiGAItL (ORCPT ); Fri, 1 Jul 2022 04:49:11 -0400 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 352D87393F; Fri, 1 Jul 2022 01:48:56 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id C0FF76223C; Fri, 1 Jul 2022 08:48:55 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 20A96C341CD; Fri, 1 Jul 2022 08:48:55 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1656665335; bh=PLCPy3kenRuiCw55qBC87u1/3uZ+m0MdzA/eDR9lqTY=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=qF6GHEaLEf1Xgz7PFa23y+vrD9QMIlSGvQjlsFMgTqni8uuBQhKWtSHBSzfbug7za fZUXgy/U1Qc5lGUEso6KV8+Vkw52atUEvEsITiyHt3P3eRYpcnsswOQTZLjJGcX6IS 6iNu68zGm/YUu1UQMN4yJRwYu1aucbFzSa2rtNl7pRy/zSJn5ixa+R9rk2mvP//KGv jNPM5l068MGB1CnvP/UG2cVXDb5o6U0Z/lrgpb2uCzpNBUN4llbqtNaVpy2Fdi7yDn wzm/CTJZpZxJtiFFyvQrW0CtvKo6aVwJqHba9XvgrYQ6ThuNUDBmh+wYGEChQmWpwX cSaeCA3Ws75Zg== Received: from mchehab by mail.kernel.org with local (Exim 4.95) (envelope-from ) id 1o7CKZ-006T98-Pr; Fri, 01 Jul 2022 09:48:51 +0100 From: Mauro Carvalho Chehab To: Jonathan Corbet , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , Mauro Carvalho Chehab , ksummit-discuss@lists.linuxfoundation.org, linux-kernel@vger.kernel.org Subject: [PATCH 0/4] Address some issues with sphinx detection Date: Fri, 1 Jul 2022 09:48:45 +0100 Message-Id: X-Mailer: git-send-email 2.36.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-7.5 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_HI, SPF_HELO_NONE,SPF_PASS,T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Cc: Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Jonathan Corbet , ksummit-discuss@lists.linuxfoundation.org Cc: "Jonathan Corbet" Cc: "Mauro Carvalho Chehab" Cc: Jonathan Corbet Cc: Mauro Carvalho Chehab Cc: ksummit-discuss@lists.linuxfoundation.org Cc: linux-doc@vger.kernel.org Cc: linux-kernel@vger.kernel.org Checking if Sphinx is available and read to run is tricky, and may involve installing several packages for the document build to happen. There are two options to install Sphinx: - via distro-provided packages; - via pip, using virtualenv/venv. Some recent discussions showed a couple of misleading instructions. This series improves the Sphinx detection by: - Fixing the logich with checks if a past venv is working and recommend just enabling it instead of installing a new venv; - Detect if sphinx-build stopped working on a venv. This may happen during distribution updates; - Move the PDF minimal version to be later, in order for it to be printed only after finishing the Sphinx version check; Additionally, as now the Sphinx provided on almost all modern distros are above the minimal required version, place instructions about how to install Sphinx from the distro-provided packages after placing the instructions for installing it via venv. This will hopefully help to have more developers checking documentation builds with make htmldocs Mauro Carvalho Chehab (4): scripts: sphinx-pre-install: fix venv version check logic scripts: sphinx-pre-install: report broken venv scripts: sphinx-pre-install: check for PDF min version later on scripts: sphinx-pre-install: provide both venv and package installs scripts/sphinx-pre-install | 74 ++++++++++++++++++++++++++++---------- 1 file changed, 55 insertions(+), 19 deletions(-) -- 2.36.1