Seems it would be nice if the ALTER INDEX ref page were actually

linked into the docs ...

doc/src/sgml/ref/allfiles.sgml

 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/allfiles.sgml,v 1.61 2004/08/12 19:12:21 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/allfiles.sgml,v 1.62 2004/08/21 16:16:04 tgl Exp $
 PostgreSQL documentation
 Complete list of usable sgml source files in this directory.
 -->
@@ -12,6 +12,7 @@ Complete list of usable sgml source files in this directory.
 <!entity alterDomain        system "alter_domain.sgml">
 <!entity alterFunction      system "alter_function.sgml">
 <!entity alterGroup         system "alter_group.sgml">
+<!entity alterIndex         system "alter_index.sgml">
 <!entity alterLanguage      system "alter_language.sgml">
 <!entity alterOperator      system "alter_operator.sgml">
 <!entity alterOperatorClass system "alter_opclass.sgml">

doc/src/sgml/ref/alter_index.sgml

 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/alter_index.sgml,v 1.2 2004/08/20 14:56:57 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/alter_index.sgml,v 1.3 2004/08/21 16:16:04 tgl Exp $
 PostgreSQL documentation
 -->
 
@@ -46,7 +46,7 @@ where <replaceable class="PARAMETER">action</replaceable> is one of:
     <listitem>
      <para>
       This form changes the owner of the index to the
-      specified user.
+      specified user.  This can only be done by a superuser.
      </para>
     </listitem>
    </varlistentry>
@@ -67,7 +67,7 @@ where <replaceable class="PARAMETER">action</replaceable> is one of:
     <term><literal>RENAME</literal></term>
     <listitem>
      <para>
-      The <literal>RENAME</literal> forms change the name of the index. 
+      The <literal>RENAME</literal> form changes the name of the index. 
 	  There is no effect on the stored data.
      </para>
     </listitem>
@@ -134,8 +134,10 @@ where <replaceable class="PARAMETER">action</replaceable> is one of:
   <title>Notes</title>
 
    <para>
-	This same operations are supported by <literal>ALTER TABLE</>. See also
+    These operations are also possible using
     <xref linkend="SQL-ALTERTABLE" endterm="SQL-ALTERTABLE-TITLE">.
+    <command>ALTER INDEX</> is in fact just an alias for the forms
+    of <command>ALTER TABLE</> that apply to indexes.
    </para>
 
    <para>

doc/src/sgml/reference.sgml

 <!-- reference.sgml
-$PostgreSQL: pgsql/doc/src/sgml/reference.sgml,v 1.51 2004/08/01 17:32:11 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/reference.sgml,v 1.52 2004/08/21 16:16:03 tgl Exp $
 
 PostgreSQL Reference Manual
 -->
@@ -44,6 +44,7 @@ PostgreSQL Reference Manual
    &alterDomain;
    &alterFunction;
    &alterGroup;
+   &alterIndex;
    &alterLanguage;
    &alterOperator;
    &alterOperatorClass;