doc: Fix indentation of MERGE synopsis.
authorDean Rasheed
Thu, 26 Jun 2025 08:36:05 +0000 (09:36 +0100)
committerDean Rasheed
Thu, 26 Jun 2025 08:36:05 +0000 (09:36 +0100)
The convention in the documentation for other SQL commands is to
indent continuation lines and sub-clauses in the "Synopsis" section by
4 spaces, so do the same for MERGE.

Author: Dean Rasheed 
Reviewed-by: Nathan Bossart
Discussion: https://postgr.es/m/CAEZATCV+9tR9+WM-SCcdBEZ3x7WVxUpADD5jX9WeGX97z4LCGA@mail.gmail.com
Backpatch-through: 15

doc/src/sgml/ref/merge.sgml

index ecbcd8345d87487f136bce8f585e9f8f04c24dc0..e76ebd157e52a0f9c43a20f91a1b195685c572a8 100644 (file)
@@ -23,37 +23,37 @@ PostgreSQL documentation
 
 [ WITH with_query [, ...] ]
 MERGE INTO [ ONLY ] target_table_name [ * ] [ [ AS ] target_alias ]
-USING data_source ON join_condition
-when_clause [...]
-[ RETURNING [ WITH ( { OLD | NEW } AS output_alias [, ...] ) ]
-            { * | output_expression [ [ AS ] output_name ] } [, ...] ]
+    USING data_source ON join_condition
+    when_clause [...]
+    [ RETURNING [ WITH ( { OLD | NEW } AS output_alias [, ...] ) ]
+                { * | output_expression [ [ AS ] output_name ] } [, ...] ]
 
 where data_source is:
 
-{ [ ONLY ] source_table_name [ * ] | ( source_query ) } [ [ AS ] source_alias ]
+    { [ ONLY ] source_table_name [ * ] | ( source_query ) } [ [ AS ] source_alias ]
 
 and when_clause is:
 
-{ WHEN MATCHED [ AND condition ] THEN { merge_update | merge_delete | DO NOTHING } |
-  WHEN NOT MATCHED BY SOURCE [ AND condition ] THEN { merge_update | merge_delete | DO NOTHING } |
-  WHEN NOT MATCHED [ BY TARGET ] [ AND condition ] THEN { merge_insert | DO NOTHING } }
+    { WHEN MATCHED [ AND condition ] THEN { merge_update | merge_delete | DO NOTHING } |
+      WHEN NOT MATCHED BY SOURCE [ AND condition ] THEN { merge_update | merge_delete | DO NOTHING } |
+      WHEN NOT MATCHED [ BY TARGET ] [ AND condition ] THEN { merge_insert | DO NOTHING } }
 
 and merge_insert is:
 
-INSERT [( column_name [, ...] )]
-[ OVERRIDING { SYSTEM | USER } VALUE ]
-{ VALUES ( { expression | DEFAULT } [, ...] ) | DEFAULT VALUES }
+    INSERT [( column_name [, ...] )]
+        [ OVERRIDING { SYSTEM | USER } VALUE ]
+        { VALUES ( { expression | DEFAULT } [, ...] ) | DEFAULT VALUES }
 
 and merge_update is:
 
-UPDATE SET { column_name = { expression | DEFAULT } |
-             ( column_name [, ...] ) = [ ROW ] ( { expression | DEFAULT } [, ...] ) |
-             ( column_name [, ...] ) = ( sub-SELECT )
-           } [, ...]
+    UPDATE SET { column_name = { expression | DEFAULT } |
+                 column_name [, ...] ) = [ ROW ] ( { expression | DEFAULT } [, ...] ) |
+                 column_name [, ...] ) = ( sub-SELECT )
+               } [, ...]
 
 and merge_delete is:
 
-DELETE
+    DELETE