From: Bruno Haible <bruno@clisp.org>
Date: Thu, 29 Jun 2023 13:19:10 +0000 (+0200)
Subject: Update the installation instructions for Windows.
X-Git-Tag: v0.23~419
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=eecc0f83e2e22dde2aa4d18367bdf1f688bac6f1;p=thirdparty%2Fgettext.git

Update the installation instructions for Windows.

* INSTALL.windows: Add a note about MSYS2.
---

diff --git a/INSTALL.windows b/INSTALL.windows
index a1dc4ae03..3aa1c004a 100644
--- a/INSTALL.windows
+++ b/INSTALL.windows
@@ -8,7 +8,7 @@ There are three ways to create binaries of this package for Microsoft Windows:
 ===============================================================================
 1) Native binaries, built using the mingw tool chain.
 
-   I recommend to use the Cygwin environment as the development environment
+   I recommend to use the Cygwin environment as the development environment (*)
    and mingw only as the target (runtime, deployment) environment.
    For this, you need to install
      * Cygwin (from https://cygwin.com/),
@@ -57,6 +57,13 @@ There are three ways to create binaries of this package for Microsoft Windows:
 
       make install
 
+   (*) Note: The MSYS2 environment as a development environment is *not*
+       supported.  This environment contains an ignoble and ignominious hack:
+       In a program invocation, the program *by default* receives different
+       arguments than the ones that the caller has passed.  See
+       <https://www.msys2.org/wiki/Porting/#filesystem-namespaces>.
+       All program invocations in this environment are therefore unreliable.
+
 ===============================================================================
 2) Native binaries, built using the MS Visual C/C++ tool chain.