Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

usb: fotg210-udc: fix function kernel-doc comments

Correct kernel-doc comments to prevent warnings from
scripts/kernel-doc.

fotg210-udc.c:1103: warning: Function parameter or member 'g' not described in 'fotg210_vbus_session'
fotg210-udc.c:1103: warning: Excess function parameter '_gadget' description in 'fotg210_vbus_session'
fotg210-udc.c:1103: warning: No description found for return value of 'fotg210_vbus_session'
fotg210-udc.c:1129: warning: No description found for return value of 'fotg210_phy_event'

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Linus Walleij <linus.walleij@linaro.org>
Cc: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Cc: <linux-usb@vger.kernel.org>
Reviewed-by: Linus Walleij <linus.walleij@linaro.org>
Link: https://lore.kernel.org/r/20231206181335.27540-1-rdunlap@infradead.org
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

authored by

Randy Dunlap and committed by
Greg Kroah-Hartman
51920207 5cc623a4

+3 -3
+3 -3
drivers/usb/fotg210/fotg210-udc.c
··· 1094 1094 1095 1095 /** 1096 1096 * fotg210_vbus_session - Called by external transceiver to enable/disable udc 1097 - * @_gadget: usb gadget 1097 + * @g: usb gadget 1098 1098 * @is_active: 0 if should disable UDC VBUS, 1 if should enable 1099 1099 * 1100 - * Returns 0 1100 + * Returns: %0 1101 1101 */ 1102 1102 static int fotg210_vbus_session(struct usb_gadget *g, int is_active) 1103 1103 { ··· 1122 1122 * 1123 1123 * Called by the USB Phy when a cable connect or disconnect is sensed. 1124 1124 * 1125 - * Returns NOTIFY_OK or NOTIFY_DONE 1125 + * Returns: NOTIFY_OK or NOTIFY_DONE 1126 1126 */ 1127 1127 static int fotg210_phy_event(struct notifier_block *nb, unsigned long action, 1128 1128 void *data)