Include installation instructions for WIN32 client-side libraries.

From Magnus Hagander <mha@sollentuna.net>.
This commit is contained in:
Thomas G. Lockhart 1999-01-07 02:59:45 +00:00
parent a1164a2508
commit 350f422bdb
3 changed files with 145 additions and 2 deletions

View File

@ -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:
-->

View File

@ -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:
-->

View File

@ -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;