From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-2.5 required=3.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED, DKIM_VALID,MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,USER_AGENT_SANE_1 autolearn=no autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id BAEE4C433DF for ; Wed, 8 Jul 2020 08:41:08 +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 877CB221EE for ; Wed, 8 Jul 2020 08:41:08 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=lists.infradead.org header.i=@lists.infradead.org header.b="EJPRHEeh"; dkim=fail reason="signature verification failed" (1024-bit key) header.d=kernel.org header.i=@kernel.org header.b="Bkd31+YW" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 877CB221EE Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=kernel.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-arm-kernel-bounces+linux-arm-kernel=archiver.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-Type: Content-Transfer-Encoding:Cc:List-Subscribe:List-Help:List-Post:List-Archive: List-Unsubscribe:List-Id:In-Reply-To:MIME-Version:Date:Message-ID:From: References:To:Subject:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=vFdm7HY5NNuPCT8Zhqla2BgA+zSKE6r9MvLptdjLrwI=; b=EJPRHEehoHxI/W27KHzmSYlA5 PsG39nmreqZGiEUYgVR4SUY4gqqTAp4jt3GvdRrRFxNBgSGfY7kwfBN0TlkUm3K3Paojwg3flQUno u1U6u2fDBtZLdk0j5NYlvFJMeoJs4bhJuYlCK6uCIVLnBcMIr/QaBasBR7p9B3IKBDeohvB5g88cR nK1NtB9zr5U/kwwYfjktWmKqekacLi6fHGNTkd5rp7zNlXWfqnbgntDvI3KGSX3JZJsrLunYSsyBK 89sUMuZndH2hVcdBnHlKIpRkTxH0Jg7p33pa+Bb1XtYJObsCas5OAqr8ouQGYgcH99m/OdTvVacDU vM9FLmDQA==; Received: from localhost ([::1] helo=merlin.infradead.org) by merlin.infradead.org with esmtp (Exim 4.92.3 #3 (Red Hat Linux)) id 1jt5cA-00044m-T0; Wed, 08 Jul 2020 08:39:38 +0000 Received: from mail.kernel.org ([198.145.29.99]) by merlin.infradead.org with esmtps (Exim 4.92.3 #3 (Red Hat Linux)) id 1jt5c8-00043o-RS for linux-arm-kernel@lists.infradead.org; Wed, 08 Jul 2020 08:39:37 +0000 Received: from [192.168.0.50] (89-70-52-201.dynamic.chello.pl [89.70.52.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 4AF3F21D6C; Wed, 8 Jul 2020 08:39:33 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1594197575; bh=8v00HsesZ/yoYMitcpoPiDdEOdjfr31bHEWutYYi8K0=; h=Subject:To:Cc:References:From:Date:In-Reply-To:From; b=Bkd31+YWVBIlAFY4FlWJxPEhsQ74gF6+5bz7FTW7rX6YdEmb7DOxScpZ5fpCpQyR5 4s7TLJiKrCIYiIl0/s+h/eSDg7AEuK5/U2Pe9B2wLCASLFFZZfFp0Q5d2OncsmdpLN t3qnU58t3IRftZ6jTGHtfFcZ0tg529c6Y1AF6S48= Subject: Re: [PATCH v2 14/28] ASoC: samsung: pcm: Demote half-documented kerneldoc header To: Lee Jones , broonie@kernel.org, lgirdwood@gmail.com, perex@perex.cz, tiwai@suse.com References: <20200707143742.2959960-1-lee.jones@linaro.org> <20200707143742.2959960-15-lee.jones@linaro.org> From: Sylwester Nawrocki Message-ID: Date: Wed, 8 Jul 2020 10:39:30 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.8.0 MIME-Version: 1.0 In-Reply-To: <20200707143742.2959960-15-lee.jones@linaro.org> Content-Language: en-US X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20200708_043936_995497_3BF662DA X-CRM114-Status: GOOD ( 13.08 ) 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, Sangbeom Kim , Jaswinder Singh , linux-kernel@vger.kernel.org, Krzysztof Kozlowski , Sylwester Nawrocki , linux-arm-kernel@lists.infradead.org Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="us-ascii"; Format="flowed" Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org On 7/7/20 16:37, Lee Jones wrote: > 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. Thanks for the patch Lee, Pierre-Luis Bossart has already corrected the documentation by adding missing entries in patch: [PATCH v3 03/13] ASoC: samsung: pcm: fix kernel-doc > Fixes the following W=1 kernel build warning(s): > > sound/soc/samsung/pcm.c:127: warning: Function parameter or member 'lock' not described in 's3c_pcm_info' > sound/soc/samsung/pcm.c:127: warning: Function parameter or member 'sclk_per_fs' not described in 's3c_pcm_info' > sound/soc/samsung/pcm.c:127: warning: Function parameter or member 'idleclk' not described in 's3c_pcm_info' > sound/soc/samsung/pcm.c:127: warning: Function parameter or member 'pclk' not described in 's3c_pcm_info' > sound/soc/samsung/pcm.c:127: warning: Function parameter or member 'cclk' not described in 's3c_pcm_info' -- Regards, Sylwester _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel