linux-next: build warning for a long time

From: Stephen Rothwell
Date: Fri Oct 11 2024 - 02:25:01 EST


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

Attachment: pgpwowsk9VuP0.pgp
Description: OpenPGP digital signature