--------------------------------------------------------------------------------
                     Installation (on Debian/Ubuntu) 
--------------------------------------------------------------------------------
This file explains how to install pidgin-paranoia.

This procedure was tested on Debian Lenny (amd64/i386) and Ubuntu 8.04 (i386).

If you use Debian or a Debian derivate like Ubuntu, you can use the debian packages.
If you want, you can build the package using the debian/ directory in SVN (see HACKING).

Comments:

 * Commands beginning with '#' are meant to be executed as root whereas commands 
   beginning with '$' are meant to be executed as user.

 * '1:' and '2:' means that you have to do step 1 and step 2, but 'a:' and 'b:'
   means that you can decide between variant a and b.

 * To save time it is recommended to read the whole text first and to install 
   everything at once.

 * The plugin requires libpurple >= 2.2.0 and libglib >= 2.16.

 * The installation should work with other distributions (and maybe even on other OS)
   You just need to find out the names of the required tools and you need to
   make sure that they are new enough. If it does not work please tell us.

1: Install pidgin or finch (the command line client)

  1.a: Install Pidgin
    # aptitude install pidgin 

  1.b: Install Finch
    # aptitude install finch

2: Install the tools needed to compile Pidgin-paranoia:

  2.1: Install compilers and stuff:
    # aptitude install build-essential automake libtool intltool

  2.2: Install the headers for libpurple and gnomelib:
    # aptitude install libpurple-dev libglib2.0-dev

3. Get the Pidgin-paranoia-source from SVN or as tar.gz (Recommended)

  3.a: Get the newest release of pidgin paranoia (Recommended)

    3.a: Extract the source-code:
      $ tar -xvzf pidgin-paranoia-VERSION.tar.gz

  3.b: Get the development version from the SVN.

    3.b.1: First install SVN:
      # aptitude install subversion

    3.b.2: Get the tools needed for autoconf
      # aptitude install libtool autoconf intltool

    3.b.3: Get the source code from SVN:
      $ svn co https://pidgin-paranoia.svn.sourceforge.net/svnroot/pidgin-paranoia/trunk pidgin-paranoia

    3.b.4: Do 'autoconf' to create the configure script.
      $ cd pidgin-paranoia
      $ ./autogen.sh

4. Compile Pidgin-paranoia:

  4.1: Go into the directory:
    $ cd pidgin-paranoia-VERSION

  4.2: Create the makefile
    $ ./configure
    If you encounter an error you probably lack a program, library or headers.
    Just paste the error into your favorite search engine.

  4.3: Compile it
    $ make
    If you encounter errors or warnings please tell us.

  4.4: Install it
    # make install

5. Start pidgin (or finch) and load the plugin

  5.1: Start pidgin or finch (you can start them in debug mode with -d)
  
  5.2: Pidgin: Tools->Plugins: One-Time Pad encryption (Check)

  5.3: Please consult the file 'README' to find out how to use the plugin

(6. uninstall: (who wants to do that anyway? ;) ))

  $ cd pidgin-paranoia
  # make uninstall

