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 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id AD77CC433F5 for ; Tue, 5 Apr 2022 14:12:17 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:In-Reply-To:MIME-Version:References: Message-ID:Subject:Cc:To:From:Date:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=cdttJJcuJty1yxb6n6zrnYM8afe8n2MxM9bJIRHppn8=; b=LPdLPGr++8SfkB Hyo9vzO8PaQm0kVoT4Ye1Nzt+KN8rqvMP/HDXh8gGOEb/y0yCjUtN7AXvdRXwe8/pNyVm7w/+UyHQ U9zI0oGNUb7w4lTpoTQ9sTI9YjtHlqcsl7wClRbnyBOcToHHS8YydshXeB7Ww4/eUyuytf4mZ+WTB 07HtRO1I+eGHgripWkUhKybEZTwtA7H2TTmlIoqpvvq6M7esLSc/1ZxC0u9Au1E6ZzuDM4TcCVEkH CLvm0wcpR0l1qoF5E8a4w8DKDPLY3KRSZm22NnwvhtrwwTyngLQClOdKoiplHoLze8yPPAzLEbk6g V3qMrCz1gs2Ih/vuWlRw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1nbjtg-001MLa-UG; Tue, 05 Apr 2022 14:11:05 +0000 Received: from foss.arm.com ([217.140.110.172]) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1nbjqs-001Khn-CE for linux-arm-kernel@lists.infradead.org; Tue, 05 Apr 2022 14:08:14 +0000 Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 9388C23A; Tue, 5 Apr 2022 07:08:05 -0700 (PDT) Received: from bogus (unknown [10.57.43.163]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 14E7D3F5A1; Tue, 5 Apr 2022 07:08:03 -0700 (PDT) Date: Tue, 5 Apr 2022 15:08:00 +0100 From: Sudeep Holla To: Randy Dunlap Cc: linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, Liviu Dudau , Lorenzo Pieralisi , kernel test robot Subject: Re: [PATCH 1/2] ARM: vexpress/spc: Fix doxygen comments Message-ID: <20220405140800.baww2wrow3hdp5ho@bogus> References: <20220404130207.1162445-1-sudeep.holla@arm.com> <008aae79-4a6c-721f-7ef5-7b73f6d7e000@infradead.org> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: <008aae79-4a6c-721f-7ef5-7b73f6d7e000@infradead.org> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20220405_070810_594344_8832E1BD X-CRM114-Status: GOOD ( 20.75 ) 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 Hi Randy, On Mon, Apr 04, 2022 at 05:21:39PM -0700, Randy Dunlap wrote: > Hi-- > > On 4/4/22 06:02, Sudeep Holla wrote: > > Kbuild bot reported the following doxygen build warning: > > > > | arch/arm/mach-versatile/spc.c:231: warning: This comment starts with > > | '/**', but isn't a kernel-doc comment. > > | Refer Documentation/doc-guide/kernel-doc.rst > > | * ve_spc_cpu_in_wfi(u32 cpu, u32 cluster) > > > > Fix the issue by dropping the parameters specified in the kernel doc. > > > > Cc: Liviu Dudau > > Cc: Lorenzo Pieralisi > > Reported-by: kernel test robot > > Link: https://lore.kernel.org/linux-doc/202204031026.4ogKxt89-lkp@intel.com > > Signed-off-by: Sudeep Holla > > --- > > arch/arm/mach-vexpress/spc.c | 2 +- > > 1 file changed, 1 insertion(+), 1 deletion(-) > > > > diff --git a/arch/arm/mach-vexpress/spc.c b/arch/arm/mach-vexpress/spc.c > > index 1c6500c4e6a1..8f99d47d4b89 100644 > > --- a/arch/arm/mach-vexpress/spc.c > > +++ b/arch/arm/mach-vexpress/spc.c > > @@ -228,7 +228,7 @@ static u32 standbywfi_cpu_mask(u32 cpu, u32 cluster) > > } > > > > /** > > - * ve_spc_cpu_in_wfi(u32 cpu, u32 cluster) > > + * ve_spc_cpu_in_wfi() > > This line still needs a "function short description," e.g. > > + * ve_spc_cpu_in_wfi() - fooble the barfloppity > > similar to what you did in patch 2/2. I did this intentionally, I can move only this from the other patch. Since I saw few others w/o description, I addressed all at once in the second patch and just remove warning reported in this patch. I am fine either way. > > > * > > * @cpu: mpidr[7:0] bitfield describing CPU affinity level within cluster > > * @cluster: mpidr[15:8] bitfield describing cluster affinity level > > and I would s/doxygen/kernel-doc/ for both patches. > Sure will do. -- Regards, Sudeep _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel 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 Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 5C868C43219 for ; Wed, 6 Apr 2022 00:40:48 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1836954AbiDFAlC (ORCPT ); Tue, 5 Apr 2022 20:41:02 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:59722 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1445217AbiDEPml (ORCPT ); Tue, 5 Apr 2022 11:42:41 -0400 Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by lindbergh.monkeyblade.net (Postfix) with ESMTP id E8C62191437 for ; Tue, 5 Apr 2022 07:08:05 -0700 (PDT) Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 9388C23A; Tue, 5 Apr 2022 07:08:05 -0700 (PDT) Received: from bogus (unknown [10.57.43.163]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 14E7D3F5A1; Tue, 5 Apr 2022 07:08:03 -0700 (PDT) Date: Tue, 5 Apr 2022 15:08:00 +0100 From: Sudeep Holla To: Randy Dunlap Cc: linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, Liviu Dudau , Lorenzo Pieralisi , kernel test robot Subject: Re: [PATCH 1/2] ARM: vexpress/spc: Fix doxygen comments Message-ID: <20220405140800.baww2wrow3hdp5ho@bogus> References: <20220404130207.1162445-1-sudeep.holla@arm.com> <008aae79-4a6c-721f-7ef5-7b73f6d7e000@infradead.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <008aae79-4a6c-721f-7ef5-7b73f6d7e000@infradead.org> Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Hi Randy, On Mon, Apr 04, 2022 at 05:21:39PM -0700, Randy Dunlap wrote: > Hi-- > > On 4/4/22 06:02, Sudeep Holla wrote: > > Kbuild bot reported the following doxygen build warning: > > > > | arch/arm/mach-versatile/spc.c:231: warning: This comment starts with > > | '/**', but isn't a kernel-doc comment. > > | Refer Documentation/doc-guide/kernel-doc.rst > > | * ve_spc_cpu_in_wfi(u32 cpu, u32 cluster) > > > > Fix the issue by dropping the parameters specified in the kernel doc. > > > > Cc: Liviu Dudau > > Cc: Lorenzo Pieralisi > > Reported-by: kernel test robot > > Link: https://lore.kernel.org/linux-doc/202204031026.4ogKxt89-lkp@intel.com > > Signed-off-by: Sudeep Holla > > --- > > arch/arm/mach-vexpress/spc.c | 2 +- > > 1 file changed, 1 insertion(+), 1 deletion(-) > > > > diff --git a/arch/arm/mach-vexpress/spc.c b/arch/arm/mach-vexpress/spc.c > > index 1c6500c4e6a1..8f99d47d4b89 100644 > > --- a/arch/arm/mach-vexpress/spc.c > > +++ b/arch/arm/mach-vexpress/spc.c > > @@ -228,7 +228,7 @@ static u32 standbywfi_cpu_mask(u32 cpu, u32 cluster) > > } > > > > /** > > - * ve_spc_cpu_in_wfi(u32 cpu, u32 cluster) > > + * ve_spc_cpu_in_wfi() > > This line still needs a "function short description," e.g. > > + * ve_spc_cpu_in_wfi() - fooble the barfloppity > > similar to what you did in patch 2/2. I did this intentionally, I can move only this from the other patch. Since I saw few others w/o description, I addressed all at once in the second patch and just remove warning reported in this patch. I am fine either way. > > > * > > * @cpu: mpidr[7:0] bitfield describing CPU affinity level within cluster > > * @cluster: mpidr[15:8] bitfield describing cluster affinity level > > and I would s/doxygen/kernel-doc/ for both patches. > Sure will do. -- Regards, Sudeep