Re: [PATCH 2/7] docs: ABI: power: rt9471: Add newline for paragraphs
From: Waqar Hameed
Date: Mon Oct 26 2026 - 09:32:01 EST
On Sun, Oct 25, 2026 at 19:29 -0700 Randy Dunlap <rdunlap@xxxxxxxxxxxxx> wrote:
> 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.
Oh, missed that one! Will fix in next version then. Thanks!
There are _a lot_ similar cases of this in the directory. I'll let
someone else clean those up...
[...]