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