Minor updates and copy-editing.

Author: tglsfdc

doc/src/sgml/installation.sgml

@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/installation.sgml,v 1.218 2004/12/24 18:37:26 momjian Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/installation.sgml,v 1.219 2004/12/24 19:12:36 tgl Exp $ -->
 
 <chapter id="installation">
  <title><![%standalone-include[<productname>PostgreSQL</>]]>
@@ -146,7 +146,7 @@ su - postgres
       <filename>libperl</filename> library must be a shared library
       also on most platforms.  This appears to be the default in
       recent <productname>Perl</productname> versions, but it was not
-      in earlier versions, and in general it is the choice of whomever
+      in earlier versions, and in any case it is the choice of whomever
       installed Perl at your site.
      </para>
 
@@ -238,8 +238,9 @@ su - postgres
 
     <listitem>
      <para>
-      <application>Kerberos</>, <productname>OpenSSL</>, or <application>PAM</>,
-      if you want to support authentication using these services.
+      <application>Kerberos</>, <productname>OpenSSL</>, or
+      <application>PAM</>, if you want to support authentication or
+      encryption using these services.
      </para>
     </listitem>
    </itemizedlist>
@@ -393,23 +394,27 @@ su - postgres
      old one then shut down the old server, at the latest before you
      install the new files:
 <screen>
-<userinput>kill -INT `cat /usr/local/pgsql/data/postmaster.pid | sed 1q`</>
+<userinput>pg_ctl stop</>
 </screen>
-     Versions prior to 7.0 do not have this
-     <filename>postmaster.pid</> file. If you are using such a version
-     you must find out the process ID of the server yourself, for
-     example by typing <userinput>ps ax | grep postmaster</>, and
-     supply it to the <command>kill</> command.
+     On systems that have <productname>PostgreSQL</> started at boot time,
+     there is probably a start-up file that will accomplish the same thing. For
+     example, on a <systemitem class="osname">Red Hat Linux</> system one
+     might find that
+<screen>
+<userinput>/etc/rc.d/init.d/postgresql stop</userinput>
+</screen>
+     works.
     </para>
 
     <para>
-     On systems that have <productname>PostgreSQL</> started at boot time, there is
-     probably a start-up file that will accomplish the same thing. For
-     example, on a <systemitem class="osname">Red Hat Linux</> system one might find that
+     Very old versions might not have <application>pg_ctl</>.  If you
+     can't find it or it doesn't work, find out the process ID of the
+     old server, for
+     example by typing <userinput>ps ax | grep postmaster</>, and
+     signal it to stop this way:
 <screen>
-<userinput>/etc/rc.d/init.d/postgresql stop</userinput>
+<userinput>kill -INT <replaceable>processID</></userinput>
 </screen>
-     works.  Another possibility is <userinput>pg_ctl stop</>.
     </para>
    </step>
 
@@ -443,10 +448,10 @@ su - postgres
   </para>
 
   <para>
-   These topics are discussed at length in <![%standalone-include[the
-   documentation,]]> <![%standalone-ignore[<xref
-   linkend="migration">,]]> which you are encouraged to read in any
-   case.
+   Further discussion appears in
+   <![%standalone-include[the documentation,]]>
+   <![%standalone-ignore[<xref linkend="migration">,]]>
+   which you are encouraged to read in any case.
   </para>
  </sect1>
 
@@ -691,7 +696,7 @@ su - postgres
          Enables Native Language Support (<acronym>NLS</acronym>),
          that is, the ability to display a program's messages in a
          language other than English.
-         <replaceable>LANGUAGES</replaceable> is a space separated
+         <replaceable>LANGUAGES</replaceable> is a space-separated
          list of codes of the languages that you want supported, for
          example <literal>--enable-nls='de fr'</>.  (The intersection
          between your list and the set of actually provided
@@ -825,7 +830,7 @@ su - postgres
        <term><option>--without-readline</option></term>
        <listitem>
         <para>
-         Prevents the use of the <application>Readline</> library.  This disables
+         Prevents use of the <application>Readline</> library.  This disables
          command-line editing and history in
          <application>psql</application>, so it is not recommended.
         </para>
@@ -836,7 +841,8 @@ su - postgres
        <term><option>--with-rendezvous</option></term>
        <listitem>
         <para>
-         Build with Rendezvous support.
+         Build with Rendezvous support.  This requires Rendezvous support
+         in your operating system.  Recommended on Mac OS X.
         </para>
        </listitem>
       </varlistentry>
@@ -864,7 +870,8 @@ su - postgres
          Make the client libraries thread-safe.  This allows
          concurrent threads in <application>libpq</application> and
          <application>ECPG</application> programs to safely control
-         their private connection handles.
+         their private connection handles.  This option requires adequate
+         threading support in your operating system.
         </para>
        </listitem>
       </varlistentry>
@@ -873,8 +880,12 @@ su - postgres
        <term><option>--without-zlib</option></term>
        <listitem>
         <para>
-         Prevents the use of the <application>Zlib</> library.  This disables
-         compression support in <application>pg_dump</application>.
+         <indexterm>
+          <primary>zlib</primary>
+         </indexterm>
+         Prevents use of the <application>Zlib</> library.  This disables
+         support for compressed archives in <application>pg_dump</application>
+         and <application>pg_restore</application>.
          This option is only intended for those rare systems where this
          library is not available.
         </para>
@@ -936,12 +947,12 @@ su - postgres
 
     <para>
      If you prefer a C compiler different from the one
-     <filename>configure</filename> picks then you can set the
+     <filename>configure</filename> picks, you can set the
      environment variable <envar>CC</> to the program of your choice.
      By default, <filename>configure</filename> will pick
-     <filename>gcc</filename> unless this is inappropriate for the
-     platform.  Similarly, you can override the default compiler flags
-     with the <envar>CFLAGS</envar> variable.
+     <filename>gcc</filename> if available, else the platform's
+     default (usually <filename>cc</>).  Similarly, you can override the
+     default compiler flags if needed with the <envar>CFLAGS</envar> variable.
     </para>
 
     <para>
@@ -1002,8 +1013,8 @@ All of PostgreSQL is successfully made. Ready to install.
    <note>
     <para>
      If you are upgrading an existing system and are going to install
-     the new files over the old ones, then you should have backed up
-     your data and shut down the old server by now, as explained in
+     the new files over the old ones, be sure to back up
+     your data and shut down the old server before proceeding, as explained in
      <xref linkend="install-upgrading"> above.
     </para>
    </note>
@@ -1036,8 +1047,11 @@ All of PostgreSQL is successfully made. Ready to install.
 
    <para>
     The standard installation provides all the header files needed for client
-    application development as well as for any server-side program
-    development (such as custom functions or data types written in C).
+    application development as well as for server-side program
+    development, such as custom functions or data types written in C.
+    (Prior to <productname>PostgreSQL</> 8.0, a separate <literal>gmake
+    install-all-headers</> command was needed for the latter, but this
+    step has been folded into the standard install.)
    </para>
 
    <formalpara>

doc/src/sgml/postgres.sgml

@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/postgres.sgml,v 1.69 2004/12/23 05:37:39 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/postgres.sgml,v 1.70 2004/12/24 19:12:37 tgl Exp $
 -->
 
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.2//EN" [
@@ -117,7 +117,7 @@ $PostgreSQL: pgsql/doc/src/sgml/postgres.sgml,v 1.69 2004/12/23 05:37:39 tgl Exp
     <productname>PostgreSQL</> database administrator.  This includes
     installation of the software, set up and configuration of the
     server, management of users and databases, and maintenance tasks.
-    Anyone who runs a <productname>PostgreSQL</> server, either for
+    Anyone who runs a <productname>PostgreSQL</> server, even for
     personal use, but especially in production, should be familiar
     with the topics covered in this part.
    </para>
@@ -135,8 +135,8 @@ $PostgreSQL: pgsql/doc/src/sgml/postgres.sgml,v 1.69 2004/12/23 05:37:39 tgl Exp
     The first few chapters are written so that they can be understood
     without prerequisite knowledge, so that new users who need to set
     up their own server can begin their exploration with this part.
-    The rest of this part which is about tuning and management
-    presupposes that the reader is familiar with the general use of
+    The rest of this part is about tuning and management; that material
+    assumes that the reader is familiar with the general use of
     the <productname>PostgreSQL</> database system.  Readers are
     encouraged to look at <xref linkend="tutorial"> and <xref
     linkend="sql"> for additional information.