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.

diff --git a/doc/src/sgml/install-windows.sgml b/doc/src/sgml/install-windows.sgml
index ea86102c836cecbec54315ff7c468165cd705665..8681a7f683c6f68711b84a58bc302c34b13ee97d 100644 (file)
--- a/doc/src/sgml/install-windows.sgml
+++ b/doc/src/sgml/install-windows.sgml
@@ -47,15 +47,26 @@
   Cygwin uses the normal build system, see
    and the specific notes in
    and .
-  These builds cannot generate 64-bit binaries.
-  Cygwin is not recommended and should
-  only be used for older versions of Windows where
+  To produce native 64 bit binaries in these environments, use the tools from
+  Mingw64. These tools can also be used to
+  cross-compile for 32 bit and 64 bit Windows 
+  targets on other hosts, such as Linux and 
+  Darwin.
+  Cygwin is not recommended for running a
+  production server, and it should only be used for running on
+  older versions of Windows where
   the native build does not work, such as
-  Windows 98. MinGW is
-  only recommended if you are building other modules using it. The official
+  Windows 98. The official
   binaries are built using Visual Studio.
  
 
+ 
+  Native builds of psql don't support command 
+  line editing. The Cygwin build does support
+  command line editing, so it should be used where psql is needed for
+  interactive use on  Windows.
+ 
+
  
   Building with <productname>Visual C++</productname> or the</div>
<div class="diff ctx">   <productname>Platform SDK</productname>

diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml
index 0258eecda43b0ad0e31e002e8882092f8aaf5a53..aa2c4a63025c73aab28d3c7ee6af55e541dc83bc 100644 (file)
--- 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
     )]]> and
-    is no longer recommended.
+    running a server under Cygwin is no longer recommended.
    
 
    
@@ -2371,6 +2371,16 @@ createlang: language installation failed: ERROR:  could not load library "/opt/d
       
      
 
+     
+      
+        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
+        export LANG=C.utf8 before building, and then
+        setting it back to the previous setting, after you have installed
+        PostgreSQL.
+      
+     
+
      
       
        The parallel regression tests (make check)
@@ -2580,6 +2590,14 @@ cc-1020 cc: ERROR File = pqcomm.c, Line = 427
     creating the binaries.
    
 
+   
+     To build 64 bit binaries using MinGW, install the 64 bit tool set
+     from , put its bin
+     directory in the PATH, and run 
+     configure with the  
+     --host=x86_64-w64-mingw option.
+   
+
    
     After you have everything installed, it is suggested that you
     run psql