diff --git a/doc/src/sgml/ref/alter_opfamily.sgml b/doc/src/sgml/ref/alter_opfamily.sgml
index 31d77fcf0c8..cbb1c7b2786 100644
--- a/doc/src/sgml/ref/alter_opfamily.sgml
+++ b/doc/src/sgml/ref/alter_opfamily.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/alter_opfamily.sgml,v 1.2 2007/01/31 23:26:02 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/alter_opfamily.sgml,v 1.3 2007/02/14 04:30:26 tgl Exp $
 PostgreSQL documentation
 -->
 
@@ -65,6 +65,20 @@ ALTER OPERATOR FAMILY <replaceable>name</replaceable> USING <replaceable class="
 
   <para>
    You must be a superuser to use <command>ALTER OPERATOR FAMILY</>.
+   (This restriction is made because an erroneous operator family definition
+   could confuse or even crash the server.)
+  </para>
+
+  <para>
+   <command>ALTER OPERATOR FAMILY</command> does not presently check
+   whether the operator family definition includes all the operators and
+   functions required by the index method, nor whether the operators and
+   functions form a self-consistent set.  It is the user's
+   responsibility to define a valid operator family.
+  </para>
+
+  <para>
+   Refer to <xref linkend="xindex"> for further information.
   </para>
  </refsect1>
   
diff --git a/doc/src/sgml/ref/create_opfamily.sgml b/doc/src/sgml/ref/create_opfamily.sgml
index ee40196a473..20fd1ba123a 100644
--- a/doc/src/sgml/ref/create_opfamily.sgml
+++ b/doc/src/sgml/ref/create_opfamily.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/create_opfamily.sgml,v 1.2 2007/01/31 23:26:03 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/create_opfamily.sgml,v 1.3 2007/02/14 04:30:26 tgl Exp $
 PostgreSQL documentation
 -->
 
@@ -62,14 +62,6 @@ CREATE OPERATOR FAMILY <replaceable class="parameter">name</replaceable> USING <
    server.)
   </para>
 
-  <para>
-   <command>CREATE OPERATOR FAMILY</command> does not presently check
-   whether the operator family definition includes all the operators and
-   functions required by the index method, nor whether the operators and
-   functions form a self-consistent set.  It is the user's
-   responsibility to define a valid operator family.
-  </para>
-
   <para>
    Refer to <xref linkend="xindex"> for further information.
   </para>