Re: Fix incorrect function comment of stringToNodeInternal - Mailing list pgsql-hackers

From Daniel Gustafsson
Subject Re: Fix incorrect function comment of stringToNodeInternal
Date
Msg-id 94AE51FC-94AB-43A0-8EFE-628E9E8AC9D0@yesql.se
Whole thread Raw
In response to Re: Fix incorrect function comment of stringToNodeInternal  (Chao Li <li.evan.chao@gmail.com>)
Responses Re: Fix incorrect function comment of stringToNodeInternal
List pgsql-hackers
> On 25 Sep 2025, at 10:01, Chao Li <li.evan.chao@gmail.com> wrote:

> There are 5 different cases, showing that there is not a unique way for what function name should be put to
xxInternal()functions’ comment. 
>
> Is it deserve to take this opportunity to make all of them in a consistent format?

We don't have a policy on how to do function comments, and none of these
examples strike me as particularly confusing.  I don't think there is much
value in the churn from changing these from one flavor or another as they
aren't wrong.

--
Daniel Gustafsson




pgsql-hackers by date:

Previous
From: Álvaro Herrera
Date:
Subject: Re: NOT NULL NOT ENFORCED
Next
From: Chao Li
Date:
Subject: Re: Fix incorrect function comment of stringToNodeInternal