gajim-plural/README

Welcome and thanks for trying out Gajim.

=RUNTIME REQUIREMENTS=
python2.4 (python2.3 should work too)
pygtk2.6 or higher
python-libglade
python-pysqlite2

some distros also split too much python standard library.
I know SUSE does. In such distros you also need python-xml
the xml lib that *comes* with python and not pyxml or whatever

=COMPILE-TIME REQUIREMENTS=
python-dev
python-gtk2-dev
libgtk2.0-dev		# aka. gtk2-devel
libxss-dev			# for idle detection module (Some distributions (f.e. Debian) split xscreensaver)
libgtkspell-dev	# for gtkspell module
intltool

NOTE:
if you still have problems compiling, you may want to try removing the gtk1 series of the above dependencies

Optionally:
dnspython or pydns for SRV support; if you don't know what that is, you don't need it
gtkspell and aspell-LANG where lang is your locale eg. en, fr etc
GnomePythonExtras 2.10 or above so you can avoid compiling trayicon and gtkspell

NOTE TO PACKAGERS:
Gajim is a GTK+ app and not a gnome one. Just do 'make' so you don't require gnomepythonextras
which is gnome dep

=INSTALLATION PROCEDURE=
tar jxvf gajim-version.tar.bz2
cd gajim
make	# builds all modules
su -c make install

To specify what modules to build do:
make help

To specify where to install do:
su -c make PREFIX=custom_path install

=RUNNING GAJIM=
gajim

or if you didn't 'make install' you can also run from gajim folder with
./launch.sh

Last but not least, you can run Gajim from your GNOME/XFCE/KDE/whatever menus.

=UNINSTALLATION PROCEDURE=
su -c make uninstall
this will try to remove Gajim from the default directories.
If you want to remove it from custom directory provide it as:
make PREFIX=custom_path uninstall

=MISCELLANEOUS=
XML & Debugging:
If you want to see the xml stanzas and/or help us debugging 
you're advised to enable verbose via advanced configuration window.
If you don't want to make this permanent, execute gajim with --verbose
everytime you want to have verbose output.

Cannot join room with password:
please read the FAQ for the reply on this issue

=FAQ/Wiki=
FAQ can be found at http://trac.gajim.org/wiki/GajimFaq
Wiki can be found at http://trac.gajim.org/wiki


That is all, enjoy!

(C) 2003-2005
The Gajim Team
http://gajim.org


PS.
we use original art and parts of sounds and other art from Psi, Gossip
and some icons from various gnome-icons (mostly Dropline Etiquette)
we found at art.gnome.org
If you think we're violating a license please inform us
README even better :) 2005-03-21 23:08:06 +01:00			`Welcome and thanks for trying out Gajim.`

improve README 2005-06-25 16:18:51 +02:00			`=RUNTIME REQUIREMENTS=`
README even better :) 2005-03-21 23:08:06 +01:00			`python2.4 (python2.3 should work too)`
update readme 2005-11-22 12:39:22 +01:00			`pygtk2.6 or higher`
README even better :) 2005-03-21 23:08:06 +01:00			`python-libglade`
update readme 2005-11-22 12:39:22 +01:00			`python-pysqlite2`
README even better :) 2005-03-21 23:08:06 +01:00
some distros even split python stdlib! 2005-10-22 15:13:58 +02:00			`some distros also split too much python standard library.`
			`I know SUSE does. In such distros you also need python-xml`
			`the xml lib that comes with python and not pyxml or whatever`

improve README 2005-06-25 16:18:51 +02:00			`=COMPILE-TIME REQUIREMENTS=`
a better README 2005-05-26 00:16:57 +02:00			`python-dev`
missing build-depend in README 2005-06-19 00:55:17 +02:00			`python-gtk2-dev`
README (again) now achieved perfection :P 2005-06-25 16:24:29 +02:00			`libgtk2.0-dev # aka. gtk2-devel`
mention Debian as being one 2005-07-23 12:16:34 +02:00			`libxss-dev # for idle detection module (Some distributions (f.e. Debian) split xscreensaver)`
README (again) now achieved perfection :P 2005-06-25 16:24:29 +02:00			`libgtkspell-dev # for gtkspell module`
add intltool as compile time req 2005-09-10 20:46:44 +02:00			`intltool`
a better README 2005-05-26 00:16:57 +02:00
advise in README 2005-08-14 21:51:57 +02:00			`NOTE:`
			`if you still have problems compiling, you may want to try removing the gtk1 series of the above dependencies`

README even better :) 2005-03-21 23:08:06 +01:00			`Optionally:`
update readme to clarify things 2005-11-16 11:55:42 +01:00			`dnspython or pydns for SRV support; if you don't know what that is, you don't need it`
README (again) now achieved perfection :P 2005-06-25 16:24:29 +02:00			`gtkspell and aspell-LANG where lang is your locale eg. en, fr etc`
			`GnomePythonExtras 2.10 or above so you can avoid compiling trayicon and gtkspell`
README even better :) 2005-03-21 23:08:06 +01:00
update readme to clarify things 2005-11-16 11:55:42 +01:00			`NOTE TO PACKAGERS:`
			`Gajim is a GTK+ app and not a gnome one. Just do 'make' so you don't require gnomepythonextras`
			`which is gnome dep`
improve README 2005-06-25 16:18:51 +02:00
			`=INSTALLATION PROCEDURE=`
README even better :) 2005-03-21 23:08:06 +01:00			`tar jxvf gajim-version.tar.bz2`
			`cd gajim`
README (again) now achieved perfection :P 2005-06-25 16:24:29 +02:00			`make # builds all modules`
improve README 2005-06-25 16:18:51 +02:00			`su -c make install`

README (again) now achieved perfection :P 2005-06-25 16:24:29 +02:00			`To specify what modules to build do:`
			`make help`

			`To specify where to install do:`
PREFIX instead of DESTDIR 2005-07-07 19:59:51 +02:00			`su -c make PREFIX=custom_path install`
README even better :) 2005-03-21 23:08:06 +01:00
improve README 2005-06-25 16:18:51 +02:00			`=RUNNING GAJIM=`
README even better :) 2005-03-21 23:08:06 +01:00			`gajim`

ImageCellRenderer has now better name, gajim.py --> gajim.sh [needs fix to makefile to make it work, padding and xalign trying to clean up (don't work yet). added a fixme in new message dialog about focus problems.. 2005-04-01 01:26:05 +02:00			`or if you didn't 'make install' you can also run from gajim folder with`
launch and gajim bash script now call gajim.py with arguments 2005-05-29 16:55:22 +02:00			`./launch.sh`
better README 2005-05-28 22:10:53 +02:00
README: putting . when we can, and use distibution and not distro [more formal] 2005-06-25 16:20:34 +02:00			`Last but not least, you can run Gajim from your GNOME/XFCE/KDE/whatever menus.`
better README 2005-05-28 22:10:53 +02:00
improve README 2005-06-25 16:18:51 +02:00			`=UNINSTALLATION PROCEDURE=`
			`su -c make uninstall`
			`this will try to remove Gajim from the default directories.`
			`If you want to remove it from custom directory provide it as:`
PREFIX even on uninstallation procedure :) 2005-07-07 20:04:34 +02:00			`make PREFIX=custom_path uninstall`
improve README 2005-06-25 16:18:51 +02:00
			`=MISCELLANEOUS=`
say also in readme 2005-10-23 15:28:05 +02:00			`XML & Debugging:`
better README 2005-05-28 22:10:53 +02:00			`If you want to see the xml stanzas and/or help us debugging`
			`you're advised to enable verbose via advanced configuration window.`
			`If you don't want to make this permanent, execute gajim with --verbose`
improve README 2005-06-25 16:18:51 +02:00			`everytime you want to have verbose output.`

say also in readme 2005-10-23 15:28:05 +02:00			`Cannot join room with password:`
			`please read the FAQ for the reply on this issue`

update readme to clarify things 2005-11-16 11:58:14 +01:00			`=FAQ/Wiki=`
			`FAQ can be found at http://trac.gajim.org/wiki/GajimFaq`
			`Wiki can be found at http://trac.gajim.org/wiki`
addition of PKGBUILD for archlinux 2005-03-22 15:09:21 +01:00

README (again) now achieved perfection :P 2005-06-25 16:24:29 +02:00			`That is all, enjoy!`
README even better :) 2005-03-21 23:08:06 +01:00
improve README 2005-06-25 16:18:51 +02:00			`(C) 2003-2005`
README even better :) 2005-03-21 23:08:06 +01:00			`The Gajim Team`
			`http://gajim.org`
add_jid remove_jid is better coded like that. removal of systrayDummy class [have a look and we can discuss], also have a look at a FIXME, back to detection of http://b) with ) in it, cause http://be?b)b can be valid url 2005-03-29 18:16:42 +02:00

systray --> Systray (the class) 2005-03-29 18:37:59 +02:00			`PS.`
update readme to clarify things 2005-11-16 11:58:14 +01:00			`we use original art and parts of sounds and other art from Psi, Gossip`
update README about where we take icons from; add icon for ft proxy 2005-11-20 15:10:53 +01:00			`and some icons from various gnome-icons (mostly Dropline Etiquette)`
			`we found at art.gnome.org`
new basic emoticons 2005-04-07 02:35:06 +02:00			`If you think we're violating a license please inform us`