Received: by 2002:a05:7208:9594:b0:7e:5202:c8b4 with SMTP id gs20csp1913516rbb; Tue, 27 Feb 2024 05:25:25 -0800 (PST) X-Forwarded-Encrypted: i=3; AJvYcCXSdYnzO9vj+WUX4Cwzn7p5CYimsR/VLHRo7EEUuKU3V676WspQotzes3J9mvgM86kAXD+brAKgic9GL5RCKy11oBj10eYmHmiZjrZW/A== X-Google-Smtp-Source: AGHT+IGChxEaiqE9rXVFa3PLXqkp52YKr//y1zb6YuoxY5ybkLOcZ8YKhlKUr+qrFWR8dg9bsgvb X-Received: by 2002:a62:be06:0:b0:6e5:d7:e27a with SMTP id l6-20020a62be06000000b006e500d7e27amr7703313pff.5.1709040325391; Tue, 27 Feb 2024 05:25:25 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1709040325; cv=pass; d=google.com; s=arc-20160816; b=BxptA8GZMxosJOaXhi0NyXC92oTw2+InwrENqTN5PmPRm5L9lEvFMgIDm7IHcRYZUU ftMn7VaikYrLbcmrFnTf+tz6pF0ohGU1Y5DUeN9cjTMGNERPQQnRHv+k0dbsQmHVhmmd 3Z2MU/PlT6BLwNOzXdXfK2/9jHopLC1A3ax26sx5RPLCNnfA0I7QO0H7cOQdEEYnkWJ3 s13WbmgLAJAXYPrq0C7r2UpSSpnDtmT4AdE9Y7bpVQooYqw+BDuOg91aFafM4KVaN2cp 9Ed3haHGdYjb1XlNjAMDtrfTxu5oC+zGKhdHeQlmHe/qRHt8lHolWIngTyBI5twqYp8m XrTA== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:message-id:date:subject:cc:to :from:dkim-signature; bh=t2pGOKrAqj7OeT3MchT4Kc1lyx+483hvEbxm3Ejyu9c=; fh=34WzDOs3VxZ5xiH2yZ4WMS8oS87cDA+frzkkLSRRpxk=; b=CCgIMNqBO5SwZs5a6GfeK2E9W9DPjcJ1b2sS/2/0grlZnBRJBmlYsIwJvcZtl1W8nl t4My6UvfcIkYtUhZZECb2vIIZ7PH6v18gNxBSoXiFwIFhaCvxCa8vx/ptN2/9zpNVIJZ RJredqFQ8jHf712bIdKarWbTR+f4fOnJ7/STItJHniAdjJi6/MBSfghWuPqWHKh9pHN+ WFzxW6pSkj1exTVO1pRu7PNchPtCe2uiQkH4sgfDPe3R/wmwrPKy0AY55AmtyLn+VYpR 18u4Qe2uTZ44jo+7tt4KebetB4+c+XK7G81CFQIfX6KA51FD6VyRXd+yQi3ybFxqv1+0 QT7Q==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@gmail.com header.s=20230601 header.b=bToqdiQ2; arc=pass (i=1 spf=pass spfdomain=gmail.com dkim=pass dkdomain=gmail.com dmarc=pass fromdomain=gmail.com); spf=pass (google.com: domain of linux-kernel+bounces-83297-linux.lists.archive=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) smtp.mailfrom="linux-kernel+bounces-83297-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org. [139.178.88.99]) by mx.google.com with ESMTPS id kr20-20020a056a004b5400b006e4ee18f304si5539200pfb.251.2024.02.27.05.25.25 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 27 Feb 2024 05:25:25 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-83297-linux.lists.archive=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) client-ip=139.178.88.99; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20230601 header.b=bToqdiQ2; arc=pass (i=1 spf=pass spfdomain=gmail.com dkim=pass dkdomain=gmail.com dmarc=pass fromdomain=gmail.com); spf=pass (google.com: domain of linux-kernel+bounces-83297-linux.lists.archive=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) smtp.mailfrom="linux-kernel+bounces-83297-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sv.mirrors.kernel.org (Postfix) with ESMTPS id 7E707290F3E for ; Tue, 27 Feb 2024 13:15:18 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id E926C13B79B; Tue, 27 Feb 2024 13:14:57 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="bToqdiQ2" Received: from mail-ej1-f43.google.com (mail-ej1-f43.google.com [209.85.218.43]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 32D0113AA2B; Tue, 27 Feb 2024 13:14:54 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.218.43 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1709039697; cv=none; b=eWlZOUGz74q1oLIL9UMGQARWL59xsjwr560EpuQ2WeEyHh6qGIiVz4x7enfFnBjzSjhWPQ20T0vFWbs2rpGqTBj59r/ZN0jN5MhBf78YppuBcLjtNGX/VTyYq4aEZhWMoIzJ7u9DlUzDpB6aLK0u4ZPBXvoSlTqPQZb5atqyJoU= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1709039697; c=relaxed/simple; bh=NJNXI+K3JHWpjNDnBECTCpd1UuaOUMZ/inEaVKjUMxk=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=UP2KzJ1UR8U+rK5CyW76d4tSckqlzzcwAU9FEqpdugYmpto42wndyTabgSQTaWcQMKJUtXnCGFrNPJm2U0cMPN02c9Z2PgVeMVfiXRGuUjmqEv5+XXDqWhcJLs0Q1PJosICokv10xfQ1WL9x3Mv1zn7j89JkYgs4l0I7APYSV5c= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=bToqdiQ2; arc=none smtp.client-ip=209.85.218.43 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Received: by mail-ej1-f43.google.com with SMTP id a640c23a62f3a-a3e550ef31cso480847666b.3; Tue, 27 Feb 2024 05:14:54 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1709039693; x=1709644493; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=t2pGOKrAqj7OeT3MchT4Kc1lyx+483hvEbxm3Ejyu9c=; b=bToqdiQ25F+2xGzmpKqB1/GlkJ+/QMnVpEjj3eGROO2sMwuFODQkM296h5YUIZ5WL8 V9FbKSYy9YvIe++oyv66hgqeUFnydk6vVADUIu5VklAlRMI+xOTWk55pmurjyRDe9X4I CDKMTgIrvhGo5pNvryXuemU0qw1ZE9oLJuVnFDp6HYgv7Gy5nkXPEPshtIzpIHSgm0gn mKBG25pmY2YcpsiSBuL3FBVIOlNJCNfku/gZOPmy6ouzpTSgS+KT3W/Na8lqYwfzpFIV PA14cvsJFFBHvlyD0CatOSOmR5BXscctRFm87plMGGjT+RITk2flr9dlrXX9Z9Jp5DIO RseA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1709039693; x=1709644493; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=t2pGOKrAqj7OeT3MchT4Kc1lyx+483hvEbxm3Ejyu9c=; b=abJmfi1TYC6RctlkBQWDKGgihFaDKKduLk+ZBaRly1OgY66zqx4fLRgqunKhUI4WVB 7dvLvRqrYRagBJD/h/3K/oDrlM/pz/5Rsw45iRtSn52L0st5HTYZ5cUPKDvSSpPievi4 J3QHm8QtJUcsskRLA5W8uV4L3Ktt0IbkvtvXTyjlUyWgxvrcnbajWEidwJtfH3PDKFci 4I5BK9s/zD5ZhWe6nys1SM50zQdpICX2LLcYM0iVSI2Y7TczZcLwcTb96Dy2jaVtwQOX 3ig6j3lsjuwWAyNUypW9idkvEs68sR95BpTUJ50U/XIZG/kMbWy9aiWLtSnl/yLC7/YB g2MA== X-Forwarded-Encrypted: i=1; AJvYcCVwdflHjeHOtXhVLBLpDZ4i5fVRKV/XDchWnDa+QKl4hwmfPucacPBfnLqxSnop1qZ41nWwS3Eecfn/5V/O/bA7hINav2tCTl/I X-Gm-Message-State: AOJu0YxNcZV7axpCNaOCeGWfUul9YootkZTEWDi7EXXmFNG3Ufz2tvNZ Z2FCCqPV5UW1D4xybrjfMewGF8uQAQpyciJ5dTIAq6XMJtS7vdOuQs0RAKDN7eU= X-Received: by 2002:a17:906:ce36:b0:a3f:4fd7:3cf5 with SMTP id sd22-20020a170906ce3600b00a3f4fd73cf5mr6324320ejb.17.1709039693265; Tue, 27 Feb 2024 05:14:53 -0800 (PST) Received: from lola.. ([2a02:810d:7e40:14b0:d371:e319:5dd0:9b35]) by smtp.gmail.com with ESMTPSA id pj11-20020a170906d78b00b00a42ffa7d4cfsm760600ejb.88.2024.02.27.05.14.52 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 27 Feb 2024 05:14:52 -0800 (PST) From: Lukas Bulwahn To: Jonathan Corbet , Mauro Carvalho Chehab , Vegard Nossum , Akira Yokosawa , Jani Nikula , Randy Dunlap , linux-doc@vger.kernel.org Cc: linux-kernel@vger.kernel.org, Lukas Bulwahn Subject: [PATCH] docs: drop the version constraints for sphinx and dependencies Date: Tue, 27 Feb 2024 14:14:10 +0100 Message-ID: <20240227131410.35269-1-lukas.bulwahn@gmail.com> X-Mailer: git-send-email 2.43.2 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit As discussed (see Links), there is some inertia to move to the recent Sphinx versions for the doc build environment. As first step, drop the version constraints and the related comments. Then, the sphinx-pre-install script will fail though with: Can't get default sphinx version from ./Documentation/sphinx/requirements.txt at ./scripts/sphinx-pre-install line 305. The script simply expects to parse a version constraint with Sphinx in the requirements.txt. That version is used in the script for suggesting the virtualenv directory name. To suggest a virtualenv directory name, when there is no version given in the requirements.txt, one could try to guess the version that would be downloaded with 'pip install -r Documentation/sphinx/requirements.txt'. However, there seems no simple way to get that version without actually setting up the venv and running pip. So, instead, name the directory with the fixed name 'sphinx_latest'. Finally update the Sphinx build documentation to reflect this directory name change. Link: https://lore.kernel.org/linux-doc/874jf4m384.fsf@meer.lwn.net/ Link: https://lore.kernel.org/linux-doc/20240226093854.47830-1-lukas.bulwahn@gmail.com/ Signed-off-by: Lukas Bulwahn --- Documentation/doc-guide/sphinx.rst | 11 ++++++----- Documentation/sphinx/requirements.txt | 8 +++----- scripts/sphinx-pre-install | 19 +++---------------- 3 files changed, 12 insertions(+), 26 deletions(-) diff --git a/Documentation/doc-guide/sphinx.rst b/Documentation/doc-guide/sphinx.rst index 709e19821a16..8081ebfe48bc 100644 --- a/Documentation/doc-guide/sphinx.rst +++ b/Documentation/doc-guide/sphinx.rst @@ -48,13 +48,14 @@ or ``virtualenv``, depending on how your distribution packaged Python 3. on the Sphinx version, it should be installed separately, with ``pip install sphinx_rtd_theme``. -In summary, if you want to install Sphinx version 2.4.4, you should do:: +In summary, if you want to install the latest version of Sphinx, you +should do:: - $ virtualenv sphinx_2.4.4 - $ . sphinx_2.4.4/bin/activate - (sphinx_2.4.4) $ pip install -r Documentation/sphinx/requirements.txt + $ virtualenv sphinx_latest + $ . sphinx_latest/bin/activate + (sphinx_latest) $ pip install -r Documentation/sphinx/requirements.txt -After running ``. sphinx_2.4.4/bin/activate``, the prompt will change, +After running ``. sphinx_latest/bin/activate``, the prompt will change, in order to indicate that you're using the new environment. If you open a new shell, you need to rerun this command to enter again at the virtual environment before building the documentation. diff --git a/Documentation/sphinx/requirements.txt b/Documentation/sphinx/requirements.txt index 5d47ed443949..1f3b98eee2c9 100644 --- a/Documentation/sphinx/requirements.txt +++ b/Documentation/sphinx/requirements.txt @@ -1,6 +1,4 @@ -# jinja2>=3.1 is not compatible with Sphinx<4.0 -jinja2<3.1 -# alabaster>=0.7.14 is not compatible with Sphinx<=3.3 -alabaster<0.7.14 -Sphinx==2.4.4 +jinja2 +alabaster +Sphinx pyyaml diff --git a/scripts/sphinx-pre-install b/scripts/sphinx-pre-install index de0de5dd676e..4c781617ffe6 100755 --- a/scripts/sphinx-pre-install +++ b/scripts/sphinx-pre-install @@ -280,8 +280,6 @@ sub get_sphinx_version($) sub check_sphinx() { - my $default_version; - open IN, $conf or die "Can't open $conf"; while () { if (m/^\s*needs_sphinx\s*=\s*[\'\"]([\d\.]+)[\'\"]/) { @@ -293,18 +291,7 @@ sub check_sphinx() die "Can't get needs_sphinx version from $conf" if (!$min_version); - open IN, $requirement_file or die "Can't open $requirement_file"; - while () { - if (m/^\s*Sphinx\s*==\s*([\d\.]+)$/) { - $default_version=$1; - last; - } - } - close IN; - - die "Can't get default sphinx version from $requirement_file" if (!$default_version); - - $virtenv_dir = $virtenv_prefix . $default_version; + $virtenv_dir = $virtenv_prefix . "latest"; my $sphinx = get_sphinx_fname(); if ($sphinx eq "") { @@ -318,8 +305,8 @@ sub check_sphinx() die "$sphinx didn't return its version" if (!$cur_version); if ($cur_version lt $min_version) { - printf "ERROR: Sphinx version is %s. It should be >= %s (recommended >= %s)\n", - $cur_version, $min_version, $default_version; + printf "ERROR: Sphinx version is %s. It should be >= %s\n", + $cur_version, $min_version; $need_sphinx = 1; return; } -- 2.43.2