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)
commit66ab2660e0783fd4f6be5936e17a2c8e12335d0d
tree3b46e9d3feac303a0e3e1774451764e130753812
parent43beaa2fb16b18d3ec0dc385688cff264f6b7364
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