Re: Typo in pg_db_role_setting.h - Mailing list pgsql-hackers

From Daniel Gustafsson
Subject Re: Typo in pg_db_role_setting.h
Date
Msg-id 7E9E61EF-F028-4976-81AE-CA0E3697452B@yesql.se
Whole thread Raw
In response to Re: Typo in pg_db_role_setting.h  (Richard Guo <guofenglinux@gmail.com>)
Responses Re: Typo in pg_db_role_setting.h
List pgsql-hackers
> On 2 Aug 2022, at 09:37, Richard Guo <guofenglinux@gmail.com> wrote:

> 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?

Comments which state the obvious are seldom helpful, I would prefer to remove
such comments and only explicitly call out the .c file in a comment when it's a
different basename from the header.

--
Daniel Gustafsson        https://vmware.com/




pgsql-hackers by date:

Previous
From: Kyotaro Horiguchi
Date:
Subject: Re: Strange behavior with polygon and NaN
Next
From: Japin Li
Date:
Subject: Re: Typo in pg_db_role_setting.h