[PATCH] Documentation: Fix description format for powerpc RTAS ioctls

[Madhavan Srinivasan]

On 4/30/25 2:38 PM, Bagas Sanjaya wrote:
> On Tue, Apr 29, 2025 at 07:28:47PM -0700, Haren Myneni wrote:
>> Fix the description format for the following build warnings:
>>
>> "Documentation/userspace-api/ioctl/ioctl-number.rst:369:
>> ERROR: Malformed table. Text in column margin in table line 301.
>>
>> 0xB2  03-05 arch/powerpc/include/uapi/asm/papr-indices.h
>> powerpc/pseries indices API
>>                             <mailto:linuxppc-dev>
>> 0xB2  06-07 arch/powerpc/include/uapi/asm/papr-platform-dump.h
>> powerpc/pseries Platform Dump API
>>                             <mailto:linuxppc-dev>
>> 0xB2  08  arch/powerpc/include/uapi/asm/papr-physical-attestation.h
>> powerpc/pseries Physical Attestation API
>>                             <mailto:linuxppc-dev>"
>>
> 
> Hi,
> 
> FYI, I've also submitted the fix earlier at [1] (but different approach).
> ppc maintainers, would you like taking this patch instead or mine?

Looked your patch (thanks for the link) and it is more of generic clean up. 
I would prefer to take Haren patch now since it fixes the specific failure
case. But would encourage you to send it as generic cleanup patch.

Maddy


> 
> [1]: https://lore.kernel.org/linuxppc-dev/20250429130524.33587-2-bagasdotme@gmail.com/
> 
>> Reported-by: Stephen Rothwell <sfr at canb.auug.org.au>
>> Signed-off-by: Haren Myneni <haren at linux.ibm.com>
>> Fixes: 43d869ac25f1 ("powerpc/pseries: Define papr_indices_io_block for papr-indices ioctls")
>> Fixes: 8aa9efc0be66 ("powerpc/pseries: Add papr-platform-dump character driver for dump retrieval")
>> Fixes: 86900ab620a4 ("powerpc/pseries: Add a char driver for physical-attestation RTAS")
>> Closes: https://lore.kernel.org/linux-next/20250429181707.7848912b@canb.auug.org.au/
>> ---
>>  Documentation/userspace-api/ioctl/ioctl-number.rst | 6 +++---
>>  1 file changed, 3 insertions(+), 3 deletions(-)
>>
>> diff --git a/Documentation/userspace-api/ioctl/ioctl-number.rst b/Documentation/userspace-api/ioctl/ioctl-number.rst
>> index 017a23aeadc3..fee5c4731501 100644
>> --- a/Documentation/userspace-api/ioctl/ioctl-number.rst
>> +++ b/Documentation/userspace-api/ioctl/ioctl-number.rst
>> @@ -366,11 +366,11 @@ Code  Seq#    Include File                                           Comments
>>                                                                       <mailto:linuxppc-dev>
>>  0xB2  01-02  arch/powerpc/include/uapi/asm/papr-sysparm.h            powerpc/pseries system parameter API
>>                                                                       <mailto:linuxppc-dev>
>> -0xB2  03-05 arch/powerpc/include/uapi/asm/papr-indices.h             powerpc/pseries indices API
>> +0xB2  03-05  arch/powerpc/include/uapi/asm/papr-indices.h            powerpc/pseries indices API
>>                                                                       <mailto:linuxppc-dev>
>> -0xB2  06-07 arch/powerpc/include/uapi/asm/papr-platform-dump.h       powerpc/pseries Platform Dump API
>> +0xB2  06-07  arch/powerpc/include/uapi/asm/papr-platform-dump.h      powerpc/pseries Platform Dump API
>>                                                                       <mailto:linuxppc-dev>
>> -0xB2  08  arch/powerpc/include/uapi/asm/papr-physical-attestation.h  powerpc/pseries Physical Attestation API
>> +0xB2  08     powerpc/include/uapi/asm/papr-physical-attestation.h    powerpc/pseries Physical Attestation API
>>                                                                       <mailto:linuxppc-dev>
>>  0xB3  00     linux/mmc/ioctl.h
>>  0xB4  00-0F  linux/gpio.h                                            <mailto:linux-gpio at vger.kernel.org>
> 
> In any case,
> 
> Reviewed-by: Bagas Sanjaya <bagasdotme at gmail.com>
> 
> Thanks.
>