On Sun, Jul 6, 2025 at 8:37 PM Bagas Sanjaya <bagasdotme@xxxxxxxxx> 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. > > -- > An old man doll... just what I always wanted! - Clara Hi, I just wanted to follow up with the thread. I had inadvertently done a reply not reply all after the first series of feedback from Pavel and Randy. I agree with Randy in that the nested lists be updated to use ReST list syntax. I'm working on a v2 and spot checking the output. For reference: I am running docutils (Docutils 0.21.2, Python 3.13.5, on linux) My branch was based on commit 50c8770a42faf8b1c7abe93e7c114337f580a97d (linux-next/master). The specific error(s): /home/linux/Documentation/networking/device_drivers/can/ctu/ctucanfd-driver:526: ./drivers/net/can/ctucanfd/ctucanfd_base.c:511: ERROR: Unexpected indentation. [docutils] I apologize if I should've started this work using the docs-next tree. I wasn't aware of it at the moment and was utilizing linux-next. Best, Felipe
