Update docs on building for Windows to accomodate current reality.

Document how to build 64 bit Windows binaries using the MinGW64 tool set.
Remove recommendation against using Mingw as a build platform.
Be more specific about when Cygwin is useful and when it's not,  in
particular note its usefulness for running psql, and
add a note about building on Cygwin in non-C locales.

Per recent discussions.
This commit is contained in:
Andrew Dunstan 2011-01-31 13:40:45 -05:00
parent c5ba11f8fb
commit 51be78b09a
2 changed files with 35 additions and 6 deletions

View File

@ -47,15 +47,26 @@
<productname>Cygwin</productname> uses the normal build system, see
<xref linkend="installation"> and the specific notes in
<xref linkend="installation-notes-mingw"> and <xref linkend="installation-notes-cygwin">.
These builds cannot generate 64-bit binaries.
<productname>Cygwin</productname> is not recommended and should
only be used for older versions of <productname>Windows</productname> where
To produce native 64 bit binaries in these environments, use the tools from
<productname>Mingw64</productname>. These tools can also be used to
cross-compile for 32 bit and 64 bit <productname>Windows</productname>
targets on other hosts, such as <productname>Linux</productname> and
<productname>Darwin</productname>.
<productname>Cygwin</productname> is not recommended for running a
production server, and it should only be used for running on
older versions of <productname>Windows</productname> where
the native build does not work, such as
<productname>Windows 98</productname>. <productname>MinGW</productname> is
only recommended if you are building other modules using it. The official
<productname>Windows 98</productname>. The official
binaries are built using <productname>Visual Studio</productname>.
</para>
<para>
Native builds of <application>psql</application> don't support command
line editing. The <productname>Cygwin</productname> build does support
command line editing, so it should be used where psql is needed for
interactive use on <productname>Windows</productname>.
</para>
<sect1 id="install-windows-full">
<title>Building with <productname>Visual C++</productname> or the
<productname>Platform SDK</productname></title>

View File

@ -2312,7 +2312,7 @@ createlang: language installation failed: ERROR: could not load library "/opt/d
PostgreSQL can be built using Cygwin, a Linux-like environment for
Windows, but that method is inferior to the native Windows build
<![%standalone-ignore[(see <xref linkend="install-windows">)]]> and
is no longer recommended.
running a server under Cygwin is no longer recommended.
</para>
<para>
@ -2371,6 +2371,16 @@ createlang: language installation failed: ERROR: could not load library "/opt/d
</para>
</listitem>
<listitem>
<para>
Building might fail on some systems where a locale other than
C is in use. To fix this, set the locale to C by doing
<command>export LANG=C.utf8</command> before building, and then
setting it back to the previous setting, after you have installed
PostgreSQL.
</para>
</listitem>
<listitem>
<para>
The parallel regression tests (<literal>make check</literal>)
@ -2580,6 +2590,14 @@ cc-1020 cc: ERROR File = pqcomm.c, Line = 427
creating the binaries.
</para>
<para>
To build 64 bit binaries using MinGW, install the 64 bit tool set
from <ulink url="http://www.mingw64.org/"></ulink>, put its bin
directory in the <envar>PATH</envar>, and run
<command>configure</command> with the
<command>--host=x86_64-w64-mingw</command> option.
</para>
<para>
After you have everything installed, it is suggested that you
run <application>psql</application>