Re: nodocs in 4.19-rcX
On 9/11/18 8:25 AM, Jonathan Corbet wrote: > On Mon, 10 Sep 2018 15:51:20 -0700 > Randy Dunlap wrote: > >> 4.19-rc contains some users of :nodocs: but that is not recognized yet, >> so we get: >> >> lnx-419-rc3/Documentation/core-api/boot-time-mm.rst:78: ERROR: Error in >> "kernel-doc" directive: >> unknown option: "nodocs". >> >> .. kernel-doc:: mm/bootmem.c >>:nodocs: >> >> lnx-419-rc3/Documentation/core-api/boot-time-mm.rst:91: ERROR: Error in >> "kernel-doc" directive: >> unknown option: "nodocs". >> >> .. kernel-doc:: mm/memblock.c >>:nodocs: >> >> >> Do you plan to merge the patch(es) for :nodocs: ? > > :nodocs" was v1 of the patch set: > > > https://lwn.net/ml/linux-doc/1529328996-16247-1-git-send-email-rppt%40linux.vnet.ibm.com/ > > In the end, I merged v3, which changed things (and did not contain > the :nodocs: directive: > > > https://lwn.net/ml/linux-doc/1530306311-10510-1-git-send-email-rppt%40linux.vnet.ibm.com/ Yes, I found that later. which uses (for the record) :functions: with an empty functions list -- to exclude "DOC:" sections. > So I'm guessing that anything that snuck in with :nodocs: didn't get > updated. Somehow I missed that. Adding CC: Mike, since his > fingerprints are on all aspects of this...:) thanks. -- ~Randy
Re: nodocs in 4.19-rcX
On Mon, 10 Sep 2018 15:51:20 -0700 Randy Dunlap wrote: > 4.19-rc contains some users of :nodocs: but that is not recognized yet, > so we get: > > lnx-419-rc3/Documentation/core-api/boot-time-mm.rst:78: ERROR: Error in > "kernel-doc" directive: > unknown option: "nodocs". > > .. kernel-doc:: mm/bootmem.c >:nodocs: > > lnx-419-rc3/Documentation/core-api/boot-time-mm.rst:91: ERROR: Error in > "kernel-doc" directive: > unknown option: "nodocs". > > .. kernel-doc:: mm/memblock.c >:nodocs: > > > Do you plan to merge the patch(es) for :nodocs: ? :nodocs" was v1 of the patch set: https://lwn.net/ml/linux-doc/1529328996-16247-1-git-send-email-rppt%40linux.vnet.ibm.com/ In the end, I merged v3, which changed things (and did not contain the :nodocs: directive: https://lwn.net/ml/linux-doc/1530306311-10510-1-git-send-email-rppt%40linux.vnet.ibm.com/ So I'm guessing that anything that snuck in with :nodocs: didn't get updated. Somehow I missed that. Adding CC: Mike, since his fingerprints are on all aspects of this...:) jon
nodocs in 4.19-rcX
Hi Jonathan, 4.19-rc contains some users of :nodocs: but that is not recognized yet, so we get: lnx-419-rc3/Documentation/core-api/boot-time-mm.rst:78: ERROR: Error in "kernel-doc" directive: unknown option: "nodocs". .. kernel-doc:: mm/bootmem.c :nodocs: lnx-419-rc3/Documentation/core-api/boot-time-mm.rst:91: ERROR: Error in "kernel-doc" directive: unknown option: "nodocs". .. kernel-doc:: mm/memblock.c :nodocs: Do you plan to merge the patch(es) for :nodocs: ? thanks, -- ~Randy
