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=-15.5 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER, INCLUDES_PATCH,MAILING_LIST_MULTI,NICE_REPLY_A,SPF_HELO_NONE,SPF_PASS, URIBL_BLOCKED,USER_AGENT_SANE_1 autolearn=ham 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 3F27BC433DB for ; Sun, 14 Mar 2021 16:19:06 +0000 (UTC) Received: from desiato.infradead.org (desiato.infradead.org [90.155.92.199]) (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 CC69561574 for ; Sun, 14 Mar 2021 16:19:05 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org CC69561574 Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.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=desiato.20200630; h=Sender:Content-Transfer-Encoding :Content-Type:List-Subscribe:List-Help:List-Post:List-Archive: List-Unsubscribe:List-Id:In-Reply-To:MIME-Version:Date:Message-ID:From: References:Cc:To:Subject:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=Gxue6vATsgFMxq0tlcUVFimjbd4oTkTkwtHjYXeaAQQ=; b=Y0qAXDLJTdpmfbIN+5aEo6kDF 9tek1Cq4q+plRYqm0P64C4CHiSfZFFl3E+3N/oV0usuoH0a7BjiebPxdzyoPSe56AfF4Bte7I2gxR XFsU+Ekg7l5iAzSv5InlxYU2IYLEIBbUUOKp087yiemvzX+rmh2w1hqnf6BmuB+Ta4rhZehhiG2I9 3O/Zjt5xxibqQRy3AlTP3p2UjU7L22fssg+NC2iTzCvD6otmidJE6gYfC7NPH05Wk/NpuhWgFagxy xQ4sw0KnCGu4XpnqJ53s0flC9VYPoEXuzwXTZ2ulF8D7lDzSLTIRF22jg91Jjo3T9OlbC5g4qtctk 5p/RZktmg==; Received: from localhost ([::1] helo=desiato.infradead.org) by desiato.infradead.org with esmtp (Exim 4.94 #2 (Red Hat Linux)) id 1lLTQl-00EKRY-Ju; Sun, 14 Mar 2021 16:17:27 +0000 Received: from merlin.infradead.org ([2001:8b0:10b:1234::107]) by desiato.infradead.org with esmtps (Exim 4.94 #2 (Red Hat Linux)) id 1lLTQi-00EKRR-An for linux-arm-kernel@lists.infradead.org; Sun, 14 Mar 2021 16:17:24 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=merlin.20170209; h=Content-Transfer-Encoding:Content-Type: In-Reply-To:MIME-Version:Date:Message-ID:From:References:Cc:To:Subject:Sender :Reply-To:Content-ID:Content-Description; bh=h3oKT2DIWMi/3UOnem0PmyfrJuvNhkM34vsZ5Qcbs8I=; b=aaJt/VQm3LY5XSCT8IZoqz6Dfu RHGD6IcX8kOz4lYEBQzKW4vqCWhl54QfBJZc9YSopxtB289Mz+vP4k/TtDE7uKtCSOpaamIDgWdl4 J3H9wB23k/bWDyfxP7ATLI6a2NWh+nr14Fsm51QhmRLKaXavPYq9c7JFOuflxxb+e9H+sjk9GmEpQ iJCDlH2ynfGFS5JMDOP3i3E/sIipk5T9KcQr7AC9Z2PwsYKjQMgdIYnxXAzYthOStEnVY5MWCPmM8 XySCxYCSylV8VdUCjv0wf8OaEiaimRs/D9Hx8sj6U5xD7XqIupipP+irq5s+uUddNVb0unAyV7Vcb DbiHgJOQ==; Received: from [2601:1c0:6280:3f0::9757] by merlin.infradead.org with esmtpsa (Exim 4.94 #2 (Red Hat Linux)) id 1lLTQf-001DPd-Ni; Sun, 14 Mar 2021 16:17:22 +0000 Subject: Re: [PATCH] soc: fsl: guts: fix comment syntax in file To: Aditya Srivastava , leoyang.li@nxp.com Cc: lukas.bulwahn@gmail.com, linux-kernel-mentees@lists.linuxfoundation.org, linuxppc-dev@lists.ozlabs.org, linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org References: <20210314072828.9270-1-yashsri421@gmail.com> From: Randy Dunlap Message-ID: <1cab34f0-dcd1-b8ff-6bab-38ff9adc94b5@infradead.org> Date: Sun, 14 Mar 2021 09:17:17 -0700 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.8.0 MIME-Version: 1.0 In-Reply-To: <20210314072828.9270-1-yashsri421@gmail.com> Content-Language: en-US X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org On 3/13/21 11:28 PM, Aditya Srivastava wrote: > The opening comment mark '/**' is used for kernel-doc comments. > There are certain comments in include/linux/fsl/guts.h which follows this > syntax, but the content inside does not comply with kernel-doc. > > E.g., opening comment for "Freecale 85xx and 86xx Global Utilties > register set" follows kernel-doc syntax(i.e., '/**'), but the content > inside does not comply with any kernel-doc specification (function, > struct, etc). > > This causes unwelcomed warning from kernel-doc: > "warning: expecting prototype for Freecale 85xx and 86xx Global Utilties register set(). Prototype was for __FSL_GUTS_H__() instead" > > Replace all such comment occurrences with general comment format, > i.e. '/*' to pervent kernel-doc from parsing these. > > Signed-off-by: Aditya Srivastava Reviewed-by: Randy Dunlap Thanks. > --- > * Applies perfectly on next-20210312 > > include/linux/fsl/guts.h | 4 ++-- > 1 file changed, 2 insertions(+), 2 deletions(-) > > diff --git a/include/linux/fsl/guts.h b/include/linux/fsl/guts.h > index 0ac27b233f12..fdb55ca47a4f 100644 > --- a/include/linux/fsl/guts.h > +++ b/include/linux/fsl/guts.h > @@ -1,5 +1,5 @@ > /* SPDX-License-Identifier: GPL-2.0-or-later */ > -/** > +/* > * Freecale 85xx and 86xx Global Utilties register set > * > * Authors: Jeff Brown > @@ -14,7 +14,7 @@ > #include > #include > > -/** > +/* > * Global Utility Registers. > * > * Not all registers defined in this structure are available on all chips, so > -- ~Randy _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel