Add note deprecating use of consrc.

diff --git a/doc/src/sgml/catalogs.sgml b/doc/src/sgml/catalogs.sgml
index f918e6f..9a8e2ff 100644 (file)
--- a/doc/src/sgml/catalogs.sgml
+++ b/doc/src/sgml/catalogs.sgml
@@ -1,6 +1,6 @@
 <!--
  Documentation of the system catalogs, directed toward PostgreSQL developers
- $Header: /cvsroot/pgsql/doc/src/sgml/catalogs.sgml,v 2.74 2003/09/12 22:17:19 tgl Exp $
+ $Header: /cvsroot/pgsql/doc/src/sgml/catalogs.sgml,v 2.75 2003/10/17 00:55:17 tgl Exp $
  -->
 
 <chapter id="catalogs">
@@ -1359,6 +1359,15 @@
 
   <note>
    <para>
+    <structfield>consrc</structfield> is not updated when referenced objects
+    change; for example, it won't track renaming of columns.  Rather than
+    relying on this field, it's best to use <function>pg_get_constraintdef()</>
+    to extract the definition of a check constraint.
+   </para>
+  </note>
+
+  <note>
+   <para>
     <literal>pg_class.relchecks</literal> needs to agree with the
     number of check-constraint entries found in this table for the
     given relation.