Received: by 2002:a05:6358:3188:b0:123:57c1:9b43 with SMTP id q8csp35047965rwd; Mon, 10 Jul 2023 01:36:26 -0700 (PDT) X-Google-Smtp-Source: APBJJlF+c286iTOONSE1XvELyLEyebASxdbAyj/PfScRXaQDD/q0qjaHXHgmQ15smroWtSwLGkZt X-Received: by 2002:a05:6a00:3a04:b0:681:4274:eef0 with SMTP id fj4-20020a056a003a0400b006814274eef0mr15735890pfb.1.1688978185907; Mon, 10 Jul 2023 01:36:25 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1688978185; cv=none; d=google.com; s=arc-20160816; b=a3hZGQaBrtsHToY2E8k11LSlJhtMx7OmrrV3/SMHOi73M2D2emr4r9y/SJ4T0UQGuk +1lUbaV6byhBqyajwzcOe4cxNQZXd87ObRuT1zPl5pJvNA1ZVy0NaNnGySb4a8A/naSw dPTokDsb7NmuDMNkt+/E8CqynptUlCHlMMOJ95qGhkQGee6FWurCsjlrAw+iDXQyFc+x vDEEpTx/IC1o7hFsigR9oXSpjnm5lMjth0h8vvN+4PvSZEBOe3jxWICn3px/8Jm19thc Fka3lUk/eMFChHlFilvGkyjSpxmp0MHliNpVQsL4wNqrr7GYlEeqsZSomJ4nRxD0DU/L RrUg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:in-reply-to:content-disposition:mime-version :references:message-id:subject:cc:to:from:date:dkim-signature; bh=YTy/4WW8W7nx6VvaxiqDKN9pqOlOVSs4Zgi/UQIXjow=; fh=lzbHuphGBkmlH+VU0yFUkVeYlB8hE8A5ZiIxUJ2E5/g=; b=GB5ZfQjdBWzyW98GUfqkizfr1lK5U4Ld6psq+D1xKSE4Nf2cAD84ZWhYx/Ei340WXZ 6lzM84t0VUWgQ1byvr9470KpQBq7x0Jy95QMcCjlQk/Pbb/Y+0dwCoPVWgQnvBbpz7e5 6l5jLw+yZYpOAzqKrNcPB4VRW4WYX+QePn0T7ZRAcdTQjjCPIqJEXpvW+6p0vY2ovjaU IU0fVZGEQ+Lqid74vLP8c3t0valdC1rGKYM25hpoZeO0Lr8Tc4EXxxQ8Vk1kVH62DASP Va7LHJqyj/gZHTaAW1tRiUR3Cw98o15BoMrCLkGkLP/NjZHZaASAHKWmHjJTmbv450RJ 63Ow== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b=R8qWr8ET; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=intel.com Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id k24-20020a63f018000000b005533ded45c5si8658151pgh.17.2023.07.10.01.36.13; Mon, 10 Jul 2023 01:36:25 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b=R8qWr8ET; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=intel.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231983AbjGJIHB (ORCPT + 99 others); Mon, 10 Jul 2023 04:07:01 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:35686 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229875AbjGJIHA (ORCPT ); Mon, 10 Jul 2023 04:07:00 -0400 Received: from mga05.intel.com (mga05.intel.com [192.55.52.43]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id BFE61BB; Mon, 10 Jul 2023 01:06:59 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1688976419; x=1720512419; h=date:from:to:cc:subject:message-id:references: mime-version:in-reply-to; bh=NfXjdyeWvqp6EgsEFX6ytGwQlHh07tslExxu7PMVbis=; b=R8qWr8ETO+wyib5h6LulcCEZdmgpW4T8zKfuLVTo/0bFRuyslYu0NuJ0 MvJJObSsvNQAnSE0qLA3af78XV2bnWqUvt/bhDTkwFy9vJn7aMjItx5mH nW3+uJhlznhv74R6uKD4NHVhZUmmWTwzDHf6TysJN/ojCXNAOb5BjUj5f QAKgD4DBw8gidtxQILH6OWVBiO0o+2A/dlurrZthaFDuKSAJqYYM1Om28 IY3WUt+KbVi6bAe4VEumJqosGLeV/dFAc7y+rOpiee67STaKO4Pn7RiVY evdY+9WOK9wXY91NpN61+SwKpJL6s8B7UxeQ5Alr8i1yoVnX2pm+gjNGz w==; X-IronPort-AV: E=McAfee;i="6600,9927,10766"; a="450640722" X-IronPort-AV: E=Sophos;i="6.01,194,1684825200"; d="scan'208";a="450640722" Received: from fmsmga007.fm.intel.com ([10.253.24.52]) by fmsmga105.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 10 Jul 2023 01:06:59 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10766"; a="723921249" X-IronPort-AV: E=Sophos;i="6.01,194,1684825200"; d="scan'208";a="723921249" Received: from yilunxu-optiplex-7050.sh.intel.com (HELO localhost) ([10.239.159.165]) by fmsmga007.fm.intel.com with ESMTP; 10 Jul 2023 01:06:57 -0700 Date: Mon, 10 Jul 2023 16:05:30 +0800 From: Xu Yilun To: Randy Dunlap , marpagan@redhat.com Cc: Marco Pagani , Moritz Fischer , Wu Hao , Tom Rix , linux-kernel@vger.kernel.org, linux-fpga@vger.kernel.org Subject: Re: [RFC PATCH 1/2] fpga: region: fix kernel-doc Message-ID: References: <20230706142755.124879-1-marpagan@redhat.com> <20230706142755.124879-2-marpagan@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: X-Spam-Status: No, score=-4.4 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_MED, SPF_HELO_NONE,SPF_NONE,T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On 2023-07-06 at 14:30:34 -0700, Randy Dunlap wrote: > Hi-- > > On 7/6/23 07:27, Marco Pagani wrote: > > - Fix the following warnings issued by the kernel-doc script: > > > > drivers/fpga/fpga-region.c:46: warning: No description found for return value of 'fpga_region_get' > > drivers/fpga/fpga-region.c:97: warning: No description found for return value of 'fpga_region_program_fpga' > > drivers/fpga/fpga-region.c:295: warning: No description found for return value of 'fpga_region_init' > > > > - Remove the "and registers a reconfig notifier" part from the description > > of fpga_region_init() since it does not register an of_overlay notifier > > anymore. > > > > - Remove the outdated "if @np is not an FPGA Region" case from the return > > description of fpga_region_get() and replace it with the case when > > try_module_get() fails. > > > > Signed-off-by: Marco Pagani > > Looks good. Thanks. > > Reviewed-by: Randy Dunlap Acked-by: Xu Yilun Applied. BTW: No need to have RFC if you think it is ready for full review.