usb: gadget: udc: core: Document the relation between usb_ep_queue() and completion...
commit5d1332a8eabd8bd5b8c322d45542968ee6f113be
authorAlan Stern <stern@rowland.harvard.edu>
Tue, 27 Mar 2018 14:27:06 +0000 (27 10:27 -0400)
committerFelipe Balbi <felipe.balbi@linux.intel.com>
Mon, 23 Apr 2018 11:07:36 +0000 (23 14:07 +0300)
treedc27ad27ef366abe6b355bd65a1ee5b131537106
parent6d08b06e67cd117f6992c46611dfb4ce267cd71e
usb: gadget: udc: core: Document the relation between usb_ep_queue() and completion callback

Improve the kerneldoc for usb_ep_queue() to note explicitly that the
request's completion routine will be called if and only if the return
value is 0.  The corresponding fact about usb_submit_urb() for the
host-side API has long been documented, and this has always been the
intention for the gadget API.  But until now, documentation seems to
have been lacking.

Signed-off-by: Alan Stern <stern@rowland.harvard.edu>
Signed-off-by: Felipe Balbi <felipe.balbi@linux.intel.com>
drivers/usb/gadget/udc/core.c