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 1g2dhT-00037k-JK for pgsql-docs@arkaria.postgresql.org; Wed, 19 Sep 2018 14:43:31 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.89) (envelope-from ) id 1g2dhR-0005tC-T9 for pgsql-docs@arkaria.postgresql.org; Wed, 19 Sep 2018 14:43:29 +0000 Received: from makus.postgresql.org ([2001:4800:1501:1::229]) by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA384:256) (Exim 4.89) (envelope-from ) id 1g2dhR-0005t0-KH for pgsql-docs@lists.postgresql.org; Wed, 19 Sep 2018 14:43:29 +0000 Received: from sss.pgh.pa.us ([66.207.139.130]) by makus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA384:256) (Exim 4.89) (envelope-from ) id 1g2dhP-00031s-8U for pgsql-docs@lists.postgresql.org; Wed, 19 Sep 2018 14:43:28 +0000 Received: from sss1.sss.pgh.pa.us (localhost [127.0.0.1]) by sss.pgh.pa.us (8.14.4/8.14.4) with ESMTP id w8JEhPhM014263; Wed, 19 Sep 2018 10:43:25 -0400 From: Tom Lane To: cjames@emolecules.com cc: pgsql-docs@lists.postgresql.org Subject: Re: Punctuation error In-reply-to: <153731137094.14990.16664858806045765740@wrigleys.postgresql.org> References: <153731137094.14990.16664858806045765740@wrigleys.postgresql.org> Comments: In-reply-to =?utf-8?q?PG_Doc_comments_form?= message dated "Tue, 18 Sep 2018 22:56:10 -0000" MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-ID: <14261.1537368205.1@sss.pgh.pa.us> Date: Wed, 19 Sep 2018 10:43:25 -0400 Message-ID: <14262.1537368205@sss.pgh.pa.us> List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk =?utf-8?q?PG_Doc_comments_form?= 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