Commit 43ff9869 authored by Randy Dunlap's avatar Randy Dunlap Committed by Greg Kroah-Hartman
Browse files

usb: fix kernel-doc warnings and formatting in <linux/usb.h> 



Fix kernel-doc warnings in <linux/usb.h>:

../include/linux/usb.h:713: warning: Function parameter or member 'use_generic_driver' not described in 'usb_device'
../include/linux/usb.h:1253: warning: Function parameter or member 'match' not described in 'usb_device_driver'
../include/linux/usb.h:1253: warning: Function parameter or member 'id_table' not described in 'usb_device_driver'

Also drop an extra blank line and fix indentation.

Fixes: 77419aa4 ("USB: Fallback to generic driver when specific driver fails")
Fixes: 88b7381a ("USB: Select better matching USB drivers when available")
Signed-off-by: default avatarRandy Dunlap <rdunlap@infradead.org>
Cc: Bastien Nocera <hadess@hadess.net>
Link: https://lore.kernel.org/r/7014bab2-268c-69f6-7ef5-57fbd45c8b08@infradead.org


Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent 06825ca0

include/linux/usb.h

+7 −3
Original line number Diff line number Diff line
@@ -621,8 +621,8 @@ struct usb3_lpm_parameters { 
 *	be manipulated by those functions, with the bandwidth_mutex is held.

 * @hub_delay: cached value consisting of:

 *	parent->hub_delay + wHubDelay + tTPTransmissionDelay (40ns)

 *

 *	Will be used as wValue for SetIsochDelay requests.

 * @use_generic_driver: ask driver core to reprobe using the generic driver.

 *

 * Notes:

 * Usbcore drivers should not set usbdev->state directly.  Instead use
@@ -1215,6 +1215,7 @@ struct usb_driver { 
 * struct usb_device_driver - identifies USB device driver to usbcore

 * @name: The driver name should be unique among USB drivers,

 *	and should normally be the same as the module name.

 * @match: If set, used for better device/driver matching.

 * @probe: Called to see if the driver is willing to manage a particular

 *	device.  If it is, probe returns zero and uses dev_set_drvdata()

 *	to associate driver-specific data with the device.  If unwilling
@@ -1227,13 +1228,16 @@ struct usb_driver { 
 * @dev_groups: Attributes attached to the device that will be created once it

 *	is bound to the driver.

 * @drvwrap: Driver-model core structure wrapper.

 * @id_table: used with @match() to select better matching driver at

 * 	probe() time.

 * @supports_autosuspend: if set to 0, the USB core will not allow autosuspend

 *	for devices bound to this driver.

 * @generic_subclass: if set to 1, the generic USB driver's probe, disconnect,

 *	resume and suspend functions will be called in addition to the driver's

 *	own, so this part of the setup does not need to be replicated.

 *

 * USB drivers must provide all the fields listed above except drvwrap.

 * USB drivers must provide all the fields listed above except drvwrap,

 * match, and id_table.

 */

struct usb_device_driver {

	const char *name;

CRA Git | Maintained and supported by SUSTech CRA and CCSE