← Back to branch summary

~vcs-imports/mammoth-replicator/trunk

« back to all changes in this revision

Viewing changes to doc/src/sgml/install-win32.sgml

  • Committer: alvherre
  • Date: 2005-12-16 21:24:52 UTC
  • Revision ID: svn-v4:db760fc0-0f08-0410-9d63-cc6633f64896:trunk:1
Initial import of the REL8_0_3 sources from the Pgsql CVS repository.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/src/sgml/install-win32.sgml
 
1
<!--
 
2
$PostgreSQL: pgsql/doc/src/sgml/install-win32.sgml,v 1.23 2004-12-27 20:13:47 tgl Exp $
 
3
-->
 
4
 
 
5
<chapter id="install-win32">
 
6
 <title>Client-Only Installation on <productname>Windows</productname></title>
 
7
 
 
8
 <indexterm>
 
9
  <primary>installation</primary>
 
10
  <secondary>on Windows</secondary>
 
11
 </indexterm>
 
12
 
 
13
 <para>
 
14
  Although a complete <productname>PostgreSQL</productname> installation
 
15
  for <productname>Windows</> can only be built using
 
16
  <productname>MinGW</productname> or
 
17
  <productname>Cygwin</productname>, the C client library
 
18
  (<application>libpq</application>) and the interactive terminal
 
19
  (<application>psql</application>) can be compiled using other Windows
 
20
  tool sets. Makefiles are included in the source distribution for
 
21
  <productname>Microsoft Visual C++</productname> and
 
22
  <productname>Borland C++</productname>. It should be possible to
 
23
  compile the libraries manually for other configurations.
 
24
 </para>
 
25
 
 
26
 <tip>
 
27
  <para>
 
28
   Using <productname>MinGW</productname> or
 
29
   <productname>Cygwin</productname> is preferred.  If using one of
 
30
   those tool sets, see <xref linkend="installation">.
 
31
  </para>
 
32
 </tip>
 
33
 
 
34
 <para>
 
35
  To build everything that you can on <productname>Windows</productname>
 
36
  using <productname>Microsoft Visual C++</productname>, change into the
 
37
  <filename>src</filename> directory and type the command
 
38
<screen>
 
39
<userinput>nmake /f win32.mak</userinput>
 
40
</screen>
 
41
  This assumes that you have <productname>Visual C++</productname> in
 
42
  your path.
 
43
 </para>
 
44
 
 
45
 <para>
 
46
  To build everything using <productname>Borland
 
47
  C++</productname>, change into the <filename>src</filename> directory
 
48
  and type the command
 
49
<screen>
 
50
<userinput>make -DCFG=Release /f bcc32.mak</userinput>
 
51
</screen>
 
52
 </para>
 
53
 
 
54
 <para>
 
55
  The following files will be built:
 
56
 
 
57
  <variablelist>
 
58
   <varlistentry>
 
59
    <term><filename>interfaces\libpq\Release\libpq.dll</filename></term>
 
60
    <listitem>
 
61
     <para>
 
62
      The dynamically linkable frontend library
 
63
     </para>
 
64
    </listitem>
 
65
   </varlistentry>
 
66
  
 
67
   <varlistentry>
 
68
    <term><filename>interfaces\libpq\Release\libpqdll.lib</filename></term>
 
69
    <listitem>
 
70
     <para>
 
71
      Import library to link your programs to <filename>libpq.dll</filename>
 
72
     </para>
 
73
    </listitem>
 
74
   </varlistentry>
 
75
 
 
76
   <varlistentry>
 
77
    <term><filename>interfaces\libpq\Release\libpq.lib</filename></term>
 
78
    <listitem>
 
79
     <para>
 
80
      Static version of the frontend library
 
81
     </para>
 
82
    </listitem>
 
83
   </varlistentry>
 
84
 
 
85
   <varlistentry>
 
86
    <term><filename>bin\psql\Release\psql.exe</filename></term>
 
87
    <listitem>
 
88
     <para>
 
89
      The <productname>PostgreSQL</productname> interactive terminal
 
90
     </para>
 
91
    </listitem>
 
92
   </varlistentry>
 
93
  </variablelist>
 
94
 </para>
 
95
 
 
96
 <para>
 
97
  The only file that really needs to be installed is the
 
98
  <filename>libpq.dll</filename> library.  This file should in most
 
99
  cases be placed in the <filename>WINNT\SYSTEM32</filename> directory
 
100
  (or in <filename>WINDOWS\SYSTEM</filename> on a Windows 95/98/ME
 
101
  system).  If this file is installed using a setup program, it should
 
102
  be installed with version checking using the
 
103
  <symbol>VERSIONINFO</symbol> resource included in the file, to
 
104
  ensure that a newer version of the library is not overwritten.
 
105
 </para>
 
106
 
 
107
 <para>
 
108
  If you plan to do development using <application>libpq</application>
 
109
  on this machine, you will have to add the
 
110
  <filename>src\include</filename> and
 
111
  <filename>src\interfaces\libpq</filename> subdirectories of the source
 
112
  tree to the include path in your compiler's settings.
 
113
 </para>
 
114
 
 
115
 <para>
 
116
  To use the library, you must add the
 
117
  <filename>libpqdll.lib</filename> file to your project.  (In Visual
 
118
  C++, just right-click on the project and choose to add it.)
 
119
 </para>
 
120
 
 
121
</chapter>
 
122
 
 
123
<!-- Keep this comment at the end of the file
 
124
Local variables:
 
125
mode:sgml
 
126
sgml-omittag:t
 
127
sgml-shorttag:t
 
128
sgml-minimize-attributes:nil
 
129
sgml-always-quote-attributes:t
 
130
sgml-indent-step:1
 
131
sgml-indent-data:t
 
132
sgml-parent-document:nil
 
133
sgml-default-dtd-file:"./reference.ced"
 
134
sgml-exposed-tags:nil
 
135
sgml-local-catalogs:("/usr/lib/sgml/catalog")
 
136
sgml-local-ecat-files:nil
 
137
End:
 
138
-->