New socket API draft.
[doldaconnect.git] / doc / INSTALL.gaim
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.