Re: [PATCH 1/7] docs: ABI: power: rt9471: Fix invalid inline emphasis

[Waqar Hameed]

On Sun, Oct 25, 2026 at 19:39 -0700 Randy Dunlap <rdunlap@xxxxxxxxxxxxx> wrote:

> On 10/25/26 3:05 PM, Waqar Hameed wrote:
>> `docutils` warns:
>>
>>   Documentation/ABI/testing/sysfs-class-power-rt9471:1: (WARNING/2) Inline emphasis start-string without end-string.
>>   Documentation/ABI/testing/sysfs-class-power-rt9471:20: (WARNING/2) Inline
>> emphasis start-string without end-string.
>>
>> Fix this by escaping the `*`.
>
> I'm still seeing this issue after the patch is applied (same for patch 4/7).
> Maybe we are fighting a docutils your-version vs. my-version problem
> or just a moving target.

Hm, that's weird. What output do you actually get? The '*' is escaped
now, so it shouldn't complain...

>
> $ docutils --version
> docutils-3.13 (Docutils 0.23, Python 3.13.16, on linux)

I have

  docutils (Docutils 0.20.1, Python 3.12.3, on linux)

>
>> Reported-by: kernel test robot <lkp@xxxxxxxxx>
>> Closes: https://lore.kernel.org/oe-kbuild-all/202609110722.GAZVme6v-lkp@xxxxxxxxx/
>> Signed-off-by: Waqar Hameed <waqar.hameed@xxxxxxxx>
>> ---
>>  Documentation/ABI/testing/sysfs-class-power-rt9471 | 4 ++--
>>  1 file changed, 2 insertions(+), 2 deletions(-)
>>
>> diff --git a/Documentation/ABI/testing/sysfs-class-power-rt9471 b/Documentation/ABI/testing/sysfs-class-power-rt9471
>> index 0a390ee5ac21c..04a771cd23512 100644
>> --- a/Documentation/ABI/testing/sysfs-class-power-rt9471
>> +++ b/Documentation/ABI/testing/sysfs-class-power-rt9471
>> @@ -1,4 +1,4 @@
>> -What:                /sys/class/power_supply/rt9471-*/sysoff_enable
>> +What:                /sys/class/power_supply/rt9471-\*/sysoff_enable
>>  Date:                Feb 2023
>>  KernelVersion:       6.3
>>  Contact:     ChiYuan Huang <cy_huang@xxxxxxxxxxx>
>> @@ -16,7 +16,7 @@ Description:
>>               - 1: enabled
>>               - 0: disabled
>>
>> -What:                /sys/class/power_supply/rt9471-*/port_detect_enable
>> +What:                /sys/class/power_supply/rt9471-\*/port_detect_enable
>>  Date:                Feb 2023
>>  KernelVersion:       6.3
>>  Contact:     ChiYuan Huang <cy_huang@xxxxxxxxxxx>