From: Tom Lane <tgl@sss.pgh.pa.us>
To: pgsql-committers@lists.postgresql.org
Subject: pgsql: Doc: clarify behavior of row-limit arguments in the PLs' SPI wra
Date: Tue, 02 May 2023 21:55:15 +0000
Message-ID: <E1ptxxq-000Aj1-JN@gemulon.postgresql.org> (raw)
Doc: clarify behavior of row-limit arguments in the PLs' SPI wrappers.
plperl, plpython, and pltcl all provide query-execution functions
that are thin wrappers around SPI_execute() or its variants.
The SPI functions document their row-count limit arguments clearly,
as "maximum number of rows to return, or 0 for no limit". However
the PLs' documentation failed to explain this special behavior of
zero, so that a reader might well assume it means "fetch zero
rows". Improve that.
Daniel Gustafsson and Tom Lane, per report from Kieran McCusker
Discussion: https://postgr.es/m/CAGgUQ6H6qYScctOhktQ9HLFDDoafBKHyUgJbZ6q_dOApnzNTXg@mail.gmail.com
Branch
------
REL_13_STABLE
Details
-------
https://git.postgresql.org/pg/commitdiff/b00bae2e9103b4cd4fc97141b3aba2fa0ce532a8
Modified Files
--------------
doc/src/sgml/plperl.sgml | 21 ++++++++++++++++-----
doc/src/sgml/plpython.sgml | 13 +++++++++++--
doc/src/sgml/pltcl.sgml | 8 +++++---
3 files changed, 32 insertions(+), 10 deletions(-)
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-committers@postgresql.org
Cc: tgl@sss.pgh.pa.us, pgsql-committers@lists.postgresql.org
Subject: Re: pgsql: Doc: clarify behavior of row-limit arguments in the PLs' SPI wra
In-Reply-To: <E1ptxxq-000Aj1-JN@gemulon.postgresql.org>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox