Add BuildRequire to enable iconv support
[platform/upstream/gettext.git] / README.woe32
1 Installation on Woe32 (WinNT/2000/XP/Vista/7, Win95/98/ME):
2
3 This file explains how to create binaries for the mingw execution environment.
4 For how to create binaries for the cygwin environment, please see the normal
5 INSTALL file.  MS Visual C/C++ with "nmake" is no longer supported.
6
7 I recommend to use the cygwin environment as the development environment
8 and mingw only as the target (runtime, deployment) environment.
9 For this, you need to install
10   - cygwin,
11   - the mingw runtime package, also from the cygwin site.
12
13 You must not install cygwin programs directly under /usr/local -
14 because the mingw compiler and linker would pick up the include files
15 and libraries from there, thus introducing an undesired dependency to
16 cygwin. You can for example achieve this by using the
17 configure option --prefix=/usr/local/cygwin each time you build a
18 program for cygwin.
19
20 Building for mingw is then achieved through the following preparation
21 and configure commands:
22
23    PATH=/usr/local/mingw/bin:$PATH
24    export PATH
25    ./configure --host=i586-pc-mingw32 --prefix=/usr/local/mingw \
26      CC="gcc-3 -mno-cygwin" \
27      CXX="g++-3 -mno-cygwin" \
28      CPPFLAGS="-Wall -I/usr/local/mingw/include" \
29      LDFLAGS="-L/usr/local/mingw/lib"
30
31 The -mno-cygwin option tells the cygwin compiler and linker to build for
32 mingw. The -I and -L option are so that packages previously built for the
33 same environment are found. The --host option tells the various
34 tools that you are building for mingw, not cygwin.
35
36 It is also possible to build 64-bit mode binaries, by using the development
37 tool chain from the mingw-w64 project <http://mingw-w64.sourceforge.net/>
38 and the configure options:
39    --host=x86_64-w64-mingw32 --build=x86_64-w64-mingw32 \
40    CC=x86_64-w64-mingw32-gcc CXX=x86_64-w64-mingw32-g++ \
41    LD=x86_64-w64-mingw32-ld NM=x86_64-w64-mingw32-nm \
42    AR=x86_64-w64-mingw32-ar RANLIB=x86_64-w64-mingw32-ranlib
43
44 Dependencies:
45
46 This package depends on GNU libiconv. (See the file DEPENDENCIES.) Before
47 building this package, you need to build GNU libiconv, in the same development
48 environment, with the same configure options, and install it ("make install").