Doc: minor improvements for plpgsql "Transaction Management" section.
authorTom Lane
Mon, 15 Jul 2024 15:59:43 +0000 (11:59 -0400)
committerTom Lane
Mon, 15 Jul 2024 15:59:43 +0000 (11:59 -0400)
commit34f457e99a86845e7c1826686921f0daa6a02dfd
tree4b6098c8105cd2ea15ef5f80421addb17b93b39a
parentb8bf76cbde39da45224a764e73002196cf011a51
Doc: minor improvements for plpgsql "Transaction Management" section.

Point out that savepoint commands cannot be issued in PL/pgSQL,
and suggest that exception blocks can usually be used instead.

Add a caveat to the discussion of cursor loops vs. transactions,
pointing out that any locks taken by the cursor query will be lost
at COMMIT.  This is implicit in what's already said, but the existing
text leaves the distinct impression that the auto-hold behavior is
transparent, which it's not really.

Per a couple of recent complaints (one unsigned, and one in bug #18531
from Dzmitry Jachnik).  Back-patch to v17, just so this makes it into
current docs in less than a year-and-a-half.

Discussion: https://postgr.es/m/172076354433.736586.14347210271966220018@wrigleys.postgresql.org
Discussion: https://postgr.es/m/18531-c6dddd33b8555fd2@postgresql.org
doc/src/sgml/plpgsql.sgml