[doldaconnect.git] / doc / INSTALL.gaim

		       Gaim Plugin Installation

Because of  how Gaim works,  special care is required  when installing
the Dolda Connect chat plugin for  Gaim. The basic problem is the same
as with  the GNOME applet,  in that the  set of directories  that Gaim
searches  for plugins usually  does not  include the  directories into
which Dolda Connect is installed.

However, the Gaim situation is  even worse than that with GNOME, since
Gaim cannot be configured to search additional directories. Therefore,
the plugin  file must  be installed into  one of the  directories that
Gaim does look in.

As of version 2.0.0-beta6 of Gaim, Gaim searches only two directories:
The   `lib/gaim'  directory  in   its  installation   prefix  (usually
`/usr/lib/gaim'), and the $HOME/.gaim/plugins directory.

Therefore, there are only two things which can be done:

1. Install Dolda Connect in /usr. As mentioned in INSTALL.applet, this
is ugly and not recommended, but it does work and is easy.

2. You   must  either   copy,   move,  link   or   symlink  the   file
libdolcon-gaim.so   which  Dolda   Connect  typically   installs  into
/usr/local/lib/gaim    into    either    ${gaim-prefix}/lib/gaim    or
$HOME/.gaim/plugins. For  example, you can run  the following command,
which will work for most cases:
ln -s /usr/local/lib/gaim/libdolcon-gaim.so $HOME/.gaim/plugins

			     About Pidgin

Because of AOL,  Gaim had to switch name to Pidgin  in 2007, which has
some effects on  the above discussion. As of Dolda  Connect 1.0, it is
possible to  compile the plugin for  Pidgin as well as  for Gaim. Most
things still  apply as they are, but  some care must be  taken. If you
decide  to install  the plugin  in your  home directory,  the relevant
directory is now called  $HOME/.purple/plugins.  Also, the name of the
plugin is called libdolcon-purple.so, instead of libdolcon-gaim.so.


This document  was last updated 2007-10-15, reflecting  release 1.0 of
Dolda Connect.
Commit	Line	Data
	1	Gaim Plugin Installation
	2
	3	Because of how Gaim works, special care is required when installing
	4	the Dolda Connect chat plugin for Gaim. The basic problem is the same
	5	as with the GNOME applet, in that the set of directories that Gaim
	6	searches for plugins usually does not include the directories into
	7	which Dolda Connect is installed.
	8
	9	However, the Gaim situation is even worse than that with GNOME, since
	10	Gaim cannot be configured to search additional directories. Therefore,
	11	the plugin file must be installed into one of the directories that
	12	Gaim does look in.
	13
	14	As of version 2.0.0-beta6 of Gaim, Gaim searches only two directories:
	15	The `lib/gaim' directory in its installation prefix (usually
	16	`/usr/lib/gaim'), and the $HOME/.gaim/plugins directory.
	17
	18	Therefore, there are only two things which can be done:
	19
	20	1. Install Dolda Connect in /usr. As mentioned in INSTALL.applet, this
	21	is ugly and not recommended, but it does work and is easy.
	22
	23	2. You must either copy, move, link or symlink the file
	24	libdolcon-gaim.so which Dolda Connect typically installs into
	25	/usr/local/lib/gaim into either ${gaim-prefix}/lib/gaim or
	26	$HOME/.gaim/plugins. For example, you can run the following command,
	27	which will work for most cases:
	28	ln -s /usr/local/lib/gaim/libdolcon-gaim.so $HOME/.gaim/plugins
	29
	30	About Pidgin
	31
	32	Because of AOL, Gaim had to switch name to Pidgin in 2007, which has
	33	some effects on the above discussion. As of Dolda Connect 1.0, it is
	34	possible to compile the plugin for Pidgin as well as for Gaim. Most
	35	things still apply as they are, but some care must be taken. If you
	36	decide to install the plugin in your home directory, the relevant
	37	directory is now called $HOME/.purple/plugins. Also, the name of the
	38	plugin is called libdolcon-purple.so, instead of libdolcon-gaim.so.
	39
	40
	41
	42	This document was last updated 2007-10-15, reflecting release 1.0 of
	43	Dolda Connect.