From patchwork Thu Jul 2 14:46:08 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 192266 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp1511434ilg; Thu, 2 Jul 2020 07:48:50 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxLLaXWz7bsGeLv/yAD2/MOfdg/ZUChmVKCY+vZ2tHTo0mk8CQOycUkJC68CvRBzuBrZjZP X-Received: by 2002:a05:6402:13d0:: with SMTP id a16mr35131555edx.269.1593701330404; Thu, 02 Jul 2020 07:48:50 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1593701330; cv=none; d=google.com; s=arc-20160816; b=YI9TMRvTt8sFhLLdPQYwfcZoNJDQ42+LiPOWIQL+vjZj5V3ywTHvXfdXKvRw6VsntU H9MfNGg16ZDgl9Se6zmAu7Rm7Y/CbPxqZ0y7217Ncsn4V5JelTDRLm2OpgeOlveQjTwD HXQKVmeXygKcby7cxJBGfZT3hq2gFDqUZCiwjO9XGkZRaB7xBQds2TlfcRkce5wmwPZ9 A3x4Oaho0pDTeytQVw9Sbr2eNdUM9x+nCgwJhgPWh74h1/g2r5GGi/AP8bbECmIaCWNB 3PMRtrPs7Y3c+L4ctjOz5092iZ65nvdRpnpvIL5V2Y4VX3vZ3SXcqsfZb2WFVQFmxDxY eCow== 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=A68m/4vXtRoEt+tCUl/deoA+S6NQ0dzD0za0e2IsKFc=; b=o3lHxdzmc8FHoscdOxluy3ytUqadyD4p8LPXuoouRXCR+yE/I35Dwl2dVNSxMnQ8G6 hFMklUzrLBL/lDN/A+Hv+7L//rdSQt4wNyl67fk7g+kzjuErQsSE7SwR59jgJMiUR1+h 1TNBAXz34/Fx3e/JtT3OJM1ONAVUojznD+VHzCGT/iWuBtnXpM5/U4SAxCO11v6BkuDB aAV/wPXbKHAuqhrGEHCt/FNM8EiSbAI2GnZ7PlJjvvN2/1jVk/wYgusS0GgRn0XNDRh3 Kkey8SbeGLXuiSLMhTk7I0KnI+fg7O4sHI2W3M1VD9nfFV+iwhrb31Z5XEiH9fxkfyZ3 rdCA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=MnIF3NKM; spf=pass (google.com: domain of linux-usb-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-usb-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id g1si6121099ejd.517.2020.07.02.07.48.50; Thu, 02 Jul 2020 07:48:50 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-usb-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=@linaro.org header.s=google header.b=MnIF3NKM; spf=pass (google.com: domain of linux-usb-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-usb-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1730275AbgGBOso (ORCPT + 5 others); Thu, 2 Jul 2020 10:48:44 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50208 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729996AbgGBOqu (ORCPT ); Thu, 2 Jul 2020 10:46:50 -0400 Received: from mail-wm1-x344.google.com (mail-wm1-x344.google.com [IPv6:2a00:1450:4864:20::344]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 830C4C08C5DF for ; Thu, 2 Jul 2020 07:46:49 -0700 (PDT) Received: by mail-wm1-x344.google.com with SMTP id o8so27099009wmh.4 for ; Thu, 02 Jul 2020 07:46:49 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=A68m/4vXtRoEt+tCUl/deoA+S6NQ0dzD0za0e2IsKFc=; b=MnIF3NKMeHllD9bTiFG/UBWre8WcWJwn5Gs+iOqWaPWWVSs3Fmue2tnex/eI8nRqPE XQauSD7JfNVMRzo5iKgnr8oq0f8dcrGaXVQgT+wgmvxBBPLfRQpEcxBSpsifs7sxW9TI y7LrKuy/z5fGS7KaetA8KIHoBZ1xNWSKfbioR04TI5jOLFjaaMAUV6foseYp2OYdkRM4 1Z0jBQW5Nt733Tztd5Mv871YZPC7G+E2gk7GlaK964bTvoaRTTMT0v5Op/LxtOUhhyPI eeWnTopVRGYVBugAlMM1Yaopc5tKTEPkusEWAxPsCNUFafsAbuPDdUnPwlEpVSXqMaMZ sQYA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=A68m/4vXtRoEt+tCUl/deoA+S6NQ0dzD0za0e2IsKFc=; b=UUZZWhB1LM++Jg95d0MYKfy+EnJfNy9tgFKW/alTEp5cfRgnZf9n89r5qff1AHKdy3 2HTvtcxzszJiXOxfygT5aFGabbN6h8y5rmzSjh6xKAuFbmWKOUxM2X1SQ5mVCF90p0Rh lrfwWkgKnsvbwAuxpIIBDB34o8teKKuO8RMTqKn1Vh6kAJbfEdq1eAcsx5BkSs7e+25j SxFrtQMu/qIYbK0VuaX+oAq4xd+fiGmxuNVwWP/jDSIdaSQaTeQTLyn3kLQf4QfOx2aj Cmq1aBT8N30DH5KTrHV18n0QAayGTD4EwYOo4WP46C2VmC7SV2xFHCaWUvoDn12Xr/7e e9Og== X-Gm-Message-State: AOAM533yf1X0NqbCtJZJHB++b0ZdUoeHMnuZEt0Qurb4iWn2Qkvpu9jr n1rNaxa8GEgT/crMiWsTnw3YeA== X-Received: by 2002:a7b:c5c7:: with SMTP id n7mr32283737wmk.77.1593701208260; Thu, 02 Jul 2020 07:46:48 -0700 (PDT) Received: from localhost.localdomain ([2.27.35.144]) by smtp.gmail.com with ESMTPSA id g14sm7002737wrw.83.2020.07.02.07.46.47 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 02 Jul 2020 07:46:47 -0700 (PDT) From: Lee Jones To: gregkh@linuxfoundation.org Cc: linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, linux-usb@vger.kernel.org, Lee Jones , Pawel Laszczak , Peter Chen , Roger Quadros Subject: [PATCH 13/30] usb: cdns3: core: Fix incorrect formatting and misspelled function arg docs Date: Thu, 2 Jul 2020 15:46:08 +0100 Message-Id: <20200702144625.2533530-14-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200702144625.2533530-1-lee.jones@linaro.org> References: <20200702144625.2533530-1-lee.jones@linaro.org> MIME-Version: 1.0 Sender: linux-usb-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-usb@vger.kernel.org There are 3 misspellings and 1 incorrect format used in this file's kerneldoc function headers. Fixing them squashes the following W=1 kernel build warnings: drivers/usb/cdns3/gadget.c:653: warning: Function parameter or member 'priv_ep' not described in 'cdns3_wa2_descmissing_packet' drivers/usb/cdns3/gadget.c:653: warning: Excess function parameter 'priv_dev' description in 'cdns3_wa2_descmissing_packet' drivers/usb/cdns3/gadget.c:1088: warning: Function parameter or member 'request' not described in 'cdns3_ep_run_transfer' drivers/usb/cdns3/gadget.c:2574: warning: Function parameter or member 'priv_ep' not described in '__cdns3_gadget_ep_set_halt' drivers/usb/cdns3/gadget.c:2574: warning: Excess function parameter 'ep' description in '__cdns3_gadget_ep_set_halt' drivers/usb/cdns3/gadget.c:2595: warning: Function parameter or member 'priv_ep' not described in '__cdns3_gadget_ep_clear_halt' drivers/usb/cdns3/gadget.c:2595: warning: Excess function parameter 'ep' description in '__cdns3_gadget_ep_clear_halt' drivers/usb/cdns3/gadget.c:2898: warning: Function parameter or member 'priv_dev' not described in 'cdns3_init_eps' drivers/usb/cdns3/gadget.c:2898: warning: Excess function parameter 'cdns3' description in 'cdns3_init_eps' drivers/usb/cdns3/gadget.c:3210: warning: Function parameter or member 'cdns' not described in 'cdns3_gadget_init' Cc: Pawel Laszczak Cc: Peter Chen Cc: Roger Quadros Signed-off-by: Lee Jones --- drivers/usb/cdns3/core.c | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) -- 2.25.1 diff --git a/drivers/usb/cdns3/core.c b/drivers/usb/cdns3/core.c index 19bbb5b7e6b6c..59e5e213a99bb 100644 --- a/drivers/usb/cdns3/core.c +++ b/drivers/usb/cdns3/core.c @@ -282,7 +282,7 @@ static int cdns3_idle_init(struct cdns3 *cdns) /** * cdns3_hw_role_switch - switch roles based on HW state - * @cdns3: controller + * @cdns: controller */ int cdns3_hw_role_switch(struct cdns3 *cdns) { @@ -320,7 +320,7 @@ int cdns3_hw_role_switch(struct cdns3 *cdns) /** * cdsn3_role_get - get current role of controller. * - * @dev: Pointer to device structure + * @sw: pointer to USB role switch structure * * Returns role */ @@ -334,8 +334,8 @@ static enum usb_role cdns3_role_get(struct usb_role_switch *sw) /** * cdns3_role_set - set current role of controller. * - * @dev: pointer to device object - * @role - the previous role + * @sw: pointer to USB role switch structure + * @role: the previous role * Handles below events: * - Role switch for dual-role devices * - USB_ROLE_GADGET <--> USB_ROLE_NONE for peripheral-only devices