Contributed by Jill Maddox <jillm@rubens.its.unimelb.edu.au>.
[libsigsegv/ericb.git] / README.woe32
blob4c63ff314825aef5e80112fcda088411c2cb30a3
1 Installation on Woe32 (WinNT/2000/XP, Win95/98/ME):
3 ===============================================================================
4 Installation instructions on Woe32 with Cygwin, compiling for mingw32:
6 - Requires the cygwin tools, with the mingw32 compiler and runtime packages.
8 - Build instructions:
10   Make sure that cygwin's 'bin' directory is the first entry in PATH.
12   Run bash.
14         CC="gcc -mno-cygwin" ./configure --host=i386-pc-mingw32
15         make
16         make check
17         make install
19 ===============================================================================
20 Installation instructions on Woe32 with MS Visual C/C++ 4.0, 5.0, 6.0, or 7.0:
22 - Requires MS Visual C/C++ 4.0 or 5.0 or 6.0 or 7.0.
24   Note that binaries created with MSVC 7.0 should not be distributed: They
25   depend on a closed-source library 'msvcr70.dll' which is not normally part
26   of a Woe32 installation. You cannot distribute 'msvcr70.dll' with the
27   binaries - this would be a violation of the GPL and of the Microsoft EULA.
28   You can distribute the binaries without including 'msvcr70.dll', but this
29   will cause problems for users that don't have this library on their system.
30   Therefore it is not recommended. This problem does not occur with MSVC 6.0
31   and earlier.
33 - Cannot build in a separate directory.
35 - Build instructions:
37    Make sure that the MSVC4.0 or MSVC5.0 or MSVC6.0 utilities ("cl" etc.) are
38    found in PATH.
40    For shared library (DLL): **NOT YET SUPPORTED**
42         nmake -f Makefile.msvc DLL=1 MFLAGS=-MD check
44    For static library:
46         nmake -f Makefile.msvc check
48    If you want to build both the shared and static library, you have to
49    unpack the libsigsegv sources twice in different directories. Don't mix
50    the two formats; you cannot use the sigsegv.h generated for the static
51    library together with the shared library or vice versa.
53 - Installation:
55    Copy sigsegv.h to your header file repository.
56    Copy sigsegv.lib to your library repository.
57    If you built for shared library, also copy sigsegv.dll into one of the
58    directories listed in your PATH, or into the directory containing the
59    executable which shall make use of libsigsegv.