Re: uncommon syntax in datatype.sgml - Mailing list pgsql-docs

From Liudmila Mantrova
Subject Re: uncommon syntax in datatype.sgml
Date
Msg-id 541a2ac7-4898-2680-5861-9aea4c37007f@postgrespro.ru
Whole thread Raw
In response to Re: uncommon syntax in datatype.sgml  (Peter Eisentraut <peter.eisentraut@2ndquadrant.com>)
List pgsql-docs
On 07/17/2018 01:52 PM, Peter Eisentraut wrote:
> On 16.07.18 20:42, Liudmila Mantrova wrote:
>> I have noticed uncommon English syntax in datatype.sgml, with two full
>> sentences following a colon in the same paragraph.
> I don't understand what's wrong with that.
>
Hi Peter,

I have brought this up because the backpatch to REL9_6_STABLE and below 
has lost the capital letter after the colon (commit 037768cf), so I 
think this phrase is likely to confuse others in a similar way.

The current syntax in master is indeed acceptable, e.g. Chicago Manual 
of Style says:
"The colon may sometimes be used instead of a period to introduce a 
series of related sentences." However, this wording suggests to me that 
it's not the most common usage, so it can confuse non-native speakers 
(like me).

Alternatively, we could fix the backpatch only. The patch based on 
REL9_6_STABLE is attached if you decide to choose this path.

-- 
Liudmila Mantrova
Technical writer at Postgres Professional: http://www.postgrespro.com
The Russian Postgres Company


Attachment

pgsql-docs by date:

Previous
From: PG Doc comments form
Date:
Subject: Document the limit on the number of parameters
Next
From: PG Doc comments form
Date:
Subject: sql-set-session-authorization