linux-kernel - Re: [PATCH 3/3] Documentation: fb: Split toctree

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 for Android: free password hash cracker in your pocket

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

Message-ID: <51ccc0fb-d17f-45c9-984b-65b9e2d0c4ac@infradead.org>
Date: Sat, 20 Sep 2025 21:08:53 -0700
From: Randy Dunlap <rdunlap@...radead.org>
To: Bagas Sanjaya <bagasdotme@...il.com>,
 Linux Kernel Mailing List <linux-kernel@...r.kernel.org>,
 Linux Documentation <linux-doc@...r.kernel.org>,
 Linux Framebuffer <linux-fbdev@...r.kernel.org>,
 Linux DRI Development <dri-devel@...ts.freedesktop.org>
Cc: Helge Deller <deller@....de>, Jonathan Corbet <corbet@....net>,
 Sudip Mukherjee <sudipm.mukherjee@...il.com>,
 Teddy Wang <teddy.wang@...iconmotion.com>,
 Bernie Thompson <bernie@...gable.com>,
 Mauro Carvalho Chehab <mchehab+samsung@...nel.org>,
 Ard Biesheuvel <ardb@...nel.org>, Arvind Sankar <nivedita@...m.mit.edu>
Subject: Re: [PATCH 3/3] Documentation: fb: Split toctree



On 9/18/25 5:36 PM, Bagas Sanjaya wrote:
> Framebuffer docs toctree consists of driver-independent docs
> (e.g. API docs) and driver-specific docs. The latter has much
> more entries.
> 
> Group the docs into separate toctrees.
> 
> Signed-off-by: Bagas Sanjaya <bagasdotme@...il.com>

LGTM. Thanks.

Reviewed-by: Randy Dunlap <rdunlap@...radead.org>
Tested-by: Randy Dunlap <rdunlap@...radead.org>

> ---
>  Documentation/fb/index.rst | 80 +++++++++++++++++++++-----------------
>  1 file changed, 45 insertions(+), 35 deletions(-)
> 
> diff --git a/Documentation/fb/index.rst b/Documentation/fb/index.rst
> index 33e3c49f885695..e2f7488b6e2e42 100644
> --- a/Documentation/fb/index.rst
> +++ b/Documentation/fb/index.rst
> @@ -4,42 +4,52 @@
>  Frame Buffer
>  ============
>  
> -.. toctree::
> -    :maxdepth: 1
> +General information
> +===================
>  
> -    api
> -    arkfb
> -    aty128fb
> -    cirrusfb
> -    cmap_xfbdev
> -    deferred_io
> -    efifb
> -    ep93xx-fb
> -    fbcon
> -    framebuffer
> -    gxfb
> -    intel810
> -    internals
> -    lxfb
> -    matroxfb
> -    metronomefb
> -    modedb
> -    pvr2fb
> -    pxafb
> -    s3fb
> -    sa1100fb
> -    sh7760fb
> -    sisfb
> -    sm501
> -    sm712fb
> -    sstfb
> -    tgafb
> -    tridentfb
> -    udlfb
> -    uvesafb
> -    vesafb
> -    viafb
> -    vt8623fb
> +.. toctree::
> +   :maxdepth: 1
> +
> +   api
> +   cmap_xfbdev
> +   deferred_io
> +   fbcon
> +   framebuffer
> +   internals
> +   modedb
> +
> +Driver documentation
> +====================
> +
> +.. toctree::
> +   :maxdepth: 1
> +
> +   arkfb
> +   aty128fb
> +   cirrusfb
> +   efifb
> +   ep93xx-fb
> +   gxfb
> +   intel810
> +   lxfb
> +   matroxfb
> +   metronomefb
> +   pvr2fb
> +   pxafb
> +   s3fb
> +   sa1100fb
> +   sh7760fb
> +   sisfb
> +   sm501
> +   sm712fb
> +   sstfb
> +   tgafb
> +   tridentfb
> +   udlfb
> +   uvesafb
> +   vesafb
> +   viafb
> +   vt8623fb
>  
>  .. only::  subproject and html
>  

-- 
~Randy