[gaim-migrate @ 4736]
[pidgin-git.git] / README.mingw
blobdf262b8de573e576a15b705e5fa8790286dd76ec
1 How to build Gaim using MinGw
2 =============================
4 Set Up Build Environment
5 ------------------------
7 - Install Cygwin bash shell (www.cygwin.com).
9 - Install MinGw v1.1 (http://www.mingw.org)
10   Make sure to read the installation instructions. Make sure to set MinGw's
11   bin directory in your PATH (in .bash_login), before Cygwin's bin dir 
12   (so that mingw's build tools are used over cygwin's).
14 Install LIBs, DLLs and headers used by GAIM
15 -------------------------------------------
17   Assuming you have the gaim sources in ~/gaim, you will need to do the
18   fowllowing:
20   GTK & GLIB (v 2.0.9 as of writing)
21   ----------------------------------
23   $ mkdir -p ~/win32-dev/gtk_2_0/zips
25   Download the following from thw win32 download page at www.gtk.org to the
26   zips dir you just created:
28   atk-1.0.3-20020821.zip            
29   atk-dev-1.0.3-20020821.zip        
30   gettext-dev-0.10.40-20020904.zip 
31   glib-2.0.6-20020802.zip
32   glib-dev-2.0.6-20020802.zip
33   gtk+-2.0.6-20020921.zip
34   gtk+-dev-2.0.6-20020921.zip
35   libiconv-1.7-w32.bin.zip
36   libintl-0.10.40-tml-20020904.zip
37   libjpeg-6b-bin.zip
38   libpng-1.2.4-1-bin.zip
39   pango-1.0.4-20020921.zip
40   pango-dev-1.0.4-20020921.zip
41   tiff-3.5.7-bin.zip
42   zlib-1.1.4-bin.zip
44   Make sure that after unziping, the binaries (dlls and exes) have the correct
45   executable permissions (e.g. "chmod 755 iconv.dll"):
47   $ cd ~/win32-dev/gtk_2_0/zips
48   $ unzip -d .. "*.zip"
49   $ cd ..
50   $ cp lib/libintl-1.dll ./bin
51   $ cd libiconv-1.7-w32.bin
52   $ cp iconv.exe ../bin
53   $ cp iconv.lib ../lib
54   $ cp localcharset.dll ../lib
55   $ cp iconv.dll ../lib
56   $ cp iconv.dll ../bin
57   $ cp iconv.h ../include/
58   $ cp libcharset.h ../include/
60   NOTE: If you use a more recent versions of any of these packages, you may
61   need to move files around so that they can be found when Gaim is built.
63   Perl56
64   ------
66   Download perl-5.6.1 from www.cpan.org.  You can build perl56 yourself if
67   you have MS Visual C++, or you can download a win32 binary distribution
68   (I tried SiePerl successfully).  In either case make sure you do the
69   following:
71   $ mkdir -p ~/win32-dev/perl56
72   
73   Copy Perl's "CORE" directory to ~/win32-dev/perl56 as well as "perl56.dll"
74   and "perl56.lib".
76   Aspell-15
77   ---------
79   Download the dev package (aspell-15.tar.gz) from http://gaim.sf.net/win32,
80   and untar it under ~/win32-dev.
82   Gtkspell 2.0.3
83   --------------
85   Download the dev package (gtkspell-2.0.3-20021223.tar.gz) from 
86   http://gaim.sf.net/win32, and untar it under ~/win32-dev. 
88 Build Gaim
89 ----------
91   $ cd ~/gaim
92   $ make -f Makefile.mingw install
94 Run Gaim
95 --------
97   $ cd ~/gaim/win32-install-dir
98   $ ./gaim.exe
100   That's it..
102   Note: If you wish to build an install exe of Gaim, then you need to install
103   NSIS from http://www.nullsoft.com/free/nsis/ making sure to place its
104   binary dir in your PATH. Then...
106   $ cd ~/gaim
107   $ make -f Makefile.mingw installer
109 Debugging
110 ---------
112   There is quite a good "Just In Time" debugger for MinGw:
113   http://mefriss1.swan.ac.uk/~jfonseca/gnu-win32/software/drmingw/
116 Happy Gaiming...
117 Herman Bloggs <hermanator12002@yahoo.com>
118   
122   
123