Avoid polluting cygwin namespace.
[libsigsegv/ericb.git] / README.woe32
blob2ce5eaa0b3c300b73fc1709e0712c22380517c32
1 Installation on Woe32 (WinNT/2000/XP/Vista/7, Win95/98/ME):
3 There are three ways to create binaries of this package for Woe32:
4 1) Native binaries, built using the mingw tool chain.
5 2) Native binaries, built using the MS Visual C/C++ tool chain.
6 3) Binaries for the Cygwin environment. For these, please see the normal 
7    INSTALL file.
9 ===============================================================================
10 Installation instructions on Woe32 with Cygwin, compiling for mingw32:
12 - Requires the cygwin tools, with the mingw32 compiler and runtime packages.
14 - Build instructions:
16   Make sure that cygwin's 'bin' directory is the first entry in PATH.
18   Run bash.
20         ./configure --host=i386-pc-mingw32 CC="gcc-3 -mno-cygwin"
21         make
22         make check
23         make install
25 ===============================================================================
26 Installation instructions on Woe32 with MS Visual C/C++ 4.0, 5.0, 6.0, or 7.0:
28 - Requires MS Visual C/C++ 4.0 or 5.0 or 6.0 or 7.0.
30   Note that binaries created with MSVC 7.0 should not be distributed: They
31   depend on a closed-source library 'msvcr70.dll' which is not normally part
32   of a Woe32 installation. You cannot distribute 'msvcr70.dll' with the
33   binaries - this would be a violation of the GPL and of the Microsoft EULA.
34   You can distribute the binaries without including 'msvcr70.dll', but this
35   will cause problems for users that don't have this library on their system.
36   Therefore it is not recommended. This problem does not occur with MSVC 6.0
37   and earlier.
39 - Cannot build in a separate directory.
41 - Build instructions:
43    Make sure that the MSVC4.0 or MSVC5.0 or MSVC6.0 utilities ("cl" etc.) are
44    found in PATH.
46    For shared library (DLL): **NOT YET SUPPORTED**
48         nmake -f Makefile.msvc DLL=1 MFLAGS=-MD check
50    For static library:
52         nmake -f Makefile.msvc check
54    If you want to build both the shared and static library, you have to
55    unpack the libsigsegv sources twice in different directories. Don't mix
56    the two formats; you cannot use the sigsegv.h generated for the static
57    library together with the shared library or vice versa.
59 - Installation:
61    Copy sigsegv.h to your header file repository.
62    Copy sigsegv.lib to your library repository.
63    If you built for shared library, also copy sigsegv.dll into one of the
64    directories listed in your PATH, or into the directory containing the
65    executable which shall make use of libsigsegv.