Include installation instructions for WIN32 client-side libraries.

From Magnus Hagander <mha@sollentuna.net>.

diff --git a/doc/src/sgml/admin.sgml b/doc/src/sgml/admin.sgml
index 2296c5171488c57e57a11054cf506458c0b7b1d5..41a2d2ffa261930b01baf8ca4a49fdd59edad908 100644 (file)
--- a/doc/src/sgml/admin.sgml
+++ b/doc/src/sgml/admin.sgml
@@ -1,11 +1,15 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/Attic/admin.sgml,v 1.8 1998/10/31 09:36:31 thomas Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/Attic/admin.sgml,v 1.9 1999/01/07 02:59:45 thomas Exp $
 
 Postgres Administrator's Guide.
 Derived from postgres.sgml.
 - thomas 1998-10-27
 
 $Log: admin.sgml,v $
+Revision 1.9  1999/01/07 02:59:45  thomas
+Include installation instructions for WIN32 client-side libraries.
+From Magnus Hagander <mha@sollentuna.net>.
+
 Revision 1.8  1998/10/31 09:36:31  thomas
 Cleanup for v6.4 release.
 Make new file current.sgml to hold release info for the current release.
@@ -31,6 +35,7 @@ Bigger updates to the installation instructions (install and config).
 <!entity current  SYSTEM "current.sgml">
 <!entity intro-ag SYSTEM "intro-ag.sgml">
 <!entity install  SYSTEM "install.sgml">
+<!entity installw SYSTEM "install-win32.sgml">
 <!entity options  SYSTEM "pg_options.sgml">
 <!entity ports    SYSTEM "ports.sgml">
 <!entity recovery SYSTEM "recovery.sgml">
@@ -116,6 +121,7 @@ It provides SQL92/SQL3 language support,
 &ports;
 &config;
 &install;
+&installw;
 &runtime;
 &options;
 &start-ag;
@@ -134,3 +140,19 @@ Don't bother with an index until we get some index entries.
 
 </Book>
 
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+sgml-parent-document:nil
+sgml-default-dtd-file:"./reference.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:"/usr/lib/sgml/CATALOG"
+sgml-local-ecat-files:nil
+End:
+-->

diff --git a/doc/src/sgml/install-win32.sgml b/doc/src/sgml/install-win32.sgml
new file mode 100644 (file)
index 0000000..303ec7f
--- /dev/null
+++ b/doc/src/sgml/install-win32.sgml
@@ -0,0 +1,115 @@
+<Chapter Id="install-win32">
+<Title>Installation on Win32</Title>
+
+<Abstract>
+<Para>
+Build and installation instructions for <ProductName>Postgres</ProductName>
+v6.4 client libraries on Win32.
+</Para>
+</Abstract>
+
+<Sect1>
+<Title>Building the libraries</Title>
+
+<Para>
+The makefiles included in <ProductName>Postgres</ProductName> 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>
+
+<Para>
+To build the libraries, change directory into the <filename>src</filename>
+directory, and type the command
+<programlisting>
+nmake /f win32.mak
+</programlisting>
+This assumes that you have <ProductName>Visual C++</ProductName> in your
+path.
+</Para>
+
+<Para>
+The following files will be built:
+
+<ItemizedList Mark="bullet" Spacing="compact">
+<ListItem>
+<Para>
+<filename>interfaces\libpq\Release\libpq.dll</filename>
+ - The dynamically linkable frontend library
+</Para>
+</ListItem>
+
+<ListItem>
+<Para>
+<filename>interfaces\libpq\Release\libpqdll.lib</filename>
+ - Import library to link your program to libpq.dll
+</Para>
+</ListItem>
+
+<ListItem>
+<Para>
+<filename>interfaces\libpq\Release\libpq.lib</filename> - Static library version of the frontend library
+</Para>
+</ListItem>
+
+<ListItem>
+<Para>
+<filename>bin\psql\Release\psql.exe</filename> - The <ProductName>Postgresql</ProductName> interactive SQL monitor
+</Para>
+</ListItem>
+
+</ItemizedList>
+</Para>
+
+</Sect1>
+
+<Sect1>
+<Title>Installing the libraries</Title>
+<Para>
+The only part of the library to really 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 system). If this
+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>
+<Title>Using the libraries</Title>
+<Para>
+To use the libraries, you must add the <filename>libpqdll.lib</filename>
+file to your project (in Visual 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
+would on a Unix platform.
+</Para>
+</Sect1>
+
+</Chapter>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+sgml-parent-document:nil
+sgml-default-dtd-file:"./reference.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:"/usr/lib/sgml/CATALOG"
+sgml-local-ecat-files:nil
+End:
+-->

diff --git a/doc/src/sgml/postgres.sgml b/doc/src/sgml/postgres.sgml
index 3a04bf64f81c6b760c955c95e818124269578b20..3544e6962890608a31473c79c4cf2b89cee7c8e5 100644 (file)
--- a/doc/src/sgml/postgres.sgml
+++ b/doc/src/sgml/postgres.sgml
@@ -1,11 +1,15 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/postgres.sgml,v 1.15 1998/12/18 16:23:34 thomas Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/postgres.sgml,v 1.16 1999/01/07 02:59:45 thomas Exp $
 
 Postgres integrated documentation.
 Other subset docs should be copied and shrunk from here.
 thomas 1998-02-23
 
 $Log: postgres.sgml,v $
+Revision 1.16  1999/01/07 02:59:45  thomas
+Include installation instructions for WIN32 client-side libraries.
+From Magnus Hagander <mha@sollentuna.net>.
+
 Revision 1.15  1998/12/18 16:23:34  thomas
 Fix typos in rules.sgml.
 Add Emacs configuration block to postgres.sgml.
@@ -78,6 +82,7 @@ Move SQL reference pages up into the User's Guide.
 <!entity config   SYSTEM "config.sgml">
 <!entity current  SYSTEM "current.sgml">
 <!entity install  SYSTEM "install.sgml">
+<!entity installw SYSTEM "install-win32.sgml">
 <!entity intro-ag SYSTEM "intro-ag.sgml">
 <!entity options  SYSTEM "pg_options.sgml">
 <!entity ports    SYSTEM "ports.sgml">
@@ -240,6 +245,7 @@ Installation and maintenance information.
 &ports;
 &config;
 &install;
+&installw;
 &runtime;
 &options;
 &start-ag;