Re: Incorrect use of "an" and "a" in code comments and docs - Mailing list pgsql-hackers

From Abhijit Menon-Sen
Subject Re: Incorrect use of "an" and "a" in code comments and docs
Date
Msg-id 20180305055118.vkqfmfrrer7ukpsw@toroid.org
Whole thread Raw
In response to Re: Incorrect use of "an" and "a" in code comments and docs  (Michael Paquier <michael@paquier.xyz>)
Responses Re: Incorrect use of "an" and "a" in code comments and docs  (Michael Paquier <michael@paquier.xyz>)
Re: Incorrect use of "an" and "a" in code comments and docs  (Andres Freund <andres@anarazel.de>)
Re: Incorrect use of "an" and "a" in code comments and docs  (Thomas Munro <thomas.munro@enterprisedb.com>)
List pgsql-hackers
At 2018-03-05 14:42:14 +0900, michael@paquier.xyz wrote:
>
> > - sinval is a signal invalidation, so it seems to me that "a" is
> > correct, not "an".

I guess it depends on whether you read it as "sin-val" or "ess-inval".

> diff --git a/src/backend/access/gin/ginvacuum.c b/src/backend/access/gin/ginvacuum.c
> index 398532d80b..8b08b46ff6 100644
> --- a/src/backend/access/gin/ginvacuum.c
> +++ b/src/backend/access/gin/ginvacuum.c
> @@ -381,7 +381,7 @@ ginVacuumPostingTreeLeaves(GinVacuumState *gvs, BlockNumber blkno, bool isRoot)
>  
>          /*
>           * All subtree is empty - just return true to indicate that parent
> -         * must do a cleanup. Unless we are ROOT an there is way to go upper.
> +         * must do a cleanup. Unless we are ROOT and there is way to go upper.
>           */

That particular comment could use some more changes. :-)

-- Abhijit


pgsql-hackers by date:

Previous
From: Michael Paquier
Date:
Subject: Re: Incorrect use of "an" and "a" in code comments and docs
Next
From: Tom Lane
Date:
Subject: Re: postgres_fdw: perform UPDATE/DELETE .. RETURNING on a join directly