Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1qCrtU-0004XG-71 for pgsql-docs@arkaria.postgresql.org; Sat, 24 Jun 2023 01:16:52 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.92) (envelope-from ) id 1qCrtS-0004to-6q for pgsql-docs@arkaria.postgresql.org; Sat, 24 Jun 2023 01:16:50 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1qCrtR-0004nn-Ul for pgsql-docs@lists.postgresql.org; Sat, 24 Jun 2023 01:16:49 +0000 Received: from sss.pgh.pa.us ([66.207.139.130]) by magus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1qCrtL-0007cB-4q for pgsql-docs@lists.postgresql.org; Sat, 24 Jun 2023 01:16:49 +0000 Received: from sss1.sss.pgh.pa.us (localhost [127.0.0.1]) by sss.pgh.pa.us (8.15.2/8.15.2) with ESMTP id 35O1GdZf112753; Fri, 23 Jun 2023 21:16:39 -0400 From: Tom Lane To: Bruce Momjian cc: anton.sidyakin@gmail.com, pgsql-docs@lists.postgresql.org Subject: Re: bad choice of the word in sentence In-reply-to: References: <168745911769.2239590.6062411529242609290@wrigleys.postgresql.org> Comments: In-reply-to Bruce Momjian message dated "Fri, 23 Jun 2023 21:09:53 -0400" MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-ID: <112751.1687569399.1@sss.pgh.pa.us> Date: Fri, 23 Jun 2023 21:16:39 -0400 Message-ID: <112752.1687569399@sss.pgh.pa.us> List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk Bruce Momjian writes: > On Thu, Jun 22, 2023 at 06:38:37PM +0000, PG Doc comments form wrote: >> Quote: >> "<...>When a transaction uses this isolation level, a SELECT query (without >> a FOR UPDATE/SHARE clause) sees only data committed before the query began; >> it never sees either uncommitted data or changes committed during query >> execution by concurrent transactions. <...>" >> Don't you think this is bad choice of the word, especially while speaking >> about "commiting transactions" in very same sentence? > No, the issue is only for committed transactions, not aborted ones. I think this sentence is formally correct, but it is not very hard to misparse. Maybe a bit of re-ordering would help? Like ... it never sees either uncommitted data or changes committed by concurrent transactions during the query's execution. regards, tom lane