[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <87le9pg2q4.fsf@meer.lwn.net>
Date: Tue, 19 Dec 2023 17:02:59 -0700
From: Jonathan Corbet <corbet@....net>
To: Randy Dunlap <rdunlap@...radead.org>, Stephen Rothwell
<sfr@...b.auug.org.au>
Cc: Linux Kernel Mailing List <linux-kernel@...r.kernel.org>, Linux Next
Mailing List <linux-next@...r.kernel.org>
Subject: Re: linux-next: build warning after merge of the jc_docs tree
Randy Dunlap <rdunlap@...radead.org> writes:
> On 12/18/23 06:18, Jonathan Corbet wrote:
>> Stephen Rothwell <sfr@...b.auug.org.au> writes:
>>
>>> Hi all,
>>>
>>> After merging the jc_docs tree, today's linux-next build (htmldocs)
>>> produced this warning:
>>>
>>> include/crypto/hash.h:248: warning: Excess struct member 'digestsize' description in 'shash_alg'
>>>
>>> and 636 new similar warnings :-(
>>>
>>> Exposed by commit
>>>
>>> b77fdd6a48e6 ("scripts/kernel-doc: restore warning for Excess struct/union")
>>>
>>> I am not sure what we should do about this ... last Friday I only
>>> got about 18 lines of warnings.
>>
>> The warnings were expected, of course.
>>
>> The alternatives are to fix the docs or to revert b77fdd6a48e6,
>> pretending that all those kerneldoc errors don't actually exist. The
>> fixes should be pretty easy to do (and there's far less of them than it
>> seems from the number of warnings). I can't get there right away but if
>> nobody beats me to it I'll try to toss some patches together.
>
> Hi Jon,
>
> Attempt at a little coordination:
>
> It looks like you are working on some net-related patches for this.
> I am currently working on fs/ and kernel/ patches.
Oops...I did a few net ones now; they are all sent and I'm done for
today.
Thanks for working on these too!
jon
Powered by blists - more mailing lists