linux-kernel - Re: [PATCH] Documentation: parport-lowlevel: Separate function listing code blocks

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: <8766fc64-f7d5-4443-8646-604f98a6d26f@infradead.org>
Date: Wed, 5 Nov 2025 21:55:33 -0800
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 ARM <linux-arm-kernel@...ts.infradead.org>,
 linux-actions@...ts.infradead.org
Cc: Sudip Mukherjee <sudipm.mukherjee@...il.com>,
 Jonathan Corbet <corbet@....net>, Andreas Färber
 <afaerber@...e.de>, Manivannan Sadhasivam <mani@...nel.org>,
 Mauro Carvalho Chehab <mchehab@...nel.org>
Subject: Re: [PATCH] Documentation: parport-lowlevel: Separate function
 listing code blocks



On 11/5/25 4:49 AM, Bagas Sanjaya wrote:
> Commit be9d0411f1608a ("parport-lowlevel.txt: standardize document
> format") reSTify parport interface documentation but forgets to properly
> mark function listing code blocks up. As such, these are rendered as
> long-running normal paragraph instead.
> 
> Fix them by adding missing separator between the code block marker and
> the listing.
> 
> Fixes: be9d0411f1608a ("parport-lowlevel.txt: standardize document format")
> Signed-off-by: Bagas Sanjaya <bagasdotme@...il.com>

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

Thanks.

> ---
>  Documentation/driver-api/parport-lowlevel.rst | 5 +++++
>  1 file changed, 5 insertions(+)
> 
> diff --git a/Documentation/driver-api/parport-lowlevel.rst b/Documentation/driver-api/parport-lowlevel.rst
> index 0633d70ffda7fa..a907e279f509b4 100644
> --- a/Documentation/driver-api/parport-lowlevel.rst
> +++ b/Documentation/driver-api/parport-lowlevel.rst
> @@ -7,6 +7,7 @@ PARPORT interface documentation
>  Described here are the following functions:
>  
>  Global functions::
> +
>    parport_register_driver
>    parport_unregister_driver
>    parport_enumerate
> @@ -34,6 +35,7 @@ Global functions::
>  Port functions (can be overridden by low-level drivers):
>  
>    SPP::
> +
>      port->ops->read_data
>      port->ops->write_data
>      port->ops->read_status
> @@ -46,17 +48,20 @@ Port functions (can be overridden by low-level drivers):
>      port->ops->data_reverse
>  
>    EPP::
> +
>      port->ops->epp_write_data
>      port->ops->epp_read_data
>      port->ops->epp_write_addr
>      port->ops->epp_read_addr
>  
>    ECP::
> +
>      port->ops->ecp_write_data
>      port->ops->ecp_read_data
>      port->ops->ecp_write_addr
>  
>    Other::
> +
>      port->ops->nibble_read_data
>      port->ops->byte_read_data
>      port->ops->compat_write_data
> 
> base-commit: 27600b51fbc8b9a4eba18c8d88d7edb146605f3f

-- 
~Randy