doc: Updates for RETURNING OLD/NEW.
authorDean Rasheed
Thu, 26 Jun 2025 09:13:00 +0000 (10:13 +0100)
committerDean Rasheed
Thu, 26 Jun 2025 09:13:00 +0000 (10:13 +0100)
Fix a couple of sentences in the documentation that were missed in
commit 80feb727c8.

Author: Dean Rasheed 
Reviewed-by: Robert Treat
Discussion: https://postgr.es/m/CAEZATCUcqADJuapZSjPf2b6hFJ6AGOUwefRvh8Ht3UZoqqw69Q@mail.gmail.com

doc/src/sgml/ref/merge.sgml
doc/src/sgml/ref/update.sgml

index e76ebd157e52a0f9c43a20f91a1b195685c572a8..c2e181066a4e19c354328c739e22d79568f376f4 100644 (file)
@@ -106,10 +106,11 @@ MERGE INTO [ ONLY ] target_table_name
    to compute and return value(s) based on each row inserted, updated, or
    deleted.  Any expression using the source or target table's columns, or
    the merge_action()
-   function can be computed.  When an INSERT or
+   function can be computed.  By default, when an INSERT or
    UPDATE action is performed, the new values of the target
-   table's columns are used.  When a DELETE is performed,
-   the old values of the target table's columns are used.  The syntax of the
+   table's columns are used, and when a DELETE is performed,
+   the old values of the target table's columns are used, but it is also
+   possible to explicitly request old and new values.  The syntax of the
    RETURNING list is identical to that of the output list
    of SELECT.
   
index 12ec5ba070939bc16d43c0daf92449e3035afe8c..40cca06394636b1db20081756bcd34c08708ba56 100644 (file)
@@ -57,7 +57,8 @@ UPDATE [ ONLY ] table_name [ * ] [
    to compute and return value(s) based on each row actually updated.
    Any expression using the table's columns, and/or columns of other
    tables mentioned in FROM, can be computed.
-   The new (post-update) values of the table's columns are used.
+   By default, the new (post-update) values of the table's columns are used,
+   but it is also possible to request the old (pre-update) values.
    The syntax of the RETURNING list is identical to that of the
    output list of SELECT.