Doc: remove long-obsolete advice about generated constraint names.
authorTom Lane <[email protected]>
Thu, 10 Apr 2025 18:49:10 +0000 (14:49 -0400)
committerTom Lane <[email protected]>
Thu, 10 Apr 2025 18:49:10 +0000 (14:49 -0400)
It's been twenty years since we generated constraint names that
look like "$N".  So this advice about double-quoting such names
is well past its sell-by date, and now it merely seems confusing.

Reported-by: Yaroslav Saburov <[email protected]>
Author: "David G. Johnston" <[email protected]>
Discussion: https://postgr.es/m/174393459040.678.17810152410419444783@wrigleys.postgresql.org
Backpatch-through: 13

doc/src/sgml/ddl.sgml

index d2082b7e88ec78747dd5fedf09ab010b9e4d289f..fcd1cb85352fcf5855685e6eda5377b3e5522abb 100644 (file)
@@ -1764,9 +1764,6 @@ ALTER TABLE products ALTER COLUMN product_no SET NOT NULL;
 <programlisting>
 ALTER TABLE products DROP CONSTRAINT some_name;
 </programlisting>
-    (If you are dealing with a generated constraint name like <literal>$2</literal>,
-    don't forget that you'll need to double-quote it to make it a valid
-    identifier.)
    </para>
 
    <para>