Distribute a README for Windows users.

3 files changed, 46 insertions, 1 deletions

diff --git a/ChangeLog b/ChangeLog
index 40b17c1..a2c294c 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,10 @@
 2009-04-26  Bruno Haible  <bruno@clisp.org>
 
+	* README.woe32: New file, from GNU gettext.
+	* Makefile.am (EXTRA_DIST): Add it.
+
+2009-04-26  Bruno Haible  <bruno@clisp.org>
+
 	* doc/uniconv.texi: Update for changed calling conventions of
 	u*_conv_from_encoding and u*_conv_to_encoding functions.
 
diff --git a/Makefile.am b/Makefile.am
index 868f478..91c0bf3 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -38,4 +38,4 @@ EXTRA_DIST += woe32dll/export.h
 
 # Woe32 support.
 
-EXTRA_DIST += build-aux/windres-options
+EXTRA_DIST += README.woe32 build-aux/windres-options
diff --git a/README.woe32 b/README.woe32
new file mode 100644
index 0000000..07c7260
--- /dev/null
+++ b/README.woe32
@@ -0,0 +1,40 @@
+Installation on Woe32 (WinNT/2000/XP/Vista, Win95/98/ME):
+
+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 preparation
+and configure commands:
+
+   PATH=/usr/local/mingw/bin:$PATH
+   export PATH
+   ./configure --host=i586-pc-mingw32 --prefix=/usr/local/mingw \
+     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"
+
+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.
+
+Dependencies:
+
+This package depends on GNU libiconv. (See the file DEPENDENCIES.) Before
+building this package, you need to build GNU libiconv, in the same development
+environment, with the same configure options, and install it ("make install").