Structure reference pages consistently. Document that structure.

Add information about environment variables.

doc/src/sgml/ref/pg_ctl-ref.sgml

@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_ctl-ref.sgml,v 1.14 2002/04/21 19:02:39 thomas Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_ctl-ref.sgml,v 1.15 2002/07/28 15:22:20 petere Exp $
 PostgreSQL documentation
 -->
 
@@ -225,9 +225,32 @@ PostgreSQL documentation
     </variablelist>
    </para>
   </refsect2>
+ </refsect1>
 
-  <refsect2>
-   <title>Files</title>
+
+ <refsect1>
+  <title>Environment</title>
+
+  <variablelist>
+   <varlistentry>
+    <term><envar>PGDATA</envar></term>
+
+    <listitem>
+     <para>
+      Default data direction location
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+
+  <para>
+   For others, see <xref linkend="app-postmaster">.
+  </para>
+ </refsect1>
+
+
+ <refsect1>
+  <title>Files</title>
 
    <para>
     If the file <filename>postmaster.opts.default</filename> exists in
@@ -235,8 +258,17 @@ PostgreSQL documentation
     options to the <application>postmaster</application>, unless
     overridden by the <option>-o</option> option.
    </para>
-  </refsect2>
+ </refsect1>
 
+
+ <refsect1>
+  <title>Notes</title>
+
+  <para>
+   Waiting for complete start is not a well-defined operation and may
+   fail if access control is set up so that a local client cannot
+   connect without manual interaction.  It should be avoided.
+  </para>
  </refsect1>
 
 
@@ -330,15 +362,6 @@ Command line was:
   </refsect2>
  </refsect1>
 
- <refsect1>
-  <title>Bugs</title>
-
-  <para>
-   Waiting for complete start is not a well-defined operation and may
-   fail if access control is set up so that a local client cannot
-   connect without manual interaction.  It should be avoided.
-  </para>
- </refsect1>
 
  <refsect1>
   <title>See Also</title>