psql: Rename meta-command \close to \close_prepared
authorMichael Paquier <[email protected]>
Tue, 24 Jun 2025 04:12:46 +0000 (13:12 +0900)
committerMichael Paquier <[email protected]>
Tue, 24 Jun 2025 04:12:46 +0000 (13:12 +0900)
commitfc39b286ad7262a4aac8ff9a34f244763bed7a53
treecbfd155f53862bbeeaba80e97b0eba49d37564c9
parentf3ed72ca0765bdd726a31b7fa20219e96baf312c
psql: Rename meta-command \close to \close_prepared

\close has been introduced in d55322b0da60 to be able to close a
prepared statement using the extended protocol in psql.  Per discussion,
the name "close" is ambiguous.  At the SQL level, CLOSE is used to close
a cursor.  At protocol level, the close message can be used to either
close a statement or a portal.

This patch renames \close to \close_prepared to avoid any ambiguity and
make it clear that this is used to close a prepared statement.  This new
name has been chosen based on the feedback from the author and the
reviewers.

Author: Anthonin Bonnefoy <[email protected]>
Reviewed-by: Peter Eisentraut <[email protected]>
Reviewed-by: Jelte Fennema-Nio <[email protected]>
Discussion: https://postgr.es/m/3e694442-0df5-4f92-a08f-c5d4c4346b85@eisentraut.org
doc/src/sgml/ref/psql-ref.sgml
doc/src/sgml/release-18.sgml
src/bin/psql/command.c
src/bin/psql/common.c
src/bin/psql/help.c
src/bin/psql/tab-complete.in.c
src/test/regress/expected/psql.out
src/test/regress/expected/psql_pipeline.out
src/test/regress/sql/psql.sql
src/test/regress/sql/psql_pipeline.sql