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:17 +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 bef1275871198177f533ec7930ba789fe72b9bd8..44578e51a8288930ec1e1d02b9f8ad9086ff46e9 100644 (file)
@@ -1681,9 +1681,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>