kopete/INSTALL

   1 Basic Installation
   2 ==================
   3
   4         KDE uses the cmake build system. The simple instructions for
   5 building kdenetwork are these commands (starting in kdenetwork source directory):
   6
   7                         mkdir ../kdenetwork-build && cd ../kdenetwork-build
   8                         cmake ../kdenetwork
   9                         make
  10                         make install
  11
  12         This will not work unless necessary prerequisites are met. These are,
  13 in the order in which they should be built:
  14
  15                         kdesupport
  16                         kdelibs
  17                         kdepimlibs
  18                         kdebase/runtime
  19
  20         Various components of kdenetwork and the KDE modules listed above have
  21 other dependencies as well. If these are not met when the 'cmake' command is
  22 run, those components will not be built. The output of 'cmake' should make it
  23 clear what these dependencies are and how to meet them.
  24
  25         Arguments can be given to cmake similar to those given to a traditional
  26 configure script, like the install prefix. See 'cmake --help-full' for more
  27 information. For example, 'configure --prefix=/usr/lib' translates to
  28 'cmake -DCMAKE_INSTALL_PREFIX=/usr/lib'.
  29
  30 Finding Plugins
  31 ===============
  32 If you don't see any "plugins" listed in the Configure Plugins
  33 dialog, or the list of messaging protocols in the Add Account Wizard
  34 is empty after installing, Kopete you may have installed it in a
  35 directory where KDE doesn't look for additional resources like plugins.
  36
  37 It's also possible that you've just been too impatient :)
  38
  39 Kopete installs several .desktop files that have to be processed by a
  40 KDE application called 'kbuildsycoca4'. If you run Kopete directly
  41 after installing it this process might still be running and Kopete
  42 doesn't see the new plugins yet. Try running 'kbuildsycoca4' from a
  43 console and restart Kopete when it finishes. If that doesn't help,
  44 please read on.
  45
  46 KDE applications by default look in all directories listed in the
  47 /etc/kderc file, the $KDEDIRS environment variable, in $KDEDIR if
  48 this variable doesn't exist, and ultimately in the directory where
  49 kdelibs is installed. Unless you take special precautions applications
  50 will _NOT_ look in other directories, even if you install additional
  51 software (like Kopete) there.
  52
  53 The best solution is to add the following to /etc/kderc (create the file
  54 if it doesn't exist yet):
  55
  56     [Directories]
  57     prefixes=/the/prefix/I/used/for/kopete
  58
  59 If you don't have write access to /etc/kderc, or if you want to use more
  60 parallel builds of KDE and/or Kopete you need to rely on the environment
  61 variables instead.
  62
  63 If $KDEDIRS currently points to /opt/kde4 and you installed Kopete
  64 to /usr/local then you need to set $KDEDIRS to '/opt/kde4:/usr/local'.
  65 You need to store this change in a file that is picked up by all shells
  66 and for all users, like /etc/profile. The name of the preferred version
  67 varies from system to system.
  68
  69 As a last resort you can simply install Kopete in the same directory as
  70 where your KDE resides by adding a flag to configure like
  71
  72     cmake -DCMAKE_INSTALL_PREFIX=/usr/lib
  73
  74 if KDE is installed in /opt/kde4. The downside is that you'll probably
  75 end up installing Kopete into directories used by your distribution,
  76 instead of a separate path for your own packages like the /usr/local/
  77 tree. Whether or not your package manager has problems with that and
  78 whether or not you'll accept those problems should they occur is of
  79 course up to you to decide, but we strongly recommend to not install
  80 source-compiled packages like Kopete in directories that are managed
  81 by a package manager and only use the KDE prefix if you compiled all
  82 of KDE from source yourself.