Re: Typo in pg_db_role_setting.h

From: Richard Guo <guofenglinux(at)gmail(dot)com>
To: John Naylor <john(dot)naylor(at)enterprisedb(dot)com>
Cc: Japin Li <japinli(at)hotmail(dot)com>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, "pgsql-hackers(at)lists(dot)postgresql(dot)org" <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: Typo in pg_db_role_setting.h
Date: 2022-08-02 07:37:58
Message-ID: CAMbWs4_vvwj-Q8AP=SW-wu6YTx=QomQMVC5pqXptSb+-eFBAyA@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Tue, Aug 2, 2022 at 12:13 PM John Naylor <john(dot)naylor(at)enterprisedb(dot)com>
wrote:

>
> On Tue, Aug 2, 2022 at 10:06 AM Richard Guo <guofenglinux(at)gmail(dot)com>
> wrote:
> >
> > I'm not sure that we should remove such comments. And a rough search
> > shows that there are much more places with this kind of comments, such
> > as below:
> >
> > nbtxlog transam readfuncs walreceiver buffile bufmgr fd latch pmsignal
> > procsignal sinvaladt logtape rangetypes
>
> I was talking only about catalog/pg_*.c functions, as in Japin Li's latest
> patch. You didn't mention whether your examples fall in the category Tom
> mentioned upthread, so I'm not sure what your angle is.
>

Sorry I forgot to mention that. The examples listed upthread all contain
such comment in foo.h saying 'prototypes for functions in foo.c'. For
instance, in buffile.h, there is comment saying

/*
* prototypes for functions in buffile.c
*/

So if we remove such comments, should we also do so for those cases?

Thanks
Richard

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Kyotaro Horiguchi 2022-08-02 07:44:23 Re: Strange behavior with polygon and NaN
Previous Message Bharath Rupireddy 2022-08-02 07:25:01 Generalize ereport_startup_progress infrastructure