From: Liudmila Mantrova <l.mantrova@postgrespro.ru>
To: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
To: pgsql-docs@lists.postgresql.org
Subject: Re: uncommon syntax in datatype.sgml
Date: Tue, 17 Jul 2018 16:50:22 +0300
Message-ID: <541a2ac7-4898-2680-5861-9aea4c37007f@postgrespro.ru> (raw)
In-Reply-To: <3e930230-1dbb-4dba-4f35-a1e604284387@2ndquadrant.com>
References: <fc6452f7-f0de-0cf1-8273-ccc3c6867fdf@postgrespro.ru>
<3e930230-1dbb-4dba-4f35-a1e604284387@2ndquadrant.com>
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
Attachments:syntax-fix-in-datatype-9-6.patch (text/x-patch, 506B) downloaddiff --git a/doc/src/sgml/datatype.sgml b/doc/src/sgml/datatype.sgmlindex 5f45db2..7244449 100644--- a/doc/src/sgml/datatype.sgml+++ b/doc/src/sgml/datatype.sgml@@ -508,7 +508,7 @@
</para>
<para>
- We use the following terms below: the+ We use the following terms below: The
<firstterm>precision</firstterm> of a <type>numeric</type>
is the total count of significant digits in the whole number,
that is, the number of digits to both sides of the decimal point.
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: l.mantrova@postgrespro.ru, peter.eisentraut@2ndquadrant.com, pgsql-docs@lists.postgresql.org
Subject: Re: uncommon syntax in datatype.sgml
In-Reply-To: <541a2ac7-4898-2680-5861-9aea4c37007f@postgrespro.ru>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox