Subject: Re: linux-next: build warnings after merge of Linus' tree

From: Jonathan Corbet <[email-masked]>
Date: Thu, 13 Nov 2025 09:23:27 -0700

Mauro Carvalho Chehab <[email-masked]> writes:

> Em Thu, 13 Nov 2025 12:55:37 +1100
> Stephen Rothwell <[email-masked]> escreveu:
>
>> Hi all,
>> 
>> Today's linux-next build (htmldocs) produced these warnings:
>> 
>> WARNING: /home/sfr/kernels/next/next/include/linux/virtio_config.h:174 duplicate section name 'Return'
>> WARNING: /home/sfr/kernels/next/next/include/linux/virtio_config.h:184 duplicate section name 'Return'
>> WARNING: /home/sfr/kernels/next/next/include/linux/virtio_config.h:190 duplicate section name 'Return'
>> 
>> Introduced by commit
>> 
>>   bee8c7c24b73 ("virtio: introduce map ops in virtio core")
>> 
>> but is probably a bug in our scripts as those lines above have "Returns:"
>> in them, not "Return:".
>
> It is not a mistake. What happens is that, when kernel-doc detects
> something like:
>
> 	/**
> ...
> 	 * return: something
> ...
> 	 *    returns: else
> ...
> 	 */
>
> we have a duplicated section.

This seems like something we should be able to fix...will try to find
some time to look into it...

jon