From: Tom Lane <tgl@sss.pgh.pa.us>
To: Kevin Grittner <kgrittn@ymail.com>
cc: Marti Raudsepp <marti@juffo.org>, pgsql-docs <pgsql-docs@postgresql.org>
Subject: Re: [PATCH] Various documentation typo/grammar fixes
In-reply-to: <1409416383.3283.YahooMailNeo@web122306.mail.ne1.yahoo.com>
References: 
 <CABRT9RA_kHEZrw9W=C_yYpR8+TTLqVMVKUSU0hrLC213cJ4Hyg@mail.gmail.com>
 <1408994031.21717.YahooMailNeo@web122306.mail.ne1.yahoo.com>
 <CABRT9RBDUVXJGoVP3CGL2y5JbpqHSGjH1871wPBj3fw+qX_b3g@mail.gmail.com>
 <1409003998.48777.YahooMailNeo@web122302.mail.ne1.yahoo.com>
 <CABRT9RCR8XziafHjS=P6DvKxQ2x1T=EnmB4MsLBqwf23byDOig@mail.gmail.com>
 <1409416383.3283.YahooMailNeo@web122306.mail.ne1.yahoo.com>
Comments: In-reply-to Kevin Grittner <kgrittn@ymail.com>
 message dated "Sat, 30 Aug 2014 09:33:03 -0700"
Date: Sat, 30 Aug 2014 13:43:26 -0400
Message-ID: <6438.1409420606@sss.pgh.pa.us>
Precedence: bulk
Sender: pgsql-docs-owner@postgresql.org

Kevin Grittner <kgrittn@ymail.com> writes:
> Patch 1 pushed, with each fix back-patched as far as the error
> exists in supported releases.  I held off on patch 2 -- partly
> because I spotted at least one case where things weren't quite
> right, partly because there's so much I haven't had time to go over
> it in sufficient detail, and partly because commas are omitted so
> consistently where most style guides want them that I thought
> someone might want to argue that this was an intentional style
> choice and should be preserved.

I would argue against applying patch 2 at all.  I think it's what
John McIntyre (http://www.baltimoresun.com/news/language-blog/)
would call peeverism.  If there are any places where the extra
commas/periods actually add anything to clarity, then sure, change
those places --- but doing it only because some style guide tells
you to is not the way to approach the issue.  We're writing English
not C code here, and so there is no single standard of correctness.

			regards, tom lane


-- 
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs