Correct the description of the pg_get_viewdef() function. Do some nearby

SGML cleanup: sort table entries alphabetically.

diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 78f998e782eea9239655ea8d8100c2cb6a8fdf4b..c46a8f452e320235be7a9c7377a1156b51c09747 100644 (file)
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.324 2006/07/06 01:46:37 momjian Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.325 2006/07/11 19:11:26 neilc Exp $ -->
 
  <chapter id="functions">
   <title>Functions and Operators</title>
@@ -9496,34 +9496,26 @@ SELECT pg_type_is_visible('myschema.widget'::regtype);
        <entry>get SQL name of a data type</entry>
       </row>
       <row>
-       <entry><literal><function>pg_get_viewdef</function>(<parameter>view_name</parameter>)</literal></entry>
-       <entry><type>text</type></entry>
-       <entry>get <command>CREATE VIEW</> command for view (<emphasis>deprecated</emphasis>)</entry>
-      </row>
-      <row>
-       <entry><literal><function>pg_get_viewdef</function>(<parameter>view_name</parameter>, <parameter>pretty_bool</>)</literal></entry>
-       <entry><type>text</type></entry>
-       <entry>get <command>CREATE VIEW</> command for view (<emphasis>deprecated</emphasis>)</entry>
-      </row>
-      <row>
-       <entry><literal><function>pg_get_viewdef</function>(<parameter>view_oid</parameter>)</literal></entry>
+       <entry><literal><function>pg_get_constraintdef</function>(<parameter>constraint_oid</parameter>)</literal></entry>
        <entry><type>text</type></entry>
-       <entry>get <command>CREATE VIEW</> command for view</entry>
+       <entry>get definition of a constraint</entry>
       </row>
       <row>
-       <entry><literal><function>pg_get_viewdef</function>(<parameter>view_oid</parameter>, <parameter>pretty_bool</>)</literal></entry>
+       <entry><literal><function>pg_get_constraintdef</function>(<parameter>constraint_oid</parameter>, <parameter>pretty_bool</>)</literal></entry>
        <entry><type>text</type></entry>
-       <entry>get <command>CREATE VIEW</> command for view</entry>
+       <entry>get definition of a constraint</entry>
       </row>
       <row>
-       <entry><literal><function>pg_get_ruledef</function>(<parameter>rule_oid</parameter>)</literal></entry>
+       <entry><literal><function>pg_get_expr</function>(<parameter>expr_text</parameter>, <parameter>relation_oid</>)</literal></entry>
        <entry><type>text</type></entry>
-       <entry>get <command>CREATE RULE</> command for rule</entry>
+       <entry>decompile internal form of an expression, assuming that any Vars
+       in it refer to the relation indicated by the second parameter</entry>
       </row>
       <row>
-       <entry><literal><function>pg_get_ruledef</function>(<parameter>rule_oid</parameter>, <parameter>pretty_bool</>)</literal></entry>
+       <entry><literal><function>pg_get_expr</function>(<parameter>expr_text</parameter>, <parameter>relation_oid</>, <parameter>pretty_bool</>)</literal></entry>
        <entry><type>text</type></entry>
-       <entry>get <command>CREATE RULE</> command for rule</entry>
+       <entry>decompile internal form of an expression, assuming that any Vars
+       in it refer to the relation indicated by the second parameter</entry>
       </row>
       <row>
        <entry><literal><function>pg_get_indexdef</function>(<parameter>index_oid</parameter>)</literal></entry>
@@ -9538,31 +9530,30 @@ SELECT pg_type_is_visible('myschema.widget'::regtype);
        <parameter>column_no</> is not zero</entry>
       </row>
       <row>
-       <entry><function>pg_get_triggerdef</function>(<parameter>trigger_oid</parameter>)</entry>
+       <entry><literal><function>pg_get_ruledef</function>(<parameter>rule_oid</parameter>)</literal></entry>
        <entry><type>text</type></entry>
-       <entry>get <command>CREATE [ CONSTRAINT ] TRIGGER</> command for trigger</entry>
+       <entry>get <command>CREATE RULE</> command for rule</entry>
       </row>
       <row>
-       <entry><literal><function>pg_get_constraintdef</function>(<parameter>constraint_oid</parameter>)</literal></entry>
+       <entry><literal><function>pg_get_ruledef</function>(<parameter>rule_oid</parameter>, <parameter>pretty_bool</>)</literal></entry>
        <entry><type>text</type></entry>
-       <entry>get definition of a constraint</entry>
+       <entry>get <command>CREATE RULE</> command for rule</entry>
       </row>
       <row>
-       <entry><literal><function>pg_get_constraintdef</function>(<parameter>constraint_oid</parameter>, <parameter>pretty_bool</>)</literal></entry>
+       <entry><literal><function>pg_get_serial_sequence</function>(<parameter>table_name</parameter>, <parameter>column_name</parameter>)</literal></entry>
        <entry><type>text</type></entry>
-       <entry>get definition of a constraint</entry>
+       <entry>get name of the sequence that a <type>serial</type> or <type>bigserial</type> column
+       uses</entry>
       </row>
       <row>
-       <entry><literal><function>pg_get_expr</function>(<parameter>expr_text</parameter>, <parameter>relation_oid</>)</literal></entry>
-       <entry><type>text</type></entry>
-       <entry>decompile internal form of an expression, assuming that any Vars
-       in it refer to the relation indicated by the second parameter</entry>
+       <entry><literal><function>pg_tablespace_databases</function>(<parameter>tablespace_oid</parameter>)</literal></entry>
+       <entry><type>setof oid</type></entry>
+       <entry>get the set of database OIDs that have objects in the tablespace</entry>
       </row>
       <row>
-       <entry><literal><function>pg_get_expr</function>(<parameter>expr_text</parameter>, <parameter>relation_oid</>, <parameter>pretty_bool</>)</literal></entry>
+       <entry><function>pg_get_triggerdef</function>(<parameter>trigger_oid</parameter>)</entry>
        <entry><type>text</type></entry>
-       <entry>decompile internal form of an expression, assuming that any Vars
-       in it refer to the relation indicated by the second parameter</entry>
+       <entry>get <command>CREATE [ CONSTRAINT ] TRIGGER</> command for trigger</entry>
       </row>
       <row>
        <entry><literal><function>pg_get_userbyid</function>(<parameter>roleid</parameter>)</literal></entry>
@@ -9570,15 +9561,24 @@ SELECT pg_type_is_visible('myschema.widget'::regtype);
        <entry>get role name with given ID</entry>
       </row>
       <row>
-       <entry><literal><function>pg_get_serial_sequence</function>(<parameter>table_name</parameter>, <parameter>column_name</parameter>)</literal></entry>
+       <entry><literal><function>pg_get_viewdef</function>(<parameter>view_name</parameter>)</literal></entry>
        <entry><type>text</type></entry>
-       <entry>get name of the sequence that a <type>serial</type> or <type>bigserial</type> column
-       uses</entry>
+       <entry>get underlying <command>SELECT</command> command for view (<emphasis>deprecated</emphasis>)</entry>
       </row>
       <row>
-       <entry><literal><function>pg_tablespace_databases</function>(<parameter>tablespace_oid</parameter>)</literal></entry>
-       <entry><type>setof oid</type></entry>
-       <entry>get the set of database OIDs that have objects in the tablespace</entry>
+       <entry><literal><function>pg_get_viewdef</function>(<parameter>view_name</parameter>, <parameter>pretty_bool</>)</literal></entry>
+       <entry><type>text</type></entry>
+       <entry>get underlying <command>SELECT</command> command for view (<emphasis>deprecated</emphasis>)</entry>
+      </row>
+      <row>
+       <entry><literal><function>pg_get_viewdef</function>(<parameter>view_oid</parameter>)</literal></entry>
+       <entry><type>text</type></entry>
+       <entry>get underlying <command>SELECT</command> command for view</entry>
+      </row>
+      <row>
+       <entry><literal><function>pg_get_viewdef</function>(<parameter>view_oid</parameter>, <parameter>pretty_bool</>)</literal></entry>
+       <entry><type>text</type></entry>
+       <entry>get underlying <command>SELECT</command> command for view</entry>
       </row>
      </tbody>
     </tgroup>
@@ -9591,30 +9591,22 @@ SELECT pg_type_is_visible('myschema.widget'::regtype);
   </para>
 
   <para>
-   <function>pg_get_viewdef</function>,
-   <function>pg_get_ruledef</function>,
-   <function>pg_get_indexdef</function>,
-   <function>pg_get_triggerdef</function>, and
-   <function>pg_get_constraintdef</function> respectively
-   reconstruct the creating command for a view, rule, index, trigger, or
-   constraint.  (Note that this is a decompiled reconstruction, not
-   the original text of the command.)
+   <function>pg_get_constraintdef</function>,
+   <function>pg_get_indexdef</function>, <function>pg_get_ruledef</function>,
+   and <function>pg_get_triggerdef</function>, respectively reconstruct the
+   creating command for a constraint, index, rule, or trigger. (Note that this
+   is a decompiled reconstruction, not the original text of the command.)
    <function>pg_get_expr</function> decompiles the internal form of an
-   individual expression, such as the default value for a column.  It
-   may be useful when examining the contents of system catalogs.
-   Most of these functions come in two
-   variants, one of which can optionally <quote>pretty-print</> the result.
-   The pretty-printed format is more readable, but the default format is more
-   likely to be
-   interpreted the same way by future versions of <productname>PostgreSQL</>;
-   avoid using pretty-printed output for dump purposes.
-   Passing <literal>false</> for the pretty-print parameter yields the
-   same result as the variant that does not have the parameter at all.
-  </para>
-
-  <para>
-   <function>pg_get_userbyid</function> extracts a role's name given
-   its OID.
+   individual expression, such as the default value for a column.  It may be
+   useful when examining the contents of system catalogs.
+   <function>pg_get_viewdef</function> reconstructs the <command>SELECT</>
+   query that defines a view. Most of these functions come in two variants,
+   one of which can optionally <quote>pretty-print</> the result.  The
+   pretty-printed format is more readable, but the default format is more
+   likely to be interpreted the same way by future versions of
+   <productname>PostgreSQL</>; avoid using pretty-printed output for dump
+   purposes.  Passing <literal>false</> for the pretty-print parameter yields
+   the same result as the variant that does not have the parameter at all.
   </para>
 
   <para>
@@ -9626,14 +9618,18 @@ SELECT pg_type_is_visible('myschema.widget'::regtype);
   </para>
 
   <para>
-  <function>pg_tablespace_databases</function> allows a tablespace to
-  be examined. It returns the set of OIDs of databases that have objects
-  stored in the tablespace. If this function returns any rows, the
-  tablespace is not empty and cannot be dropped. To
-  display the specific objects populating the tablespace, you will need
-  to connect to the databases identified by 
-  <function>pg_tablespace_databases</function> and query their
-  <structname>pg_class</> catalogs.
+   <function>pg_tablespace_databases</function> allows a tablespace to be
+   examined. It returns the set of OIDs of databases that have objects stored
+   in the tablespace. If this function returns any rows, the tablespace is not
+   empty and cannot be dropped. To display the specific objects populating the
+   tablespace, you will need to connect to the databases identified by
+   <function>pg_tablespace_databases</function> and query their
+   <structname>pg_class</> catalogs.
+  </para>
+
+  <para>
+   <function>pg_get_userbyid</function> extracts a role's name given
+   its OID.
   </para>
 
    <indexterm zone="functions-info">