From 51be78b09a83b8d533e4a9f81cf9a7f2edde6654 Mon Sep 17 00:00:00 2001
From: Andrew Dunstan <andrew@dunslane.net>
Date: Mon, 31 Jan 2011 13:40:45 -0500
Subject: [PATCH] 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.
---
 doc/src/sgml/install-windows.sgml | 21 ++++++++++++++++-----
 doc/src/sgml/installation.sgml    | 20 +++++++++++++++++++-
 2 files changed, 35 insertions(+), 6 deletions(-)

diff --git a/doc/src/sgml/install-windows.sgml b/doc/src/sgml/install-windows.sgml
index ea86102c83..8681a7f683 100644
--- a/doc/src/sgml/install-windows.sgml
+++ b/doc/src/sgml/install-windows.sgml
@@ -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>
diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml
index 0258eecda4..aa2c4a6302 100644
--- a/doc/src/sgml/installation.sgml
+++ b/doc/src/sgml/installation.sgml
@@ -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>
-- 
2.40.0