From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.remote-ip=103.168.172.148 ARC-Seal: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; cv=none; t=1795117943; b=Ff/Cu5YKSDpq17Uzt7txJ/eZ35uyC1UjfgggL42bYq9F6VUm5XKFvbK87ZfyDH251jVM KCzRqXYzovGk6kC1Nc7HLXSlwIc4el7OAg+lUsFoo6KEYPVQVtklZ/bOMeVwKd6Iqu0Iy GwcBS1RmjRGzET6PmFI5eyUAwCnkerH6p4O3QdQcpPQz61IDkO6D+X2MmMJX+FERAFXWk P02pYt+VSkHd23FAyJnyOwU8S6JYsKqG0Z2Vx/aTxnxPwc4dF0MRc5YukT/8WN9M80Ry0 u7UbuTizmhQHDc3sqZDZOEqt5SiDItdiInGwr28nyjvW53puFTWcviF4wip7sHkfyaA== ARC-Message-Signature: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1795117943; h=DMARC-Filter:Received:Received:DKIM-Signature:DKIM-Signature: X-DKIM2-Info:DKIM2-Signature:X-DKIM2-Info:Message-Instance: X-ME-Sender:X-ME-Received:X-ME-Proxy-Cause:X-ME-Proxy:Feedback-ID: Received:From:To:Cc:Subject:Date:Message-ID:X-Mailer:MIME-Version: Content-Transfer-Encoding; bh=5FjEiY2j0pqnJYqUO8LQZ01V4lTyJQIMaHfii/c8ujs=; b=498C797Vc6eSOwF85fFfGx41ac4qoGouaM9hHeCKf/G0mSrVIoKQXzvb/bfZ5e6lceyo do7Xnkj4NF2lTYw17KxLmJ1PyYJv0TXjyYvAKQp/E0fuXT1ZbphieJucA85VVpZs/eTsl B1dqAY+O8OqHGzY4MSgIPYoXstV2dbaVDtKGCYkoCu9/T8q0wfwDiXTcH5eoiBagtXcns 2Np8tj0bXhVVy4z9aXGQypRWMyPuQ1rbxY3vVfjuYx6z89W0fqV8A9Uu+YQe3/XqENzfr JZT46eFt2b1IKPSpSz8QFbCdsXsCmpL6qkB5geNs2LixZYam+JRtxKfshERnVjVUSsw== ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none header.from=seanlyon.dev; spf=pass smtp.mailfrom=seanlyon.dev; dkim=pass header.d=seanlyon.dev header.i=@seanlyon.dev header.a=rsa-sha256 header.s=fm1 header.b=A5NILQNp; dkim=pass header.d=messagingengine.com header.i=@messagingengine.com header.a=rsa-sha256 header.s=fm3 header.b=DoEtj5dC; arc=none smtp.remote-ip=103.168.172.148 Received: from fout-a5-smtp.messagingengine.com (fout-a5-smtp.messagingengine.com [103.168.172.148]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 0313C606A320 for ; Thu, 19 Nov 2026 19:52:21 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org 0313C606A320 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=seanlyon.dev Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=seanlyon.dev Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key, unprotected) header.d=seanlyon.dev header.i=@seanlyon.dev header.a=rsa-sha256 header.s=fm1 header.b=A5NILQNp; dkim=pass (2048-bit key, unprotected) header.d=messagingengine.com header.i=@messagingengine.com header.a=rsa-sha256 header.s=fm3 header.b=DoEtj5dC Received: from phl-compute-04.internal (phl-compute-04.internal [10.202.2.44]) by mailfout.phl.internal (Postfix) with ESMTP id 32A26EC05DF for ; Thu, 19 Nov 2026 14:52:21 -0500 (EST) Received: from phl-frontend-04 ([10.202.2.163]) by phl-compute-04.internal (MEProxy); Thu, 19 Nov 2026 14:52:21 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=seanlyon.dev; h= cc:cc:content-transfer-encoding:content-type:date:date:from:from :in-reply-to:message-id:mime-version:reply-to:subject:subject:to :to; s=fm1; t=1795117941; x=1795204341; bh=5FjEiY2j0pqnJYqUO8LQZ 01V4lTyJQIMaHfii/c8ujs=; b=A5NILQNpaqmb25B7qSoLYDA72SEndK4NYDQL5 tdE0tgYGxMz01qwYcHlr8xwJKS9UBqTbDJlNEvIBo4OmdfhAU6SidpJev8x1FLqB 1wZA49QqQkVC+NL8WW9TnfEuNAJvGw4B5mnGRrB5+om+YCU8QwjbqHsgl7Jp99l/ DFvO5n0WVmuc43GRDiw9AebtAAK2vrtgZlm7RZwPjdgcXtJSIoR2ny/b1Wy8AjEe o05PtWEl8xxkKocB8iLHSovx+oDHPYMQ0z0vKe6hzq3qBfNsD8+z/jufN2Dp722C 6++GuWqgHBriRkbdZqjVIo/hfGZhLoEiK/Xgy4DzDr4phAmKw== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:date:date:feedback-id:feedback-id:from:from :in-reply-to:message-id:mime-version:reply-to:subject:subject:to :to:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s=fm3; t= 1795117941; x=1795204341; bh=5FjEiY2j0pqnJYqUO8LQZ01V4lTyJQIMaHf ii/c8ujs=; b=DoEtj5dCosVk6dWQukrqwF9KOM0CatNXHrFz3H3poJSKi1iYoRH +07RIAdgSWDzmp1O1S9GtoyggrXCjcu6Of8PGO8GHDu3CaukZ4/TOAmWzrxDWtRV SCx62UjIIp4ArChkzOtHSjRwtFV/wX6B+rWsu00YorFfuvS9eUVBTagVmebLYvlB qQG9W2xe54V9CUUvWRqz+OZge/2bt7NLDhZtPlyRmEbRaIZVG0Nx0UDLh00N1h9u uHJff6S0GqmpgmIHJpClOxV5FMMVXwI3MA4yc38xqOwHvOJgr6wUGfPrTLoakP30 z6cx1d9ELKtnP1Kvr8//z8nJ1K7VRBOfZNg== X-DKIM2-Info: draft=ietf-dkim-dkim2-spec-09; repo=github.com/dkim2wg/interop; date=2026-11-03; sw=lmtpprox; action=sign d=seanlyon.dev a=rsa-sha256; DKIM2-Signature: i=1; m=1; t=1795117941; d=seanlyon.dev; mf=PHNlYW5Ac2Vhbmx5b24uZGV2Pg==; rt=PGxpbnV4LWtlcm5lbEB2Z2VyLmtlcm5lbC5vcmc+; s=fm1:rsa-sha256:Wu/9qHmTlOrFFjUlqBmdjMUvws6+RQDHJ9GYydHfhR8vVfv rTwaK/cnsjX58u3/KW6vNGANNaEAInSO2Qc/BUS4GYctdbnr33BUVoaTtSwArR9c JFrWoml6ZvdN4LScqx+F/NBdqV29prGAGbv33cPpr1MMJvUZ+h/wvNMB+0duaAm/ XtesqlikW6ZNi/+tDbazbObk9w/tFrJMn3JW+g5zMVuZb8mJ1oT0m1g27VXYL2p2 jI9ghkbc2JkBluPzT6mJTf1d9+FKN60vhdPASYrNxI3JszWijxMM1D/ZE1z5fiqd 0Gd+Ks+H0h25E8RJ6zGAWecVnVTfmBxzjvX9J2A==; X-DKIM2-Info: draft=ietf-dkim-dkim2-spec-09; repo=github.com/dkim2wg/interop; date=2026-11-03; sw=lmtpprox; action=mi-m=1; hc=9; hn=cc,content-transfer-encoding,date,feedback-id,from, message-id,mime-version,subject,to; Message-Instance: m=1; h=sha256:cAveVNDD+ew5zPUXkJJnNBxyXH3cvf95LA9N2pkyLxA=:cE8Cjx1Ug9f35OqIeaF0tCJO5wwoN3wrfbL7I76s6zE=; X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: dmFkZTGau1atO3MrYD3qEN84EWdErHQgOJ0rluMbRKPREXP6FaJXy5yJ0tpk05a5GywC+v TRicIgN+4SnX3mHFykaymQi8S/97vjstQNrCruN8pF4hRLJ1xYvRe6szYVPb03vEbSJK7P 88RFMe7CpYhYgaA2ijv8tRnf4U95UmpqmrTl1NryAxkXCxIcJMn1WnNO1kRf46Dfey/R2G PsVB6k2kkKpDIm46sbTOsAWC4jrLaqV/l39TDXRroXb6cDpC6OirZD8K0koX6nVv0xPJ+2 3yEPhdUhJ3qK3Qn+h3rIYiKfVEKCjnDWBWKLRBCD+HohhxJbfwkyx/uT4S7rXi5QcygylD xHRkQInGSc4coFgtqJeyc/JFSdcvjLcnqgrb+j++A5jIWFSLJj/ttZI11t2MWMkpsIdr4o 1VqBCkb5f4zn/zq86+o096jHZUKjndp9IVsKLwRcknVU5hlCWYBqHdZVU0z98OIELwJnSf xg0HMHXaScWkNQBwqS4TkrR4NIlFx3fIbJJ8dgTBDwAdRJrR1uugjLe5twTpob4+mXngYi suTAfJ4YYtTvFuUr45+GE47eb8pdGtjaEIo0GpLJPCHVIUBeZBFc9LGq73hrBg99NJLleE C43MMc8REd9ja0XYKsBzmM6B1A89vcnvr10s4hUxoti3L7jgL5fqXkljrRDQ X-ME-Proxy: Feedback-ID: i07c64b5b:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Thu, 19 Nov 2026 14:52:20 -0500 (EST) From: Sean Lyon To: Jonathan Corbet Cc: Shuah Khan , Randy Dunlap , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Sean Lyon Subject: [PATCH] docs: conf.py: register sphinx_rtd_theme as an extension Date: Thu, 19 Nov 2026 14:51:17 -0500 Message-ID: <20261119195117.32709-1-sean@seanlyon.dev> X-Mailer: git-send-email 2.56.1 X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Transfer-Encoding: 8bit The sphinx_rtd_theme sidebar has collapsible sections. The theme uses jQuery to add the toctree-expand buttons that control them. Sphinx 6 stopped bundling jQuery. Since sphinx_rtd_theme 1.2.0, the theme's setup() enables the sphinxcontrib-jquery extension to load it, but setup() does not run when the theme is loaded through html_theme_path. Without jQuery, the buttons are never added, so sidebar sections cannot be collapsed. Register sphinx_rtd_theme as an extension so its setup() runs. The setup() also registers the theme, so html_theme_path is no longer needed, and sphinx_rtd_theme 3.0 warns that it is deprecated. Signed-off-by: Sean Lyon --- Note for testers: with Sphinx >= 8.1, some pages (e.g. core-api/) expand more than one sidebar section. This also happens without this patch. It comes from documents included in multiple toctrees. Sphinx warns about these documents, but the warnings are only shown with make V=1 htmldocs. I'm looking into this separately and plan to send an RFC. Tested with sphinx_rtd_theme 3.1.0 and sphinx_rtd_dark_mode 1.3.0 on Sphinx 9.2.0, and on min_requirements.txt with sphinx_rtd_theme 1.3.0. No new build warnings, and the get_html_theme_path deprecation warning is gone. Documentation/conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/conf.py b/Documentation/conf.py index 5ab26ce89daf..ed15bb80ef87 100644 --- a/Documentation/conf.py +++ b/Documentation/conf.py @@ -385,7 +385,7 @@ if html_theme in ["sphinx_rtd_theme", "sphinx_rtd_dark_mode"]: try: import sphinx_rtd_theme - html_theme_path = [sphinx_rtd_theme.get_html_theme_path()] + extensions.append("sphinx_rtd_theme") # Add any paths that contain custom static files (such as style sheets) here, # relative to this directory. They are copied after the builtin static files, base-commit: 2138148bf44fd84d3e0a863f0e8cb3627cdcc606 -- 2.56.1