From patchwork Tue Nov 8 11:57:07 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Daniel Vetter X-Patchwork-Id: 17004 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:6687:0:0:0:0:0 with SMTP id l7csp2661136wru; Tue, 8 Nov 2022 04:06:36 -0800 (PST) X-Google-Smtp-Source: AMsMyM53keaJ27BNDxgSRk0VK3OgiXhuQoRyyMgmllxlbU/cd2mMIim+Nkmls8jbks+oZvDVO329 X-Received: by 2002:a17:907:25c9:b0:77b:a343:bd62 with SMTP id ae9-20020a17090725c900b0077ba343bd62mr55018393ejc.660.1667909196058; Tue, 08 Nov 2022 04:06:36 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1667909196; cv=none; d=google.com; s=arc-20160816; b=XIzcOLupDonTV6rfZ0nWEklxzjndX9mTXEgjcNh90chf5QVl6cKZdGs4KFsVjneApd 6kJFl/kjNOKyMTc3xhdGpQ+ZBBdaGOHzfzIwu9sMVQMm06ixD1f/331tzSUspzbSjJEw XV42PFcfjK6kKVElgKr1uiwnimw+Oz5icMU3qD69hssfUY2PtRkAJOARPiLII5sCat2S y12lS8hyPvD5NLgUtIabkjzAaBz7KBHJpjoB9ipZDMAYJoKNu5QQGHMzkzAx+SrRtZKj 8vXWNyd0LFSZ5qUY5XkzCh8TIQxYTkc/ZRPYAsGZD2KBMglZJ51K5vTUJVuW6IMAOgbd EYVg== 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 :message-id:date:subject:cc:to:from:dkim-signature; bh=kVfGNdtNg+zCQhJb8JnZXraJEUpvWY2XlNM2DVwiefU=; b=F9Yna8Iyt+0X+iTnC1dXFWW6sEczZELvkTbeaI6mVhrIbjeVpvZ+50m7eTcRUxvLQ7 sS+fR+2Cxn56Lx0TUkduskyFbUD/enEeWf93pQKOmN03lo2o/d2iqxcfG0ukmqafHjzz /akTGNDPXT0pehBHHhoPrPlOS/hq38zHwoIRxujadAxhBreOsZ1ZVNIvuNSfBXScLKt7 pfuM05TA4yya+wZPmZHylZU7Ag0F5Ewldw/t+e3kfZ0OC18slxjRsOnbtOIGyabgJG7F oBQ4h0eCjL95J5WSM8J4IHSWNuo0ZBRWC3+sjBvjFE76lYe/Mpf/q6/0AoZ0TuTqGaA1 14Pg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@ffwll.ch header.s=google header.b=Es1qARbs; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id e14-20020a056402190e00b004643f382880si14729619edz.401.2022.11.08.04.06.10; Tue, 08 Nov 2022 04:06:36 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@ffwll.ch header.s=google header.b=Es1qARbs; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234011AbiKHL5W (ORCPT + 99 others); Tue, 8 Nov 2022 06:57:22 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:53530 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233994AbiKHL5Q (ORCPT ); Tue, 8 Nov 2022 06:57:16 -0500 Received: from mail-ej1-x62d.google.com (mail-ej1-x62d.google.com [IPv6:2a00:1450:4864:20::62d]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 1026E12AFF for ; Tue, 8 Nov 2022 03:57:15 -0800 (PST) Received: by mail-ej1-x62d.google.com with SMTP id y14so37936381ejd.9 for ; Tue, 08 Nov 2022 03:57:14 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ffwll.ch; s=google; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=kVfGNdtNg+zCQhJb8JnZXraJEUpvWY2XlNM2DVwiefU=; b=Es1qARbsX7RS0Xd92HZZOXqamwXebEAT3D2rXZ3242oq86HzzlEKeouCKkE0VHuTdS wV5oVWbgvc1NgAKIFqN8aujoG++ihft46CuIV9EBKh+8ZOeAr+ECVeYP3n7kbgEcJzqU PASmZvErmpFvngKyJXPLWQGHor2Qink3rJUPw= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=kVfGNdtNg+zCQhJb8JnZXraJEUpvWY2XlNM2DVwiefU=; b=6CUE40CDq0wavtbJdBNkUwY+CaQHPSKbvqC+qjeznmiLREl8KZXRGgYz/CFObOG0qo /i22lVHJ0zsiSjzEmat+rIjgh4Pnu0G0bWF5nWOrqbInMSzNKtW/4lhsMNf5x/SCoGLs LXt3Vndio+Jxud6xC52zdyB88UALUMPX2j3GHmT6bAzH4bol8qmRtkMQaP8TgpVQsrsL tJ6QQIUzWFbLBFdUo2HT6CRy0Nv4aEOkfn88spPzJ1bcSKU0ZPofGdlmnOhHCME4wF9i vvznC1xeDRyG8oORyBV3JeEfGa6zyXF1t2Z9SZltjfBwFDxhrf4roY3FAYbnZXzeXHvA VmEg== X-Gm-Message-State: ACrzQf2KO8inEi+GtxfiHEgrAPlBj0waapsPGWeYEVtGwK8rRW6/6+Fg 96zBZp7L/eposVv9sprTvRalbA== X-Received: by 2002:a17:907:e8f:b0:7ad:923a:5a2c with SMTP id ho15-20020a1709070e8f00b007ad923a5a2cmr51867849ejc.736.1667908633613; Tue, 08 Nov 2022 03:57:13 -0800 (PST) Received: from phenom.ffwll.local (212-51-149-33.fiber7.init7.net. [212.51.149.33]) by smtp.gmail.com with ESMTPSA id ky26-20020a170907779a00b0073cd7cc2c81sm4513201ejc.181.2022.11.08.03.57.12 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 08 Nov 2022 03:57:12 -0800 (PST) From: Daniel Vetter To: DRI Development Cc: LKML , Daniel Vetter , Daniel Vetter , Jonathan Corbet , linux-doc@vger.kernel.org Subject: [PATCH] docs/sphinx: More depth in the rtd sidebar toc Date: Tue, 8 Nov 2022 12:57:07 +0100 Message-Id: <20221108115707.1232621-1-daniel.vetter@ffwll.ch> X-Mailer: git-send-email 2.37.2 MIME-Version: 1.0 X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_NONE, 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-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1748929553339605710?= X-GMAIL-MSGID: =?utf-8?q?1748929553339605710?= We love to nest our documenation for good structure, but that means the table of contents needs to keep up or you can't navigate them. Realized this trying to find the drm property documentation, which with some shuffling around disappeared. Why I didn't realize we can do this earlier, no idea. Since the relevant parts of the toc are only loaded if you're in the right .html file there's no harm in going all the way to unlimited. Note that this has no impact on the alabaster theme (which has a much simpler sidebar toc which doesn't show the entire hierarchy, only what's in the local rendered file) nor on the various :toctree: rendered inline in the output. Signed-off-by: Daniel Vetter Cc: Jonathan Corbet Cc: linux-doc@vger.kernel.org --- v2: Rebase onto linux-next, reword commit message to take into account that alabaster is the default now. --- Documentation/conf.py | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/Documentation/conf.py b/Documentation/conf.py index c715610d6297..a5c45df0bd83 100644 --- a/Documentation/conf.py +++ b/Documentation/conf.py @@ -296,6 +296,10 @@ if html_theme == 'sphinx_rtd_theme' or html_theme == 'sphinx_rtd_dark_mode': # Add color-specific RTD normal mode html_css_files.append('theme_rtd_colors.css') + html_theme_options = { + 'navigation_depth': -1, + } + except ImportError: html_theme = 'alabaster'