pgsql: Doc: improve description of plpgsql's FETCH and MOVE commands. - Mailing list pgsql-committers

From Tom Lane
Subject pgsql: Doc: improve description of plpgsql's FETCH and MOVE commands.
Date
Msg-id E1sW2i1-000mC4-0e@gemulon.postgresql.org
Whole thread Raw
List pgsql-committers
Doc: improve description of plpgsql's FETCH and MOVE commands.

We were not being clear about which variants of the "direction"
clause are permitted in MOVE.  Also, the text seemed to be
written with only the FETCH/MOVE NEXT case in mind, so it
didn't apply very well to other variants.

Also, document that "MOVE count IN cursor" only works if count
is a constant.  This is not the whole truth, because some other
cases such as a parenthesized expression will also work, but
we want to push people to use "MOVE FORWARD count" instead.
The constant case is enough to cover what we allow in plain SQL,
and that seems sufficient to claim support for.

Update a comment in pl_gram.y claiming that we don't document
that point.

Per gripe from Philipp Salvisberg.

Discussion: https://postgr.es/m/172155553388.702.7932496598218792085@wrigleys.postgresql.org

Branch
------
REL_13_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/78ff6e0fab3fa2a7064ef8aadaa9e7f87ed5f4a6

Modified Files
--------------
doc/src/sgml/plpgsql.sgml    | 29 +++++++++++++++++++++++------
src/pl/plpgsql/src/pl_gram.y | 10 +++++-----
2 files changed, 28 insertions(+), 11 deletions(-)


pgsql-committers by date:

Previous
From: Tom Lane
Date:
Subject: pgsql: Doc: improve description of plpgsql's FETCH and MOVE commands.
Next
From: Richard Guo
Date:
Subject: pgsql: Fix rowcount estimate for gather (merge) paths