Rewritten Woe32 recommendations.

diff --git a/ChangeLog b/ChangeLog
index 8176354b24a67ec4d0b13fe90809f4f9c31e236e..0b2f2e3b9cc133b304881f6dd5ac6c848a30e7cd 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2006-08-04  Bruno Haible  <bruno@clisp.org>
+
+       * README.woe32: Recommend to use cygwin as development environment,
+       and mingw only as target environment. Needed to avoid libtool problems
+       reported by Matthew McGillis <matthew@jenika.com>.
+
 2006-07-31  Bruno Haible  <bruno@clisp.org>
 
        * autogen.sh: Invoke gnulib-tool inside gettext-runtime directory.

diff --git a/README.woe32 b/README.woe32
index 0c04b0b0e0753b9810cef9b15482c5da7a67af0e..39728c0dd65a56bb32239714582920edd4f3ab0f 100644 (file)
--- a/README.woe32
+++ b/README.woe32
@@ -1,4 +1,32 @@
 Installation on Woe32 (WinNT/2000/XP, Win95/98/ME):
 
-Building requires the mingw development environment (includes gcc).
-MS Visual C/C++ with "nmake" is no longer supported.
+This file explains how to create binaries for the mingw execution environment.
+For how to create binaries for the cygwin environment, please see the normal
+INSTALL file.  MS Visual C/C++ with "nmake" is no longer supported.
+
+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,
+  - the mingw runtime package, also from the cygwin site.
+
+You must not install cygwin programs directly under /usr/local -
+because the mingw compiler and linker would pick up the include files
+and libraries from there, thus introducing an undesired dependency to
+cygwin. You can for example achieve this by using the
+configure option --prefix=/usr/local/cygwin each time you build a
+program for cygwin.
+
+Building for mingw is then achieved through the following configure
+command:
+
+   CPPFLAGS="-mno-cygwin -Wall -I/usr/local/mingw/include" \
+   CFLAGS="-mno-cygwin -O2 -g" \
+   CXXFLAGS="-mno-cygwin -O2 -g" \
+   LDFLAGS="-mno-cygwin -L/usr/local/mingw/lib" \
+   ./configure --host=i586-pc-mingw32 --prefix=/usr/local/mingw
+
+The -mno-cygwin tells the cygwin compiler and linker to build for mingw.
+The -I and -L option are so that packages previously built for the
+same environment are found. The --host option tells the various
+tools that you are building for mingw, not cygwin.