Updates

doc/src/sgml/install-win32.sgml

@@ -1,101 +1,112 @@
- <chapter id="install-win32">
+<chapter id="install-win32">
-  <title>Installation on Win32</title>
+ <title>Installation on <productname>Windows</productname></title>
 
  <abstract>
   <para>
-    Build and installation instructions for <productname>Postgres</productname>
+   Build, installation, and use instructions for
-    v6.4 client libraries on Win32.
+   <productname>PostgreSQL</productname> client libraries on
+   <productname>Windows</productname>
   </para>
  </abstract>
 
-  <sect1 id="win32-install-build">
-   <title>Building the libraries</title>
-
  <para>
-    The makefiles included in <productname>Postgres</productname> are written
+  Although <productname>PostgreSQL</productname> is written for
-    for <productname>Microsoft Visual C++</productname>, and will probably
+  Unix-like operating systems, the C client library
-    not work with other systems. It should be possible to compile the libaries
+  (<application>libpq</application>) and the interactive terminal
-    manually in other cases.
+  (<application>psql</application>) can be compiled natively under
+  Windows.  The makefiles included in the source distribution are
+  written for <productname>Microsoft Visual C++</productname> and will
+  probably not work with other systems.  It should be possible to
+  compile the libaries manually in other cases.
  </para>
 
+ <tip>
   <para>
-    To build the libraries, change directory into the <filename>src</filename>
+   If you are using Windows NT/2000 you can build and use all of
-    directory, and type the commands
+   <productname>PostgreSQL</productname> <quote>the Unix way</quote>
-    <programlisting>
+   if you install the <productname>Cygwin</productname> toolkit first.
-copy include\config.h.win32 include\config.h
+   In that case see <xref linkend="installation">.
-nmake /f win32.mak
+  </para>
-    </programlisting>
+ </tip>
-    This assumes that you have <productname>Visual C++</productname> in your
+
-    path.
+ <para>
+  To build everything that you can on
+  <productname>Windows</productname>, change into the
+  <filename>src</filename> directory and type the command
+<screen>
+<userinput>nmake /f win32.mak</userinput>
+</screen>
+  This assumes that you have <productname>Visual C++</productname> in
+  your path.
  </para>
 
  <para>
   The following files will be built:
 
-    <itemizedlist spacing="compact" mark="bullet">
+  <variablelist>
+   <varlistentry>
+    <term><filename>interfaces\libpq\Release\libpq.dll</filename></term>
     <listitem>
      <para>
-       <filename>interfaces\libpq\Release\libpq.dll</filename>
+      The dynamically linkable frontend library
-       - The dynamically linkable frontend library
      </para>
     </listitem>
+   </varlistentry>
   
+   <varlistentry>
+    <term><filename>interfaces\libpq\Release\libpqdll.lib</filename></term>
     <listitem>
      <para>
-       <filename>interfaces\libpq\Release\libpqdll.lib</filename>
+      Import library to link your program to <filename>libpq.dll</filename>
-       - Import library to link your program to libpq.dll
      </para>
     </listitem>
+   </varlistentry>
 
+   <varlistentry>
+    <term><filename>interfaces\libpq\Release\libpq.lib</filename></term>
     <listitem>
      <para>
-       <filename>interfaces\libpq\Release\libpq.lib</filename> - Static library version of the frontend library
+      Static library version of the frontend library
      </para>
     </listitem>
+   </varlistentry>
 
+   <varlistentry>
+    <term><filename>bin\psql\Release\psql.exe</filename></term>
     <listitem>
      <para>
-       <filename>bin\psql\Release\psql.exe</filename> - The <productname>Postgresql</productname> interactive SQL monitor
+      The <productname>PostgreSQL</productname> interactive terminal
      </para>
     </listitem>
-
+   </varlistentry>
-    </itemizedlist>
+  </variablelist>
  </para>
 
-  </sect1>
+ <para>
+  The only file that really needs to be installed is the
+  <filename>libpq.dll</filename> library.  This file should in most
+  cases be placed in the <filename>WINNT\SYSTEM32</filename> directory
+  (or in <filename>WINDOWS\SYSTEM</filename> on a Windows 95/98/ME
+  system).  If this file is installed using a setup program, it should
+  be installed with version checking using the
+  <symbol>VERSIONINFO</symbol> resource included in the file, to
+  ensure that a newer version of the library is not overwritten.
+ </para>
 
-  <sect1 id="win32-install-install">
-   <title>Installing the libraries</title>
  <para>
-    The only part of the library to really be installed is the 
+  If you plan to do development using libpq on this machine, you will
-    <filename>libpq.dll</filename> library. This file should in most cases 
+  have to add the <filename>src\include</filename> and
-    be placed in the <filename>WINNT\SYSTEM32</filename> directory (or in
+  <filename>src\interfaces\libpq</filename> subdirectories of the
-    <filename>WINDOWS\SYSTEM</filename> on a Windows 95/98 system). If this
+  source tree to the include path in your compilers settings.
-    file is installed using a setup program, it should be installed with
-    version checking using the VERSIONINFO resource included in the file,
-    to ensure that a newer version of the library is not overwritten.
  </para>
-   <para>
-    If you plan to do development using libpq on this machine, you will have
-    to add the <filename>src\include</filename> and 
-    <filename>src\interfaces\libpq</filename> directories to the include
-    path in your compilers settings.
-   </para>
-  </sect1>
 
-  <sect1 id="win32-install-use">
-   <title>Using the libraries</title>
  <para>
-    To use the libraries, you must add the <filename>libpqdll.lib</filename>
+  To use the libraries, you must add the
-    file to your project (in Visual C++, just right-click on the project and
+  <filename>libpqdll.lib</filename> file to your project.  (In Visual
-    chose to add it).
+  C++, just right-click on the project and chose to add it.)
  </para>
-   <para>
+
-    Once this is done, it should be possible to use the library just as you
+</chapter>
-    would on a Unix platform.
-   </para>
-  </sect1>
- </chapter>
 
 <!-- Keep this comment at the end of the file
 Local variables: