From nobody Wed Dec 17 09:44:35 2025 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id A2138C25B47 for ; Fri, 27 Oct 2023 08:19:03 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235084AbjJ0ITD (ORCPT ); Fri, 27 Oct 2023 04:19:03 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:58850 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S235152AbjJ0IS5 (ORCPT ); Fri, 27 Oct 2023 04:18:57 -0400 Received: from mx0a-00069f02.pphosted.com (mx0a-00069f02.pphosted.com [205.220.165.32]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 24E141AA; Fri, 27 Oct 2023 01:18:55 -0700 (PDT) Received: from pps.filterd (m0246627.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 39R5iCdc020786; Fri, 27 Oct 2023 08:18:46 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : in-reply-to : references : mime-version : content-transfer-encoding; s=corp-2023-03-30; bh=XiYBzT666XUrJBEenylzauji4KGI2RRUgvA0UHv3h4o=; b=Yas+hTB6dx4N568I6QVS8R1FAu0ig/u0ZNN/EIJsAzpJTg3i4OSHjEsc0hRKfDXh+a1y C2KATGg/ojZBkNwWYXp3oZuqOR89oWqYbmjHTPYnMkEtZrbm9g6cL6/ra00M8klFlyLr Al2D7T0EtZCi5to4CZnjqEB1182OHWTK4TODiQJtrZ0agDVLxtymtK2v5/M+aNzVAsr5 ynIYwmQZ6ab3OQIuUZme7YWkGh1/SEDkGaXoXFATpEKmR89F1We2C3JnlMa3ILtVyAKA +R8Ifr5ZhO+ur74kpeP1CeIlPHWTTJyYKHiH1YuwZO4Tx6n8zP8LDMysP9fr1MGlgDsg Qg== Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.appoci.oracle.com [138.1.37.129]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3tyx4tgx01-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 27 Oct 2023 08:18:45 +0000 Received: from pps.filterd (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 39R6Bkhg009253; Fri, 27 Oct 2023 08:18:45 GMT Received: from pps.reinject (localhost [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3tywqjeb6j-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 27 Oct 2023 08:18:45 +0000 Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by pps.reinject (8.17.1.5/8.17.1.5) with ESMTP id 39R8Ig9L028975; Fri, 27 Oct 2023 08:18:44 GMT Received: from t460-2.nl.oracle.com (dhcp-10-175-63-126.vpn.oracle.com [10.175.63.126]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTP id 3tywqjeb1g-2; Fri, 27 Oct 2023 08:18:44 +0000 From: Vegard Nossum To: linux-doc@vger.kernel.org, Jonathan Corbet , Mauro Carvalho Chehab Cc: Jani Nikula , linux-kernel@vger.kernel.org, Vegard Nossum Subject: [PATCH RFC 01/11] docs: style toctree captions as headings Date: Fri, 27 Oct 2023 10:18:20 +0200 Message-Id: <20231027081830.195056-2-vegard.nossum@oracle.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20231027081830.195056-1-vegard.nossum@oracle.com> References: <20231027081830.195056-1-vegard.nossum@oracle.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.272,Aquarius:18.0.987,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2023-10-27_06,2023-10-26_01,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 mlxlogscore=999 mlxscore=0 spamscore=0 suspectscore=0 adultscore=0 bulkscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2310240000 definitions=main-2310270071 X-Proofpoint-GUID: QAlaJOtZyHK1XoTMy3SD0PnWrVYs97TY X-Proofpoint-ORIG-GUID: QAlaJOtZyHK1XoTMy3SD0PnWrVYs97TY Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" The rtd theme already styles toctree captions as headings, but the alabaster theme doesn't. Add this in. Cc: Mauro Carvalho Chehab Cc: Jonathan Corbet Signed-off-by: Vegard Nossum --- Documentation/sphinx-static/custom.css | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Documentation/sphinx-static/custom.css b/Documentation/sphinx-= static/custom.css index 084a884f6fb7..c7439349dda6 100644 --- a/Documentation/sphinx-static/custom.css +++ b/Documentation/sphinx-static/custom.css @@ -8,6 +8,9 @@ div.body h1 { font-size: 180%; } div.body h2 { font-size: 150%; } div.body h3 { font-size: 130%; } =20 +/* toctree captions are styled like h2 */ +div.toctree-wrapper p.caption[role=3Dheading] { font-size: 150%; } + /* Tighten up the layout slightly */ div.body { padding: 0 15px 0 10px; } div.sphinxsidebarwrapper { padding: 1em 0.4em; } --=20 2.34.1 From nobody Wed Dec 17 09:44:35 2025 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 7E26AC25B67 for ; Fri, 27 Oct 2023 08:19:28 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229604AbjJ0IT1 (ORCPT ); Fri, 27 Oct 2023 04:19:27 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:47280 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S235176AbjJ0ITQ (ORCPT ); Fri, 27 Oct 2023 04:19:16 -0400 Received: from mx0a-00069f02.pphosted.com (mx0a-00069f02.pphosted.com [205.220.165.32]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 61F7A10D0; Fri, 27 Oct 2023 01:19:12 -0700 (PDT) Received: from pps.filterd (m0246627.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 39R5iCdd020786; Fri, 27 Oct 2023 08:18:49 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : in-reply-to : references : mime-version : content-type : content-transfer-encoding; s=corp-2023-03-30; bh=LAEaozT4QqgZE84FVGuX7tOgFZQKNBd0vZkJmsXPoh8=; b=4RIEmFU/cPmAlSyiC+tXdGDRKDI0s67Eehi9tm+dQhgqnGLkbLQBHzY5WPs+d1XnoeV0 vGKRZWxGjFsztublzUTs+i/RWvACnKLKW1I20HdZX1ON2CclHOY0Yx7JQIETtBPsic74 wo/TM12beTAalTTYb6NbCEv6+3puXdR3mVlUBLZA1BoRUaL8bEargdgTThbU6gc1hhDm Wv/Jy7J8tSpTWvoEWSOmaA3TWkOpLMkvMZV5f0ncb72DwuO92OqDbfLytuQTUTsEvFe+ Q9Nmfp+G6vrA+HW66gQRNfAdSOpJq4A0Lb/Z7tDrll3zltu3UX48uN+Mfc2mP9b9j3JS 1Q== Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.appoci.oracle.com [138.1.37.129]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3tyx4tgx04-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 27 Oct 2023 08:18:48 +0000 Received: from pps.filterd (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 39R62lNv009264; Fri, 27 Oct 2023 08:18:48 GMT Received: from pps.reinject (localhost [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3tywqjeb7t-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 27 Oct 2023 08:18:48 +0000 Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by pps.reinject (8.17.1.5/8.17.1.5) with ESMTP id 39R8Ig9N028975; Fri, 27 Oct 2023 08:18:47 GMT Received: from t460-2.nl.oracle.com (dhcp-10-175-63-126.vpn.oracle.com [10.175.63.126]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTP id 3tywqjeb1g-3; Fri, 27 Oct 2023 08:18:47 +0000 From: Vegard Nossum To: linux-doc@vger.kernel.org, Jonathan Corbet , Mauro Carvalho Chehab Cc: Jani Nikula , linux-kernel@vger.kernel.org, Vegard Nossum , Rui Li , Yanteng Si , Wu XiangCheng Subject: [PATCH RFC 02/11] doc: userspace-api: properly format ToC headings Date: Fri, 27 Oct 2023 10:18:21 +0200 Message-Id: <20231027081830.195056-3-vegard.nossum@oracle.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20231027081830.195056-1-vegard.nossum@oracle.com> References: <20231027081830.195056-1-vegard.nossum@oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.272,Aquarius:18.0.987,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2023-10-27_06,2023-10-26_01,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 mlxlogscore=664 mlxscore=0 spamscore=0 suspectscore=0 adultscore=0 bulkscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2310240000 definitions=main-2310270071 X-Proofpoint-GUID: ZsdjRiu4E0N0YFVQjp1yEforhYRYX6RD X-Proofpoint-ORIG-GUID: ZsdjRiu4E0N0YFVQjp1yEforhYRYX6RD Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org "class:: toc-title" was a workaround for older Sphinx versions that are no longer supported. The canonical way to add a heading to the ToC is to use :caption:. Do that. Cc: Rui Li Cc: Yanteng Si Cc: Wu XiangCheng Signed-off-by: Vegard Nossum --- Documentation/translations/zh_CN/userspace-api/index.rst | 5 +---- Documentation/userspace-api/index.rst | 5 +---- 2 files changed, 2 insertions(+), 8 deletions(-) diff --git a/Documentation/translations/zh_CN/userspace-api/index.rst b/Doc= umentation/translations/zh_CN/userspace-api/index.rst index 5dc0f2e69c17..5b14721c8264 100644 --- a/Documentation/translations/zh_CN/userspace-api/index.rst +++ b/Documentation/translations/zh_CN/userspace-api/index.rst @@ -17,11 +17,8 @@ Linux =E5=86=85=E6=A0=B8=E7=94=A8=E6=88=B7=E7=A9=BA=E9= =97=B4API=E6=8C=87=E5=8D=97 =E5=9C=A8=E4=BB=A3=E7=A0=81=E6=A0=91=E4=B8=AD=E4=BB=8D=E7=84=B6=E5=8F=AF= =E4=BB=A5=E6=89=BE=E5=88=B0=E6=9C=89=E5=85=B3=E7=94=A8=E6=88=B7=E7=A9=BA=E9= =97=B4=E7=9A=84=E9=83=A8=E5=88=86=E4=BF=A1=E6=81=AF=E3=80=82=E8=BF=99=E4=B8= =AA=E6=89=8B=E5=86=8C=E6=84=8F=E5=9C=A8=E6=88=90=E4=B8=BA=E8=BF=99=E4=BA=9B= =E4=BF=A1=E6=81=AF =E8=81=9A=E9=9B=86=E7=9A=84=E5=9C=B0=E6=96=B9=E3=80=82 =20 -.. class:: toc-title - - =E7=9B=AE=E5=BD=95 - .. toctree:: + :caption: =E7=9B=AE=E5=BD=95 :maxdepth: 2 =20 no_new_privs diff --git a/Documentation/userspace-api/index.rst b/Documentation/userspac= e-api/index.rst index 72a65db0c498..5b32a461c2dd 100644 --- a/Documentation/userspace-api/index.rst +++ b/Documentation/userspace-api/index.rst @@ -9,11 +9,8 @@ While much of the kernel's user-space API is documented el= sewhere also be found in the kernel tree itself. This manual is intended to be the place where this information is gathered. =20 -.. class:: toc-title - - Table of contents - .. toctree:: + :caption: Table of contents :maxdepth: 2 =20 no_new_privs --=20 2.34.1 From nobody Wed Dec 17 09:44:35 2025 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id A62FAC25B67 for ; Fri, 27 Oct 2023 08:19:12 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235168AbjJ0ITL (ORCPT ); Fri, 27 Oct 2023 04:19:11 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:58968 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229604AbjJ0ITB (ORCPT ); Fri, 27 Oct 2023 04:19:01 -0400 Received: from mx0a-00069f02.pphosted.com (mx0a-00069f02.pphosted.com [205.220.165.32]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id D0AE41AC; Fri, 27 Oct 2023 01:18:59 -0700 (PDT) Received: from pps.filterd (m0333521.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 39R5iMtF005798; Fri, 27 Oct 2023 08:18:51 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : in-reply-to : references : mime-version : content-transfer-encoding; s=corp-2023-03-30; bh=s1EbLkYdolk3yWS71XSb9v+3TTnjVXp+R3q9NNNtvvQ=; b=3OKBa59j+xlak04GwN1NyD43BlEjLWdsE2WlpECHTGajC/Q6itdC0XfU2wpFqSWlARsQ SXvwD/9G+Bg8fFZGLtcELqUyTD77+c6GcuE+1yR+mIMf7hAiZL2J5iIDMsrKXVZHtN0W MPtT4ousFNqY6OfdhjkFp/9a9F1W3xnrVfcWTgW9Edp4VYedNO46BEW2mJYnXj1ToZnj LDqBvho97u867V5fS1NDTTEAELkNpcnWXzjl8x3lTFsJyDukWwXwyOPvllXSkrXKUIZ/ BWtSIWxD9RB3eXCjFHoc5oR+H2FWq9oxDTVOR5Geq0TPMBT87dXXix4lMIQb1lizdd3p 6g== Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.appoci.oracle.com [138.1.37.129]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3tywtt0ymb-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 27 Oct 2023 08:18:51 +0000 Received: from pps.filterd (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 39R5u6Uk009204; Fri, 27 Oct 2023 08:18:50 GMT Received: from pps.reinject (localhost [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3tywqjeb8j-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 27 Oct 2023 08:18:50 +0000 Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by pps.reinject (8.17.1.5/8.17.1.5) with ESMTP id 39R8Ig9P028975; Fri, 27 Oct 2023 08:18:49 GMT Received: from t460-2.nl.oracle.com (dhcp-10-175-63-126.vpn.oracle.com [10.175.63.126]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTP id 3tywqjeb1g-4; Fri, 27 Oct 2023 08:18:49 +0000 From: Vegard Nossum To: linux-doc@vger.kernel.org, Jonathan Corbet , Mauro Carvalho Chehab Cc: Jani Nikula , linux-kernel@vger.kernel.org, Vegard Nossum Subject: [PATCH RFC 03/11] media: admin-guide: properly format ToC heading Date: Fri, 27 Oct 2023 10:18:22 +0200 Message-Id: <20231027081830.195056-4-vegard.nossum@oracle.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20231027081830.195056-1-vegard.nossum@oracle.com> References: <20231027081830.195056-1-vegard.nossum@oracle.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.272,Aquarius:18.0.987,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2023-10-27_06,2023-10-26_01,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 mlxlogscore=999 mlxscore=0 spamscore=0 suspectscore=0 adultscore=0 bulkscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2310240000 definitions=main-2310270071 X-Proofpoint-GUID: 5-XATpbd4sc33KQxbXKDaOC0NnJ8AWkl X-Proofpoint-ORIG-GUID: 5-XATpbd4sc33KQxbXKDaOC0NnJ8AWkl Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" "class:: toc-title" was a workaround for older Sphinx versions that are no longer supported. The canonical way to add a heading to the ToC is to use :caption:. Do that. Cc: Mauro Carvalho Chehab Signed-off-by: Vegard Nossum --- Documentation/admin-guide/media/index.rst | 10 +--------- 1 file changed, 1 insertion(+), 9 deletions(-) diff --git a/Documentation/admin-guide/media/index.rst b/Documentation/admi= n-guide/media/index.rst index 43f4a292b245..be7e0e4482ca 100644 --- a/Documentation/admin-guide/media/index.rst +++ b/Documentation/admin-guide/media/index.rst @@ -20,16 +20,8 @@ Documentation/driver-api/media/index.rst - for driver development information and Kernel APIs used by media devices; =20 -The media subsystem -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D - -.. only:: html - - .. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :maxdepth: 2 :numbered: =20 --=20 2.34.1 From nobody Wed Dec 17 09:44:35 2025 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 3E7A4C25B6E for ; Fri, 27 Oct 2023 08:19:06 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235130AbjJ0ITG (ORCPT ); Fri, 27 Oct 2023 04:19:06 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:59756 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S235179AbjJ0ITB (ORCPT ); Fri, 27 Oct 2023 04:19:01 -0400 Received: from mx0a-00069f02.pphosted.com (mx0a-00069f02.pphosted.com [205.220.165.32]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 68FD1FA; Fri, 27 Oct 2023 01:18:59 -0700 (PDT) Received: from pps.filterd (m0333521.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 39R5jogH007956; Fri, 27 Oct 2023 08:18:53 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : in-reply-to : references : mime-version : content-transfer-encoding; s=corp-2023-03-30; bh=5c5YvRGx45E/+CpHH1wWVK8msPoSxpNh0E1Lgo5HjKg=; b=Vg/5HBbfSOSiVtEKMpurNNLEl7cWPNsa2QGjRFCbGOyKSva5U2ffD1x0HjVPVy8NlBZh lqO10Kf5gumPSloaB9U1nGZ7GXXHhCC5YCAgeAS8poyPcV8asvgKiYua/4w0orGsUv3i YDgEmDt6X6aRnEzWbOjaUgDyz3mw/xSC8WR4ZrnIStGyDqC0PzIXqYNGaV/quw4CuxV2 tYEkymQlswAxuixozm1BMfSL/SuCRh6bEY5ZIxEukZrsiBInVygLFt/s4q1D+I9/wMg0 cK28WaDjL2C0xcE6XjpHNQBA53h8b7/Y/XMIaHw7L0lVLPmmYV90JMhrK9tFRQdt2BPu Eg== Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.appoci.oracle.com [138.1.37.129]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3tywtt0yme-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 27 Oct 2023 08:18:53 +0000 Received: from pps.filterd (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 39R6K2cZ009162; Fri, 27 Oct 2023 08:18:52 GMT Received: from pps.reinject (localhost [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3tywqjeb9d-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 27 Oct 2023 08:18:52 +0000 Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by pps.reinject (8.17.1.5/8.17.1.5) with ESMTP id 39R8Ig9R028975; Fri, 27 Oct 2023 08:18:52 GMT Received: from t460-2.nl.oracle.com (dhcp-10-175-63-126.vpn.oracle.com [10.175.63.126]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTP id 3tywqjeb1g-5; Fri, 27 Oct 2023 08:18:52 +0000 From: Vegard Nossum To: linux-doc@vger.kernel.org, Jonathan Corbet , Mauro Carvalho Chehab Cc: Jani Nikula , linux-kernel@vger.kernel.org, Vegard Nossum , Stephan Mueller Subject: [PATCH RFC 04/11] crypto: doc: properly format ToC headings Date: Fri, 27 Oct 2023 10:18:23 +0200 Message-Id: <20231027081830.195056-5-vegard.nossum@oracle.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20231027081830.195056-1-vegard.nossum@oracle.com> References: <20231027081830.195056-1-vegard.nossum@oracle.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.272,Aquarius:18.0.987,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2023-10-27_06,2023-10-26_01,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 mlxlogscore=999 mlxscore=0 spamscore=0 suspectscore=0 adultscore=0 bulkscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2310240000 definitions=main-2310270071 X-Proofpoint-GUID: QehSy-H1XCn1uln3sRzJuY2bFJDiWyhb X-Proofpoint-ORIG-GUID: QehSy-H1XCn1uln3sRzJuY2bFJDiWyhb Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" "class:: toc-title" was a workaround for older Sphinx versions that are no longer supported. The canonical way to add a heading to the ToC is to use :caption:. Do that. Cc: Mauro Carvalho Chehab Cc: Stephan Mueller Signed-off-by: Vegard Nossum --- Documentation/crypto/api.rst | 5 +---- Documentation/crypto/index.rst | 5 +---- 2 files changed, 2 insertions(+), 8 deletions(-) diff --git a/Documentation/crypto/api.rst b/Documentation/crypto/api.rst index b91b31736df8..ff31c30561d4 100644 --- a/Documentation/crypto/api.rst +++ b/Documentation/crypto/api.rst @@ -1,11 +1,8 @@ Programming Interface =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 -.. class:: toc-title - - Table of contents - .. toctree:: + :caption: Table of contents :maxdepth: 2 =20 api-skcipher diff --git a/Documentation/crypto/index.rst b/Documentation/crypto/index.rst index da5d5ad2bdf3..10647c5ae2ea 100644 --- a/Documentation/crypto/index.rst +++ b/Documentation/crypto/index.rst @@ -9,11 +9,8 @@ This documentation outlines the Linux kernel crypto API wi= th its concepts, details about developing cipher implementations, employment of t= he API for cryptographic use cases, as well as programming examples. =20 -.. class:: toc-title - - Table of contents - .. toctree:: + :caption: Table of contents :maxdepth: 2 =20 intro --=20 2.34.1 From nobody Wed Dec 17 09:44:35 2025 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id B5B40C25B67 for ; Fri, 27 Oct 2023 08:19:23 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235199AbjJ0ITX (ORCPT ); Fri, 27 Oct 2023 04:19:23 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:47236 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230502AbjJ0ITQ (ORCPT ); Fri, 27 Oct 2023 04:19:16 -0400 Received: from mx0a-00069f02.pphosted.com (mx0a-00069f02.pphosted.com [205.220.165.32]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id AD0AED64; Fri, 27 Oct 2023 01:19:10 -0700 (PDT) Received: from pps.filterd (m0246627.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 39R5iCp3020795; Fri, 27 Oct 2023 08:18:57 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : in-reply-to : references : mime-version : content-type : content-transfer-encoding; s=corp-2023-03-30; bh=90EykabD4ky8gN9ceDHoX9V0x2ufhKNuMutQG/mnc40=; b=otszQ7DwOSf2+NOtAFNw48W3FqanZs6xgE7Lqn03+ddKvQ1OtkxLNhK8oB3SZoDJXS8Q Lo6+c4wNJElWfPwQdhuWN/5R8WmvwCsIK1nMtm9szG7BNC76OWZFAcy3mjs0mEebuK5H mEUD4H3FiNjb2Zn4jwl7Nl2YpixAlBOmyfVoofPGltlImUVgoD3EHx0yKAXD6E7abG+f o2AS6Cs9UApu/9e6BAul2LOXLm9q0hkmEunfR+wS8zSvTDp/R173YcPUtphvRg2Rz2KH lCSP7BTQkxG4DfV+d7gIoxiFkRSDuDDYDUHqSemBMe6uYXzFR/fec6ody5H0pZmsOZcy 5w== Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.appoci.oracle.com [138.1.37.129]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3tyx4tgx09-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 27 Oct 2023 08:18:57 +0000 Received: from pps.filterd (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 39R678mw009213; Fri, 27 Oct 2023 08:18:56 GMT Received: from pps.reinject (localhost [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3tywqjebas-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 27 Oct 2023 08:18:56 +0000 Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by pps.reinject (8.17.1.5/8.17.1.5) with ESMTP id 39R8Ig9T028975; Fri, 27 Oct 2023 08:18:55 GMT Received: from t460-2.nl.oracle.com (dhcp-10-175-63-126.vpn.oracle.com [10.175.63.126]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTP id 3tywqjeb1g-6; Fri, 27 Oct 2023 08:18:55 +0000 From: Vegard Nossum To: linux-doc@vger.kernel.org, Jonathan Corbet , Mauro Carvalho Chehab Cc: Jani Nikula , linux-kernel@vger.kernel.org, Vegard Nossum , gaochao , Yanteng Si , Wu XiangCheng , Fangrui Song , Wan Jiabing , Alex Shi Subject: [PATCH RFC 05/11] Documentation: dev-tools: properly format ToC headingss Date: Fri, 27 Oct 2023 10:18:24 +0200 Message-Id: <20231027081830.195056-6-vegard.nossum@oracle.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20231027081830.195056-1-vegard.nossum@oracle.com> References: <20231027081830.195056-1-vegard.nossum@oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.272,Aquarius:18.0.987,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2023-10-27_06,2023-10-26_01,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 mlxlogscore=999 mlxscore=0 spamscore=0 suspectscore=0 adultscore=0 bulkscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2310240000 definitions=main-2310270071 X-Proofpoint-GUID: fT_Oghynhwp9KiRAAPgCQEmUF9l74s6b X-Proofpoint-ORIG-GUID: fT_Oghynhwp9KiRAAPgCQEmUF9l74s6b Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org "class:: toc-title" was a workaround for older Sphinx versions that are no longer supported. The canonical way to add a heading to the ToC is to use :caption:. Do that. Cc: Mauro Carvalho Chehab Cc: gaochao Cc: Yanteng Si Cc: Wu XiangCheng Cc: Fangrui Song Cc: Wan Jiabing Cc: Alex Shi Signed-off-by: Vegard Nossum --- Documentation/dev-tools/index.rst | 5 +---- Documentation/translations/zh_CN/dev-tools/index.rst | 5 +---- 2 files changed, 2 insertions(+), 8 deletions(-) diff --git a/Documentation/dev-tools/index.rst b/Documentation/dev-tools/in= dex.rst index 6b0663075dc0..3d2286c683bc 100644 --- a/Documentation/dev-tools/index.rst +++ b/Documentation/dev-tools/index.rst @@ -10,11 +10,8 @@ whole; patches welcome! A brief overview of testing-specific tools can be found in Documentation/dev-tools/testing-overview.rst =20 -.. class:: toc-title - - Table of contents - .. toctree:: + :caption: Table of contents :maxdepth: 2 =20 testing-overview diff --git a/Documentation/translations/zh_CN/dev-tools/index.rst b/Documen= tation/translations/zh_CN/dev-tools/index.rst index 02577c379007..c2db3e566b1b 100644 --- a/Documentation/translations/zh_CN/dev-tools/index.rst +++ b/Documentation/translations/zh_CN/dev-tools/index.rst @@ -14,11 +14,8 @@ =E6=9C=89=E5=85=B3=E6=B5=8B=E8=AF=95=E4=B8=93=E7=94=A8=E5=B7=A5=E5=85=B7= =E7=9A=84=E7=AE=80=E8=A6=81=E6=A6=82=E8=BF=B0=EF=BC=8C=E5=8F=82=E8=A7=81 Documentation/translations/zh_CN/dev-tools/testing-overview.rst =20 -.. class:: toc-title - - =E7=9B=AE=E5=BD=95 - .. toctree:: + :caption: =E7=9B=AE=E5=BD=95 :maxdepth: 2 =20 testing-overview --=20 2.34.1 From nobody Wed Dec 17 09:44:35 2025 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id C8431C25B47 for ; Fri, 27 Oct 2023 08:19:52 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235284AbjJ0ITw (ORCPT ); Fri, 27 Oct 2023 04:19:52 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:58572 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S235221AbjJ0ITc (ORCPT ); Fri, 27 Oct 2023 04:19:32 -0400 Received: from mx0a-00069f02.pphosted.com (mx0a-00069f02.pphosted.com [205.220.165.32]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 06922D42; Fri, 27 Oct 2023 01:19:22 -0700 (PDT) Received: from pps.filterd (m0246627.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 39R5iCp5020795; Fri, 27 Oct 2023 08:19:01 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : in-reply-to : references : mime-version : content-type : content-transfer-encoding; s=corp-2023-03-30; bh=1pikA91vUTNV05//EH2EMfg5yCx5g71Zj4B5oU1dgV0=; b=jzYtVlJsH7AHD5Czyrz5o1kH1Kti08yoBSUPloSJCxOD5oSdafKtwEHMGrEetRVo6H5U 3R2WtZ19Ar4xncHO4/X3NMx8HLiiC9lwX7/FyntzrxcTkbkJWyHg32buQjea61C25lnt +pcvUDPAguIFz9Km1GTrxGFrEHIjBoamzZDskUvV+EmcGUnjJyvp8JjRT/hhY8ZCVZYT 7j4r6SejUjOFwJ3HzLOZ36EvdXt6quUFdwMPgFkWSc6QjQ4h7lbHNy8fyl43cUwOA8XP us9HTuZWiiEZJ2Fno7vorfjna9i9zpSew4cv4zx/iZmgNoLx6CibK7AT3Mvxqeer+lH0 PA== Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.appoci.oracle.com [138.1.37.129]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3tyx4tgx0j-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 27 Oct 2023 08:19:01 +0000 Received: from pps.filterd (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 39R8FtVl009374; Fri, 27 Oct 2023 08:19:00 GMT Received: from pps.reinject (localhost [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3tywqjebch-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 27 Oct 2023 08:19:00 +0000 Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by pps.reinject (8.17.1.5/8.17.1.5) with ESMTP id 39R8Ig9V028975; Fri, 27 Oct 2023 08:19:00 GMT Received: from t460-2.nl.oracle.com (dhcp-10-175-63-126.vpn.oracle.com [10.175.63.126]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTP id 3tywqjeb1g-7; Fri, 27 Oct 2023 08:19:00 +0000 From: Vegard Nossum To: linux-doc@vger.kernel.org, Jonathan Corbet , Mauro Carvalho Chehab Cc: Jani Nikula , linux-kernel@vger.kernel.org, Vegard Nossum , Richard Cochran , SeongJae Park , Hans de Goede , Armin Wolf , Iwona Winiarska , =?UTF-8?q?Ricardo=20Ca=C3=B1uelo?= , Tomas Winkler , linux-media@vger.kernel.org, Yanteng Si , Alex Shi , Wu XiangCheng Subject: [PATCH RFC 06/11] docs: driver-api: properly format ToC headings Date: Fri, 27 Oct 2023 10:18:25 +0200 Message-Id: <20231027081830.195056-7-vegard.nossum@oracle.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20231027081830.195056-1-vegard.nossum@oracle.com> References: <20231027081830.195056-1-vegard.nossum@oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.272,Aquarius:18.0.987,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2023-10-27_06,2023-10-26_01,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 mlxlogscore=999 mlxscore=0 spamscore=0 suspectscore=0 adultscore=0 bulkscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2310240000 definitions=main-2310270071 X-Proofpoint-GUID: wz7HOd5et-SDzZciojXibt6vUTGSeytM X-Proofpoint-ORIG-GUID: wz7HOd5et-SDzZciojXibt6vUTGSeytM Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org "class:: toc-title" was a workaround for older Sphinx versions that are no longer supported. The canonical way to add a heading to the ToC is to use :caption:. Do that. Cc: Mauro Carvalho Chehab Cc: Richard Cochran Cc: SeongJae Park Cc: Hans de Goede Cc: Armin Wolf Cc: Iwona Winiarska Cc: "Ricardo Ca=C3=B1uelo" Cc: Tomas Winkler Cc: linux-media@vger.kernel.org Cc: Yanteng Si Cc: Alex Shi Cc: Wu XiangCheng Signed-off-by: Vegard Nossum --- Documentation/driver-api/index.rst | 5 +---- Documentation/driver-api/media/index.rst | 7 +------ Documentation/driver-api/mei/index.rst | 7 +------ Documentation/driver-api/pci/index.rst | 5 +---- Documentation/translations/zh_CN/driver-api/gpio/index.rst | 3 +-- Documentation/translations/zh_CN/driver-api/index.rst | 5 +---- 6 files changed, 6 insertions(+), 26 deletions(-) diff --git a/Documentation/driver-api/index.rst b/Documentation/driver-api/= index.rst index 1e16a40da3ba..4540f79a34a9 100644 --- a/Documentation/driver-api/index.rst +++ b/Documentation/driver-api/index.rst @@ -9,11 +9,8 @@ of device drivers. This document is an only somewhat orga= nized collection of some of those interfaces =E2=80=94 it will hopefully get better over ti= me! The available subsections can be seen below. =20 -.. class:: toc-title - - Table of contents - .. toctree:: + :caption: Table of contents :maxdepth: 2 =20 driver-model/index diff --git a/Documentation/driver-api/media/index.rst b/Documentation/drive= r-api/media/index.rst index 08e206567408..d5593182a3f9 100644 --- a/Documentation/driver-api/media/index.rst +++ b/Documentation/driver-api/media/index.rst @@ -20,13 +20,8 @@ Documentation/userspace-api/media/index.rst - for the userspace APIs used on media devices. =20 =20 -.. only:: html - - .. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :maxdepth: 5 :numbered: =20 diff --git a/Documentation/driver-api/mei/index.rst b/Documentation/driver-= api/mei/index.rst index 3a22b522ee78..eae6f18f18cf 100644 --- a/Documentation/driver-api/mei/index.rst +++ b/Documentation/driver-api/mei/index.rst @@ -9,13 +9,8 @@ Intel(R) Management Engine Interface (Intel(R) MEI) **Copyright** |copy| 2019 Intel Corporation =20 =20 -.. only:: html - - .. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :maxdepth: 3 =20 mei diff --git a/Documentation/driver-api/pci/index.rst b/Documentation/driver-= api/pci/index.rst index c6cf1fef61ce..a38e475cdbe3 100644 --- a/Documentation/driver-api/pci/index.rst +++ b/Documentation/driver-api/pci/index.rst @@ -4,11 +4,8 @@ The Linux PCI driver implementer's API guide =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 -.. class:: toc-title - - Table of contents - .. toctree:: + :caption: Table of contents :maxdepth: 2 =20 pci diff --git a/Documentation/translations/zh_CN/driver-api/gpio/index.rst b/D= ocumentation/translations/zh_CN/driver-api/gpio/index.rst index 9ab64e94aced..9a6a14162a6c 100644 --- a/Documentation/translations/zh_CN/driver-api/gpio/index.rst +++ b/Documentation/translations/zh_CN/driver-api/gpio/index.rst @@ -14,9 +14,8 @@ =E9=80=9A=E7=94=A8=E5=9E=8B=E8=BE=93=E5=85=A5/=E8=BE=93=E5=87=BA=EF=BC=88G= PIO=EF=BC=89 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 -=E7=9B=AE=E5=BD=95: - .. toctree:: + :caption: =E7=9B=AE=E5=BD=95 :maxdepth: 2 =20 legacy diff --git a/Documentation/translations/zh_CN/driver-api/index.rst b/Docume= ntation/translations/zh_CN/driver-api/index.rst index ba354e1f4e6d..92ff1b7fc3d3 100644 --- a/Documentation/translations/zh_CN/driver-api/index.rst +++ b/Documentation/translations/zh_CN/driver-api/index.rst @@ -17,11 +17,8 @@ Linux=E9=A9=B1=E5=8A=A8=E5=AE=9E=E7=8E=B0=E8=80=85=E7=9A= =84API=E6=8C=87=E5=8D=97 =E5=86=85=E6=A0=B8=E6=8F=90=E4=BE=9B=E4=BA=86=E5=90=84=E7=A7=8D=E5=90=84= =E6=A0=B7=E7=9A=84=E6=8E=A5=E5=8F=A3=E6=9D=A5=E6=94=AF=E6=8C=81=E8=AE=BE=E5= =A4=87=E9=A9=B1=E5=8A=A8=E7=9A=84=E5=BC=80=E5=8F=91=E3=80=82=E8=BF=99=E4=BB= =BD=E6=96=87=E6=A1=A3=E5=8F=AA=E6=98=AF=E5=AF=B9=E5=85=B6=E4=B8=AD=E4=B8=80= =E4=BA=9B=E6=8E=A5=E5=8F=A3=E8=BF=9B=E8=A1=8C=E4=BA=86 =E4=B8=80=E5=AE=9A=E7=A8=8B=E5=BA=A6=E7=9A=84=E6=95=B4=E7=90=86=E2=80=94= =E2=80=94=E5=B8=8C=E6=9C=9B=E9=9A=8F=E7=9D=80=E6=97=B6=E9=97=B4=E7=9A=84=E6= =8E=A8=E7=A7=BB=EF=BC=8C=E5=AE=83=E8=83=BD=E5=8F=98=E5=BE=97=E6=9B=B4=E5=A5= =BD=EF=BC=81=E5=8F=AF=E7=94=A8=E7=9A=84=E5=B0=8F=E8=8A=82=E5=8F=AF=E4=BB=A5= =E5=9C=A8=E4=B8=8B=E9=9D=A2=E7=9C=8B=E5=88=B0=E3=80=82 =20 -.. class:: toc-title - - =E7=9B=AE=E5=BD=95=E5=88=97=E8=A1=A8=EF=BC=9A - .. toctree:: + :caption: =E7=9B=AE=E5=BD=95=E5=88=97=E8=A1=A8 :maxdepth: 2 =20 gpio/index --=20 2.34.1 From nobody Wed Dec 17 09:44:35 2025 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 5C53FC25B6E for ; Fri, 27 Oct 2023 08:19:40 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235196AbjJ0ITj (ORCPT ); Fri, 27 Oct 2023 04:19:39 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:35150 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230502AbjJ0ITY (ORCPT ); Fri, 27 Oct 2023 04:19:24 -0400 Received: from mx0a-00069f02.pphosted.com (mx0a-00069f02.pphosted.com [205.220.165.32]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 07271D5E; Fri, 27 Oct 2023 01:19:18 -0700 (PDT) Received: from pps.filterd (m0246617.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 39R5i5w6003086; Fri, 27 Oct 2023 08:19:15 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : in-reply-to : references : mime-version : content-transfer-encoding; s=corp-2023-03-30; bh=phDJ9fYkNDZ1+LpOWiE4bE9znlIs1VUuwW3/CIkXJvU=; b=i1/TC3SthuFqudfz2WOcUUFklFcfOYAV3631LtS5OSRJ2rV+AuC/b/n8S4yT8hhblK1+ r4GtCn4M8LXE7Vq9U8W5CFuvbcoXdG9aqaO5ge3F5v2kkRqFGNkl8oj8oB97ho1arWk8 Oe5GhEACObCql/85AvATImIGY4CbZTn/SJrg+fwkGJagPoB4tyq+cDh6WcSkQGRA5IG0 pKZgore+ZqGoX6Rr9Rso3gglbkCJfohhGxQpDx0CKSszC5iz5q1wcL/Qj7YYhq+H0hEn IIADLJuZVZmF7a3+IwzclK2MAuFznCkoUri5G4cXQm0St4yQhWOrbLaoKeZ1xkSJFJNg Kg== Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.appoci.oracle.com [138.1.37.129]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3tyxmv8v0j-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 27 Oct 2023 08:19:15 +0000 Received: from pps.filterd (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 39R62lO6009264; Fri, 27 Oct 2023 08:19:03 GMT Received: from pps.reinject (localhost [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3tywqjebdd-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 27 Oct 2023 08:19:03 +0000 Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by pps.reinject (8.17.1.5/8.17.1.5) with ESMTP id 39R8Ig9X028975; Fri, 27 Oct 2023 08:19:03 GMT Received: from t460-2.nl.oracle.com (dhcp-10-175-63-126.vpn.oracle.com [10.175.63.126]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTP id 3tywqjeb1g-8; Fri, 27 Oct 2023 08:19:02 +0000 From: Vegard Nossum To: linux-doc@vger.kernel.org, Jonathan Corbet , Mauro Carvalho Chehab Cc: Jani Nikula , linux-kernel@vger.kernel.org, Vegard Nossum , Dmitry Torokhov , linux-input@vger.kernel.org Subject: [PATCH RFC 07/11] input: docs: properly format ToC headings Date: Fri, 27 Oct 2023 10:18:26 +0200 Message-Id: <20231027081830.195056-8-vegard.nossum@oracle.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20231027081830.195056-1-vegard.nossum@oracle.com> References: <20231027081830.195056-1-vegard.nossum@oracle.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.272,Aquarius:18.0.987,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2023-10-27_06,2023-10-26_01,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 mlxlogscore=999 mlxscore=0 spamscore=0 suspectscore=0 adultscore=0 bulkscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2310240000 definitions=main-2310270071 X-Proofpoint-GUID: aoJ9XceRi8i7_aMEaDo6B2ImGRMp_3ab X-Proofpoint-ORIG-GUID: aoJ9XceRi8i7_aMEaDo6B2ImGRMp_3ab Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" "class:: toc-title" was a workaround for older Sphinx versions that are no longer supported. The canonical way to add a heading to the ToC is to use :caption:. Do that. Cc: Dmitry Torokhov Cc: linux-input@vger.kernel.org Signed-off-by: Vegard Nossum --- Documentation/input/input_kapi.rst | 5 +---- Documentation/input/input_uapi.rst | 5 +---- Documentation/input/joydev/index.rst | 5 +---- 3 files changed, 3 insertions(+), 12 deletions(-) diff --git a/Documentation/input/input_kapi.rst b/Documentation/input/input= _kapi.rst index 41f1b7e6b78e..9937522daa9b 100644 --- a/Documentation/input/input_kapi.rst +++ b/Documentation/input/input_kapi.rst @@ -4,11 +4,8 @@ Linux Input Subsystem kernel API ################################ =20 -.. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :maxdepth: 2 :numbered: =20 diff --git a/Documentation/input/input_uapi.rst b/Documentation/input/input= _uapi.rst index 4a0391609327..8275b4223a84 100644 --- a/Documentation/input/input_uapi.rst +++ b/Documentation/input/input_uapi.rst @@ -4,11 +4,8 @@ Linux Input Subsystem userspace API ################################### =20 -.. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :maxdepth: 2 :numbered: =20 diff --git a/Documentation/input/joydev/index.rst b/Documentation/input/joy= dev/index.rst index ebcff43056e2..d03d6f6cbfab 100644 --- a/Documentation/input/joydev/index.rst +++ b/Documentation/input/joydev/index.rst @@ -6,11 +6,8 @@ Linux Joystick support =20 :Copyright: |copy| 1996-2000 Vojtech Pavlik - Sponsored b= y SuSE =20 -.. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :maxdepth: 3 =20 joystick --=20 2.34.1 From nobody Wed Dec 17 09:44:35 2025 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 11314C25B67 for ; Fri, 27 Oct 2023 08:20:06 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235259AbjJ0IUF (ORCPT ); Fri, 27 Oct 2023 04:20:05 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:34032 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S235193AbjJ0ITi (ORCPT ); Fri, 27 Oct 2023 04:19:38 -0400 Received: from mx0a-00069f02.pphosted.com (mx0a-00069f02.pphosted.com [205.220.165.32]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 093C21715; Fri, 27 Oct 2023 01:19:25 -0700 (PDT) Received: from pps.filterd (m0333521.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 39R5jE8b007095; Fri, 27 Oct 2023 08:19:22 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : in-reply-to : references : mime-version : content-transfer-encoding; s=corp-2023-03-30; bh=l2Ve0RbGhs4TQpF+YaCkmro1guzF3Tr3hOAoJy3n7Ow=; b=IqYb4tSsvfPIyfvDqcOu2UMkZPCa27H3dhNLiNTxvJ5h2FFAv2MbIUi/Uxi1I42TJ/Zk 5zc8q5wlAshf4NFQ+DBtNF7NBfa3xEJiACFZL9XaVDGzQ0crVauXlRGyixFdjgvDtslU 7q62GZNSJCU2yoVQxB38UYePLLKT85TaSz3GMgNCuhATrlttHuVLVV4us2ndZ12zXrQw T1m0MNDj2haHXrSnpcQWzcQCWLe6nvCSpQS830O8EAWW0K/v+BieOHakd8PUxpqdfQDl 3zuCq/48nRCT0NZlB/D5JyR0LME+luW/xBlJDTsJEyP3bSRZ34FJPkeWwex+OujxHPpV Kw== Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.appoci.oracle.com [138.1.37.129]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3tywtt0yn3-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 27 Oct 2023 08:19:21 +0000 Received: from pps.filterd (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 39R6F1X2009189; Fri, 27 Oct 2023 08:19:06 GMT Received: from pps.reinject (localhost [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3tywqjebeb-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 27 Oct 2023 08:19:06 +0000 Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by pps.reinject (8.17.1.5/8.17.1.5) with ESMTP id 39R8Ig9Z028975; Fri, 27 Oct 2023 08:19:05 GMT Received: from t460-2.nl.oracle.com (dhcp-10-175-63-126.vpn.oracle.com [10.175.63.126]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTP id 3tywqjeb1g-9; Fri, 27 Oct 2023 08:19:05 +0000 From: Vegard Nossum To: linux-doc@vger.kernel.org, Jonathan Corbet , Mauro Carvalho Chehab Cc: Jani Nikula , linux-kernel@vger.kernel.org, Vegard Nossum , Greg Kroah-Hartman , Julien Panis Subject: [PATCH RFC 08/11] doc: misc-device: properly format ToC heading Date: Fri, 27 Oct 2023 10:18:27 +0200 Message-Id: <20231027081830.195056-9-vegard.nossum@oracle.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20231027081830.195056-1-vegard.nossum@oracle.com> References: <20231027081830.195056-1-vegard.nossum@oracle.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.272,Aquarius:18.0.987,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2023-10-27_06,2023-10-26_01,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 mlxlogscore=999 mlxscore=0 spamscore=0 suspectscore=0 adultscore=0 bulkscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2310240000 definitions=main-2310270071 X-Proofpoint-GUID: FNcKRM6DNqO1Ow8JFJXL0xe-LzKCc-aS X-Proofpoint-ORIG-GUID: FNcKRM6DNqO1Ow8JFJXL0xe-LzKCc-aS Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" "class:: toc-title" was a workaround for older Sphinx versions that are no longer supported. The canonical way to add a heading to the ToC is to use :caption:. Do that. Cc: Greg Kroah-Hartman Cc: Julien Panis Signed-off-by: Vegard Nossum --- Documentation/misc-devices/index.rst | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/Documentation/misc-devices/index.rst b/Documentation/misc-devi= ces/index.rst index ecc40fbbcfb8..1fc89d664830 100644 --- a/Documentation/misc-devices/index.rst +++ b/Documentation/misc-devices/index.rst @@ -7,11 +7,8 @@ Assorted Miscellaneous Devices Documentation This documentation contains information for assorted devices that do not fit into other categories. =20 -.. class:: toc-title - - Table of contents - .. toctree:: + :caption: Table of contents :maxdepth: 2 =20 ad525x_dpot --=20 2.34.1 From nobody Wed Dec 17 09:44:35 2025 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id EA9A5C25B47 for ; Fri, 27 Oct 2023 08:19:31 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235212AbjJ0ITa (ORCPT ); Fri, 27 Oct 2023 04:19:30 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:59766 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S235198AbjJ0ITU (ORCPT ); Fri, 27 Oct 2023 04:19:20 -0400 Received: from mx0b-00069f02.pphosted.com (mx0b-00069f02.pphosted.com [205.220.177.32]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9A32CD4D; Fri, 27 Oct 2023 01:19:15 -0700 (PDT) Received: from pps.filterd (m0246632.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 39R5i7VK020414; Fri, 27 Oct 2023 08:19:10 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : in-reply-to : references : mime-version : content-transfer-encoding; s=corp-2023-03-30; bh=DXSUD6D4gKvGLEozl2neVPvk09OeuaDfgn2a+Uvpugo=; b=4Kpy5f/I89OCxsliZBqE9SKvfTop/EnnMkIkvl+APmvoLPgZZjNDz/qV3LdF83fRv2M3 pmYakKDxbAutVzK+IIjgrn40F/FqJgDVlvyPavy34fgyAdj6dFYy1jmLOiVKONxeYCGt EKZVTMgEqfGs8ggYWyyTa0bxtUmiUyFLV8GH1gLqxumxydAFeI6AC8NxX2L5mjNQWSxE nYTc43XbG9bH/rsF2vQRdYd35P1d5Ce9kgGsDRYO2hzCemIzeiPPP8nFgoFr1fq9gPp7 76sCvrZvinMeb8UX7YMBMQxGxHqA7brRPlXQW1aZet5GdCp0bZRyHy9bZouUrlGIo2YI TA== Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.appoci.oracle.com [138.1.37.129]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3tyxge0vaf-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 27 Oct 2023 08:19:09 +0000 Received: from pps.filterd (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 39R6Jdh0009176; Fri, 27 Oct 2023 08:19:08 GMT Received: from pps.reinject (localhost [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3tywqjebfh-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 27 Oct 2023 08:19:08 +0000 Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by pps.reinject (8.17.1.5/8.17.1.5) with ESMTP id 39R8Ig9b028975; Fri, 27 Oct 2023 08:19:08 GMT Received: from t460-2.nl.oracle.com (dhcp-10-175-63-126.vpn.oracle.com [10.175.63.126]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTP id 3tywqjeb1g-10; Fri, 27 Oct 2023 08:19:08 +0000 From: Vegard Nossum To: linux-doc@vger.kernel.org, Jonathan Corbet , Mauro Carvalho Chehab Cc: Jani Nikula , linux-kernel@vger.kernel.org, Vegard Nossum , linux-media@vger.kernel.org Subject: [PATCH RFC 09/11] media: doc: properly format ToC headings Date: Fri, 27 Oct 2023 10:18:28 +0200 Message-Id: <20231027081830.195056-10-vegard.nossum@oracle.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20231027081830.195056-1-vegard.nossum@oracle.com> References: <20231027081830.195056-1-vegard.nossum@oracle.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.272,Aquarius:18.0.987,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2023-10-27_06,2023-10-26_01,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 mlxlogscore=999 mlxscore=0 spamscore=0 suspectscore=0 adultscore=0 bulkscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2310240000 definitions=main-2310270071 X-Proofpoint-GUID: E4AH135QpSPthVEXi7VDe67BysDZfm3d X-Proofpoint-ORIG-GUID: E4AH135QpSPthVEXi7VDe67BysDZfm3d Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" "class:: toc-title" was a workaround for older Sphinx versions that are no longer supported. The canonical way to add a heading to the ToC is to use :caption:. Do that. Cc: Mauro Carvalho Chehab Cc: linux-media@vger.kernel.org Signed-off-by: Vegard Nossum --- Documentation/userspace-api/media/cec/cec-api.rst | 7 +------ Documentation/userspace-api/media/drivers/index.rst | 7 +------ Documentation/userspace-api/media/dvb/dvbapi.rst | 7 +------ Documentation/userspace-api/media/index.rst | 7 +------ .../userspace-api/media/mediactl/media-controller.rst | 7 +------ .../userspace-api/media/rc/remote_controllers.rst | 7 +------ Documentation/userspace-api/media/v4l/v4l2.rst | 7 +------ 7 files changed, 7 insertions(+), 42 deletions(-) diff --git a/Documentation/userspace-api/media/cec/cec-api.rst b/Documentat= ion/userspace-api/media/cec/cec-api.rst index 4d229ed8a1d9..578303d484f3 100644 --- a/Documentation/userspace-api/media/cec/cec-api.rst +++ b/Documentation/userspace-api/media/cec/cec-api.rst @@ -10,13 +10,8 @@ Part V - Consumer Electronics Control API This part describes the CEC: Consumer Electronics Control =20 =20 -.. only:: html - - .. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :maxdepth: 5 :numbered: =20 diff --git a/Documentation/userspace-api/media/drivers/index.rst b/Document= ation/userspace-api/media/drivers/index.rst index 6708d649afd7..d4338dc506dd 100644 --- a/Documentation/userspace-api/media/drivers/index.rst +++ b/Documentation/userspace-api/media/drivers/index.rst @@ -21,13 +21,8 @@ more details. =20 For more details see the file COPYING in the source distribution of Linux. =20 -.. only:: html - - .. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :maxdepth: 5 :numbered: =20 diff --git a/Documentation/userspace-api/media/dvb/dvbapi.rst b/Documentati= on/userspace-api/media/dvb/dvbapi.rst index 1dda69343f34..4ac0c1bc54ca 100644 --- a/Documentation/userspace-api/media/dvb/dvbapi.rst +++ b/Documentation/userspace-api/media/dvb/dvbapi.rst @@ -27,13 +27,8 @@ Part II - Digital TV API =20 **Version 5.10** =20 -.. only:: html - - .. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :maxdepth: 5 :numbered: =20 diff --git a/Documentation/userspace-api/media/index.rst b/Documentation/us= erspace-api/media/index.rst index d839904be085..337ef6c7c47f 100644 --- a/Documentation/userspace-api/media/index.rst +++ b/Documentation/userspace-api/media/index.rst @@ -21,13 +21,8 @@ Documentation/driver-api/media/index.rst media devices; =20 =20 -.. only:: html - - .. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :maxdepth: 1 =20 intro diff --git a/Documentation/userspace-api/media/mediactl/media-controller.rs= t b/Documentation/userspace-api/media/mediactl/media-controller.rst index 508dd693bf6c..73a87f82f92d 100644 --- a/Documentation/userspace-api/media/mediactl/media-controller.rst +++ b/Documentation/userspace-api/media/mediactl/media-controller.rst @@ -7,13 +7,8 @@ Part IV - Media Controller API ############################## =20 -.. only:: html - - .. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :maxdepth: 5 :numbered: =20 diff --git a/Documentation/userspace-api/media/rc/remote_controllers.rst b/= Documentation/userspace-api/media/rc/remote_controllers.rst index f89291838637..483f9ae92a90 100644 --- a/Documentation/userspace-api/media/rc/remote_controllers.rst +++ b/Documentation/userspace-api/media/rc/remote_controllers.rst @@ -7,13 +7,8 @@ Part III - Remote Controller API ################################ =20 -.. only:: html - - .. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :maxdepth: 5 :numbered: =20 diff --git a/Documentation/userspace-api/media/v4l/v4l2.rst b/Documentation= /userspace-api/media/v4l/v4l2.rst index ad7a2bf0cf26..cf8ae56a008c 100644 --- a/Documentation/userspace-api/media/v4l/v4l2.rst +++ b/Documentation/userspace-api/media/v4l/v4l2.rst @@ -11,13 +11,8 @@ This part describes the Video for Linux API version 2 (V= 4L2 API) specification. =20 **Revision 4.5** =20 -.. only:: html - - .. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :numbered: :maxdepth: 5 =20 --=20 2.34.1 From nobody Wed Dec 17 09:44:35 2025 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 3424BC25B47 for ; Fri, 27 Oct 2023 08:20:33 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235287AbjJ0IUa (ORCPT ); Fri, 27 Oct 2023 04:20:30 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:34016 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S235296AbjJ0IUB (ORCPT ); Fri, 27 Oct 2023 04:20:01 -0400 Received: from mx0a-00069f02.pphosted.com (mx0a-00069f02.pphosted.com [205.220.165.32]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 99EF81996; Fri, 27 Oct 2023 01:19:35 -0700 (PDT) Received: from pps.filterd (m0246627.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 39R5iCdg020786; Fri, 27 Oct 2023 08:19:25 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : in-reply-to : references : mime-version : content-type : content-transfer-encoding; s=corp-2023-03-30; bh=3Wu6bIg7tVvARFbVYaBYPJjOg+gs9lUaxjqSIpedt0E=; b=gLX/GWaCBpyh1Lw+Mg5zW/ROBo2V7+vbr0cGfLNNAEBpV3J8c4crQgFYu7kTsk2VOgCB 419izoc3g9sD9pGD8O0mjqfBxUsKO12FRYO907Kj4GoK7L/C4/us05ktxrikmTGg4IoU WWg6xhlFTK1alsAlFY120lkgFn0dd+rcAit19QNs0ig6WAKGO1Veq2ajKTcj0DWInDXJ AQ7v89Db1RoRCQzmmEcJItUDE256ZQAmMjL40ygtN2puuEosYzRoO2deDreKY1vV5NlR bu31FNiY5m9+DcJx8DQP/oVbdsm7JKuH4ffqkyRQ7gMDvz8I+pGJ69uMjWaRQnuyOdAO 7g== Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.appoci.oracle.com [138.1.37.129]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3tyx4tgx0y-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 27 Oct 2023 08:19:25 +0000 Received: from pps.filterd (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 39R6HWAx009159; Fri, 27 Oct 2023 08:19:12 GMT Received: from pps.reinject (localhost [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3tywqjebh6-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 27 Oct 2023 08:19:12 +0000 Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by pps.reinject (8.17.1.5/8.17.1.5) with ESMTP id 39R8Ig9d028975; Fri, 27 Oct 2023 08:19:11 GMT Received: from t460-2.nl.oracle.com (dhcp-10-175-63-126.vpn.oracle.com [10.175.63.126]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTP id 3tywqjeb1g-11; Fri, 27 Oct 2023 08:19:11 +0000 From: Vegard Nossum To: linux-doc@vger.kernel.org, Jonathan Corbet , Mauro Carvalho Chehab Cc: Jani Nikula , linux-kernel@vger.kernel.org, Vegard Nossum , Federico Vaga , Alex Shi , Yanteng Si , Hu Haowen , workflows@vger.kernel.org Subject: [PATCH RFC 10/11] docs: use toctree :caption: and move introduction Date: Fri, 27 Oct 2023 10:18:29 +0200 Message-Id: <20231027081830.195056-11-vegard.nossum@oracle.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20231027081830.195056-1-vegard.nossum@oracle.com> References: <20231027081830.195056-1-vegard.nossum@oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.272,Aquarius:18.0.987,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2023-10-27_06,2023-10-26_01,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 mlxlogscore=999 mlxscore=0 spamscore=0 suspectscore=0 adultscore=0 bulkscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2310240000 definitions=main-2310270071 X-Proofpoint-GUID: aNYiUgR9x7UUOkNNILohSUk0CHjwFX3r X-Proofpoint-ORIG-GUID: aNYiUgR9x7UUOkNNILohSUk0CHjwFX3r Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org The canonical way to add a heading to the ToC is to use :caption:. Do that. Let's also move the introduction to the top of the document to be consistent with most other documents. Cc: Jonathan Corbet Cc: Mauro Carvalho Chehab Cc: Federico Vaga Cc: Alex Shi Cc: Yanteng Si Cc: Hu Haowen Cc: workflows@vger.kernel.org Signed-off-by: Vegard Nossum --- Documentation/process/development-process.rst | 19 +++++++++---------- .../it_IT/process/development-process.rst | 19 +++++++++---------- .../zh_CN/process/development-process.rst | 5 ++--- .../zh_TW/process/development-process.rst | 5 ++--- 4 files changed, 22 insertions(+), 26 deletions(-) diff --git a/Documentation/process/development-process.rst b/Documentation/= process/development-process.rst index 61c627e41ba8..e34d7da58b7f 100644 --- a/Documentation/process/development-process.rst +++ b/Documentation/process/development-process.rst @@ -3,9 +3,17 @@ A guide to the Kernel Development Process =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 -Contents: +The purpose of this document is to help developers (and their managers) +work with the development community with a minimum of frustration. It is +an attempt to document how this community works in a way which is +accessible to those who are not intimately familiar with Linux kernel +development (or, indeed, free software development in general). While +there is some technical material here, this is very much a process-oriented +discussion which does not require a deep knowledge of kernel programming to +understand. =20 .. toctree:: + :caption: Contents :numbered: :maxdepth: 2 =20 @@ -17,12 +25,3 @@ Contents: 6.Followthrough 7.AdvancedTopics 8.Conclusion - -The purpose of this document is to help developers (and their managers) -work with the development community with a minimum of frustration. It is -an attempt to document how this community works in a way which is -accessible to those who are not intimately familiar with Linux kernel -development (or, indeed, free software development in general). While -there is some technical material here, this is very much a process-oriented -discussion which does not require a deep knowledge of kernel programming to -understand. diff --git a/Documentation/translations/it_IT/process/development-process.r= st b/Documentation/translations/it_IT/process/development-process.rst index f1a6eca30824..20e77c9816a1 100644 --- a/Documentation/translations/it_IT/process/development-process.rst +++ b/Documentation/translations/it_IT/process/development-process.rst @@ -8,9 +8,17 @@ Una guida al processo di sviluppo del Kernel =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 -Contenuti: +Lo scopo di questo documento =C3=A8 quello di aiutare gli sviluppatori (ed= i loro +supervisori) a lavorare con la communit=C3=A0 di sviluppo con il minimo sf= orzo. =C3=88 +un tentativo di documentare il funzionamento di questa communit=C3=A0 in m= odo che +sia accessibile anche a coloro che non hanno famigliarit=C3=A0 con lo svil= uppo del +Kernel Linux (o, anzi, con lo sviluppo di software libero in generale). B= ench=C3=A8 +qui sia presente del materiale tecnico, questa =C3=A8 una discussione rivo= lta in +particolare al procedimento, e quindi per essere compreso non richiede una +conoscenza approfondit=C3=A0 sullo sviluppo del kernel. =20 .. toctree:: + :caption: Contenuti :numbered: :maxdepth: 2 =20 @@ -22,12 +30,3 @@ Contenuti: 6.Followthrough 7.AdvancedTopics 8.Conclusion - -Lo scopo di questo documento =C3=A8 quello di aiutare gli sviluppatori (ed= i loro -supervisori) a lavorare con la communit=C3=A0 di sviluppo con il minimo sf= orzo. =C3=88 -un tentativo di documentare il funzionamento di questa communit=C3=A0 in m= odo che -sia accessibile anche a coloro che non hanno famigliarit=C3=A0 con lo svil= uppo del -Kernel Linux (o, anzi, con lo sviluppo di software libero in generale). B= ench=C3=A8 -qui sia presente del materiale tecnico, questa =C3=A8 una discussione rivo= lta in -particolare al procedimento, e quindi per essere compreso non richiede una -conoscenza approfondit=C3=A0 sullo sviluppo del kernel. diff --git a/Documentation/translations/zh_CN/process/development-process.r= st b/Documentation/translations/zh_CN/process/development-process.rst index 30cffe66c075..c10d8e2e21eb 100644 --- a/Documentation/translations/zh_CN/process/development-process.rst +++ b/Documentation/translations/zh_CN/process/development-process.rst @@ -8,9 +8,10 @@ =E5=86=85=E6=A0=B8=E5=BC=80=E5=8F=91=E8=BF=87=E7=A8=8B=E6=8C=87=E5=8D=97 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 -=E5=86=85=E5=AE=B9: +=E6=9C=AC=E6=96=87=E6=A1=A3=E7=9A=84=E7=9B=AE=E7=9A=84=E6=98=AF=E5=B8=AE= =E5=8A=A9=E5=BC=80=E5=8F=91=E4=BA=BA=E5=91=98=EF=BC=88=E5=8F=8A=E5=85=B6=E7= =BB=8F=E7=90=86=EF=BC=89=E4=BB=A5=E6=9C=80=E5=B0=8F=E7=9A=84=E6=8C=AB=E6=8A= =98=E6=84=9F=E4=B8=8E=E5=BC=80=E5=8F=91=E7=A4=BE=E5=8C=BA=E5=90=88=E4=BD=9C= =E3=80=82=E5=AE=83=E8=AF=95=E5=9B=BE=E8=AE=B0=E5=BD=95=E8=BF=99=E4=B8=AA=E7= =A4=BE=E5=8C=BA=E5=A6=82=E4=BD=95=E4=BB=A5=E4=B8=80=E7=A7=8D=E4=B8=8D=E7=86= =9F=E6=82=89Linux=E5=86=85=E6=A0=B8=E5=BC=80=E5=8F=91=EF=BC=88=E6=88=96=E8= =80=85=E5=AE=9E=E9=99=85=E4=B8=8A=E6=98=AF=E8=87=AA=E7=94=B1=E8=BD=AF=E4=BB= =B6=E5=BC=80=E5=8F=91=EF=BC=89=E7=9A=84=E4=BA=BA=E5=8F=AF=E4=BB=A5=E8=AE=BF= =E9=97=AE=E7=9A=84=E6=96=B9=E5=BC=8F=E5=B7=A5=E4=BD=9C=E3=80=82=E8=99=BD=E7= =84=B6=E8=BF=99=E9=87=8C=E6=9C=89=E4=B8=80=E4=BA=9B=E6=8A=80=E6=9C=AF=E8=B5= =84=E6=96=99=EF=BC=8C=E4=BD=86=E8=BF=99=E6=98=AF=E4=B8=80=E4=B8=AA=E9=9D=A2= =E5=90=91=E8=BF=87=E7=A8=8B=E7=9A=84=E8=AE=A8=E8=AE=BA=EF=BC=8C=E4=B8=8D=E9= =9C=80=E8=A6=81=E6=B7=B1=E5=85=A5=E4=BA=86=E8=A7=A3=E5=86=85=E6=A0=B8=E7=BC= =96=E7=A8=8B=E5=B0=B1=E5=8F=AF=E4=BB=A5=E7=90=86=E8=A7=A3=E3=80=82 =20 .. toctree:: + :caption: =E5=86=85=E5=AE=B9 :numbered: :maxdepth: 2 =20 @@ -22,5 +23,3 @@ 6.Followthrough 7.AdvancedTopics 8.Conclusion - -=E6=9C=AC=E6=96=87=E6=A1=A3=E7=9A=84=E7=9B=AE=E7=9A=84=E6=98=AF=E5=B8=AE= =E5=8A=A9=E5=BC=80=E5=8F=91=E4=BA=BA=E5=91=98=EF=BC=88=E5=8F=8A=E5=85=B6=E7= =BB=8F=E7=90=86=EF=BC=89=E4=BB=A5=E6=9C=80=E5=B0=8F=E7=9A=84=E6=8C=AB=E6=8A= =98=E6=84=9F=E4=B8=8E=E5=BC=80=E5=8F=91=E7=A4=BE=E5=8C=BA=E5=90=88=E4=BD=9C= =E3=80=82=E5=AE=83=E8=AF=95=E5=9B=BE=E8=AE=B0=E5=BD=95=E8=BF=99=E4=B8=AA=E7= =A4=BE=E5=8C=BA=E5=A6=82=E4=BD=95=E4=BB=A5=E4=B8=80=E7=A7=8D=E4=B8=8D=E7=86= =9F=E6=82=89Linux=E5=86=85=E6=A0=B8=E5=BC=80=E5=8F=91=EF=BC=88=E6=88=96=E8= =80=85=E5=AE=9E=E9=99=85=E4=B8=8A=E6=98=AF=E8=87=AA=E7=94=B1=E8=BD=AF=E4=BB= =B6=E5=BC=80=E5=8F=91=EF=BC=89=E7=9A=84=E4=BA=BA=E5=8F=AF=E4=BB=A5=E8=AE=BF= =E9=97=AE=E7=9A=84=E6=96=B9=E5=BC=8F=E5=B7=A5=E4=BD=9C=E3=80=82=E8=99=BD=E7= =84=B6=E8=BF=99=E9=87=8C=E6=9C=89=E4=B8=80=E4=BA=9B=E6=8A=80=E6=9C=AF=E8=B5= =84=E6=96=99=EF=BC=8C=E4=BD=86=E8=BF=99=E6=98=AF=E4=B8=80=E4=B8=AA=E9=9D=A2= =E5=90=91=E8=BF=87=E7=A8=8B=E7=9A=84=E8=AE=A8=E8=AE=BA=EF=BC=8C=E4=B8=8D=E9= =9C=80=E8=A6=81=E6=B7=B1=E5=85=A5=E4=BA=86=E8=A7=A3=E5=86=85=E6=A0=B8=E7=BC= =96=E7=A8=8B=E5=B0=B1=E5=8F=AF=E4=BB=A5=E7=90=86=E8=A7=A3=E3=80=82 diff --git a/Documentation/translations/zh_TW/process/development-process.r= st b/Documentation/translations/zh_TW/process/development-process.rst index f4cf5c2bbc82..c4db0e3e72ce 100644 --- a/Documentation/translations/zh_TW/process/development-process.rst +++ b/Documentation/translations/zh_TW/process/development-process.rst @@ -11,9 +11,10 @@ =E5=85=A7=E6=A0=B8=E9=96=8B=E7=99=BC=E9=81=8E=E7=A8=8B=E6=8C=87=E5=8D=97 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 -=E5=85=A7=E5=AE=B9: +=E6=9C=AC=E6=96=87=E6=AA=94=E7=9A=84=E7=9B=AE=E7=9A=84=E6=98=AF=E5=B9=AB= =E5=8A=A9=E9=96=8B=E7=99=BC=E4=BA=BA=E5=93=A1=EF=BC=88=E5=8F=8A=E5=85=B6=E7= =B6=93=E7=90=86=EF=BC=89=E4=BB=A5=E6=9C=80=E5=B0=8F=E7=9A=84=E6=8C=AB=E6=8A= =98=E6=84=9F=E8=88=87=E9=96=8B=E7=99=BC=E7=A4=BE=E5=8D=80=E5=90=88=E4=BD=9C= =E3=80=82=E5=AE=83=E8=A9=A6=E5=9C=96=E8=A8=98=E9=8C=84=E9=80=99=E5=80=8B=E7= =A4=BE=E5=8D=80=E5=A6=82=E4=BD=95=E4=BB=A5=E4=B8=80=E7=A8=AE=E4=B8=8D=E7=86= =9F=E6=82=89Linux=E5=85=A7=E6=A0=B8=E9=96=8B=E7=99=BC=EF=BC=88=E6=88=96=E8= =80=85=E5=AF=A6=E9=9A=9B=E4=B8=8A=E6=98=AF=E8=87=AA=E7=94=B1=E8=BB=9F=E9=AB= =94=E9=96=8B=E7=99=BC=EF=BC=89=E7=9A=84=E4=BA=BA=E5=8F=AF=E4=BB=A5=E8=A8=AA= =E5=95=8F=E7=9A=84=E6=96=B9=E5=BC=8F=E5=B7=A5=E4=BD=9C=E3=80=82=E9=9B=96=E7= =84=B6=E9=80=99=E8=A3=A1=E6=9C=89=E4=B8=80=E4=BA=9B=E6=8A=80=E8=A1=93=E8=B3= =87=E6=96=99=EF=BC=8C=E4=BD=86=E9=80=99=E6=98=AF=E4=B8=80=E5=80=8B=E9=9D=A2= =E5=90=91=E9=81=8E=E7=A8=8B=E7=9A=84=E8=A8=8E=E8=AB=96=EF=BC=8C=E4=B8=8D=E9= =9C=80=E8=A6=81=E6=B7=B1=E5=85=A5=E4=BA=86=E8=A7=A3=E5=85=A7=E6=A0=B8=E7=B7= =A8=E7=A8=8B=E5=B0=B1=E5=8F=AF=E4=BB=A5=E7=90=86=E8=A7=A3=E3=80=82 =20 .. toctree:: + :caption: =E5=85=A7=E5=AE=B9 :numbered: :maxdepth: 2 =20 @@ -26,5 +27,3 @@ 7.AdvancedTopics 8.Conclusion =20 -=E6=9C=AC=E6=96=87=E6=AA=94=E7=9A=84=E7=9B=AE=E7=9A=84=E6=98=AF=E5=B9=AB= =E5=8A=A9=E9=96=8B=E7=99=BC=E4=BA=BA=E5=93=A1=EF=BC=88=E5=8F=8A=E5=85=B6=E7= =B6=93=E7=90=86=EF=BC=89=E4=BB=A5=E6=9C=80=E5=B0=8F=E7=9A=84=E6=8C=AB=E6=8A= =98=E6=84=9F=E8=88=87=E9=96=8B=E7=99=BC=E7=A4=BE=E5=8D=80=E5=90=88=E4=BD=9C= =E3=80=82=E5=AE=83=E8=A9=A6=E5=9C=96=E8=A8=98=E9=8C=84=E9=80=99=E5=80=8B=E7= =A4=BE=E5=8D=80=E5=A6=82=E4=BD=95=E4=BB=A5=E4=B8=80=E7=A8=AE=E4=B8=8D=E7=86= =9F=E6=82=89Linux=E5=85=A7=E6=A0=B8=E9=96=8B=E7=99=BC=EF=BC=88=E6=88=96=E8= =80=85=E5=AF=A6=E9=9A=9B=E4=B8=8A=E6=98=AF=E8=87=AA=E7=94=B1=E8=BB=9F=E9=AB= =94=E9=96=8B=E7=99=BC=EF=BC=89=E7=9A=84=E4=BA=BA=E5=8F=AF=E4=BB=A5=E8=A8=AA= =E5=95=8F=E7=9A=84=E6=96=B9=E5=BC=8F=E5=B7=A5=E4=BD=9C=E3=80=82=E9=9B=96=E7= =84=B6=E9=80=99=E8=A3=A1=E6=9C=89=E4=B8=80=E4=BA=9B=E6=8A=80=E8=A1=93=E8=B3= =87=E6=96=99=EF=BC=8C=E4=BD=86=E9=80=99=E6=98=AF=E4=B8=80=E5=80=8B=E9=9D=A2= =E5=90=91=E9=81=8E=E7=A8=8B=E7=9A=84=E8=A8=8E=E8=AB=96=EF=BC=8C=E4=B8=8D=E9= =9C=80=E8=A6=81=E6=B7=B1=E5=85=A5=E4=BA=86=E8=A7=A3=E5=85=A7=E6=A0=B8=E7=B7= =A8=E7=A8=8B=E5=B0=B1=E5=8F=AF=E4=BB=A5=E7=90=86=E8=A7=A3=E3=80=82 - --=20 2.34.1 From nobody Wed Dec 17 09:44:35 2025 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 7240EC25B67 for ; Fri, 27 Oct 2023 08:19:44 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235096AbjJ0ITo (ORCPT ); Fri, 27 Oct 2023 04:19:44 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:58850 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231345AbjJ0IT1 (ORCPT ); Fri, 27 Oct 2023 04:19:27 -0400 Received: from mx0b-00069f02.pphosted.com (mx0b-00069f02.pphosted.com [205.220.177.32]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 037A4D6D; Fri, 27 Oct 2023 01:19:20 -0700 (PDT) Received: from pps.filterd (m0246630.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 39R5hxH6009507; Fri, 27 Oct 2023 08:19:15 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : in-reply-to : references : mime-version : content-transfer-encoding; s=corp-2023-03-30; bh=H0/aCDFt4Sn9FnJqoeRJjT/9P98mgpduCZMNdUkai2Y=; b=I7Ce0QoF9iOgsWGsFkpEFEK0eoPQ5t7jGHvB7iF+taEqlN3MBF+YjoRU4c566XShlm5X UGpCiadlLhbisUKbVy+VCFg3RM3+hU6Bwb6OOrVNQ/PaWxmsDVamsFuGODzjuUKsR7dj Dhi9q76uRw6DtcOlCxejffOkfF8ZHadykOLuUunQmi6O8VaJYBy/kfnpUsW3F5gbYPLT frkLxM+z2nKRfo5JHMUqJSHb2vfWJvQ+fTN5zF9unEcLbjbAUoKw257Zt9rZ6u6uD4ZT NE7uH4hAdp3b7/9GM5xgGGD+dq+sTNtXGAgZBNeh9VvhuMtIaDz6KiPEwTk9kD0tI+yS Hg== Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.appoci.oracle.com [138.1.37.129]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3tyx218x86-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 27 Oct 2023 08:19:15 +0000 Received: from pps.filterd (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 39R6Bkhp009253; Fri, 27 Oct 2023 08:19:14 GMT Received: from pps.reinject (localhost [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3tywqjebju-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 27 Oct 2023 08:19:14 +0000 Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by pps.reinject (8.17.1.5/8.17.1.5) with ESMTP id 39R8Ig9f028975; Fri, 27 Oct 2023 08:19:14 GMT Received: from t460-2.nl.oracle.com (dhcp-10-175-63-126.vpn.oracle.com [10.175.63.126]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTP id 3tywqjeb1g-12; Fri, 27 Oct 2023 08:19:13 +0000 From: Vegard Nossum To: linux-doc@vger.kernel.org, Jonathan Corbet , Mauro Carvalho Chehab Cc: Jani Nikula , linux-kernel@vger.kernel.org, Vegard Nossum Subject: [PATCH RFC 11/11] docs: remove .toc-title class Date: Fri, 27 Oct 2023 10:18:30 +0200 Message-Id: <20231027081830.195056-12-vegard.nossum@oracle.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20231027081830.195056-1-vegard.nossum@oracle.com> References: <20231027081830.195056-1-vegard.nossum@oracle.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.272,Aquarius:18.0.987,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2023-10-27_06,2023-10-26_01,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 mlxlogscore=999 mlxscore=0 spamscore=0 suspectscore=0 adultscore=0 bulkscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2310240000 definitions=main-2310270071 X-Proofpoint-ORIG-GUID: vJdNOq0fC4ie_LIk4NGSKgqQrgRerXJU X-Proofpoint-GUID: vJdNOq0fC4ie_LIk4NGSKgqQrgRerXJU Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" The "toc-title" class was introduced in commit ef88f10eb877 ("[media] doc-rst: backward compatibility with older Sphinx versions") as a workaround for Sphinx versions older than 1.4.x. However, these old versions have been deprecated since commit 31abfdda6527 ("docs: Deprecate use of Sphinx < 2.4.x"). Having now changed all the toc-title users to use the :caption: attribute, we can also remove the custom style. Note that the toc-title class is separate from the "kernel-toc" logic that was introduced in commit c404f5d4f099 ("docs: Add more information to the HTML sidebar"). Cc: Mauro Carvalho Chehab Cc: Jonathan Corbet Signed-off-by: Vegard Nossum --- Documentation/sphinx-static/theme_overrides.css | 5 ----- 1 file changed, 5 deletions(-) diff --git a/Documentation/sphinx-static/theme_overrides.css b/Documentatio= n/sphinx-static/theme_overrides.css index f6f2b941a5d6..79000b26e64e 100644 --- a/Documentation/sphinx-static/theme_overrides.css +++ b/Documentation/sphinx-static/theme_overrides.css @@ -81,11 +81,6 @@ div[class^=3D"highlight"] pre { * - hide the permalink symbol as long as link is not hovered */ =20 - .toc-title { - font-size: 150%; - font-weight: bold; - } - caption, .wy-table caption, .rst-content table.field-list caption { font-size: 100%; } --=20 2.34.1