Add note deprecating use of consrc.

diff --git a/doc/src/sgml/catalogs.sgml b/doc/src/sgml/catalogs.sgml
index f918e6f1bf2ee51a6d245386fe0b7b8ae49b703a..9a8e2ff455b9267a85bb55c8850df14e4fe424e5 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">
@@ -1357,6 +1357,15 @@
    </tgroup>
   </table>
 
+  <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