From patchwork Fri Oct 27 08:18:20 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Vegard Nossum X-Patchwork-Id: 158814 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:d641:0:b0:403:3b70:6f57 with SMTP id cy1csp443037vqb; Fri, 27 Oct 2023 01:19:31 -0700 (PDT) X-Google-Smtp-Source: AGHT+IF7lROq4PKxEdBO5CAWQfbdxriLSRYJjivrsFfhg6eqQ8pVwytWiFxdAi7FYAGbt+8fifY4 X-Received: by 2002:a05:6102:355a:b0:457:cc6c:9491 with SMTP id e26-20020a056102355a00b00457cc6c9491mr2266930vss.17.1698394771299; Fri, 27 Oct 2023 01:19:31 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1698394771; cv=none; d=google.com; s=arc-20160816; b=w+rlnPPWncUUKrhdDsdS3e9AzFQcZel0RoId3vBu/VRupx872XYMQvHGI7ajCdzLNt ogDJBdibD7mPT/YbvEXb/+iUKTEzWkXLNe5t1UDsc3c0z4xK5K1I3GvxVQhMHUFiv+c2 Bx6T/yBnZ4skNszyWYiwCCRFWbE6irUBofda20kiLXmPJ9AuNCjxXrfl+038lVog/2QZ Huj4Yl6KwLQdVkh1Qt/1Er20V69gqQLUHVyiAVhoEniPA1PaD7D8a6sEuF0qQaDal8k+ ZHnIid8uk5SlUXcMK0n11idfIKSXc1814/Jk0FD++DU0QZ6VBqWQN6h87bo/0XWs+7bw 9Hhw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=XiYBzT666XUrJBEenylzauji4KGI2RRUgvA0UHv3h4o=; fh=YLm7DaHboaqKJSHxeEA7IRaMzLE6qC6nbePU5PNtNio=; b=rrDcLNdT738yGIpbg3JoGPtkQJQADaMhoybI6EKkHpwnB8GB2nXh0htKuExwgyM9R5 z5/2X+53KKDRlWk9nfH+PGtp1JvXj6JaQsJ3cc/XQFbLxEIjoBbWi9JNMgFXX0obPCQZ c2vkC4kH527+TxmzY0ScrRb6Hgoongy5l7+yDaWAMgyjtAyzejXOoORRdtU24YhAjLpU rCg5DYl+69sYfy1VqePOaQD+k5GgSyspcEwKsKYFxDc+JSC30sbVbX6rhkaIKpENqofZ WFFFxB2ymnCLqfmBZyGIifxYI9AT+JvEMwxVpR1THGEfBFEqg4TVoGjT+KTsCxFV2mgg 6gTg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b=Yas+hTB6; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:5 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from groat.vger.email (groat.vger.email. [2620:137:e000::3:5]) by mx.google.com with ESMTPS id h14-20020a25d00e000000b00da0ca27493esi2091299ybg.384.2023.10.27.01.19.30 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 27 Oct 2023 01:19:31 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:5 as permitted sender) client-ip=2620:137:e000::3:5; Authentication-Results: mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b=Yas+hTB6; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:5 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by groat.vger.email (Postfix) with ESMTP id 4138B82878B9; Fri, 27 Oct 2023 01:19:25 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at groat.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235094AbjJ0ITC (ORCPT + 26 others); Fri, 27 Oct 2023 04:19:02 -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 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 X-Spam-Status: No, score=-0.9 required=5.0 tests=DKIMWL_WL_MED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on groat.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (groat.vger.email [0.0.0.0]); Fri, 27 Oct 2023 01:19:25 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1780895995504870792 X-GMAIL-MSGID: 1780895995504870792 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%; } +/* toctree captions are styled like h2 */ +div.toctree-wrapper p.caption[role=heading] { font-size: 150%; } + /* Tighten up the layout slightly */ div.body { padding: 0 15px 0 10px; } div.sphinxsidebarwrapper { padding: 1em 0.4em; } From patchwork Fri Oct 27 08:18:21 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Vegard Nossum X-Patchwork-Id: 158817 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:d641:0:b0:403:3b70:6f57 with SMTP id cy1csp443187vqb; Fri, 27 Oct 2023 01:19:50 -0700 (PDT) X-Google-Smtp-Source: AGHT+IHBvIa4JIyG49NT5sY9JacP/3PY2YYXm6qXEioYYjFYjo44ghk44Sty6sSck41mRIBrc6wE X-Received: by 2002:a05:620a:170d:b0:774:3742:31e4 with SMTP id az13-20020a05620a170d00b00774374231e4mr2002801qkb.52.1698394790532; Fri, 27 Oct 2023 01:19:50 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1698394790; cv=none; d=google.com; s=arc-20160816; b=o6zNpPzq+1Qh0dnIBq8pCgzYjpiJXI7suMyFXrDBUMylAodV9UScpDshhADagvsw7z WJqeSM3f5RfAqUUuqpC95DCi3Bog0zhAjbKWPlYSVJL246GoQUEkfKf+YJucMJhUsHF3 04yDn5gnEaDuTeshdzATihwztzf214w0++2Cz0uBvOfujfsKnerHNK4RWDWVEI6iztoY cseimMQDV7DhZOe1uwwSn9UFrozAHGCGffgwialSaZHBG1P2k7Dt5w3qZADbl/hYAnyQ 1cwyirAz5W5PnTBaxDVnGOSrlPg/EU1OLrBk7qRuEHFMhRt3a/WrgCeL+NejfZmpWvwK zT3g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=LAEaozT4QqgZE84FVGuX7tOgFZQKNBd0vZkJmsXPoh8=; fh=uChsg/BxrpCDoTnsWCmj3EQOXPL+nFFPLeFwKOStMhI=; b=IgroAGqMe9h1Dxc1cPa9pzbCyHGUajRFn526M2RAhoV8c3k7DmcF/tdP5TpA1/YC4+ VvMzwJM15MH0UVFhxBn2K9VRMzmJqgZuG1cPqEmiJfoPHGHetJiSdSBdm0J31JyEnlbC IKqA3P+aeQiHPA2NPH9nyCGgHlZTJtp/06sRsTei5OAIqcjdsjQPUx6dclm9uFunOSdz 4W/Thfd0l/T+6q0g90rO98MtPcza6FzLU3pCMhnRLAvPX1LTyBrZyftIurT9h/Qi+QUq S1we5+euGuNbA+t7gcADxo71U0msyT8JiPFwAbUE1/fKnRz24e+PgWteQN+1iAvObWrF qKvQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b="4RIEmFU/"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.32 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from agentk.vger.email (agentk.vger.email. [23.128.96.32]) by mx.google.com with ESMTPS id x195-20020a25e0cc000000b00da0c8110f18si1840856ybg.233.2023.10.27.01.19.50 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 27 Oct 2023 01:19:50 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.32 as permitted sender) client-ip=23.128.96.32; Authentication-Results: mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b="4RIEmFU/"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.32 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by agentk.vger.email (Postfix) with ESMTP id 2BE58822F041; Fri, 27 Oct 2023 01:19:45 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at agentk.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235195AbjJ0IT0 (ORCPT + 26 others); Fri, 27 Oct 2023 04:19:26 -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 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 X-Spam-Status: No, score=-0.9 required=5.0 tests=DKIMWL_WL_MED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on agentk.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (agentk.vger.email [0.0.0.0]); Fri, 27 Oct 2023 01:19:45 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1780896016113298741 X-GMAIL-MSGID: 1780896016113298741 "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/Documentation/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 内核用户空间API指南 在代码树中仍然可以找到有关用户空间的部分信息。这个手册意在成为这些信息 聚集的地方。 -.. class:: toc-title - - 目录 - .. toctree:: + :caption: 目录 :maxdepth: 2 no_new_privs diff --git a/Documentation/userspace-api/index.rst b/Documentation/userspace-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 elsewhere also be found in the kernel tree itself. This manual is intended to be the place where this information is gathered. -.. class:: toc-title - - Table of contents - .. toctree:: + :caption: Table of contents :maxdepth: 2 no_new_privs From patchwork Fri Oct 27 08:18:22 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Vegard Nossum X-Patchwork-Id: 158813 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:d641:0:b0:403:3b70:6f57 with SMTP id cy1csp443013vqb; Fri, 27 Oct 2023 01:19:27 -0700 (PDT) X-Google-Smtp-Source: AGHT+IEylMRH26qDD9UPnI4LgdZ02UJejxb1BG90dUS8Tdj8iXFqb5yXVgiCvexGL/pljNmCGT9u X-Received: by 2002:a81:bc45:0:b0:595:e1b:b978 with SMTP id b5-20020a81bc45000000b005950e1bb978mr2176068ywl.21.1698394766790; Fri, 27 Oct 2023 01:19:26 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1698394766; cv=none; d=google.com; s=arc-20160816; b=d8pfT2YX8JadKPusX4X27tMhdE5Xm9XE7MrP4ybQTKXs4Chfe5DQUwMsY3cIKcnsF9 jWOHhUYeBEgHQBYwXl9W7O36EkWFCCP1okFOq+Yjw5CijrsBL6NxVcya6ry0TUO7XKGQ w8kCiZhwXx9UrTjz/f4Hi1Bo5ZGZ2McXkaGFX6aRKTb9nrHa6FERrTYKcX2+R78U0J3Z 5epwOyx6rjwA0WJKC3qXCIMPKm5kFfVhAeZ4jr2cqYkt+DqXqGjTZVOlHYUeQT09ZBby 9XrfA6VIw11Fof6rIZohXwg2gsc361IGlGVFQFfmh8wg3tdEXmgzhROH0Xp+GAqDh94t 0Z8w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=s1EbLkYdolk3yWS71XSb9v+3TTnjVXp+R3q9NNNtvvQ=; fh=YLm7DaHboaqKJSHxeEA7IRaMzLE6qC6nbePU5PNtNio=; b=kuY19NZjgKt6YPZup6y0snttm8o2A+T7Haty6X285VVXobgDDLDiFCUMOH4XM1xUo2 MphO9YI43vOZPEnS7rq1Zv/fogz1pxnlh3c+qJulbTMFRe+KZE1h+YIq6dMpBuxCfX9/ 0GQTFjgqPrzjiypOd1pEhjeSA7pUdYYm06ETsYztYmVYn0icdgqhqSjjsnrag6m3wsZ4 deCdd9z/BFTAYNm1cz0nrNi9oj9bVICGJoiAm14YCDlpO5wuXNAW0EyOTG8oo2VgdVc5 7jeOmMzzJs29BbddKH+CNpmK/khc3xylpi0++862emtWYA6DoovI9cu0pgcIad15ZqCE RYaw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b=3OKBa59j; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:3 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from lipwig.vger.email (lipwig.vger.email. [2620:137:e000::3:3]) by mx.google.com with ESMTPS id z124-20020a0dd782000000b0059f69a1a142si1581742ywd.43.2023.10.27.01.19.26 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 27 Oct 2023 01:19:26 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:3 as permitted sender) client-ip=2620:137:e000::3:3; Authentication-Results: mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b=3OKBa59j; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:3 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by lipwig.vger.email (Postfix) with ESMTP id 511EA829F9AD; Fri, 27 Oct 2023 01:19:24 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at lipwig.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235125AbjJ0ITL (ORCPT + 26 others); 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 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 X-Spam-Status: No, score=-0.9 required=5.0 tests=DKIMWL_WL_MED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lipwig.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (lipwig.vger.email [0.0.0.0]); Fri, 27 Oct 2023 01:19:24 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1780895990538802183 X-GMAIL-MSGID: 1780895990538802183 "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/admin-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; -The media subsystem -=================== - -.. only:: html - - .. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :maxdepth: 2 :numbered: From patchwork Fri Oct 27 08:18:23 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Vegard Nossum X-Patchwork-Id: 158815 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:d641:0:b0:403:3b70:6f57 with SMTP id cy1csp443048vqb; Fri, 27 Oct 2023 01:19:32 -0700 (PDT) X-Google-Smtp-Source: AGHT+IHEgzHvhFrMdaY8ipb0ZeO8cgrFBU0rOSDHBbM+eFrWDShr9Yv9/T1BT78b9NRlIF1jWzc9 X-Received: by 2002:a05:6902:1209:b0:da0:9826:d88f with SMTP id s9-20020a056902120900b00da09826d88fmr2267896ybu.29.1698394772065; Fri, 27 Oct 2023 01:19:32 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1698394772; cv=none; d=google.com; s=arc-20160816; b=l2KrLTYDrVKfaWbXmVv+N7MQax52gwrzu/Vu7nXxgQGlItDAEnn/UQ6otlUzXgEjNz dkbVdsl/7IGBAP2TeQBeem6FErG4Ipl1jCfdgMbuRRzZ9bzY0O5KHYJNJjN4ZtbfkEjO zRJvw5x3KMGnS7kTtmePaOnQwbyJzUU9ChpYiG7HIaBjtY27cy/c8r/FsWy3nBR3WEHd x0LjdyQb3BEr7/5W2TomtVwWKZvCBy39+jNl0zAinO+phn3jaaxgf9oVVx5pWSHhjmoV oWmMFLRJpGMTFPVbr3oc/swDpJlIwXOOGrFUmRER1SvK9MAb3P8IG24L3uFlbUkBixIp nIdg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=5c5YvRGx45E/+CpHH1wWVK8msPoSxpNh0E1Lgo5HjKg=; fh=El34TxFoVpUhSyf8TIQ+acmPtnVtKdYoyd6/1Sc9klo=; b=rkkVnIdWP2hBHwI2oV8riexxl0L8ZRP60lx1aWKHooCDNsJwPYnq61pnrc8GSlUg/t jrGNAIwGoQjrEoRRwtOS3k5YSDS7F5S5apHOx9RAow2Sb3I8PmYqgLY9dG41jhL24u6Y 8GEyePxdQ/xLcY4Xn+qtalOXudSf0p0i1la6xOMxqTPE+zIfRcd+5d2+suj9i2mcDJre ZKoT6W7OPlxDB0L0i20sPBfko36vKO1OiDBhTaT0vbF/zfHRvrxytivyna5S7rXX5GAQ Dk8K3VXtwzsCpMFZATsYKOF8495p8wK64rfH0VPRvnJtnGlSG+eihy3oIcwljW5QY83W SnWw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b="Vg/5HBbf"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.35 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from groat.vger.email (groat.vger.email. [23.128.96.35]) by mx.google.com with ESMTPS id 130-20020a250188000000b00da03fbfa085si1899161ybb.331.2023.10.27.01.19.31 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 27 Oct 2023 01:19:32 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.35 as permitted sender) client-ip=23.128.96.35; Authentication-Results: mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b="Vg/5HBbf"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.35 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by groat.vger.email (Postfix) with ESMTP id 9965482878BF; Fri, 27 Oct 2023 01:19:25 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at groat.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235101AbjJ0ITF (ORCPT + 26 others); Fri, 27 Oct 2023 04:19:05 -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 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 X-Spam-Status: No, score=-0.9 required=5.0 tests=DKIMWL_WL_MED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on groat.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (groat.vger.email [0.0.0.0]); Fri, 27 Oct 2023 01:19:25 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1780895996673752139 X-GMAIL-MSGID: 1780895996673752139 "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 ===================== -.. class:: toc-title - - Table of contents - .. toctree:: + :caption: Table of contents :maxdepth: 2 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 with its concepts, details about developing cipher implementations, employment of the API for cryptographic use cases, as well as programming examples. -.. class:: toc-title - - Table of contents - .. toctree:: + :caption: Table of contents :maxdepth: 2 intro From patchwork Fri Oct 27 08:18:24 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Vegard Nossum X-Patchwork-Id: 158822 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:d641:0:b0:403:3b70:6f57 with SMTP id cy1csp443634vqb; Fri, 27 Oct 2023 01:21:01 -0700 (PDT) X-Google-Smtp-Source: AGHT+IGPIwXFS3+g6ALVFoJGV24YgIAM2u01rWEsQSNqga1nx7ArmGoO4Lf63jMgZyZrwvDaQAcT X-Received: by 2002:a81:b668:0:b0:5a8:8330:6f20 with SMTP id h40-20020a81b668000000b005a883306f20mr2183548ywk.23.1698394860999; Fri, 27 Oct 2023 01:21:00 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1698394860; cv=none; d=google.com; s=arc-20160816; b=DHb5+mY0XT1WNGVrehIp0Ea26xZANxOQlUtfK7u6Df7dHxBMOWYGzixlnox3vUZqxs zB0CIhOZtj2DnNVKuddYr2MKc8iw3SqT42AFeeK16c1dQIn25/OLdTWL5GdhPJPfEGu6 IoSXqpy4WGpQciKtZJRoF9SbamJkEUUiAPGedMmBhmk/n5+JflsStgqxjcot5e83wTP/ zgDTbNbgz/gjpkWyOKCMu16JETyeXaGQjGISNXm8Vz8rxCFDFZaXIaHHb+RQ3fKBcZ0j k/eugXgFAcaQSblaD39CvTegaCVE4FQNssZz3UF3KlRKCV8/bVbiBxgN1fPMNlae292g hG7A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=90EykabD4ky8gN9ceDHoX9V0x2ufhKNuMutQG/mnc40=; fh=Xo7aHDJ7moUet+mt6NwNvTP5bc1EmHANllGcdLkNoKs=; b=WIcfU4Fgy6PZSyqIvHcwODligMbKao1kyh9rxctwu3swKbQMTip4kMT8h3/bJ1TR4K vK6kzjQigcz/imZfH8PTU9IWrpD9St9PQHUXFlT4G27bhkyMLzVDkrww8Ceq9425hbSr DJUkil6rQsMwUToVmhOTOyKoCt0eqdvX59VNL7h2/rKEFDmuNr0Z9+6VoBpZ8fy7Dfu/ Z5gZdCA2/JaQtnmIAn+47EG/oa4MaJJ3RDX2jXPkCxXXLM+dGgUrdN+oHrGKo+V+4ca+ Nt6UdkTBpn1wfydt5u9fBwKX2HjBgeA2npsYA1bwXSbPxoJ5T4uMWhOP+iqet5PwbNB1 r0Xw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b=otszQ7Dw; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:5 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from groat.vger.email (groat.vger.email. [2620:137:e000::3:5]) by mx.google.com with ESMTPS id x68-20020a0dd547000000b0059f650f46b5si1687740ywd.160.2023.10.27.01.21.00 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 27 Oct 2023 01:21:00 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:5 as permitted sender) client-ip=2620:137:e000::3:5; Authentication-Results: mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b=otszQ7Dw; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:5 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by groat.vger.email (Postfix) with ESMTP id EB31C829D9A5; Fri, 27 Oct 2023 01:20:46 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at groat.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235178AbjJ0ITW (ORCPT + 26 others); Fri, 27 Oct 2023 04:19:22 -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 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 X-Spam-Status: No, score=-0.9 required=5.0 tests=DKIMWL_WL_MED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on groat.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (groat.vger.email [0.0.0.0]); Fri, 27 Oct 2023 01:20:47 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1780896089695906307 X-GMAIL-MSGID: 1780896089695906307 "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/index.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 -.. class:: toc-title - - Table of contents - .. toctree:: + :caption: Table of contents :maxdepth: 2 testing-overview diff --git a/Documentation/translations/zh_CN/dev-tools/index.rst b/Documentation/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 @@ 有关测试专用工具的简要概述，参见 Documentation/translations/zh_CN/dev-tools/testing-overview.rst -.. class:: toc-title - - 目录 - .. toctree:: + :caption: 目录 :maxdepth: 2 testing-overview From patchwork Fri Oct 27 08:18:25 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Vegard Nossum X-Patchwork-Id: 158819 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:d641:0:b0:403:3b70:6f57 with SMTP id cy1csp443240vqb; Fri, 27 Oct 2023 01:20:00 -0700 (PDT) X-Google-Smtp-Source: AGHT+IHaF5Ze6udYY8seMlpF9Jtn3A87bjqoGG6e9hDGs62DAbFUB5VoiPsvtcA2WilD6AdV1aH9 X-Received: by 2002:a25:ab10:0:b0:d7b:9211:51a5 with SMTP id u16-20020a25ab10000000b00d7b921151a5mr1699886ybi.44.1698394799852; Fri, 27 Oct 2023 01:19:59 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1698394799; cv=none; d=google.com; s=arc-20160816; b=JIDTRMgadlQYP8gJSqp9kBbL4Y9dJ2t3S7qIbDPbr1BCUJG02jb2+74cRhtU2xWbk3 3rK23UF5G6WM2rZLsCR+Cd+R2bIpp3Okm/hoJL2mPB89T7Ru5KU+vGsnfBatsTM+Qu6v bLet3nVN5Wcq8G6LGlS64+CD6aKYlgkcUmC4r9/I0mimmglB+ivK762kGnJ06AVAezH2 i2EE9MnC6wtw/YsqvRe3wK9VCMH10bYDHgBQVxXjVg0PnQnFr8GSLaSjB9txMDcoEeur FjtI8NZF3aSf9Uzr3Y/yr/uxklNdWoHiBR+xPwiZ1We7HJKqp7E3m4zpRp5Ripvvn5zi WLmQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=1pikA91vUTNV05//EH2EMfg5yCx5g71Zj4B5oU1dgV0=; fh=YlQ/SLAGVpkzDWSF/mvIutn4mCovr3YiGdkg7MIydDI=; b=fntY1N9tEtdUaYrT/n9DOOYFhOWXW+UP30jaQjgJOYkm1hgK4w1ooTSkQyL5pnG6vS 4W1gD6/usPbNhygreO6GrvIyBdfObXYuGeOlzNY2B412eFV38NFU15AQqEhBb9skiPcT aHo7+kfPD0cydY8jAxHayqF1N3prGwdBQjA6OYZH5NybGIvgR1uZn2JvgPKTHowHuNs6 7FZ6zUBpHik7hWFoeeMAfn3c7ACxgO6ElWs3DvtGxccjN6XNUR+bmFxArfM+ZxeFpAgV 3rPY267hmZ8ViCljw0Okywnzo7OyW5xsrkMJqlB5lTQDetJ23mcppk0WQzsdQFb3O4oi 7ZyA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b=jzYtVlJs; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.37 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from snail.vger.email (snail.vger.email. [23.128.96.37]) by mx.google.com with ESMTPS id z185-20020a254cc2000000b00d8169bdad70si1663061yba.56.2023.10.27.01.19.59 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 27 Oct 2023 01:19:59 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.37 as permitted sender) client-ip=23.128.96.37; Authentication-Results: mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b=jzYtVlJs; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.37 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by snail.vger.email (Postfix) with ESMTP id C93A382BB575; Fri, 27 Oct 2023 01:19:58 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at snail.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235181AbjJ0ITv (ORCPT + 26 others); Fri, 27 Oct 2023 04:19:51 -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_Ca=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 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 X-Spam-Status: No, score=-2.8 required=5.0 tests=BAYES_00,DKIMWL_WL_MED, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_H5,RCVD_IN_MSPIKE_WL,SPF_HELO_NONE,SPF_NONE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (snail.vger.email [0.0.0.0]); Fri, 27 Oct 2023 01:19:58 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1780896025889219555 X-GMAIL-MSGID: 1780896025889219555 "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ñuelo" 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 organized collection of some of those interfaces — it will hopefully get better over time! The available subsections can be seen below. -.. class:: toc-title - - Table of contents - .. toctree:: + :caption: Table of contents :maxdepth: 2 driver-model/index diff --git a/Documentation/driver-api/media/index.rst b/Documentation/driver-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. -.. only:: html - - .. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :maxdepth: 5 :numbered: 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 -.. only:: html - - .. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :maxdepth: 3 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 ============================================ -.. class:: toc-title - - Table of contents - .. toctree:: + :caption: Table of contents :maxdepth: 2 pci diff --git a/Documentation/translations/zh_CN/driver-api/gpio/index.rst b/Documentation/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 @@ 通用型输入/输出（GPIO） ======================= -目录: - .. toctree:: + :caption: 目录 :maxdepth: 2 legacy diff --git a/Documentation/translations/zh_CN/driver-api/index.rst b/Documentation/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驱动实现者的API指南 内核提供了各种各样的接口来支持设备驱动的开发。这份文档只是对其中一些接口进行了 一定程度的整理——希望随着时间的推移，它能变得更好！可用的小节可以在下面看到。 -.. class:: toc-title - - 目录列表： - .. toctree:: + :caption: 目录列表 :maxdepth: 2 gpio/index From patchwork Fri Oct 27 08:18:26 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Vegard Nossum X-Patchwork-Id: 158818 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:d641:0:b0:403:3b70:6f57 with SMTP id cy1csp443193vqb; Fri, 27 Oct 2023 01:19:51 -0700 (PDT) X-Google-Smtp-Source: AGHT+IHEPb7xLScWqgqGwd8nu3EKhJVb/nGpEFSUX+A314TNNke6XA7UuZrlDxk0I9sJhHFtl+he X-Received: by 2002:a05:6808:210e:b0:3ae:1b21:fab1 with SMTP id r14-20020a056808210e00b003ae1b21fab1mr2104880oiw.31.1698394791504; Fri, 27 Oct 2023 01:19:51 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1698394791; cv=none; d=google.com; s=arc-20160816; b=AZoSnTU666x0zhsD3mgqtMfAkK1f5ROYGnnsK/aRocTuPDEl36fIDo5xFwiOqcSp/o JStEFWNmqgb53/m/HEL25kndOsevVFzTfctfDgf51JgpCJJGeA3vcHfuoNTqvp0bRRHI Xw8ceVWk0W+MmMLx51Wfm5960sVAGmeT7vYlq4jIsfGhuHT9VgJuO1NGe7crzIYTq0PG SkzfBLGs/HTzsIwAoBSMGQNSkVkt918YW0SzctdXlxlC7+IsgyzubX90MgYJm6mp+T/Z ylMhyanYWd2kv4NnZpngNzvG6XaxhNNzWMGw+38dbEj+wBUeigx66Nly8xiNDalg1MOK R36A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=phDJ9fYkNDZ1+LpOWiE4bE9znlIs1VUuwW3/CIkXJvU=; fh=29zt3gCfQci1dcQkGHloT630fXTNaFghYS1IWpJzUkE=; b=AmxL5Sut5wZ82qI5Zp5TlTigKKQEJBtio8J9wgw0Bbe4MANrpLoSDI7TNqtWAmsEcW ZAcioE8Rl1U6emn1SU+9JXfp2H5G4WSaqXrj3hcmcduaEAobUw5FHtp2q57TYoOdbONk JzYj5U/O3232755Lpk/Ma0z8UJZvB7gCwzjwNoVeUDgBoFabkUbM4JJ0CzYOCeXLdY/o nJ+5lvbUfkObuaBNXQB4bTzpV2NlHERcnBdjY4fo84GfsTbLY6tQyTspMGy5LKVB+P5D rwN2IE+gyqSEttYvrWE/a8E99ENvb2NLl60ZzUkk35K8Est5Dh4JF7Eq72yMEBpitOQr eCCA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b="i1/TC3St"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from snail.vger.email (snail.vger.email. [2620:137:e000::3:7]) by mx.google.com with ESMTPS id d198-20020a25e6cf000000b00d80a716899asi1916850ybh.417.2023.10.27.01.19.51 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 27 Oct 2023 01:19:51 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) client-ip=2620:137:e000::3:7; Authentication-Results: mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b="i1/TC3St"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by snail.vger.email (Postfix) with ESMTP id 7358B82B6F7B; Fri, 27 Oct 2023 01:19:50 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at snail.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235230AbjJ0ITi (ORCPT + 26 others); Fri, 27 Oct 2023 04:19:38 -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 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 X-Spam-Status: No, score=-2.8 required=5.0 tests=BAYES_00,DKIMWL_WL_MED, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_H5,RCVD_IN_MSPIKE_WL,SPF_HELO_NONE,SPF_NONE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (snail.vger.email [0.0.0.0]); Fri, 27 Oct 2023 01:19:50 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1780896016863386898 X-GMAIL-MSGID: 1780896016863386898 "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 ################################ -.. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :maxdepth: 2 :numbered: 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 ################################### -.. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :maxdepth: 2 :numbered: diff --git a/Documentation/input/joydev/index.rst b/Documentation/input/joydev/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 :Copyright: |copy| 1996-2000 Vojtech Pavlik - Sponsored by SuSE -.. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :maxdepth: 3 joystick From patchwork Fri Oct 27 08:18:27 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Vegard Nossum X-Patchwork-Id: 158820 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:d641:0:b0:403:3b70:6f57 with SMTP id cy1csp443347vqb; Fri, 27 Oct 2023 01:20:16 -0700 (PDT) X-Google-Smtp-Source: AGHT+IELXFKg+uvlGLc6BNWSVkwtEVA0lVLR9f7j6bq8DZM5gTTcIjaAzbHV5qWKkPA2+qoLJb3Y X-Received: by 2002:a05:6808:8d9:b0:3b2:e520:dfab with SMTP id k25-20020a05680808d900b003b2e520dfabmr1784080oij.44.1698394816173; Fri, 27 Oct 2023 01:20:16 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1698394816; cv=none; d=google.com; s=arc-20160816; b=TaPGAFEz1MAWlIK+nUzOm6QKHYQM+NrXaRGeWsnqjutFSUoqeHMgxvTvFqbsQCQK0u zYnZdpbdJ1j9Ir0MKmYbinnWamx34eBI3qenQgR/d/WaR2mmlwBLrbdcuV7JVkSBlMla dCLNwVq+QY8RPRnxod4yEtuJTrIocJJu9NEmTUlFwkXkOM5THjYyfxvf5LU3AFYT62Co fG8wVxUYyzY3Qboy1yRVyhLBuFiAnUtWXzUMmv5NaLBc5KGLr1ZYBbaUQ1miGzykDRpk FPPV45FD2lTiQ9h+LB0gTJ61OTc8YZG8byeDTqunAHi5m6rhAH2yAM84AafhrgJBrMYx c4/g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=l2Ve0RbGhs4TQpF+YaCkmro1guzF3Tr3hOAoJy3n7Ow=; fh=Vkgd6v0oNotoNAleFzvr8SiAXTsDjGTilTa/iXKZ4n0=; b=GxQAVLnAlxCkFRXv0d7pW1iLJRtKmHtUxt0GVfD3u5RJjAiOTDcOQ7fQbRQkZPXGl2 xkKbwkOvIvMrlpwdKMofndG9Xx/2k/EQtko1ApqcL2kdTDBdf2gyy8KUlHNicUY198p9 iDV30a1e80KkVUjO1GpF5hFlEX17NJ7neq0VUht+wxoVzI8foFNmWAn1QcrhRz0NDkjB j7VaZb8cBesEoBPImceO6GUYEMDxseFPXFBFidc1CJ5pOf/eq1g/a7EeTx4UzwaUs9L9 9Gq0ebcWnySebg++FBXFs+PcJGOrKTpiA4pP0GmgRrAyU2sZpv8sJPs8zRro/8icR0+9 5fSQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b=IqYb4tSs; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.33 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from lipwig.vger.email (lipwig.vger.email. [23.128.96.33]) by mx.google.com with ESMTPS id 9-20020a251909000000b00d9a42c75a5bsi1557742ybz.157.2023.10.27.01.20.15 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 27 Oct 2023 01:20:16 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.33 as permitted sender) client-ip=23.128.96.33; Authentication-Results: mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b=IqYb4tSs; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.33 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by lipwig.vger.email (Postfix) with ESMTP id 5D079829FDF3; Fri, 27 Oct 2023 01:20:13 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at lipwig.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235169AbjJ0IUF (ORCPT + 26 others); 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 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 X-Spam-Status: No, score=-0.9 required=5.0 tests=DKIMWL_WL_MED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lipwig.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (lipwig.vger.email [0.0.0.0]); Fri, 27 Oct 2023 01:20:13 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1780896042883267792 X-GMAIL-MSGID: 1780896042883267792 "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-devices/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. -.. class:: toc-title - - Table of contents - .. toctree:: + :caption: Table of contents :maxdepth: 2 ad525x_dpot From patchwork Fri Oct 27 08:18:28 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Vegard Nossum X-Patchwork-Id: 158816 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:d641:0:b0:403:3b70:6f57 with SMTP id cy1csp443090vqb; Fri, 27 Oct 2023 01:19:37 -0700 (PDT) X-Google-Smtp-Source: AGHT+IETNFntDrRPbwGU4BiceFfR76wGPm6RTbr4E6/TiGGgjxzOG2tW4Bfk4OxvOzv22Kabf2pU X-Received: by 2002:a67:c199:0:b0:457:e9fe:66b with SMTP id h25-20020a67c199000000b00457e9fe066bmr2235935vsj.2.1698394777205; Fri, 27 Oct 2023 01:19:37 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1698394777; cv=none; d=google.com; s=arc-20160816; b=icCWmJ4bi0PTAAxVsv2qq/PuHSTXfBmbmpSPlUcAfuiKFRI4oWqBO6wwrSoshIkrMG Hyxva2qFVLncm1VbD6eBi1F65m8epNuolrLv5LkQX4KTSvPseabWc5ONXy8lxPIV7LOS Y7sXb/gr6NZsCHiVu4Ax9p7KK0F7IdgFrctMWoi+k8QiSZz5mY3tT8q+7jNujoKXarEj fM83P0Rv8x+7t+qYl7HUL1+8B1A5yEGnsggsyDItWmufHZfvnWsoGrer3D1DXE8Y5EGU LzqlbRB4dqcpz4P0mxOYF5cmyI2HDaUrX1zHV45G0CqggMiBhqgtGcNO6elQMx/lebQZ ddJw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=DXSUD6D4gKvGLEozl2neVPvk09OeuaDfgn2a+Uvpugo=; fh=8pnP4nTpyCpnUoeLMRmzXBJYejrl7xCpTckXy5MI3zw=; b=aAy9pH6NSpOkTdUABD3q9NhQDBhWxinoNMLZXKnaODeeEdXl+PyguwJR2PH3BwdgfQ 56uwZmVcLR+a4cW/9SjsSqhtmcvqJ6vnqRQuZzmEDqBTCfYdLRh7CpwLez1KFery6nRd PHbGfLHrFdnpp0C3gcziMhKOa+iLXj1wUMrPCLxOexWhsnB0wTH1IjoiqUzOW5KRHRMS hRyyqHdvQdjuqX+bKxB1Gn4ALJtR/WEE0sUZeGP9DJa3PtiSUkVCbf72MX0HudTS8c7C yFGfMZGATEa7Q0w87nhu6VKC6NCm67j3H6ixV5TYv7iUJ0hgRj7eEw2jOALd4A8hh9Hc BDWA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b="4Kpy5f/I"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.37 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from snail.vger.email (snail.vger.email. [23.128.96.37]) by mx.google.com with ESMTPS id z6-20020a258686000000b00d9cacabec21si1961163ybk.223.2023.10.27.01.19.36 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 27 Oct 2023 01:19:37 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.37 as permitted sender) client-ip=23.128.96.37; Authentication-Results: mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b="4Kpy5f/I"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.37 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by snail.vger.email (Postfix) with ESMTP id 083F182BB542; Fri, 27 Oct 2023 01:19:36 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at snail.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235163AbjJ0IT3 (ORCPT + 26 others); Fri, 27 Oct 2023 04:19:29 -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 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 X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIMWL_WL_MED, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF, RCVD_IN_DNSWL_BLOCKED,RCVD_IN_MSPIKE_H5,RCVD_IN_MSPIKE_WL, SPF_HELO_NONE,SPF_NONE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (snail.vger.email [0.0.0.0]); Fri, 27 Oct 2023 01:19:36 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1780896002257822572 X-GMAIL-MSGID: 1780896002257822572 "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/Documentation/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 -.. only:: html - - .. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :maxdepth: 5 :numbered: diff --git a/Documentation/userspace-api/media/drivers/index.rst b/Documentation/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. For more details see the file COPYING in the source distribution of Linux. -.. only:: html - - .. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :maxdepth: 5 :numbered: diff --git a/Documentation/userspace-api/media/dvb/dvbapi.rst b/Documentation/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 **Version 5.10** -.. only:: html - - .. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :maxdepth: 5 :numbered: diff --git a/Documentation/userspace-api/media/index.rst b/Documentation/userspace-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; -.. only:: html - - .. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :maxdepth: 1 intro diff --git a/Documentation/userspace-api/media/mediactl/media-controller.rst 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 ############################## -.. only:: html - - .. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :maxdepth: 5 :numbered: 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 ################################ -.. only:: html - - .. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :maxdepth: 5 :numbered: 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 (V4L2 API) specification. **Revision 4.5** -.. only:: html - - .. class:: toc-title - - Table of Contents - .. toctree:: + :caption: Table of Contents :numbered: :maxdepth: 5 From patchwork Fri Oct 27 08:18:29 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Vegard Nossum X-Patchwork-Id: 158821 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:d641:0:b0:403:3b70:6f57 with SMTP id cy1csp443570vqb; Fri, 27 Oct 2023 01:20:48 -0700 (PDT) X-Google-Smtp-Source: AGHT+IEr+rBErmkoIOQuFRIkobOxz1xuFO/OnToUdSL/VMxLlKgDIzPpx/8uG/sMIZiwWQI8K9xM X-Received: by 2002:a67:e006:0:b0:452:f119:20f with SMTP id c6-20020a67e006000000b00452f119020fmr2340845vsl.8.1698394848672; Fri, 27 Oct 2023 01:20:48 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1698394848; cv=none; d=google.com; s=arc-20160816; b=aQPD7dIqcc8FJrBexAvI+2wlm5lSbPIq5NH4KkmgY+eTMzh0fTsDDfYxhn7L+sRYiC RR2smT0XKcI7BYdO2tL/LHW8yrvVK+KSn4gKCsse7A9Wxl7aM8gHTo69io3vkkyFawjx TcHj/XIRxUNN6iqqTFIs16o/5vJGhXhMeSzdJbiq0fc8FLrK2v4ZnpF6VfSCLmuMW6VZ 9HMTHWui/QkD4Ah4EOCYmaEuCyc4/Dr4HbY//Vkz5zqEY8WFV4I3ovWtzTS/mxHsHysE 9hg+78gkFRh+OXtfU48gvjj7uZoABWL7kmSBcA1rLsynrmPhx1cSF8VA5BWs6kzLZ/cV lI2A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=3Wu6bIg7tVvARFbVYaBYPJjOg+gs9lUaxjqSIpedt0E=; fh=gftZfzL2f9Lk8zgVCARLcpPuopK5Z7KehXMXOn/yfzc=; b=OJmH0wttKy1fOGj6fGTKz0VTG5uV9Z0EqNhkcGox50gEkiquwQ++Fn1bM42krrXhVO vRkJKgLK4qLDB21iwQeFwak8JkrdyYkwT85kmawSPWWwRUCRiW4wngBwN26DC6RoBQpS ZovGytVS4GXFnuMTnxAxJwgI8dd6ADkNclU6vyrLqSf1r/jGBzZDtbA/KXrICzPTg4Mz m4QXQEj+Q99Bo4h6xUv87ALoRbjEts6MOrVEVzFTookDqth6QDzlTAFRitBW3Uvk8rTH Q1lNEThKQCG6T756ZHKz+WG6OmFEVxnpNRpjGMknnlZRPFVG+FtroOBGI+4Qwoub41pO +s5g== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b="gLX/GWaC"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:3 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from lipwig.vger.email (lipwig.vger.email. [2620:137:e000::3:3]) by mx.google.com with ESMTPS id 3-20020a250a03000000b00d4dea91ca51si1713428ybk.208.2023.10.27.01.20.48 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 27 Oct 2023 01:20:48 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:3 as permitted sender) client-ip=2620:137:e000::3:3; Authentication-Results: mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b="gLX/GWaC"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:3 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by lipwig.vger.email (Postfix) with ESMTP id 0CFEA829FDFB; Fri, 27 Oct 2023 01:20:46 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at lipwig.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235227AbjJ0IU3 (ORCPT + 26 others); Fri, 27 Oct 2023 04:20:29 -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 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 X-Spam-Status: No, score=-0.9 required=5.0 tests=DKIMWL_WL_MED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lipwig.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (lipwig.vger.email [0.0.0.0]); Fri, 27 Oct 2023 01:20:46 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1780896076409197558 X-GMAIL-MSGID: 1780896076409197558 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 ========================================= -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. .. toctree:: + :caption: Contents :numbered: :maxdepth: 2 @@ -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.rst 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 ============================================ -Contenuti: +Lo scopo di questo documento è quello di aiutare gli sviluppatori (ed i loro +supervisori) a lavorare con la communità di sviluppo con il minimo sforzo. È +un tentativo di documentare il funzionamento di questa communità in modo che +sia accessibile anche a coloro che non hanno famigliarità con lo sviluppo del +Kernel Linux (o, anzi, con lo sviluppo di software libero in generale). Benchè +qui sia presente del materiale tecnico, questa è una discussione rivolta in +particolare al procedimento, e quindi per essere compreso non richiede una +conoscenza approfondità sullo sviluppo del kernel. .. toctree:: + :caption: Contenuti :numbered: :maxdepth: 2 @@ -22,12 +30,3 @@ Contenuti: 6.Followthrough 7.AdvancedTopics 8.Conclusion - -Lo scopo di questo documento è quello di aiutare gli sviluppatori (ed i loro -supervisori) a lavorare con la communità di sviluppo con il minimo sforzo. È -un tentativo di documentare il funzionamento di questa communità in modo che -sia accessibile anche a coloro che non hanno famigliarità con lo sviluppo del -Kernel Linux (o, anzi, con lo sviluppo di software libero in generale). Benchè -qui sia presente del materiale tecnico, questa è una discussione rivolta in -particolare al procedimento, e quindi per essere compreso non richiede una -conoscenza approfondità sullo sviluppo del kernel. diff --git a/Documentation/translations/zh_CN/process/development-process.rst 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 @@ 内核开发过程指南 ================ -内容: +本文档的目的是帮助开发人员（及其经理）以最小的挫折感与开发社区合作。它试图记录这个社区如何以一种不熟悉Linux内核开发（或者实际上是自由软件开发）的人可以访问的方式工作。虽然这里有一些技术资料，但这是一个面向过程的讨论，不需要深入了解内核编程就可以理解。 .. toctree:: + :caption: 内容 :numbered: :maxdepth: 2 @@ -22,5 +23,3 @@ 6.Followthrough 7.AdvancedTopics 8.Conclusion - -本文档的目的是帮助开发人员（及其经理）以最小的挫折感与开发社区合作。它试图记录这个社区如何以一种不熟悉Linux内核开发（或者实际上是自由软件开发）的人可以访问的方式工作。虽然这里有一些技术资料，但这是一个面向过程的讨论，不需要深入了解内核编程就可以理解。 diff --git a/Documentation/translations/zh_TW/process/development-process.rst 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 @@ 內核開發過程指南 ================ -內容: +本文檔的目的是幫助開發人員（及其經理）以最小的挫折感與開發社區合作。它試圖記錄這個社區如何以一種不熟悉Linux內核開發（或者實際上是自由軟體開發）的人可以訪問的方式工作。雖然這裡有一些技術資料，但這是一個面向過程的討論，不需要深入了解內核編程就可以理解。 .. toctree:: + :caption: 內容 :numbered: :maxdepth: 2 @@ -26,5 +27,3 @@ 7.AdvancedTopics 8.Conclusion -本文檔的目的是幫助開發人員（及其經理）以最小的挫折感與開發社區合作。它試圖記錄這個社區如何以一種不熟悉Linux內核開發（或者實際上是自由軟體開發）的人可以訪問的方式工作。雖然這裡有一些技術資料，但這是一個面向過程的討論，不需要深入了解內核編程就可以理解。 - From patchwork Fri Oct 27 08:18:30 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Vegard Nossum X-Patchwork-Id: 158823 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:d641:0:b0:403:3b70:6f57 with SMTP id cy1csp443781vqb; Fri, 27 Oct 2023 01:21:23 -0700 (PDT) X-Google-Smtp-Source: AGHT+IFCgDmmIMouThVEg1yDdEOAD0QNfocTfzYdZee9uIEGBbbKCvksmMcJKQ2fhciuaZlvIn9q X-Received: by 2002:a25:9085:0:b0:d9a:6b96:4f37 with SMTP id t5-20020a259085000000b00d9a6b964f37mr1906394ybl.7.1698394882807; Fri, 27 Oct 2023 01:21:22 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1698394882; cv=none; d=google.com; s=arc-20160816; b=KZMNyyT6L4TgnR+uE9jY4tAFrB/KLYj00W3yXm2lYd0EFFzwrPW0tOvplxPlqjfFb/ U9netWjc0SPIHA0eftx9EFOWcL29YcH84kg2IFg0voxHr0zRlVSTM01rr2bQpY5olbYb l/b1Lqvw+5YTgMepiG5Xo4pvV2Cre8LqQ4/GOdXG5eEq/cYpOPUOxsX4p3OKzll6XwOv vaVCqeU7WZtmrX/EpuaO/OqLI+rsFl/696sJ8slNKKmGx3x5It/9DDi1nuTTtsWisKRU 0t4j01HHCKbF0Z6UwouFe50BQShGmC7QGkEnZrHEFq4JlZuAK/ab52JL+/0ewPSAaDU4 uHVQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=H0/aCDFt4Sn9FnJqoeRJjT/9P98mgpduCZMNdUkai2Y=; fh=YLm7DaHboaqKJSHxeEA7IRaMzLE6qC6nbePU5PNtNio=; b=nG5QeuKHmiEpFUtubZyXPRucTrMfT2xMWtEti1BnQN0CQjsba+1y0lMfRKeplak6Ig 8PmQIvg66w9YDN9kMiz8oJ/3SyBSo1llcxpSV6jcGnUrsbjR3cW2mxn3QtMqbk1O90VX FfU3iwvrRdOevRgPcdGyXVx2q6H98tWNYaQ4YqTEyUeD3NFL/JJNjYQ475jJ1unmimr5 Y0Rs7gIZfVoKZ+/XpEclyc3kWMdY8YmCU/zX26qz+cch5DLUSxolv9lpQCR0HjT28/5D W+iT7O5PEkH57u5JAqbiZNbGVlnSxQ16YbsKMdQhv4VJbCmFecr9v813REe5nqaLBxgb ojXw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b=I7Ce0QoF; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:5 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from groat.vger.email (groat.vger.email. [2620:137:e000::3:5]) by mx.google.com with ESMTPS id s133-20020a25778b000000b00d86670eb0c2si2075254ybc.289.2023.10.27.01.21.22 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 27 Oct 2023 01:21:22 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:5 as permitted sender) client-ip=2620:137:e000::3:5; Authentication-Results: mx.google.com; dkim=pass header.i=@oracle.com header.s=corp-2023-03-30 header.b=I7Ce0QoF; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:5 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=oracle.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by groat.vger.email (Postfix) with ESMTP id 4FD21829D99B; Fri, 27 Oct 2023 01:21:12 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at groat.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235177AbjJ0ITm (ORCPT + 26 others); Fri, 27 Oct 2023 04:19:42 -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 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 X-Spam-Status: No, score=-0.9 required=5.0 tests=DKIMWL_WL_MED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on groat.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (groat.vger.email [0.0.0.0]); Fri, 27 Oct 2023 01:21:12 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1780896112684890225 X-GMAIL-MSGID: 1780896112684890225 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/Documentation/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^="highlight"] pre { * - hide the permalink symbol as long as link is not hovered */ - .toc-title { - font-size: 150%; - font-weight: bold; - } - caption, .wy-table caption, .rst-content table.field-list caption { font-size: 100%; }