|
1 | | -<!-- $PostgreSQL: pgsql/doc/src/sgml/install-win32.sgml,v 1.31 2007/03/13 16:03:35 mha Exp $ --> |
| 1 | +<!-- $PostgreSQL: pgsql/doc/src/sgml/install-win32.sgml,v 1.32 2007/03/14 00:15:26 tgl Exp $ --> |
2 | 2 |
|
3 | 3 | <chapter id="install-win32"> |
4 | 4 | <title>Installation on <productname>Windows</productname></title> |
|
71 | 71 | <title>Requirements</title> |
72 | 72 | <para> |
73 | 73 | PostgreSQL will build using either the professional versions (any edition) |
74 | | - or the free Express edition of |
75 | | - <productname>Visual Studio 2005</productname>. The following additional products |
76 | | - are required to build the complete package. Use the |
77 | | - <filename>config.pl</filename> to specify which directories the libraries |
78 | | - are available in. |
| 74 | + or the free Express edition of |
| 75 | + <productname>Visual Studio 2005</productname>. The following additional products |
| 76 | + are required to build the complete package. Use the |
| 77 | + <filename>config.pl</filename> to specify which directories the libraries |
| 78 | + are available in. |
79 | 79 |
|
80 | 80 | <variablelist> |
81 | 81 | <varlistentry> |
82 | 82 | <term><productname>ActiveState Perl</productname></term> |
83 | 83 | <listitem><para> |
84 | | - ActiveState Perl is required to run the build generation scripts. MinGW |
85 | | - or Cygwin perl will not work. It must also be present in the PATH. |
86 | | - Binaries can be downloaded from |
87 | | - <ulink url="http://www.activestate.com"></>. |
88 | | - </para></listitem> |
| 84 | + ActiveState Perl is required to run the build generation scripts. MinGW |
| 85 | + or Cygwin perl will not work. It must also be present in the PATH. |
| 86 | + Binaries can be downloaded from |
| 87 | + <ulink url="http://www.activestate.com"></>. |
| 88 | + </para></listitem> |
89 | 89 | </varlistentry> |
90 | 90 |
|
91 | 91 | <varlistentry> |
92 | | - <term><productname>ActiveState TCL</productname></term> |
| 92 | + <term><productname>ActiveState TCL</productname></term> |
93 | 93 | <listitem><para> |
94 | | - Required for building <application>PL/TCL</application>. |
95 | | - </para></listitem> |
| 94 | + Required for building <application>PL/TCL</application>. |
| 95 | + </para></listitem> |
96 | 96 | </varlistentry> |
97 | 97 |
|
98 | 98 | <varlistentry> |
99 | 99 | <term><productname>Bison</productname> and |
100 | | - <productname>Flex</productname></term> |
| 100 | + <productname>Flex</productname></term> |
101 | 101 | <listitem><para> |
102 | | - Bison and Flex are required to build from CVS, but not required when |
103 | | - building from a release file. Note that Bison version 2.0 will not |
104 | | - work, but both earlier and later versions do. Bison and Flex can be |
105 | | - downloaded from <ulink url="http://gnuwin32.sourceforge.net"></>. |
106 | | - </para></listitem> |
| 102 | + Bison and Flex are required to build from CVS, but not required when |
| 103 | + building from a release file. Note that Bison version 2.0 will not |
| 104 | + work, but both earlier and later versions do. Bison and Flex can be |
| 105 | + downloaded from <ulink url="http://gnuwin32.sourceforge.net"></>. |
| 106 | + </para></listitem> |
107 | 107 | </varlistentry> |
108 | 108 |
|
109 | | - <varlistentry> |
110 | | - <term><productname>Microsoft Platform SDK</productname></term> |
111 | | - <listitem><para> |
112 | | - It is recommended that you upgrade to the latest available version |
113 | | - of the <productname>Microsoft Platform SDK</productname>, available |
114 | | - for download from <ulink url="http://www.microsoft.com/downloads/"></>. |
115 | | - </para></listitem> |
116 | | - </varlistentry |
| 109 | + <varlistentry> |
| 110 | + <term><productname>Microsoft Platform SDK</productname></term> |
| 111 | + <listitem><para> |
| 112 | + It is recommended that you upgrade to the latest available version |
| 113 | + of the <productname>Microsoft Platform SDK</productname>, available |
| 114 | + for download from <ulink url="http://www.microsoft.com/downloads/"></>. |
| 115 | + </para></listitem> |
| 116 | + </varlistentry> |
117 | 117 |
|
118 | 118 | <varlistentry> |
119 | 119 | <term><productname>MIT Kerberos</productname></term> |
120 | 120 | <listitem><para> |
121 | | - Required for Kerberos authentication support. MIT Kerberos can be |
122 | | - downloaded from |
123 | | - <ulink url="http://web.mit.edu/Kerberos/dist/index.html"></>. |
124 | | - </para></listitem> |
| 121 | + Required for Kerberos authentication support. MIT Kerberos can be |
| 122 | + downloaded from |
| 123 | + <ulink url="http://web.mit.edu/Kerberos/dist/index.html"></>. |
| 124 | + </para></listitem> |
125 | 125 | </varlistentry> |
126 | 126 |
|
127 | 127 | <varlistentry> |
128 | 128 | <term><productname>libxml2</productname> and |
129 | | - <productname>libxslt</productname></term> |
| 129 | + <productname>libxslt</productname></term> |
130 | 130 | <listitem><para> |
131 | 131 | Required for XML support. Binaries can be downloaded from |
132 | | - <ulink url="http://zlatkovic.com/pub/libxml"></> or source from |
133 | | - <ulink url="http://xmlsoft.org"></>. Note that libxml2 requires iconv, |
134 | | - which is available from the same download location. |
135 | | - </para></listitem> |
| 132 | + <ulink url="http://zlatkovic.com/pub/libxml"></> or source from |
| 133 | + <ulink url="http://xmlsoft.org"></>. Note that libxml2 requires iconv, |
| 134 | + which is available from the same download location. |
| 135 | + </para></listitem> |
136 | 136 | </varlistentry> |
137 | 137 |
|
138 | 138 | <varlistentry> |
139 | 139 | <term><productname>openssl</productname></term> |
140 | 140 | <listitem><para> |
141 | 141 | Required for SSL support. Binaries can be downloaded from |
142 | 142 | <ulink url="http://www.slproweb.com/products/Win32OpenSSL.html"></> |
143 | | - or source from <ulink url="http://www.openssl.org"></>. |
144 | | - </para></listitem> |
| 143 | + or source from <ulink url="http://www.openssl.org"></>. |
| 144 | + </para></listitem> |
145 | 145 | </varlistentry> |
146 | 146 |
|
147 | 147 | <varlistentry> |
148 | 148 | <term><productname>pthreads</productname></term> |
149 | 149 | <listitem><para> |
150 | 150 | Required for building the <application>ECPG</application> libraries. |
151 | | - Binaries can be downloaded from |
152 | | - <ulink url="ftp://sources.redhat.com/pub/pthreads-win32"></>. |
153 | | - </para></listitem> |
| 151 | + Binaries can be downloaded from |
| 152 | + <ulink url="ftp://sources.redhat.com/pub/pthreads-win32"></>. |
| 153 | + </para></listitem> |
154 | 154 | </varlistentry> |
155 | 155 |
|
156 | 156 | <varlistentry> |
157 | 157 | <term><productname>Python</productname></term> |
158 | 158 | <listitem><para> |
159 | 159 | Required for building <application>PL/Python</application>. Binaries can |
160 | | - be downloaded from <ulink url="http://www.python.org"></>. |
161 | | - </para></listitem> |
| 160 | + be downloaded from <ulink url="http://www.python.org"></>. |
| 161 | + </para></listitem> |
162 | 162 | </varlistentry> |
163 | 163 |
|
164 | | - <varlistentry> |
165 | | - <term><productname>zlib</productname></term> |
| 164 | + <varlistentry> |
| 165 | + <term><productname>zlib</productname></term> |
166 | 166 | <listitem><para> |
167 | | - Required for compression support in <application>pg_dump</application> |
168 | | - and <application>pg_restore</application>. Binaries can be downloaded |
169 | | - from <ulink url="http://www.zlib.net"></>. |
170 | | - </para></listitem> |
| 167 | + Required for compression support in <application>pg_dump</application> |
| 168 | + and <application>pg_restore</application>. Binaries can be downloaded |
| 169 | + from <ulink url="http://www.zlib.net"></>. |
| 170 | + </para></listitem> |
171 | 171 | </varlistentry> |
172 | 172 |
|
173 | 173 | </variablelist> |
|
179 | 179 |
|
180 | 180 | <para> |
181 | 181 | To build all of PostgreSQL in debug configuration (the default), run the |
182 | | - command: |
| 182 | + command: |
183 | 183 | <screen> |
184 | 184 | <userinput> |
185 | 185 | build |
|
204 | 204 |
|
205 | 205 | <para> |
206 | 206 | It is also possible to build from inside the Visual Studio GUI. In this |
207 | | - case, you need to run: |
| 207 | + case, you need to run: |
208 | 208 | <screen> |
209 | 209 | <userinput> |
210 | 210 | perl mkvcbuild.pl |
211 | 211 | </userinput> |
212 | 212 | </screen> |
213 | 213 | from the command prompt, and then open the generated |
214 | | - <filename>pgsql.sln</filename> (in the root directory of the source tree) |
215 | | - in Visual Studio. |
| 214 | + <filename>pgsql.sln</filename> (in the root directory of the source tree) |
| 215 | + in Visual Studio. |
216 | 216 | </para> |
217 | 217 | </sect2> |
218 | 218 |
|
|
221 | 221 |
|
222 | 222 | <para> |
223 | 223 | Most of the time, the automatic dependency tracking in Visual Studio will |
224 | | - handle changed files. But if there have been large changes, you may need |
225 | | - to clean the installation. To do this, simply run the |
226 | | - <filename>clean.bat</filename> command, which will automatically clean out |
227 | | - all generated files. |
| 224 | + handle changed files. But if there have been large changes, you may need |
| 225 | + to clean the installation. To do this, simply run the |
| 226 | + <filename>clean.bat</filename> command, which will automatically clean out |
| 227 | + all generated files. |
228 | 228 | </para> |
229 | 229 |
|
230 | 230 | <para> |
231 | 231 | By default, all files are written into a subdirectory of the |
232 | | - <filename>debug</filename> or <filename>release</filename> directories. To |
233 | | - install these files using the standard layout, and also generate the files |
234 | | - required to initialize and use the database, run the command: |
| 232 | + <filename>debug</filename> or <filename>release</filename> directories. To |
| 233 | + install these files using the standard layout, and also generate the files |
| 234 | + required to initialize and use the database, run the command: |
235 | 235 | <screen> |
236 | 236 | <userinput> |
237 | 237 | perl install.pl c:\destination\directory |
|
245 | 245 |
|
246 | 246 | <para> |
247 | 247 | Building the PostgreSQL documentation in HTML format requires several tools |
248 | | - and files. Create a root directory for all these files, and store them |
249 | | - in the subdirectories in the list below. |
| 248 | + and files. Create a root directory for all these files, and store them |
| 249 | + in the subdirectories in the list below. |
250 | 250 | <variablelist> |
251 | 251 | <varlistentry> |
252 | 252 | <term>OpenJade 1.3.1-2</term> |
253 | 253 | <listitem><para> |
254 | 254 | Download from |
255 | | - <ulink url="http://sourceforge.net/project/downloading.php?groupname=openjade&filename=openjade-1_3_1-2-bin.zip"></> |
256 | | - and uncompress in the subdirectory <filename>openjade-1.3.1</filename>. |
| 255 | + <ulink url="http://sourceforge.net/project/downloading.php?groupname=openjade&filename=openjade-1_3_1-2-bin.zip"></> |
| 256 | + and uncompress in the subdirectory <filename>openjade-1.3.1</filename>. |
257 | 257 | </para></listitem> |
258 | 258 | </varlistentry> |
259 | 259 |
|
260 | 260 | <varlistentry> |
261 | 261 | <term>DocBook DTD 4.2</term> |
262 | 262 | <listitem><para> |
263 | 263 | Download from |
264 | | - <ulink url="http://www.oasis-open.org/docbook/sgml/4.2/docbook-4.2.zip"></> |
265 | | - and uncompress in the subdirectory <filename>docbook</filename>. |
| 264 | + <ulink url="http://www.oasis-open.org/docbook/sgml/4.2/docbook-4.2.zip"></> |
| 265 | + and uncompress in the subdirectory <filename>docbook</filename>. |
266 | 266 | </para></listitem> |
267 | 267 | </varlistentry> |
268 | 268 |
|
|
272 | 272 | Download from |
273 | 273 | <ulink url="http://sourceforge.net/project/downloading.php?groupname=docbook&filename=docbook-dsssl-1.79.zip"></> |
274 | 274 | and uncompress in the subdirectory |
275 | | - <filename>docbook-dsssl-1.79</filename>. |
| 275 | + <filename>docbook-dsssl-1.79</filename>. |
276 | 276 | </para></listitem> |
277 | 277 | </varlistentry> |
278 | 278 |
|
279 | 279 | <varlistentry> |
280 | 280 | <term>ISO character entities</term> |
281 | 281 | <listitem><para> |
282 | 282 | Download from |
283 | | - <ulink url="http://www.oasis-open.org/cover/ISOEnts.zip"></> and |
284 | | - uncompress in the subdirectory <filename>docbook</filename>. |
| 283 | + <ulink url="http://www.oasis-open.org/cover/ISOEnts.zip"></> and |
| 284 | + uncompress in the subdirectory <filename>docbook</filename>. |
285 | 285 | </para></listitem> |
286 | 286 | </varlistentry> |
287 | 287 | </variablelist> |
288 | 288 | Edit the <filename>buildenv.bat</filename> file, and add a variable for the |
289 | | - location of the root directory, for example: |
| 289 | + location of the root directory, for example: |
290 | 290 | <screen> |
291 | 291 | @ECHO OFF |
292 | 292 | SET DOCROOT=c:\docbook |
293 | 293 | </screen> |
294 | 294 | To build the documentation, run the command |
295 | | - <filename>builddoc.bat</filename>. Note that this will actually run the |
296 | | - build twice, in order to generate the indexes. The generated HTML files |
297 | | - will be in <filename>doc\src\sgml</filename>. |
| 295 | + <filename>builddoc.bat</filename>. Note that this will actually run the |
| 296 | + build twice, in order to generate the indexes. The generated HTML files |
| 297 | + will be in <filename>doc\src\sgml</filename>. |
298 | 298 | </para> |
299 | 299 | </sect2> |
300 | 300 |
|
|
0 commit comments