linux-kernel - linux-next: build warning for a long time

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [thread-next>] [day] [month] [year] [list]

Message-ID: <20241011172442.3a9cc81b@canb.auug.org.au>
Date: Fri, 11 Oct 2024 17:24:42 +1100
From: Stephen Rothwell <sfr@...b.auug.org.au>
To: Greg KH <greg@...ah.com>
Cc: Jonathan Corbet <corbet@....net>, Linux Kernel Mailing List
 <linux-kernel@...r.kernel.org>, Linux Next Mailing List
 <linux-next@...r.kernel.org>
Subject: linux-next: build warning for a long time

Hi all,

From before the git era, an htmldocs build (if we had such a thing back
then) would complain like this:

Documentation/driver-api/usb/usb:164: drivers/usb/core/message.c:968: WARNING: Duplicate C declaration, also defined at driver-api/usb/gadget:804.
Declaration is '.. c:function:: int usb_string (struct usb_device *dev, int index, char *buf, size_t size)'.

I assume it is confused because we have documented both a function and a
data type called "usb_string".  The former in drivers/usb/core/message.c
and the latter in include/linux/usb/gadget.h.

There are about 46 references to the function and 105 to the struct.
We could rename the function to usb_string_utf8 ...
-- 
Cheers,
Stephen Rothwell

Content of type "application/pgp-signature" skipped