From patchwork Tue Jul 7 10:16:30 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 11648191 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 70E8614B7 for ; Tue, 7 Jul 2020 10:22:04 +0000 (UTC) Received: from merlin.infradead.org (merlin.infradead.org [205.233.59.134]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 4A03D2065F for ; Tue, 7 Jul 2020 10:22:04 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=lists.infradead.org header.i=@lists.infradead.org header.b="EAJVEnm0"; dkim=fail reason="signature verification failed" (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b="odgYUcrj" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 4A03D2065F Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=linaro.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=merlin.20170209; h=Sender:Content-Transfer-Encoding: Content-Type:Cc:List-Subscribe:List-Help:List-Post:List-Archive: List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To:Message-Id:Date: Subject:To:From:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=5KG9UL3slb86sJRHSCDXuwLuWMeL0+st7M+ilY6RqyM=; b=EAJVEnm0WifOJBqlPG/pjK4FY HTroOhrkNqGtf90YmtcROM7+63VbermIXDlIWtAAbCEhD6JQ78Terbod9CPzA3SvcGqWZQ3Zc/eHH 9BJKxAo+4drkUcrTgCQS8X7uMwTQ72uiKNXrbV/F6fF8DU67Fd+NmDEJGbP+3xQN4kEb0SdUiAoYd qeIX297grwMtt0KLs70lMBhqFjgyfGSr8xSSJcFE6T2NiCV9RSncaO55s6vyBgJ7Z3ktKfInWZM5w 9u8eQRk/DNjMAwgU+sg8AlFOZB/AE54Al6oHtMXQLbWKszUmZhgN6iaeqTrSmO2C7mASSACLE3Zax h9yq4zk8w==; Received: from localhost ([::1] helo=merlin.infradead.org) by merlin.infradead.org with esmtp (Exim 4.92.3 #3 (Red Hat Linux)) id 1jskha-0005cq-TH; Tue, 07 Jul 2020 10:19:50 +0000 Received: from mail-wm1-x344.google.com ([2a00:1450:4864:20::344]) by merlin.infradead.org with esmtps (Exim 4.92.3 #3 (Red Hat Linux)) id 1jskez-0004Cz-26 for linux-arm-kernel@lists.infradead.org; Tue, 07 Jul 2020 10:17:12 +0000 Received: by mail-wm1-x344.google.com with SMTP id f139so45916283wmf.5 for ; Tue, 07 Jul 2020 03:17:08 -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=GCffUQZ+pBFslq04fueNayccH0ricdllCgVoeeuKMEc=; b=odgYUcrjBkWubGoKGvf/V/V80vy17B/RnX7fHgsFMRUIpPOJcrJt9dv+tXTEr3zxIH 4VsYldSNIBGB1DSkbFXTHBa0geEKra9/qralT48dvdSWtNZ7chRn9zar3CUhzrZOp7Hw zr8dgtoNbIXHH9at4ApTG7Uu7k0aeDOo2fUnOoFyAotLj2PlDySDbWPhpKQPJFvKG4lz gxmvNUMXPop7hY3KcqWMubpQ/jwBvQEy/Rxb55ZVJnbhlrqw/63qx6GNenP/HQK0xkXf 9RKzqvQVpNRpV1pdZFlvCD7F+DoL0i/coqsXs47ThIYQhKcOL4zpWvIXNMbG3+/omqZj tVKA== 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=GCffUQZ+pBFslq04fueNayccH0ricdllCgVoeeuKMEc=; b=tWknfsrtrvM6DMwAg7qOVIi7Rvz2ToD2N2A+uV0w7MchbGKFyRT7cMcaqRG2Z0iKmV t9V6RBngadGh5b7oZPbK/90NH7FujRi8udivWaeaBeVvcP8Z7lG9qG1hfzO69bG8F+Pe bs5ObwLLA5RR2OURv2u+AZFMDEZ0pP/4J7+no41kDGseC8B8J88rdyEMKTOeO1lDIfrP FrZX8FDEQtiVOKDHFl1WTU47MauFmrSJXkhnv3664gSE1NAj13TnpqLDrkZKKtomR4y/ 98/Y0Mdt/vzpXakceOLdY4romB7DeKJG3Mo/bNoFBF1cPMTfO5FRmWTYSUe7v8W/OCKg 0zqg== X-Gm-Message-State: AOAM533Kc/DOFOVELjTvI/qkBSAI1P7j9aySMxdgHxM/ADEiLK66Fv8y MBWQOGj+d/G33va6zc/JVGDlKkdBnqo= X-Google-Smtp-Source: ABdhPJwTGPinkE3kiIv2EohNfkljh6vRj8hjjmX611oqnzrxQA4XinO205+FsY+R+JHSOtM4FcmiIQ== X-Received: by 2002:a1c:2109:: with SMTP id h9mr3331083wmh.174.1594117027926; Tue, 07 Jul 2020 03:17:07 -0700 (PDT) Received: from localhost.localdomain ([2.27.35.206]) by smtp.gmail.com with ESMTPSA id z8sm469409wmg.39.2020.07.07.03.17.06 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 07 Jul 2020 03:17:07 -0700 (PDT) From: Lee Jones To: broonie@kernel.org, lgirdwood@gmail.com, perex@perex.cz, tiwai@suse.com Subject: [PATCH 16/28] ASoC: sunxi: sun4i-i2s: Demote half-documented kerneldoc header Date: Tue, 7 Jul 2020 11:16:30 +0100 Message-Id: <20200707101642.1747944-17-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200707101642.1747944-1-lee.jones@linaro.org> References: <20200707101642.1747944-1-lee.jones@linaro.org> MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20200707_061709_193377_8F84EF8E X-CRM114-Status: GOOD ( 12.76 ) X-Spam-Score: -0.2 (/) X-Spam-Report: SpamAssassin version 3.4.4 on merlin.infradead.org summary: Content analysis details: (-0.2 points) pts rule name description ---- ---------------------- -------------------------------------------------- -0.0 RCVD_IN_DNSWL_NONE RBL: Sender listed at https://www.dnswl.org/, no trust [2a00:1450:4864:20:0:0:0:344 listed in] [list.dnswl.org] -0.0 SPF_PASS SPF: sender matches SPF record 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record -0.1 DKIM_VALID Message has at least one valid DKIM or DK signature -0.1 DKIM_VALID_AU Message has a valid DKIM or DK signature from author's domain -0.1 DKIM_VALID_EF Message has a valid DKIM or DK signature from envelope-from domain 0.1 DKIM_SIGNED Message has a DKIM or DK signature, not necessarily valid X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: alsa-devel@alsa-project.org, linux-kernel@vger.kernel.org, Maxime Ripard , Andrea Venturi , Chen-Yu Tsai , Philipp Zabel , Lee Jones , linux-arm-kernel@lists.infradead.org Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org Ideally the author or someone 'in the know' should come back and provide the remainder of the documentation. Until the kerneldoc checkers have been satisfied, let's just demote the header to a standard comment block. Fixes the following W=1 kernel build warning(s): sound/soc/sunxi/sun4i-i2s.c:160: warning: Function parameter or member 'bclk_dividers' not described in 'sun4i_i2s_quirks' sound/soc/sunxi/sun4i-i2s.c:160: warning: Function parameter or member 'num_bclk_dividers' not described in 'sun4i_i2s_quirks' sound/soc/sunxi/sun4i-i2s.c:160: warning: Function parameter or member 'mclk_dividers' not described in 'sun4i_i2s_quirks' sound/soc/sunxi/sun4i-i2s.c:160: warning: Function parameter or member 'num_mclk_dividers' not described in 'sun4i_i2s_quirks' sound/soc/sunxi/sun4i-i2s.c:160: warning: Function parameter or member 'get_bclk_parent_rate' not described in 'sun4i_i2s_quirks' sound/soc/sunxi/sun4i-i2s.c:160: warning: Function parameter or member 'get_sr' not described in 'sun4i_i2s_quirks' sound/soc/sunxi/sun4i-i2s.c:160: warning: Function parameter or member 'get_wss' not described in 'sun4i_i2s_quirks' sound/soc/sunxi/sun4i-i2s.c:160: warning: Function parameter or member 'set_chan_cfg' not described in 'sun4i_i2s_quirks' sound/soc/sunxi/sun4i-i2s.c:160: warning: Function parameter or member 'set_fmt' not described in 'sun4i_i2s_quirks' Cc: Maxime Ripard Cc: Chen-Yu Tsai Cc: Philipp Zabel Cc: Andrea Venturi Signed-off-by: Lee Jones --- sound/soc/sunxi/sun4i-i2s.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sound/soc/sunxi/sun4i-i2s.c b/sound/soc/sunxi/sun4i-i2s.c index d0a8d5810c0a5..34c24e3cedc78 100644 --- a/sound/soc/sunxi/sun4i-i2s.c +++ b/sound/soc/sunxi/sun4i-i2s.c @@ -126,7 +126,7 @@ struct sun4i_i2s; -/** +/* * struct sun4i_i2s_quirks - Differences between SoC variants. * * @has_reset: SoC needs reset deasserted.