Structure reference pages consistently. Document that structure.

Add information about environment variables.

1 files changed, 69 insertions, 40 deletions

diff --git a/doc/src/sgml/ref/droplang.sgml b/doc/src/sgml/ref/droplang.sgml
index c6eadb401f..186af6e2a0 100644
--- a/doc/src/sgml/ref/droplang.sgml
+++ b/doc/src/sgml/ref/droplang.sgml
@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/droplang.sgml,v 1.18 2002/04/21 19:02:39 thomas Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/droplang.sgml,v 1.19 2002/07/28 15:22:20 petere Exp $
 PostgreSQL documentation
 -->
 
@@ -11,7 +11,7 @@ PostgreSQL documentation
  </refmeta>
 
  <refnamediv>
-  <refname id="droplang">droplang</refname>
+  <refname>droplang</refname>
   <refpurpose>remove a <productname>PostgreSQL</productname> procedural language</refpurpose>
  </refnamediv>
 
@@ -27,11 +27,34 @@ PostgreSQL documentation
    <group choice="plain"><arg>--list</arg><arg>-l</arg></group>
    <arg choice="plain"><replaceable>dbname</replaceable></arg>
   </cmdsynopsis>
+ </refsynopsisdiv>
+ 
+ <refsect1 id="R1-APP-DROPLANG-1">
+  <title>
+   Description
+  </title>
+
+  <para>
+   <application>droplang</application> is a utility for removing an 
+   existing programming language from a
+   <productname>PostgreSQL</productname> database.
+   <application>droplang</application> can drop any procedural language,
+   even those not supplied by the <productname>PostgreSQL</> distribution.
+  </para>
+  <para>
+   Although backend programming languages can be removed directly using
+   several <acronym>SQL</acronym> commands, it is recommended to use
+   <application>droplang</application> because it performs a number
+   of checks and is much easier to use. See
+   <xref linkend="sql-droplanguage" endterm="sql-droplanguage-title">
+   for more.
+  </para>
+ </refsect1>
+
+
+ <refsect1>
+  <title>Options</title>
 
-  <refsect2 id="R2-APP-DROPLANG-1">
-   <title>
-    Inputs
-   </title>
    <para>
     <application>droplang</application> accepts the following command line arguments:
     
@@ -126,12 +149,31 @@ PostgreSQL documentation
 
     </variablelist>
    </para>
-  </refsect2>
+ </refsect1>
+
+
+ <refsect1>
+  <title>Environment</title>
+
+  <variablelist>
+   <varlistentry>
+    <term><envar>PGHOST</envar></term>
+    <term><envar>PGPORT</envar></term>
+    <term><envar>PGUSER</envar></term>
+
+    <listitem>
+     <para>
+      Default connection parameters.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+
+ <refsect1>
+   <title>Diagnostics</title>
 
-  <refsect2 id="R2-APP-DROPLANG-2">
-   <title>
-    Outputs
-   </title>
    <para>
     Most error messages are self-explanatory. If not, run
     <application>droplang</application> with the <option>--echo</option>
@@ -139,43 +181,20 @@ PostgreSQL documentation
     for details. Check also under <xref linkend="APP-PSQL">
     for more possibilities.
    </para>
-  </refsect2>
- </refsynopsisdiv>
- 
- <refsect1 id="R1-APP-DROPLANG-1">
-  <title>
-   Description
-  </title>
-
-  <para>
-   <application>droplang</application> is a utility for removing an 
-   existing programming language from a
-   <productname>PostgreSQL</productname> database.
-   <application>droplang</application> can drop any procedural language,
-   even those not supplied by the <productname>PostgreSQL</> distribution.
-  </para>
-  <para>
-   Although backend programming languages can be removed directly using
-   several <acronym>SQL</acronym> commands, it is recommended to use
-   <application>droplang</application> because it performs a number
-   of checks and is much easier to use. See
-   <xref linkend="sql-droplanguage" endterm="sql-droplanguage-title">
-   for more.
-  </para>
  </refsect1>
 
- <refsect1 id="R1-APP-DROPLANG-2">
-  <title>
-   Notes
-  </title>
+
+ <refsect1>
+  <title>Notes</title>
 
   <para>
    Use <xref linkend="app-createlang"> to add a language.
   </para>
  </refsect1>
  
- <refsect1 id="R1-APP-DROPLANG-3">
-  <title>Usage</title>
+
+ <refsect1>
+  <title>Examples</title>
 
   <informalexample>
    <para>
@@ -186,6 +205,16 @@ PostgreSQL documentation
    </para>
   </informalexample>
  </refsect1>
+
+ <refsect1>
+  <title>See Also</title>
+
+  <simplelist type="inline">
+   <member><xref linkend="app-createlang"></member>
+   <member><xref linkend="sql-droplanguage" endterm="sql-droplanguage-title"></member>
+  </simplelist>
+ </refsect1>
+
 </refentry>
 
 <!-- Keep this comment at the end of the file