mirror of https://gitee.com/openkylin/linux.git
usb: host: ohci-at91: Demote kerneldoc headers down to basic comment blocks
Neither usb_hcd_at91_probe() nor usb_hcd_at91_remove()'s function headers reach the standards required of a kerneldoc entry. Only one attempt at describing an argument was made, as it is not correct (we're removing that too to save confusion). Fixes the following kernel build warning(s): drivers/usb/host/ohci-at91.c:166: warning: Function parameter or member 'driver' not described in 'usb_hcd_at91_probe' drivers/usb/host/ohci-at91.c:166: warning: Function parameter or member 'pdev' not described in 'usb_hcd_at91_probe' drivers/usb/host/ohci-at91.c:259: warning: Function parameter or member 'hcd' not described in 'usb_hcd_at91_remove' drivers/usb/host/ohci-at91.c:259: warning: Function parameter or member 'pdev' not described in 'usb_hcd_at91_remove' drivers/usb/host/ohci-at91.c:259: warning: Excess function parameter 'dev' description in 'usb_hcd_at91_remove' Cc: Alan Stern <stern@rowland.harvard.edu> Cc: Nicolas Ferre <nicolas.ferre@microchip.com> Cc: Alexandre Belloni <alexandre.belloni@bootlin.com> Cc: Ludovic Desroches <ludovic.desroches@microchip.com> Cc: Thibaut VARENE <varenet@parisc-linux.org> Signed-off-by: Lee Jones <lee.jones@linaro.org> Link: https://lore.kernel.org/r/20200702144625.2533530-21-lee.jones@linaro.org Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
This commit is contained in:
parent
048715c070
commit
f73a8db011
|
@ -153,7 +153,7 @@ static struct regmap *at91_dt_syscon_sfr(void)
|
||||||
/* always called with process context; sleeping is OK */
|
/* always called with process context; sleeping is OK */
|
||||||
|
|
||||||
|
|
||||||
/**
|
/*
|
||||||
* usb_hcd_at91_probe - initialize AT91-based HCDs
|
* usb_hcd_at91_probe - initialize AT91-based HCDs
|
||||||
* Context: !in_interrupt()
|
* Context: !in_interrupt()
|
||||||
*
|
*
|
||||||
|
@ -244,9 +244,8 @@ static int usb_hcd_at91_probe(const struct hc_driver *driver,
|
||||||
|
|
||||||
/* may be called with controller, bus, and devices active */
|
/* may be called with controller, bus, and devices active */
|
||||||
|
|
||||||
/**
|
/*
|
||||||
* usb_hcd_at91_remove - shutdown processing for AT91-based HCDs
|
* usb_hcd_at91_remove - shutdown processing for AT91-based HCDs
|
||||||
* @dev: USB Host Controller being removed
|
|
||||||
* Context: !in_interrupt()
|
* Context: !in_interrupt()
|
||||||
*
|
*
|
||||||
* Reverses the effect of usb_hcd_at91_probe(), first invoking
|
* Reverses the effect of usb_hcd_at91_probe(), first invoking
|
||||||
|
|
Loading…
Reference in New Issue