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 EAA89C433F5 for ; Mon, 18 Apr 2022 21:36:52 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229941AbiDRVjb (ORCPT ); Mon, 18 Apr 2022 17:39:31 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50674 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229560AbiDRVja (ORCPT ); Mon, 18 Apr 2022 17:39:30 -0400 Received: from mga02.intel.com (mga02.intel.com [134.134.136.20]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 6E6522E9FB; Mon, 18 Apr 2022 14:36:50 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1650317810; x=1681853810; h=date:from:to:cc:subject:message-id:references: mime-version:in-reply-to; bh=eEJGoHVsFofaV6UR/94SRICq/E+Aa7hOKpo5pnC+TWg=; b=OPq384zsCazXPpiowFRt49lJQYMQrk4oNsoezfiue+1L7H8rzsRhGHA1 mWeGwg5KWCUHiEVZA4C3Hzzmg9apXXW6vZe2YtkwY4LqEDH13QSq4QzoP NHgrvRYqALkgDk/+n3OCRRF27svnwVtOzWOvIfhWRGm+WMYNJG0qCwiJu kKmCsVIzAxl5Jqec6YqYs9cUtvJCQ2N48uTZh3xgUswtCOTlvW6QXj7j/ rgJHp3wQsdgDBPm7GPkptIAQHXmAV4uM+7ldVDLX/Z+FymYfSXbe8gAj/ POw70d3r6REzJhaJJvP17Pg9RVlLV4bcFV/m1csKuX8BVPum95WEt/PFr w==; X-IronPort-AV: E=McAfee;i="6400,9594,10321"; a="250918424" X-IronPort-AV: E=Sophos;i="5.90,270,1643702400"; d="scan'208";a="250918424" Received: from fmsmga006.fm.intel.com ([10.253.24.20]) by orsmga101.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 18 Apr 2022 14:36:50 -0700 X-IronPort-AV: E=Sophos;i="5.90,270,1643702400"; d="scan'208";a="804432221" Received: from moseshab-mobl1.amr.corp.intel.com (HELO localhost) ([10.209.143.127]) by fmsmga006-auth.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 18 Apr 2022 14:36:49 -0700 Date: Mon, 18 Apr 2022 14:36:49 -0700 From: Ira Weiny To: "Fabio M. De Francesco" Cc: Jonathan Corbet , Andrew Morton , SeongJae Park , Jiajian Ye , Thomas Gleixner , Matthew Wilcox , Peter Zijlstra , outreachy@lists.linux.dev, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH] Documentation/vm: Include kernel-doc from highmem-internal.h Message-ID: References: <20220418081740.21001-1-fmdefrancesco@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20220418081740.21001-1-fmdefrancesco@gmail.com> Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org On Mon, Apr 18, 2022 at 10:17:40AM +0200, Fabio M. De Francesco wrote: > In Documentation/vm/highmem.rst the kernel-doc comments are missing, > therefore kunmap_local() and kunmap_atomic() are yet undocumented. > > Add a kernel-doc directive to include the above-mentioned kernel-doc > comments in highmem.rst. > > Cc: Jonathan Corbet > Cc: Thomas Gleixner > Cc: Ira Weiny > Cc: Matthew Wilcox > Cc: Peter Zijlstra > Signed-off-by: Fabio M. De Francesco I thought I saw a patch fly by which changed the comment of kunmap_atomic() in include/linux/highmem-internal.h? Did I miss that somewhere? This is a good inclusion for now. However, I think I would rather see this as part of a new series which puts the bulk of the documentation with the code as I proposed in patch 1/2 in your other series. For this particular change: Reviewed-by: Ira Weiny > --- > > This patch must be applied and built on top of > "[PATCH v3 2/2] Documentation/vm: Include kernel-doc to highmem.rst" > https://lore.kernel.org/lkml/20220415231917.25962-3-fmdefrancesco@gmail.com/ > > Documentation/vm/highmem.rst | 1 + > 1 file changed, 1 insertion(+) > > diff --git a/Documentation/vm/highmem.rst b/Documentation/vm/highmem.rst > index 5dcee6233cd5..1a3e6a8f5d3e 100644 > --- a/Documentation/vm/highmem.rst > +++ b/Documentation/vm/highmem.rst > @@ -161,3 +161,4 @@ Functions > ========= > > .. kernel-doc:: include/linux/highmem.h > +.. kernel-doc:: include/linux/highmem-internal.h > -- > 2.34.1 >