Received: by 2002:a05:6a10:6744:0:0:0:0 with SMTP id w4csp812826pxu; Fri, 23 Oct 2020 14:01:40 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyAX8vHji4s1f4Yd2grG8ty6eKpYsfCGleXgAkA09hyEIDYVAqn6YzLB5rx1aBaC+9IYUIP X-Received: by 2002:a17:906:fad8:: with SMTP id lu24mr3813293ejb.486.1603486900618; Fri, 23 Oct 2020 14:01:40 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1603486900; cv=none; d=google.com; s=arc-20160816; b=rteNCIiiRyrSAHVvSfz2ZwBZAx0cv3YN+rbg+tIMl0NuSKYHwXFe4oz5B1ytW3pBo2 9mpfwxviZmVVymJvJMSWET+lTBv3mzkrCoKDZe1+5XJNDJTAE8H2gXBThQtFxsGu1dAy Tp4il3CwQFmvLnli9hTak9pmHZk0hcQd2IhdAsZIRx9G7eYPgdrKhVNcMBxeG1O0cWjh jWLT4YMcnX9hBQUgyGANL3eE70qFFtZlpZl+ONiUhUfaJMDkKUdptV0yDYHKcz7Nfv91 +GgNdDYGnhgt/ITAsBcmX6UVp0G1CnSFYKOcVUv1yaH1L7cupV/53TRUiKe/ONErC1UB KKQw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=5Psf4nw+tLQlD+/Y+VNMzrsW4VBZMoFaQYuvNGY7tLg=; b=ZLN4fimSGaNT5F9+HNb9rCKiRVYwK9DDEsqbIxv06iUTv1GWaKXi8XUdMSdMk8s7BK KjuO2zCtHS1ejmhJ2Kpf1hHHIwhYs9Z09W+lyKWlA2CtYEBwZ2JoYYiZtdcfxz+7nXx1 dz6E6dX6O83n9UZwzQZrHrToOnoIEytm+qyQoYSgd5Ufm8FTC0LECmLqOyHykvcBWS9U sSL65YSUFp0ORYBljvNJDEM1X2Mj/rCA+CliyV7sYxDb0J1iNQ5fmojkuzMlaLUZ1TaR 3SU1plFc2m2iynKxbusEzs0MoDQIPFE8FpFneoxM9r/6uoiXTj6gd8sF3mHO356G8KP9 fvlw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=ACDS0rg2; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id p25si1846771ejc.412.2020.10.23.14.01.18; Fri, 23 Oct 2020 14:01:40 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=ACDS0rg2; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751434AbgJWQhN (ORCPT + 99 others); Fri, 23 Oct 2020 12:37:13 -0400 Received: from mail.kernel.org ([198.145.29.99]:33724 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751842AbgJWQdu (ORCPT ); Fri, 23 Oct 2020 12:33:50 -0400 Received: from mail.kernel.org (ip5f5ad5a3.dynamic.kabel-deutschland.de [95.90.213.163]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 33495246A9; Fri, 23 Oct 2020 16:33:48 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1603470828; bh=Hv3Ehg3kTw6mL0c8DIamVwpl0TjhhlhRQyeLYyTHoe0=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=ACDS0rg2ZzKVKSkkIt/nbSZC2aXVth9Lg6KXYJ80ULPC4mmNTxgIrDQCKgpeZT/AB zCb4Nk3UoukNIGd2TE52FlCojs+I+tL0fziMX4NdqZvtpRwj4BftFdlBegQWnaoWd+ r3yy5e7f7LEjxE+J/Wg9vK0Y4y0uQMDH6fSZMzhQ= Received: from mchehab by mail.kernel.org with local (Exim 4.94) (envelope-from ) id 1kW00g-002Awk-3i; Fri, 23 Oct 2020 18:33:46 +0200 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Jonathan Corbet" , Felipe Balbi , Greg Kroah-Hartman , Heikki Krogerus , linux-kernel@vger.kernel.org, linux-usb@vger.kernel.org Subject: [PATCH v3 31/56] usb: dwc3: fix kernel-doc markups Date: Fri, 23 Oct 2020 18:33:18 +0200 Message-Id: <0b964be3884def04fcd20ea5c12cb90d0014871c.1603469755.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.26.2 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Sender: Mauro Carvalho Chehab Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org 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: Mauro Carvalho Chehab --- drivers/usb/dwc3/core.c | 2 +- drivers/usb/dwc3/core.h | 2 +- drivers/usb/gadget/composite.c | 2 +- drivers/usb/typec/mux.c | 2 +- include/linux/usb/composite.h | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/drivers/usb/dwc3/core.c b/drivers/usb/dwc3/core.c index bdf0925da6b6..841daec70b6e 100644 --- a/drivers/usb/dwc3/core.c +++ b/drivers/usb/dwc3/core.c @@ -1,5 +1,5 @@ // 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 diff --git a/drivers/usb/dwc3/core.h b/drivers/usb/dwc3/core.h index 74323b10a64a..2f95f08ca511 100644 --- a/drivers/usb/dwc3/core.h +++ b/drivers/usb/dwc3/core.h @@ -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: diff --git a/drivers/usb/gadget/composite.c b/drivers/usb/gadget/composite.c index 05b176c82cc5..c6d455f2bb92 100644 --- a/drivers/usb/gadget/composite.c +++ b/drivers/usb/gadget/composite.c @@ -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 diff --git a/drivers/usb/typec/mux.c b/drivers/usb/typec/mux.c index b069a5122aaa..cf720e944aaa 100644 --- a/drivers/usb/typec/mux.c +++ b/drivers/usb/typec/mux.c @@ -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. diff --git a/include/linux/usb/composite.h b/include/linux/usb/composite.h index 2040696d75b6..a2d229ab63ba 100644 --- a/include/linux/usb/composite.h +++ b/include/linux/usb/composite.h @@ -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 -- 2.26.2