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
pysqlite2 (aka. 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
notification-daemon (and D-Bus) to get cooler popups
D-Bus to have gajim-remote working

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,
Gnomebaker 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`
log system rewrite to use sqlite database instead of plain ascii files. this allows us to scale better (be faster), provide search in history, and save logs for JIDs that are non-ASCII. PLEASE read http://trac.gajim.org/wiki/MigrateLogToDot9DB 2005-11-23 20:12:52 +01:00			`pysqlite2 (aka. 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`
Merged trunk 2005-12-30 22:37:36 +01:00			`notification-daemon (and D-Bus) to get cooler popups`
			`D-Bus to have gajim-remote working`
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.`
add sound for buddy bounce [future feature]. this snd is borrowed from GnomeBaker burnok sound 2006-03-12 22:20:08 +01:00			`we use original art and parts of sounds and other art from Psi, Gossip,`
			`Gnomebaker and some icons from various gnome-icons (mostly Dropline Etiquette)`
update README about where we take icons from; add icon for ft proxy 2005-11-20 15:10:53 +01:00			`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`