Commit cbdc0f54 authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab Committed by Greg Kroah-Hartman
Browse files

usb: fix kernel-doc markups 



There is a common comment marked, instead, with kernel-doc
notation.

Also, some identifiers have different names between their
prototypes and the kernel-doc markup.

Signed-off-by: default avatarMauro Carvalho Chehab <mchehab+huawei@kernel.org>
Acked-by: default avatarFelipe Balbi <balbi@kernel.org>
Link: https://lore.kernel.org/r/0b964be3884def04fcd20ea5c12cb90d0014871c.1603469755.git.mchehab+huawei@kernel.org


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

drivers/usb/dwc3/core.c

+1 −1
Original line number Diff line number Diff line 
// SPDX-License-Identifier: GPL-2.0

/**

/*

 * core.c - DesignWare USB3 DRD Controller Core file

 *

 * Copyright (C) 2010-2011 Texas Instruments Incorporated - https://www.ti.com

drivers/usb/dwc3/core.h

+1 −1
Original line number Diff line number Diff line
@@ -1277,7 +1277,7 @@ struct dwc3_event_type { 
#define DWC3_DEPEVT_EPCMDCMPLT		0x07



/**

 * struct dwc3_event_depvt - Device Endpoint Events

 * struct dwc3_event_depevt - Device Endpoint Events

 * @one_bit: indicates this is an endpoint event (not used)

 * @endpoint_number: number of the endpoint

 * @endpoint_event: The event we have:

drivers/usb/gadget/composite.c

+1 −1
Original line number Diff line number Diff line
@@ -1245,7 +1245,7 @@ int usb_string_id(struct usb_composite_dev *cdev) 
EXPORT_SYMBOL_GPL(usb_string_id);



/**

 * usb_string_ids() - allocate unused string IDs in batch

 * usb_string_ids_tab() - allocate unused string IDs in batch

 * @cdev: the device whose string descriptor IDs are being allocated

 * @str: an array of usb_string objects to assign numbers to

 * Context: single threaded during gadget setup

drivers/usb/typec/mux.c

+1 −1
Original line number Diff line number Diff line
@@ -71,7 +71,7 @@ struct typec_switch *fwnode_typec_switch_get(struct fwnode_handle *fwnode) 
EXPORT_SYMBOL_GPL(fwnode_typec_switch_get);



/**

 * typec_put_switch - Release USB Type-C orientation switch

 * typec_switch_put - Release USB Type-C orientation switch

 * @sw: USB Type-C orientation switch

 *

 * Decrement reference count for @sw.

include/linux/usb/composite.h

+1 −1
Original line number Diff line number Diff line
@@ -437,7 +437,7 @@ static inline struct usb_composite_driver *to_cdriver( 
#define OS_STRING_IDX			0xEE



/**

 * struct usb_composite_device - represents one composite usb gadget

 * struct usb_composite_dev - represents one composite usb gadget

 * @gadget: read-only, abstracts the gadget's usb peripheral controller

 * @req: used for control responses; buffer is pre-allocated

 * @os_desc_req: used for OS descriptors responses; buffer is pre-allocated

CRA Git | Maintained and supported by SUSTech CRA and CCSE