linux-kernel - Re: [PATCH 1/2] Documentation: RCU: Reduce toctree depth

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <f483a724-1d63-4082-914f-dea8361d5c96@paulmck-laptop>
Date: Mon, 18 Aug 2025 19:36:00 -0700
From: "Paul E. McKenney" <paulmck@...nel.org>
To: Bagas Sanjaya <bagasdotme@...il.com>
Cc: Linux Kernel Mailing List <linux-kernel@...r.kernel.org>,
	Linux Documentation <linux-doc@...r.kernel.org>,
	Linux RCU <rcu@...r.kernel.org>,
	Frederic Weisbecker <frederic@...nel.org>,
	Neeraj Upadhyay <neeraj.upadhyay@...nel.org>,
	Joel Fernandes <joelagnelf@...dia.com>,
	Josh Triplett <josh@...htriplett.org>,
	Boqun Feng <boqun.feng@...il.com>,
	Uladzislau Rezki <urezki@...il.com>,
	Steven Rostedt <rostedt@...dmis.org>,
	Mathieu Desnoyers <mathieu.desnoyers@...icios.com>,
	Lai Jiangshan <jiangshanlai@...il.com>,
	Zqiang <qiang.zhang@...ux.dev>
Subject: Re: [PATCH 1/2] Documentation: RCU: Reduce toctree depth

On Tue, Aug 19, 2025 at 08:26:19AM +0700, Bagas Sanjaya wrote:
> toctree index for RCU currently has maximum depth of 3. Since no docs
> currently use more than 3 section heading levels, this effectively spills
> the entire docs hierarchy.
> 
> Tidy up by reducing toctree depth to 2 (only showing docs title and
> second-level sections).
> 
> Signed-off-by: Bagas Sanjaya <bagasdotme@...il.com>

I pulled all three in for testing and review, thank you!

							Thanx, Paul

> ---
>  Documentation/RCU/index.rst | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/Documentation/RCU/index.rst b/Documentation/RCU/index.rst
> index 84a79903f6a883..e1be5b3c2c6773 100644
> --- a/Documentation/RCU/index.rst
> +++ b/Documentation/RCU/index.rst
> @@ -7,7 +7,7 @@ RCU concepts
>  ============
>  
>  .. toctree::
> -   :maxdepth: 3
> +   :maxdepth: 2
>  
>     checklist
>     lockdep
> -- 
> An old man doll... just what I always wanted! - Clara
>