add new sigc++2 directory
[ardour.git] / libs / gtkmm2 / README.win32
1 Building gtkmm on Win32
2 ===========================
3
4 Currently, both the mingw (native win32) gcc compiler and MS Visual
5 Studio 2005 are supported. gtkmm can be built with mingw32-gcc using
6 the gnu autotools (automake, autoconf, libtool). As explicitly
7 stated in the gtk+ for win32 distribution (http://www.gimp.org/win32/),
8 the gcc compiler provided by the cygwin distribution should not be
9 used to build gtk+/gtkmm libraries and/or applications (see the
10 README.win32 that comes with the gtk+ DLLs). This MIGHT cause
11 conflicts between the cygwin and msvcrt runtime environments.
12
13 1. Mingw
14
15 The mingw distribution which has been tested with this release is the
16 following :
17
18 * MinGW-4.1 as the base distribution.
19
20 The bare mingw distribution does not provide the necessary tools (sh, perl, m4
21 , autoconf, automake, ..) to run the provided configure script "as is". One 
22 (currently non supported) solution is to use mingw in conjunction with msys,
23 which is readily available on the mingw website (http://www.mingw.org/).
24
25 The preferred method is to combine the cygwin distribution (for the unix tools
26 that were mentioned above) with mingw by making sure that the mingw
27 tools (gcc, ld, dlltool, ..) are called first.
28
29 First, make sure that you have working distribution of the native port
30 of both libsigc++-2.0.x and gtk+-2.0 on win32 (see
31 http://www.gimp.org/win32). If you can't compile a simple gtk+ example
32 using gcc and `pkg-config --cflags --libs`, you should not even think
33 about trying to compile gtkmm, let alone using precompiled libgtkmm
34 DLLs to port your gtkmm application !
35
36 The configure script can then be called using (as an example) the
37 following options
38
39 ./configure --prefix=/target --build=i386-pc-mingw32 --disable-static
40
41 then
42
43 make
44 make check
45 make install
46
47 2. MS Visual Studio 2005
48
49 Open the gtkmm.sln solution file in the MSVC_Net2003 directory. In
50 the Tools/Options panel, add the appropriate GTK+, glibmm include and lib
51 directories to the Projects and Solutions/VC++ directories. Build the
52 solution. 
53
54 Important NOTE : to circumvent the C++ compiler bug described in this
55 bugzilla entry (http://bugzilla.gnome.org/show_bug.cgi?id=158040), it
56 is necessary to add '/vd2' to the list of compiler options when
57 building and/or using gtkmm with Visual Studio 2005. 
58
59 gtkmm-2.8 will probably not work correctly with Visual Studio 7.1 or
60 below because of the aforementioned bug.
61
62 3. Gtkmm methods and signals not available on win32
63
64 All gtkmm methods and signals are available on win32.
65
66 4. Gtkmm examples and demos on win32
67
68 All demos and examples compile/run on win32
69