Re: nodocs in 4.19-rcX

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On 9/11/18 8:25 AM, Jonathan Corbet wrote:
> On Mon, 10 Sep 2018 15:51:20 -0700
> Randy Dunlap <rdunlap@xxxxxxxxxxxxx> 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



[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux