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 1osFWw-0006C4-7a for pgsql-hackers@arkaria.postgresql.org; Tue, 08 Nov 2022 03:44:06 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.92) (envelope-from ) id 1osFWu-0000SS-UZ for pgsql-hackers@arkaria.postgresql.org; Tue, 08 Nov 2022 03:44:04 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1osFWu-0000SI-LG for pgsql-hackers@lists.postgresql.org; Tue, 08 Nov 2022 03:44:04 +0000 Received: from momjian.us ([72.94.173.45]) by makus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1osFWs-0008HC-AK for pgsql-hackers@postgresql.org; Tue, 08 Nov 2022 03:44:03 +0000 Received: from bruce by momjian.us with local (Exim 4.94.2) (envelope-from ) id 1osFWm-00EJJg-Nz; Mon, 07 Nov 2022 22:43:56 -0500 Date: Mon, 7 Nov 2022 22:43:56 -0500 From: Bruce Momjian To: Laurenz Albe Cc: Simon Riggs , Robert Treat , Alvaro Herrera , Erik Rijkers , Justin Pryzby , PostgreSQL Hackers Subject: Re: New docs chapter on Transaction Management and related changes Message-ID: References: <20221014084615.chvollxv3oz43oqu@alvherre.pgsql> <80a5fd9c080d66e62f90c9565e3e1b54e61f584c.camel@cybertec.at> <3603e6e85544daa5300c7106c31bc52673711cd0.camel@cybertec.at> <7344373b30cd07a97cc490b29ed4f93fc90da43c.camel@cybertec.at> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <7344373b30cd07a97cc490b29ed4f93fc90da43c.camel@cybertec.at> List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk On Tue, Nov 8, 2022 at 04:37:59AM +0100, Laurenz Albe wrote: > On Mon, 2022-11-07 at 23:04 +0100, Laurenz Albe wrote: > > On Sat, 2022-11-05 at 10:08 +0000, Simon Riggs wrote: > > > Agreed; new compilation patch attached, including mine and then > > > Robert's suggested rewordings. > > > > Thanks.  There is clearly a lot of usefule information in this. > > > > Some comments: [...] > > I thought some more about the patch, and I don't like the title > "Transaction Management" for the new chapter. I'd expect some more > from a chapter titled "Internals" / "Transaction Management". > > In reality, the new chapter is about transaction IDs. So perhaps the > name should reflect that, so that it does not mislead the reader. I renamed it to "Transaction Processing" since we also cover locking and subtransactions. How is that? -- Bruce Momjian https://momjian.us EDB https://enterprisedb.com Indecision is a decision. Inaction is an action. Mark Batterson