From 2c72d7042bc09bd8a1f2dc8ab288fec449760ba8 Mon Sep 17 00:00:00 2001
From: Bruce Momjian <bruce@momjian.us>
Date: Tue, 22 Feb 2011 23:31:45 -0500
Subject: [PATCH] Update wording about information schema and name which views
 potentially can have duplicates, per request from Tom.

---
 doc/src/sgml/information_schema.sgml | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/doc/src/sgml/information_schema.sgml b/doc/src/sgml/information_schema.sgml
index 21e4f98913..aa6f852a8a 100644
--- a/doc/src/sgml/information_schema.sgml
+++ b/doc/src/sgml/information_schema.sgml
@@ -32,6 +32,16 @@
    automatically-generated constraint names avoid duplicates in the
    same schema, but users can specify such duplicate names.
   </para>
+
+  <para>
+   This problem can appear when querying information schema views like
+   <literal>referential_constraints</>, <literal>check_constraints</>,
+   <literal>domain_constraints</>, and
+   <literal>check_constraint_routine_usage</>.  Some other views have
+   similar issues but contain the table name to help distinguish
+   duplicate rows, e.g. <literal>table_constraints</>,
+   <literal>constraint_table_usage</>, <literal>constraint_column_usage</>.
+  </para>
  </note>