Re: [PATCH] docs: Fix kernel-doc indentation errors in multiple drivers
From: Randy Dunlap
Date: Sun Jul 06 2025 - 20:47:57 EST
On 7/6/25 5:37 PM, Bagas Sanjaya wrote:
> On Sat, Jul 05, 2025 at 02:36:45PM -0700, Randy Dunlap wrote:
>> It needs something to turn True and False into a bullet list
>> (non-numbered), as documented in Documentation/doc-guide/kernel-doc.rst:
>>
>> So, in order to produce the desired line breaks, you need to use a
>> ReST list, e. g.::
>>
>> * Return:
>> * * %0 - OK to runtime suspend the device
>> * * %-EBUSY - Device should not be runtime suspended
>>
>>
>>
>> I don't see any of these kernel-doc warnings. I would guess that
>> either Pavel or I am using some older/newer version of whatever
>> software is causing this.
>>
>
> I think Sphinx reported these warnings on docs-next tree.
>
> Thanks.
>
I would hope and think that the docs-next tree is in linux-next and I
tested on linux-next.
But I probably don't know what is going on...
--
~Randy