public inbox for [email protected]
help / color / mirror / Atom feedPunctuation error
3+ messages / 3 participants
[nested] [flat]
* Punctuation error
@ 2018-09-18 22:56 PG Doc comments form <[email protected]>
2018-09-19 14:43 ` Re: Punctuation error Tom Lane <[email protected]>
0 siblings, 1 reply; 3+ messages in thread
From: PG Doc comments form @ 2018-09-18 22:56 UTC (permalink / raw)
To: [email protected]; +Cc: [email protected]
The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/10/static/logical-replication-publication.html
Description:
This sentence should not use a semicolon: "Both the ADD TABLE and DROP TABLE
operations are transactional; so the table will start or stop replicating at
the correct snapshot once the transaction has committed." You can either
change it to a comma, or else leave out the "so" that follows the semicolon.
The text that follows a semicolon must be a complete sentence that stands on
its own.
^ permalink raw reply [nested|flat] 3+ messages in thread
* Re: Punctuation error
2018-09-18 22:56 Punctuation error PG Doc comments form <[email protected]>
@ 2018-09-19 14:43 ` Tom Lane <[email protected]>
2018-09-19 15:23 ` Re: Punctuation error Neil <[email protected]>
0 siblings, 1 reply; 3+ messages in thread
From: Tom Lane @ 2018-09-19 14:43 UTC (permalink / raw)
To: [email protected]; +Cc: [email protected]
=?utf-8?q?PG_Doc_comments_form?= <[email protected]> writes:
> This sentence should not use a semicolon: "Both the ADD TABLE and DROP TABLE
> operations are transactional; so the table will start or stop replicating at
> the correct snapshot once the transaction has committed."
That looks perfectly fine to me. Moreover, there are a *lot* of places
in the PG docs that we'd have to change if we got persnickety about this
sort of thing.
> You can either
> change it to a comma, or else leave out the "so" that follows the semicolon.
> The text that follows a semicolon must be a complete sentence that stands on
> its own.
I am unfamiliar with this grammar "rule", and vigorously dispute that
anyone follows it in the real world.
regards, tom lane
^ permalink raw reply [nested|flat] 3+ messages in thread
* Re: Punctuation error
2018-09-18 22:56 Punctuation error PG Doc comments form <[email protected]>
2018-09-19 14:43 ` Re: Punctuation error Tom Lane <[email protected]>
@ 2018-09-19 15:23 ` Neil <[email protected]>
0 siblings, 0 replies; 3+ messages in thread
From: Neil @ 2018-09-19 15:23 UTC (permalink / raw)
To: [email protected]
> On Sep 19, 2018, at 9:43 AM, Tom Lane <[email protected]> wrote:
>
> =?utf-8?q?PG_Doc_comments_form?= <[email protected]> writes:
>> This sentence should not use a semicolon: "Both the ADD TABLE and DROP TABLE
>> operations are transactional; so the table will start or stop replicating at
>> the correct snapshot once the transaction has committed."
>
> That looks perfectly fine to me. Moreover, there are a *lot* of places
> in the PG docs that we'd have to change if we got persnickety about this
> sort of thing.
>
>> You can either
>> change it to a comma, or else leave out the "so" that follows the semicolon.
>> The text that follows a semicolon must be a complete sentence that stands on
>> its own.
>
> I am unfamiliar with this grammar "rule", and vigorously dispute that
> anyone follows it in the real world.
>
> regards, tom lane
>
Seems Tom is correct for at least the last 100 years or so. From Strunk & White, Elements of Style 1918, Rule 5 (available on-line). Not saying this is the definitive PG writing guide, but most of us in the US used it for college writing.
“Note that if the second clause is preceded by an adverb, such as accordingly, besides, so, then, therefore, or thus, and not by a conjunction, the semicolon is still required.”
“I had never been in the place before; so I had difficulty in finding my way about.”
Neil
^ permalink raw reply [nested|flat] 3+ messages in thread
end of thread, other threads:[~2018-09-19 15:23 UTC | newest]
Thread overview: 3+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2018-09-18 22:56 Punctuation error PG Doc comments form <[email protected]>
2018-09-19 14:43 ` Tom Lane <[email protected]>
2018-09-19 15:23 ` Neil <[email protected]>
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox