Received: by 2002:a05:7208:9594:b0:7e:5202:c8b4 with SMTP id gs20csp1206803rbb; Mon, 26 Feb 2024 02:03:51 -0800 (PST) X-Forwarded-Encrypted: i=3; AJvYcCX5tFOwx/ql+VU3loHFdtQaaiRiiofLEC5Fe4btkuXWsF0lUbiIb7HLa+yp3yXlpOkr4bRwwDFlmPsVwgUSDGUBsXJpczon/aD80bkJig== X-Google-Smtp-Source: AGHT+IFdZG30dsYLQOGdMjo6z77lxSeokHYB30WPbxhSXLaU3HCr9R5QBmiiXeaoxTnExvKdru+G X-Received: by 2002:aa7:d30e:0:b0:565:bd4d:8a89 with SMTP id p14-20020aa7d30e000000b00565bd4d8a89mr3068793edq.31.1708941831325; Mon, 26 Feb 2024 02:03:51 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1708941831; cv=pass; d=google.com; s=arc-20160816; b=qph4c1zFiyWVgulgmggfrTvljb7cFpmkj5uvXhnpsWr1qczmTjyWng7y8f8V1ccqTj 9vhUVWeIhu2KGHpC9l35FORpufkA9Qb2nsLZSVAIgVTsb5asZ9lUWJs9gkmXXd3fTNNE Jh5cnLwF9W7Aiafk3HfoSOvLKkiOHFHGJuy6B5qQc8SBXwtOr+Y4q9H2ifH5NkXNGf/f Bp3CaI85j4kjhS2GBEYkgJZg5fH5HwYPHTWPtHW6bqkrLQuKiPTMQXAFMQyBSVLpYb3Y Xm+Kp1mz7Uq35kfyc/ufOrb4NvMYE6ObOOyIzKDwyc4PJ9msp5KNsrECs2BOdq7T8tdb T2mg== 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=vawvIwXybApZ/749Z2EWmgW5ee2p21jliyJDHDQcteA=; fh=2w2SfztpS3k9NunhNll30lPDN6I2gh1e9XBec5vxJ5s=; b=M/ZzsfRwx5thbF80l6vdJwj5HmQdv4pQ4ZzpCKzbVDbzHdfB+Fy1PmjyUJC7lNLRsv LZ4/aAfZh5HGw6HpZ7GbvraIZb35OiWjni+RMuYYx+ushV2GAVhZzs2d0fCbQ9A4ThYr XVjyub16GCT+S+7Oz2ADmnP8nin6euxWhfuH4BbZeTwN/64FP1XeB1CSHwmom9wI3Kr7 RxQcbIl3AK+ChVkxLsWT1TZuYD+qP0xl4Sj5+cpZkGQe2fDD8Q7mLWqtKsdq398ZnxTk fNdYQfhFxRCz1qh/010W5cKvfgYGA1uhDdKJJwkmpaGkN29xv8ycuuornrPjfily5Bdy pKRg==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@gmail.com header.s=20230601 header.b=aXmWn3Gi; 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-81069-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-81069-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [147.75.80.249]) by mx.google.com with ESMTPS id t4-20020a50d704000000b0056470992c0asi2011790edi.274.2024.02.26.02.03.51 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 26 Feb 2024 02:03:51 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-81069-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) client-ip=147.75.80.249; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20230601 header.b=aXmWn3Gi; 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-81069-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-81069-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 am.mirrors.kernel.org (Postfix) with ESMTPS id 996561F2825D for ; Mon, 26 Feb 2024 10:03:26 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 9C3A65DF30; Mon, 26 Feb 2024 09:39:24 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="aXmWn3Gi" Received: from mail-ej1-f51.google.com (mail-ej1-f51.google.com [209.85.218.51]) (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 27CED5DF12; Mon, 26 Feb 2024 09:39:21 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.218.51 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1708940363; cv=none; b=DSx2joSddIvsRTM585JEfD2vRLBeZls+n6/xpsUXrojGxuUULvs6u1JjVqCB0/IQVAVo4XKcjmctrV2XLKxSnTTIvGD/UqBz8bIs2RAQJRvQaWNRQVUdkNYAhilaPPU9SlfGnwh+ZaoA8YT0EKcHFO8fe0J3e8wCbMgdfKIJp6s= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1708940363; c=relaxed/simple; bh=3sQIE5Ce5t4wLKok3Vp32KDZX/XtBqvN1n0Wh/SWVNs=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=VkcXIdg2xOJooyUhAB1fvulD/fnd6IPWsUw0sc8zmt/PkxHp6G1goucBGdO0cEEox/V0+Qe0rYTBT5dzqV7Mba/aBoDR1aQNEY9r4fuGKUcwH1cCgi5HMLWO3qOpam4LPAYQhKc4LYURhuGoSUyCxXmyGJrX3tqum8IBQrqV2xg= 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=aXmWn3Gi; arc=none smtp.client-ip=209.85.218.51 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-f51.google.com with SMTP id a640c23a62f3a-a3e72ec566aso348518566b.2; Mon, 26 Feb 2024 01:39:21 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1708940360; x=1709545160; 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=vawvIwXybApZ/749Z2EWmgW5ee2p21jliyJDHDQcteA=; b=aXmWn3Gie8XON7WCzheCzqAURX6yJP/B4yB445/SGjr3yPC1bbe/vtzonNg8ZaGS30 9BGGGlCOvkDmtngY8w5Gz/xvevZulxfwV/IQ5WXU5Y3449ne64PgYgdmxQM4KsB+W97n XTWnUSAWxD6z0swVe704psVGOatwG7IHmt260ALO2ebPneEoef32Dw1GmWquWmtNtr0S OqQKTMNLlJsSbpAtA2JzivjlebAmAX4zruU92ATAl6T+OG/f660sNlJH5tq7BabCHXyz vB0xaa+uJgy3ABAfk2cl3JgMyAH/GNKBWVspLINmy5pcMtNeNKPJfEPJtaCdSZJiHQc/ eMiQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1708940360; x=1709545160; 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=vawvIwXybApZ/749Z2EWmgW5ee2p21jliyJDHDQcteA=; b=vXf1k+UmtqoycuS+sY4vXd/sxX5XRWW/W62SLOyXqjrMHjP7sZhBeDMLk9bNEXYgKY 1NfsuQePVl1iLt8p9TfNk9inejwe8Az5L8usBTV5fWZ79h5qJvOeOj+Qa+OPzWPKZO9z /xHdC5jX/dUH05keYv8uTKfc/b3jNooovR4ot2ax0f8La1eK4JfQ54mspC2LT0ts1xhq f2oSlZBDldMIp+BfysTskVpRfqTxvLzgo+u0WAI37kR5kkGA+XokeXsOvj1oyD1aUKZX G/4ONoLdqZvRFfnhvWNHMLIXbjCo4+tBU7WD74Cr8lbSyHqPbg6LywBzcV8FZQofOdPT f1Dg== X-Forwarded-Encrypted: i=1; AJvYcCVXf5tWYkxa7OuDMAfexkHXz+Q53jkboVUHAY4+gI87kwJDH+Mn91mo0Y4NhblEWY9mtTsK5B3A3jG+YXO7ECwNTncWc+fZuW/ff1qxOtq/r8EzxumwWfuzOaR9pypg86hd7c44qHrs X-Gm-Message-State: AOJu0Yw2cUQu7CP8jTrL8rrE2o6jz90qt8nGOoD10dKu3IS/4IP46xpP aWzJNtPxtze6guqUC+lzJwyWP6nv+jnARFjenQ2FGEJf0UVEuCaj X-Received: by 2002:a17:906:fb0b:b0:a43:5429:499d with SMTP id lz11-20020a170906fb0b00b00a435429499dmr1209736ejb.27.1708940360174; Mon, 26 Feb 2024 01:39:20 -0800 (PST) Received: from lola.. ([2a02:810d:7e40:14b0:d371:e319:5dd0:9b35]) by smtp.gmail.com with ESMTPSA id ll9-20020a170907190900b00a42e4b5ab00sm2226937ejc.41.2024.02.26.01.39.19 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 26 Feb 2024 01:39:19 -0800 (PST) From: Lukas Bulwahn To: Jonathan Corbet , Akira Yokosawa , Jani Nikula , linux-doc@vger.kernel.org, Vegard Nossum , Mauro Carvalho Chehab Cc: kernel-janitors@vger.kernel.org, linux-kernel@vger.kernel.org, Lukas Bulwahn Subject: [PATCH] docs: freeze some package versions for sphinx virtualenv setup Date: Mon, 26 Feb 2024 10:38:54 +0100 Message-ID: <20240226093854.47830-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 If you currently follow the instructions for sphinx install: /usr/bin/python3 -m venv sphinx_2.4.4 . sphinx_2.4.4/bin/activate pip install -r ./Documentation/sphinx/requirements.txt you encounter an error during make htmldocs: Sphinx version error: The sphinxcontrib.applehelp extension used by this project needs at least Sphinx v5.0; it therefore cannot be built with this version. Akira-san Yokosawa reported this already in January 2023 and Jani Nikula was fast in providing a fix (see Link). This however remained as a thread on the linux-doc mailing and was never turned into a patch for Jonathan to pick up. Fix some versions for the Sphinx 2.4.4 to continue to work. Link: https://lore.kernel.org/linux-doc/cb72b3d6-de7a-4c8a-a99c-72d58a23f89c@gmail.com/ Reported-by: Akira Yokosawa Closes: https://lore.kernel.org/linux-doc/cb72b3d6-de7a-4c8a-a99c-72d58a23f89c@gmail.com/ Suggested-by: Jani Nikula Signed-off-by: Lukas Bulwahn --- Documentation/sphinx/requirements.txt | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/Documentation/sphinx/requirements.txt b/Documentation/sphinx/requirements.txt index 5d47ed443949..0aa4fdb84632 100644 --- a/Documentation/sphinx/requirements.txt +++ b/Documentation/sphinx/requirements.txt @@ -2,5 +2,10 @@ jinja2<3.1 # alabaster>=0.7.14 is not compatible with Sphinx<=3.3 alabaster<0.7.14 +sphinxcontrib-applehelp==1.0.4 +sphinxcontrib-devhelp==1.0.2 +sphinxcontrib-htmlhelp==2.0.1 +sphinxcontrib-qthelp==1.0.3 +sphinxcontrib-serializinghtml==1.1.5 Sphinx==2.4.4 pyyaml -- 2.43.2