From: Johan Hovold Date: Fri, 24 Mar 2017 15:25:34 +0000 (+0100) Subject: USB: core: fix up kerneldoc comment X-Git-Tag: v4.14-rc1~993^2~65 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=2e58cafa0bbde529a9f44300382f60f6ce46d7d2;p=platform%2Fkernel%2Flinux-rpi.git USB: core: fix up kerneldoc comment Make the kerneldoc comment for usb_find_common_endpoints_reverse() self-contained by adding a full description and removing the reference to usb_find_common_endpoints(). Reported-by: kbuild test robot Signed-off-by: Johan Hovold Signed-off-by: Greg Kroah-Hartman --- diff --git a/drivers/usb/core/usb.c b/drivers/usb/core/usb.c index 1ec9d24..28b053c 100644 --- a/drivers/usb/core/usb.c +++ b/drivers/usb/core/usb.c @@ -165,9 +165,20 @@ EXPORT_SYMBOL_GPL(usb_find_common_endpoints); /** * usb_find_common_endpoints_reverse() -- look up common endpoint descriptors + * @alt: alternate setting to search + * @bulk_in: pointer to descriptor pointer, or NULL + * @bulk_out: pointer to descriptor pointer, or NULL + * @int_in: pointer to descriptor pointer, or NULL + * @int_out: pointer to descriptor pointer, or NULL + * + * Search the alternate setting's endpoint descriptors for the last bulk-in, + * bulk-out, interrupt-in and interrupt-out endpoints and return them in the + * provided pointers (unless they are NULL). + * + * If a requested endpoint is not found, the corresponding pointer is set to + * NULL. * - * Same as usb_find_common_endpoints(), but the endpoint descriptors are - * searched in reverse order (see usb_find_common_endpoints() for details). + * Return: Zero if all requested descriptors were found, or -ENXIO otherwise. */ int usb_find_common_endpoints_reverse(struct usb_host_interface *alt, struct usb_endpoint_descriptor **bulk_in,