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=-17.8 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,INCLUDES_CR_TRAILER,INCLUDES_PATCH, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,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 375D5C433E0 for ; Mon, 25 Jan 2021 17:00:18 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 0A0E222513 for ; Mon, 25 Jan 2021 17:00:18 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1730081AbhAYRAM (ORCPT ); Mon, 25 Jan 2021 12:00:12 -0500 Received: from mail.kernel.org ([198.145.29.99]:57184 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1730040AbhAYQ7r (ORCPT ); Mon, 25 Jan 2021 11:59:47 -0500 Received: by mail.kernel.org (Postfix) with ESMTPSA id 3D20220658; Mon, 25 Jan 2021 16:58:13 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1611593893; bh=kxggTNC3zOxhHV9GLTZJpYh6V/gkPDghPdf7uj5wkPw=; h=Date:From:To:Cc:Subject:Reply-To:References:In-Reply-To:From; b=jVMuSN0SY61xCC7u0zDSn/jSnsFgzsTUGp5JSDTBzhcWaCMIQ2MoYwXM5QE2EJUPn NV83zDvBtzkSXiPReR9PAmDaJYHAXizXKfbIqpIGK8twTqxVDuJ87MEJkdtK8RJelH EbVeMxySK4W7qFsCnKnYo/Na/YJtr3+vXRg8JcV/zy7dl/eiQV3nAGBMHZ6PXZiGE/ IT7BT9Oew/elXI8lF7EP6M2r2M/EGIMvqstXGIrgq0Ww5XuNttUiqkkoYRWQPhliud DQhOTNx1/fcbSR++lvsfMHWKDtiK/rqTJ8Wp/FjeKLWZ9vYY2HRadkgXTIExYLmNUT nFKE1MGqvlm8g== Received: by paulmck-ThinkPad-P72.home (Postfix, from userid 1000) id F2A0B3523742; Mon, 25 Jan 2021 08:58:12 -0800 (PST) Date: Mon, 25 Jan 2021 08:58:12 -0800 From: "Paul E. McKenney" To: Lukas Bulwahn Cc: Josh Triplett , rcu@vger.kernel.org, Steven Rostedt , Mathieu Desnoyers , Lai Jiangshan , Joel Fernandes , Jonathan Corbet , Mauro Carvalho Chehab , linux-doc@vger.kernel.org, kernel-janitors@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH] rcu-tasks: rectify kernel-doc for struct rcu_tasks Message-ID: <20210125165812.GZ2743@paulmck-ThinkPad-P72> Reply-To: paulmck@kernel.org References: <20210125074105.29038-1-lukas.bulwahn@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20210125074105.29038-1-lukas.bulwahn@gmail.com> User-Agent: Mutt/1.9.4 (2018-02-28) Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org On Mon, Jan 25, 2021 at 08:41:05AM +0100, Lukas Bulwahn wrote: > The command 'find ./kernel/rcu/ | xargs ./scripts/kernel-doc -none' > reported an issue with the kernel-doc of struct rcu_tasks. > > Rectify the kernel-doc, such that no issues remain for ./kernel/rcu/. > > Signed-off-by: Lukas Bulwahn Applied for the v5.13 merge window with the usual wordsmithing, thank you! Thanx, Paul > --- > applies cleanly on v5.11-rc5 and next-20210122 > > Paul, please pick this minor kerneldoc cleanup. > > kernel/rcu/tasks.h | 4 ++-- > 1 file changed, 2 insertions(+), 2 deletions(-) > > diff --git a/kernel/rcu/tasks.h b/kernel/rcu/tasks.h > index af7c19439f4e..17c8ebe131af 100644 > --- a/kernel/rcu/tasks.h > +++ b/kernel/rcu/tasks.h > @@ -20,7 +20,7 @@ typedef void (*holdouts_func_t)(struct list_head *hop, bool ndrpt, bool *frptp); > typedef void (*postgp_func_t)(struct rcu_tasks *rtp); > > /** > - * Definition for a Tasks-RCU-like mechanism. > + * struct rcu_tasks - Definition for a Tasks-RCU-like mechanism. > * @cbs_head: Head of callback list. > * @cbs_tail: Tail pointer for callback list. > * @cbs_wq: Wait queue allowning new callback to get kthread's attention. > @@ -38,7 +38,7 @@ typedef void (*postgp_func_t)(struct rcu_tasks *rtp); > * @pregp_func: This flavor's pre-grace-period function (optional). > * @pertask_func: This flavor's per-task scan function (optional). > * @postscan_func: This flavor's post-task scan function (optional). > - * @holdout_func: This flavor's holdout-list scan function (optional). > + * @holdouts_func: This flavor's holdout-list scan function (optional). > * @postgp_func: This flavor's post-grace-period function (optional). > * @call_func: This flavor's call_rcu()-equivalent function. > * @name: This flavor's textual name. > -- > 2.17.1 >