Doc: clarify behavior of row-limit arguments in the PLs' SPI wrappers.
authorTom Lane <tgl@sss.pgh.pa.us>
Tue, 2 May 2023 21:55:01 +0000 (17:55 -0400)
committerTom Lane <tgl@sss.pgh.pa.us>
Tue, 2 May 2023 21:55:01 +0000 (17:55 -0400)
commitb00bae2e9103b4cd4fc97141b3aba2fa0ce532a8
tree0fb3247b1a2830e0c4de91b3e08f145e50c905f0
parentee24b5e792e091b216db20b765d1dcb718abfdfc
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
doc/src/sgml/plperl.sgml
doc/src/sgml/plpython.sgml
doc/src/sgml/pltcl.sgml