view README.mingw @ 4687:283fb289c510

[gaim-migrate @ 4998] This is a new buddy list. Lots of things about it just Don't Work. I probably already know about those things, and you'd just be wasting my time in submitting a bug report about it. I decided that instead of getting it to all work perfectly before committing, that I'd get it in cvs, and slowly fix it with regular commits. That way, it's easier to keep track of things, and other developers can help. Plus, I'm getting pissed off at the buddy list and want it to die. It's kinda boring, and doing nothing but the buddy list for such a long time has just gotten me very bitter. After 0.60 is released later this week, Gaim will resume being fun. This week is going to be very stressful, though, I'm sure. Things you ought to know about this buddy list: - It crashes - It leaks - There's no way to edit the buddy list, or access offline buddies - Most of the menus and buttons and whatnot just plain ol' don't work. - Status icons are only implemented for AIM. That's mostly just because I'm lazy. As such, you may want to be wary of updating this. If you do decide to update this, you may want to learn "cvs update -D yesterday" as well :) All the art there is just placeholder art. You probably won't really have as many problems as it sounds like you will from reading this. This message is extra-negative to stress that I don't want to be bothered with complaints about something not working about it :). I'll repeat: If something doesn't work, I probably already know about it. If you want to actually help with something, I'd be delighted to have it. IM me. -s. committer: Tailor Script <[e-mail]>

How to build Gaim using MinGw
=============================

Set Up Build Environment
------------------------

- Install Cygwin bash shell (www.cygwin.com).

- Install MinGw v1.1 (http://www.mingw.org)
  Make sure to read the installation instructions. Make sure to set MinGw's
  bin directory in your PATH (in .bash_login), before Cygwin's bin dir 
  (so that mingw's build tools are used over cygwin's).

Install LIBs, DLLs and headers used by GAIM
-------------------------------------------

  Assuming you have the gaim sources in ~/gaim, you will need to do the
  fowllowing:

  GTK & GLIB (v 2.0.9 as of writing)
  ----------------------------------

  $ mkdir -p ~/win32-dev/gtk_2_0/zips

  Download the following from thw win32 download page at www.gtk.org to the
  zips dir you just created:

  atk-1.0.3-20020821.zip            
  atk-dev-1.0.3-20020821.zip        
  gettext-dev-0.10.40-20020904.zip 
  glib-2.0.6-20020802.zip
  glib-dev-2.0.6-20020802.zip
  gtk+-2.0.6-20020921.zip
  gtk+-dev-2.0.6-20020921.zip
  libiconv-1.7-w32.bin.zip
  libintl-0.10.40-tml-20020904.zip
  libjpeg-6b-bin.zip
  libpng-1.2.4-1-bin.zip
  pango-1.0.4-20020921.zip
  pango-dev-1.0.4-20020921.zip
  tiff-3.5.7-bin.zip
  zlib-1.1.4-bin.zip

  Make sure that after unziping, the binaries (dlls and exes) have the correct
  executable permissions (e.g. "chmod 755 iconv.dll"):

  $ cd ~/win32-dev/gtk_2_0/zips
  $ unzip -d .. "*.zip"
  $ cd ..
  $ cp lib/libintl-1.dll ./bin
  $ cd libiconv-1.7-w32.bin
  $ cp iconv.exe ../bin
  $ cp iconv.lib ../lib
  $ cp localcharset.dll ../lib
  $ cp iconv.dll ../lib
  $ cp iconv.dll ../bin
  $ cp iconv.h ../include/
  $ cp libcharset.h ../include/

  NOTE: If you use a more recent versions of any of these packages, you may
  need to move files around so that they can be found when Gaim is built.

  Perl56
  ------

  Download perl-5.6.1 from www.cpan.org.  You can build perl56 yourself if
  you have MS Visual C++, or you can download a win32 binary distribution
  (I tried SiePerl successfully).  In either case make sure you do the
  following:

  $ mkdir -p ~/win32-dev/perl56
  
  Copy Perl's "CORE" directory to ~/win32-dev/perl56 as well as "perl56.dll"
  and "perl56.lib".

  Aspell-15
  ---------

  Download the dev package (aspell-15.tar.gz) from http://gaim.sf.net/win32,
  and untar it under ~/win32-dev.

  Gtkspell 2.0.3
  --------------

  Download the dev package (gtkspell-2.0.3-20021223.tar.gz) from 
  http://gaim.sf.net/win32, and untar it under ~/win32-dev. 

Build Gaim
----------

  $ cd ~/gaim
  $ make -f Makefile.mingw install

Run Gaim
--------

  $ cd ~/gaim/win32-install-dir
  $ ./gaim.exe

  That's it..

  Note: If you wish to build an install exe of Gaim, then you need to install
  NSIS from http://www.nullsoft.com/free/nsis/ making sure to place its
  binary dir in your PATH. Then...

  $ cd ~/gaim
  $ make -f Makefile.mingw installer

Debugging
---------

  There is quite a good "Just In Time" debugger for MinGw:
  http://mefriss1.swan.ac.uk/~jfonseca/gnu-win32/software/drmingw/


Happy Gaiming...
Herman Bloggs <[e-mail]>