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

Commit d187abb9 authored Aug 11, 2010 by Randy Dunlap Committed by Greg Kroah-Hartman Aug 23, 2010

USB: gadget: fix composite kernel-doc warnings

Warning(include/linux/usb/composite.h:284): No description found for parameter 'disconnect'
Warning(drivers/usb/gadget/composite.c:744): No description found for parameter 'c'
Warning(drivers/usb/gadget/composite.c:744): Excess function parameter 'cdev' description in 'usb_string_ids_n'

Signed-off-by: Randy Dunlap <randy.dunlap@oracle.com>
Cc: David Brownell <dbrownell@users.sourceforge.net>
Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>

parent 6b8f1ca5

drivers/usb/gadget/composite.c

+2 −2

Original line number	Original line	Diff line number	Diff line
	@@ -723,12 +723,12 @@ int usb_string_ids_tab(struct usb_composite_dev cdev, struct usb_string str)

	/**		/**
	* usb_string_ids_n() - allocate unused string IDs in batch		* usb_string_ids_n() - allocate unused string IDs in batch
	* @cdev: the device whose string descriptor IDs are being allocated		* @c: the device whose string descriptor IDs are being allocated
	* @n: number of string IDs to allocate		* @n: number of string IDs to allocate
	* Context: single threaded during gadget setup		* Context: single threaded during gadget setup
	*		*
	* Returns the first requested ID. This ID and next @n-1 IDs are now		* Returns the first requested ID. This ID and next @n-1 IDs are now
	* valid IDs. At least providind that @n is non zore because if it		* valid IDs. At least provided that @n is non-zero because if it
	* is, returns last requested ID which is now very useful information.		* is, returns last requested ID which is now very useful information.
	*		*
	* @usb_string_ids_n() is called from bind() callbacks to allocate		* @usb_string_ids_n() is called from bind() callbacks to allocate

include/linux/usb/composite.h

+1 −0

Original line number	Original line	Diff line number	Diff line
	@@ -247,6 +247,7 @@ int usb_add_config(struct usb_composite_dev *,
	* value; it should return zero on successful initialization.		* value; it should return zero on successful initialization.
	* @unbind: Reverses @bind(); called as a side effect of unregistering		* @unbind: Reverses @bind(); called as a side effect of unregistering
	* this driver.		* this driver.
			* @disconnect: optional driver disconnect method
	* @suspend: Notifies when the host stops sending USB traffic,		* @suspend: Notifies when the host stops sending USB traffic,
	* after function notifications		* after function notifications
	* @resume: Notifies configuration when the host restarts USB traffic,		* @resume: Notifies configuration when the host restarts USB traffic,