gajim-plural/README

Welcome and thanks for trying out Gajim.

=RUNTIME REQUIREMENTS=
python2.4 (python2.3 should work too)
pygtk2.5 or higher (NOTE: pygtk2.5 is devel so pygtk2.6 in case of problems)
python-libglade

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:
gtkspell and aspell-LANG where lang is your locale eg. en, fr etc
dnspython for SRV support; if you don't know what that is, you don't need it)
GnomePythonExtras 2.10 or above so you can avoid compiling trayicon and gtkspell
possible package name for your distribution: python-gnome2-extras


=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=
FAQ can be found in http://trac.gajim.org/wiki/GajimFaq


That is all, enjoy!

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


PS.
sounds and stellar iconstyle taken from Psi
some emoticons taken from Psi
the basic emoticons taken from Gossip
gossip iconstyle taken from Gossip
service discovery icons taken from Gaim and the GNOME hi-color theme
If you think we're violating a license please inform us
README even better :) 2005-03-21 22:08:06 +00:00			`Welcome and thanks for trying out Gajim.`

improve README 2005-06-25 14:18:51 +00:00			`=RUNTIME REQUIREMENTS=`
README even better :) 2005-03-21 22:08:06 +00:00			`python2.4 (python2.3 should work too)`
fix string [thanks yavor] 2005-08-25 17:05:17 +00:00			`pygtk2.5 or higher (NOTE: pygtk2.5 is devel so pygtk2.6 in case of problems)`
README even better :) 2005-03-21 22:08:06 +00:00			`python-libglade`

some distros even split python stdlib! 2005-10-22 13:13:58 +00: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 14:18:51 +00:00			`=COMPILE-TIME REQUIREMENTS=`
a better README 2005-05-25 22:16:57 +00:00			`python-dev`
missing build-depend in README 2005-06-18 22:55:17 +00:00			`python-gtk2-dev`
README (again) now achieved perfection :P 2005-06-25 14:24:29 +00:00			`libgtk2.0-dev # aka. gtk2-devel`
mention Debian as being one 2005-07-23 10:16:34 +00:00			`libxss-dev # for idle detection module (Some distributions (f.e. Debian) split xscreensaver)`
README (again) now achieved perfection :P 2005-06-25 14:24:29 +00:00			`libgtkspell-dev # for gtkspell module`
add intltool as compile time req 2005-09-10 18:46:44 +00:00			`intltool`
a better README 2005-05-25 22:16:57 +00:00
advise in README 2005-08-14 19:51:57 +00: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 22:08:06 +00:00			`Optionally:`
README (again) now achieved perfection :P 2005-06-25 14:24:29 +00:00			`gtkspell and aspell-LANG where lang is your locale eg. en, fr etc`
			`dnspython for SRV support; if you don't know what that is, you don't need it)`
			`GnomePythonExtras 2.10 or above so you can avoid compiling trayicon and gtkspell`
README: putting . when we can, and use distibution and not distro [more formal] 2005-06-25 14:20:34 +00:00			`possible package name for your distribution: python-gnome2-extras`
README even better :) 2005-03-21 22:08:06 +00:00
improve README 2005-06-25 14:18:51 +00:00
			`=INSTALLATION PROCEDURE=`
README even better :) 2005-03-21 22:08:06 +00:00			`tar jxvf gajim-version.tar.bz2`
			`cd gajim`
README (again) now achieved perfection :P 2005-06-25 14:24:29 +00:00			`make # builds all modules`
improve README 2005-06-25 14:18:51 +00:00			`su -c make install`

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

			`To specify where to install do:`
PREFIX instead of DESTDIR 2005-07-07 17:59:51 +00:00			`su -c make PREFIX=custom_path install`
README even better :) 2005-03-21 22:08:06 +00:00
improve README 2005-06-25 14:18:51 +00:00			`=RUNNING GAJIM=`
README even better :) 2005-03-21 22:08:06 +00: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-03-31 23:26:05 +00: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 14:55:22 +00:00			`./launch.sh`
better README 2005-05-28 20:10:53 +00:00
README: putting . when we can, and use distibution and not distro [more formal] 2005-06-25 14:20:34 +00:00			`Last but not least, you can run Gajim from your GNOME/XFCE/KDE/whatever menus.`
better README 2005-05-28 20:10:53 +00:00
improve README 2005-06-25 14:18:51 +00: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 18:04:34 +00:00			`make PREFIX=custom_path uninstall`
improve README 2005-06-25 14:18:51 +00:00
			`=MISCELLANEOUS=`
say also in readme 2005-10-23 13:28:05 +00:00			`XML & Debugging:`
better README 2005-05-28 20:10:53 +00: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 14:18:51 +00:00			`everytime you want to have verbose output.`

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

improve README 2005-06-25 14:18:51 +00:00			`=FAQ=`
			`FAQ can be found in http://trac.gajim.org/wiki/GajimFaq`
addition of PKGBUILD for archlinux 2005-03-22 14:09:21 +00:00

README (again) now achieved perfection :P 2005-06-25 14:24:29 +00:00			`That is all, enjoy!`
README even better :) 2005-03-21 22:08:06 +00:00
improve README 2005-06-25 14:18:51 +00:00			`(C) 2003-2005`
README even better :) 2005-03-21 22:08:06 +00: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 16:16:42 +00:00

systray --> Systray (the class) 2005-03-29 16:37:59 +00:00			`PS.`
new basic emoticons 2005-04-07 00:35:06 +00:00			`sounds and stellar iconstyle taken from Psi`
			`some emoticons taken from Psi`
better README 2005-05-28 20:10:53 +00:00			`the basic emoticons taken from Gossip`
update readme fix string I missed :\| 2005-06-13 15:36:09 +00:00			`gossip iconstyle taken from Gossip`
New Service Discovery, couple of quick notes about this commit: * src/disco.py contains all the disco stuff * registration remains in src/config.py * data/pixmaps/agents contains the icons used in the toplevel server browser and the banner. They're referenced at the top of src/disco.py. 2005-10-30 09:58:13 +00:00			`service discovery icons taken from Gaim and the GNOME hi-color theme`
new basic emoticons 2005-04-07 00:35:06 +00:00			`If you think we're violating a license please inform us`