From patchwork Mon Jul 13 14:49: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: 235453 Delivered-To: patch@linaro.org Received: by 2002:a92:d244:0:0:0:0:0 with SMTP id v4csp2907303ilg; Mon, 13 Jul 2020 07:51:23 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyPjcC0A9wkUVH2iXAhKnb82eX8VZNqUz662zC3whbAlGxJ7VWNPnMzavEXnrL2xjaNOvOh X-Received: by 2002:a05:6402:2067:: with SMTP id bd7mr44526071edb.143.1594651883298; Mon, 13 Jul 2020 07:51:23 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594651883; cv=none; d=google.com; s=arc-20160816; b=gdNSEiii1kQlAG02u3rJAnDeQB+GI8t0IE9WRwLmqxvyBoPWCk1ykvoarp2lUe6EZ5 SUFIs92GmPIE80GgLTWB3IMVb6K3ue3xSyUto0lenUR4dG4ejadj6F/kxCjfpxNocldp V7RyDNWOnpcKmJHxMB8LhNv9C2ce0n+ydsVis/47e9qCojFLdOsgl4fRt2RB1mu1W15g 6Zdjr2rPedOxkIWLVcbSDulj16b8DnOuDw8fws0eVe/GaImLRc3+fdE00Foc885o3nnk 45SOM3AZGPmhjG6qQ1S/ieA0qW6Ulkjhy/6JVIsQEeT+NdZjS0A/PQ0/Hw3SZHQ771SR UeiA== 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=Xfpl3krDlT8kqZoXWzMglbVA6yEQ7zQak8/zpsxBtws=; b=XKGHuy8U5Nva+m+y207QDd2QryjY3o0Dt9uMqFGDeADzh6p7GJQpdA7uWudfaKjsBg 48A/1xR3RU3YBNHwzt7714vM1NoYioUbJx0lYo9R12q0H+FqC8qzZfKupoPtvjwkXmq9 QV53d/N3wxJooYuM0LcwbP7+evIIRopidfxKFK640XHTiyN7yHY1f/lDtHG7SsH4YaI/ drpZYNU0xB5AjDqCkQT+K/b2tubyoa1hMAMiFXzZYb8wbVXeR4KYHlygoxwbVfPG0BZ2 EXQ8qP0ZH8Eunuulh47CXNhffCXDzztIs7Wk2I3wyCjjxFbkVjjmznOWiTarwNWortoS Kq+A== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=QFwy12mD; spf=pass (google.com: domain of linux-gpio-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-gpio-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 du14si10880948ejc.721.2020.07.13.07.51.22; Mon, 13 Jul 2020 07:51:23 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-gpio-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=QFwy12mD; spf=pass (google.com: domain of linux-gpio-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-gpio-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 S1730380AbgGMOvV (ORCPT + 5 others); Mon, 13 Jul 2020 10:51:21 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:60924 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1730030AbgGMOth (ORCPT ); Mon, 13 Jul 2020 10:49:37 -0400 Received: from mail-wm1-x341.google.com (mail-wm1-x341.google.com [IPv6:2a00:1450:4864:20::341]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 84C39C061755 for ; Mon, 13 Jul 2020 07:49:37 -0700 (PDT) Received: by mail-wm1-x341.google.com with SMTP id o8so13578342wmh.4 for ; Mon, 13 Jul 2020 07:49:37 -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=Xfpl3krDlT8kqZoXWzMglbVA6yEQ7zQak8/zpsxBtws=; b=QFwy12mDhDjXsi8jVGm7MW3MzZHhi8fRtIBh763h/vU/iQIW2/e1ZjkNEqZRwTIsqI CVDQDQtRvNYzadV4mD+IQhF2tjgLdCuLoPFkjryFjF+nPggWzC0JBnNsAKpEeIzOXDXN fBc6w3f1kv0Efauvy1IP3qnvUxn9KYSk+OMgMICKfSwkIp22oX5CnpBORnfGVuGhgGPl uLTtCHN2qxiRuJPvxhRJ8RiGLDOSzQrIGXTmhwimhR2qFsDxEKYXSflgGfLyb2xInSbI qPiG9SuYlN0KdAhvKjOTrbIia8fR6wPLyfXDZTIGySrTc4wLowscvahoSUb0jdJEOErV Np+Q== 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=Xfpl3krDlT8kqZoXWzMglbVA6yEQ7zQak8/zpsxBtws=; b=MlD2a022Wvu4IeV+nLso+Lfrp8uRA3DdZzutrSRC/Dp07UONXXZ9EU4HLjYcy7TJ6A B+rOeEh22Edsjhosm8IKG0OvPIo3U39eApSve2hzf3SBONFK3uzWnDHO6v6U9zIwk2KD 7iwrAYZ1EXb3wkGgfFwFpS19a46oxWDeDau/OKtfOxow49G67FKBT8mIy0SDW/aDY/pm WmGJggGFT3PZO0N6DwanGLmEx8cPuN6nwXFG/Cfl6bsk71pa0EYo9qT4DAC76MGHqBd1 i7+A+EqswjHY3y6J0kPsLRGvXhAuYI/atOiS+jFL4QEcA6/R5ow7CJSBbmHB1WHgji0g J5kQ== X-Gm-Message-State: AOAM5304Avn/Fy8XPZEGUzuljqkD3l+BplLWf9AEk38QcxEsvkrRqzFX oz6Omkoox2UrN4itHUy1KSXi3g== X-Received: by 2002:a1c:7fd7:: with SMTP id a206mr319860wmd.104.1594651776266; Mon, 13 Jul 2020 07:49:36 -0700 (PDT) Received: from localhost.localdomain ([2.31.163.6]) by smtp.gmail.com with ESMTPSA id o29sm26207756wra.5.2020.07.13.07.49.35 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 13 Jul 2020 07:49:35 -0700 (PDT) From: Lee Jones To: linus.walleij@linaro.org Cc: linux-kernel@vger.kernel.org, linux-gpio@vger.kernel.org, Lee Jones , Florian Fainelli , Ray Jui , Scott Branden , bcm-kernel-feedback-list@broadcom.com, YueHaibing Subject: [PATCH 03/25] pinctrl: bcm: pinctrl-bcm281xx: Demote obvious misuse of kerneldoc to standard comment blocks Date: Mon, 13 Jul 2020 15:49:08 +0100 Message-Id: <20200713144930.1034632-4-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713144930.1034632-1-lee.jones@linaro.org> References: <20200713144930.1034632-1-lee.jones@linaro.org> MIME-Version: 1.0 Sender: linux-gpio-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-gpio@vger.kernel.org There has been little to no attempt to document any of the demoted structures here. These are obviously not kerneldoc headers. Fixes the following W=1 kernel build warning(s): drivers/pinctrl/bcm/pinctrl-bcm281xx.c:65: warning: cannot understand function prototype: 'enum bcm281xx_pin_type ' drivers/pinctrl/bcm/pinctrl-bcm281xx.c:79: warning: cannot understand function prototype: 'struct bcm281xx_pin_function ' drivers/pinctrl/bcm/pinctrl-bcm281xx.c:89: warning: cannot understand function prototype: 'struct bcm281xx_pinctrl_data ' Cc: Florian Fainelli Cc: Ray Jui Cc: Scott Branden Cc: bcm-kernel-feedback-list@broadcom.com Cc: YueHaibing Signed-off-by: Lee Jones --- drivers/pinctrl/bcm/pinctrl-bcm281xx.c | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) -- 2.25.1 Acked-by: Scott Branden diff --git a/drivers/pinctrl/bcm/pinctrl-bcm281xx.c b/drivers/pinctrl/bcm/pinctrl-bcm281xx.c index 71e6661783006..9ab1f427286a7 100644 --- a/drivers/pinctrl/bcm/pinctrl-bcm281xx.c +++ b/drivers/pinctrl/bcm/pinctrl-bcm281xx.c @@ -59,7 +59,7 @@ #define BCM281XX_HDMI_PIN_REG_MODE_MASK 0x0010 #define BCM281XX_HDMI_PIN_REG_MODE_SHIFT 4 -/** +/* * bcm281xx_pin_type - types of pin register */ enum bcm281xx_pin_type { @@ -73,7 +73,7 @@ static enum bcm281xx_pin_type std_pin = BCM281XX_PIN_TYPE_STD; static enum bcm281xx_pin_type i2c_pin = BCM281XX_PIN_TYPE_I2C; static enum bcm281xx_pin_type hdmi_pin = BCM281XX_PIN_TYPE_HDMI; -/** +/* * bcm281xx_pin_function- define pin function */ struct bcm281xx_pin_function { @@ -82,7 +82,7 @@ struct bcm281xx_pin_function { const unsigned ngroups; }; -/** +/* * bcm281xx_pinctrl_data - Broadcom-specific pinctrl data * @reg_base - base of pinctrl registers */