Re: [PATCH] Documentation: driver-api: usb: Limit toctree depth
From: Jonathan Corbet
Date: Thu Aug 21 2025 - 13:51:35 EST
Bagas Sanjaya <bagasdotme@xxxxxxxxx> writes:
> toctree index in USB driver api docs currently spoils the entire docs
> headings due to lack of :maxdepth: option. Add the option to limit
> toctree depth to 1, mirroring usb subsystem docs in
> Documentation/usb/index.rst.
>
> Signed-off-by: Bagas Sanjaya <bagasdotme@xxxxxxxxx>
> ---
> Documentation/driver-api/usb/index.rst | 1 +
> 1 file changed, 1 insertion(+)
>
> diff --git a/Documentation/driver-api/usb/index.rst b/Documentation/driver-api/usb/index.rst
> index cfa8797ea6144b..fcb24d0500d91d 100644
> --- a/Documentation/driver-api/usb/index.rst
> +++ b/Documentation/driver-api/usb/index.rst
> @@ -3,6 +3,7 @@ Linux USB API
> =============
>
> .. toctree::
> + :maxdepth: 1
>
It's still kind of a mess, but that does make it better. Applied,
thanks.
jon