Re: [PATCH] Various documentation typo/grammar fixes

Поиск
Список
Период
Сортировка
От Tom Lane
Тема Re: [PATCH] Various documentation typo/grammar fixes
Дата
Msg-id 6438.1409420606@sss.pgh.pa.us
обсуждение исходный текст
Ответ на Re: [PATCH] Various documentation typo/grammar fixes  (Kevin Grittner <kgrittn@ymail.com>)
Ответы Re: [PATCH] Various documentation typo/grammar fixes  (David G Johnston <david.g.johnston@gmail.com>)
Re: [PATCH] Various documentation typo/grammar fixes  (Marti Raudsepp <marti@juffo.org>)
Список pgsql-docs
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


В списке pgsql-docs по дате отправления:

Предыдущее
От: Kevin Grittner
Дата:
Сообщение: Re: [PATCH] Various documentation typo/grammar fixes
Следующее
От: David G Johnston
Дата:
Сообщение: Re: [PATCH] Various documentation typo/grammar fixes