Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18;
Date:   Tue, 28 Apr 2020 07:47:44 -0600
From:   Jonathan Corbet <corbet@lwn.net>
To:     Andrew Morton <akpm@linux-foundation.org>
Cc:     Souptick Joarder <jrdr.linux@gmail.com>, linux-mm@kvack.org,
        linux-kernel@vger.kernel.org
Subject: Re: [PATCH] mm/gup.c: Updating the documentation
Message-ID: <20200428074744.72e9e976@lwn.net>
In-Reply-To: <20200427122606.dc29c381f6da47831a40d365@linux-foundation.org>
References: <1588013630-4497-1-git-send-email-jrdr.linux@gmail.com>
        <20200427122606.dc29c381f6da47831a40d365@linux-foundation.org>
Organization: LWN.net
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 8bit
Sender: linux-kernel-owner@vger.kernel.org
Precedence: bulk

On Mon, 27 Apr 2020 12:26:06 -0700
Andrew Morton <akpm@linux-foundation.org> wrote:

> On Tue, 28 Apr 2020 00:23:50 +0530 Souptick Joarder <jrdr.linux@gmail.com> wrote:
> 
> > This patch is an attempt to update the documentation.
> > 
> > * Adding / removing extra * based on type of function
> > static / global.  
> 
> I don't think so, unless this is a new kerneldoc convention?

Nope, no new convention here.  If it's a kerneldoc comment, it should be
marked as such.  The kerneldoc utility can sort them out later.

jon