Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

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

USB: usb.h: fix kernel-doc notation 



Fix usb.h kernel-doc warnings:

Warning(include/linux/usb.h:918): Excess struct/union/enum/typedef member 'nodename' description in 'usb_device_driver'
Warning(include/linux/usb.h:939): No description found for parameter 'nodename'
Warning(include/linux/usb.h:1219): No description found for parameter 'sg'
Warning(include/linux/usb.h:1219): No description found for parameter 'num_sgs'

Signed-off-by: default avatarRandy Dunlap <randy.dunlap@oracle.com>
Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@suse.de>
parent 4e19f220

include/linux/usb.h

+4 −2
Original line number Diff line number Diff line
@@ -888,8 +888,6 @@ 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.

 * @nodename: Callback to provide a naming hint for a possible

 *	device node to create.

 * @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
@@ -924,6 +922,8 @@ extern struct bus_type usb_bus_type; 
/**

 * struct usb_class_driver - identifies a USB driver that wants to use the USB major number

 * @name: the usb class device name for this driver.  Will show up in sysfs.

 * @nodename: Callback to provide a naming hint for a possible

 *	device node to create.

 * @fops: pointer to the struct file_operations of this driver.

 * @minor_base: the start of the minor range for this driver.

 *
@@ -1046,6 +1046,8 @@ typedef void (*usb_complete_t)(struct urb *); 
 *	the device driver is saying that it provided this DMA address,

 *	which the host controller driver should use in preference to the

 *	transfer_buffer.

 * @sg: scatter gather buffer list

 * @num_sgs: number of entries in the sg list

 * @transfer_buffer_length: How big is transfer_buffer.  The transfer may

 *	be broken up into chunks according to the current maximum packet

 *	size for the endpoint, which is a function of the configuration