Re: [PATCH] USB: drop misleading usb_set_intfdata() kernel doc

From: Oliver Neukum
Date: Mon Dec 12 2022 - 05:19:15 EST


On 11.12.22 13:06, Johan Hovold wrote:

Due to a misunderstanding, a redundant and misleading kernel doc comment
for usb_set_intfdata() was recently added which claimed that the driver
data pointer must not be cleared during disconnect before "all actions
[are] completed", which is both imprecise and incorrect.

OK, but is that a reason to remove all kerneldoc? Kerneldoc is generally
a good thing. And if a pointer is NULLed by driver core, that will need
to be in it. IMHO you'd better just remove the questionable part of the
kerneldoc.

Regards
Oliver