Re: Add comma after e.g. and i.e.?

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: PostgreSQL-documentation <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Add comma after e.g. and i.e.?
Date: 2020-08-27 02:38:30
Message-ID: 20200827023830.GF13370@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Tue, Aug 25, 2020 at 03:27:33PM -0400, Bruce Momjian wrote:
> On Tue, Aug 25, 2020 at 03:10:44PM -0400, Tom Lane wrote:
> > Bruce Momjian <bruce(at)momjian(dot)us> writes:
> > > We are inconsistently about adding a comma after e.g. and i.e.:
> >
> > > This summarizes the recommended behavior:
> > > https://jakubmarian.com/comma-after-i-e-and-e-g/
> > > In British English, “i.e.” and “e.g.” are not followed by a comma, so
> > > the first example above would be:
> > > They sell computer components, e.g. motherboards, graphic cards, CPUs.
> > > Virtually all American style guides recommend to follow both “i.e.” and
> > > “e.g.” with a comma (just like if “that is” and “for example” were used
> > > instead), so the very same sentence in American English would become:
> >
> > > So, what do we want to do? Leave it unchanged, or pick one of these
> > > styles?
> >
> > I think it's fairly pointless to try to enforce such a thing.
> > Even if you made the docs 100% consistent on the issue today,
> > they wouldn't stay that way for long, because nobody else is
> > really going to care about it.
> >
> > (FWIW, I generally write a comma myself. But I'm not going
> > to cry about text that hasn't got one.)
>
> I wasn't worried about enforcing going forward, but rather if we should
> make what we have now consistent.

I plan to move forward with this, and will backpatch it so later patches
are easier to apply. I think we are fine with adding inconsistent
usages over time --- this is probably only something we will address in
mass every 10 years or so.

--
Bruce Momjian <bruce(at)momjian(dot)us> https://momjian.us
EnterpriseDB https://enterprisedb.com

The usefulness of a cup is in its emptiness, Bruce Lee

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Michael Paquier 2020-08-27 06:33:22 Re: Document "59.2. Built-in Operator Classes" have a clerical error?
Previous Message Tom Lane 2020-08-26 23:19:09 Re: Document "59.2. Built-in Operator Classes" have a clerical error?