Re: [PATCH 2/7] docs: ABI: power: rt9471: Add newline for paragraphs

[Randy Dunlap]

Hi,

On 10/25/26 3:05 PM, Waqar Hameed wrote:
> To split paragraphs in reStructuredText, an empty line is needed.
> Otherwise the output will be:
> 
>   Access: Read, Write Valid values: - 1: enabled - 0: disabled
> 
> Add a newline in order to properly format it as intended:
> 
> Reported-by: Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx>
> Closes: https://lore.kernel.org/oe-kbuild-all/20261020101625.01874245@xxxxxxx/
> Signed-off-by: Waqar Hameed <waqar.hameed@xxxxxxxx>
> ---
>  Documentation/ABI/testing/sysfs-class-power-rt9471 | 2 ++
>  1 file changed, 2 insertions(+)
> 
> diff --git a/Documentation/ABI/testing/sysfs-class-power-rt9471 b/Documentation/ABI/testing/sysfs-class-power-rt9471
> index 04a771cd23512..c306e2ead6bb7 100644
> --- a/Documentation/ABI/testing/sysfs-class-power-rt9471
> +++ b/Documentation/ABI/testing/sysfs-class-power-rt9471
> @@ -12,6 +12,7 @@ Description:
>  		the action before the device really enter shipping mode.
>  
>  		Access: Read, Write
> +
>  		Valid values:

It would look nicer to add a blank line here (and below) so that the 2
following lines are processed as bullet items.
(as Mauro suggested)

Same for patch 5/7.

>  		- 1: enabled
>  		- 0: disabled
> @@ -27,6 +28,7 @@ Description:
>  		datasheet for details. Normally controlled when TypeC/USBPD port integrated.
>  
>  		Access: Read, Write
> +
>  		Valid values:
>  		- 1: enabled
>  		- 0: disabled

-- 
~Randy