Chapter 43.8. "Transaction Management" fails to state two critical restrictions - Mailing list pgsql-docs

From PG Doc comments form
Subject Chapter 43.8. "Transaction Management" fails to state two critical restrictions
Date
Msg-id 156981670710.26184.2375673917366850651@wrigleys.postgresql.org
Whole thread Raw
Responses Re: Chapter 43.8. "Transaction Management" fails to state twocritical restrictions
List pgsql-docs
The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/11/plpgsql-transactions.html
Description:

This chapter fails to state:

(1) If a PL/pgSQL procedure issues "commit" then it must be called with
AUTOCOMMIT set to On. This is counter-intuitive. You'd expect the
opposite.

(2) If a PL/pgSQL procedure has a block statement with an exception section
(this might be the procedure's defining block, or an inner block) then that
block's executabe section must not issue "commit". Doing so causes a
run-time error.

pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: Fix contributor name-related inconsistencies in release-12.sgml
Next
From: Aramaki Zyake
Date:
Subject: RE: Required locks for ANALYZE