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.