Received: from malur.postgresql.org ([2a02:16a8:dc51::56]) by arkaria.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA384:256) (Exim 4.89) (envelope-from ) id 1ffQNJ-0001RQ-HG for pgsql-docs@arkaria.postgresql.org; Tue, 17 Jul 2018 13:50:46 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.89) (envelope-from ) id 1ffQNH-0006My-2t for pgsql-docs@arkaria.postgresql.org; Tue, 17 Jul 2018 13:50:43 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA384:256) (Exim 4.89) (envelope-from ) id 1ffQN2-0005Bm-Rm for pgsql-docs@lists.postgresql.org; Tue, 17 Jul 2018 13:50:28 +0000 Received: from mail.postgrespro.ru ([93.174.131.138]) by magus.postgresql.org with esmtp (Exim 4.89) (envelope-from ) id 1ffQMy-0000C1-J1 for pgsql-docs@lists.postgresql.org; Tue, 17 Jul 2018 13:50:27 +0000 Received: from localhost (localhost [127.0.0.1]) by mail.postgrespro.ru (Postfix) with ESMTP id DD21821C1E5B; Tue, 17 Jul 2018 16:50:22 +0300 (MSK) X-Virus-Scanned: Debian amavisd-new at postgrespro.ru X-Spam-Flag: NO X-Spam-Score: 0 X-Spam-Level: X-Spam-Status: No, score=x tagged_above=-99 required=4 WHITELISTED tests=[] autolearn=unavailable Received: from [192.168.27.117] (gw.postgrespro.ru [93.174.131.141]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client did not present a certificate) by mail.postgrespro.ru (Postfix) with ESMTPSA id A451421C1E55; Tue, 17 Jul 2018 16:50:22 +0300 (MSK) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=postgrespro.ru; s=mail; t=1531835422; bh=cfRCEKwV4M11N0/blYpnVkyZw4BVoHBUiqGqDJWSbcw=; h=Subject:To:References:From:Date:In-Reply-To; b=B1rlF92KxeSRim/IrAaVb5voeRSKSdeI7NkX2JqUZm45rc3rOmxFNgKMbO0CWYcfE L/OVh2TgjbSAAyYIP+zBA12NUL8GHadGLHS1mLsPc0LUYx331Gkyx03TXIEpUeJOqh fZlviztWSr4PUIggjV6DVGxJq8HV4DvQRiyQ10JI= Subject: Re: uncommon syntax in datatype.sgml To: Peter Eisentraut , pgsql-docs@lists.postgresql.org References: <3e930230-1dbb-4dba-4f35-a1e604284387@2ndquadrant.com> From: Liudmila Mantrova Message-ID: <541a2ac7-4898-2680-5861-9aea4c37007f@postgrespro.ru> Date: Tue, 17 Jul 2018 16:50:22 +0300 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.9.1 MIME-Version: 1.0 In-Reply-To: <3e930230-1dbb-4dba-4f35-a1e604284387@2ndquadrant.com> Content-Type: multipart/mixed; boundary="------------389584E821C1FCD68DD443E9" Content-Language: en-US List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk This is a multi-part message in MIME format. --------------389584E821C1FCD68DD443E9 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit 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 --------------389584E821C1FCD68DD443E9 Content-Type: text/x-patch; name="syntax-fix-in-datatype-9-6.patch" Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename="syntax-fix-in-datatype-9-6.patch" diff --git a/doc/src/sgml/datatype.sgml b/doc/src/sgml/datatype.sgml index 5f45db2..7244449 100644 --- a/doc/src/sgml/datatype.sgml +++ b/doc/src/sgml/datatype.sgml @@ -508,7 +508,7 @@ - We use the following terms below: the + We use the following terms below: The precision of a numeric is the total count of significant digits in the whole number, that is, the number of digits to both sides of the decimal point. --------------389584E821C1FCD68DD443E9--