[Pan-users] (Draft) Pan 0.12 Installation Howto

[Charles Kerr]

This is basically a more generic version of the HOWTO Toby wrote a
little while ago.  If you see any errors, please correct them. :)

----

Installing Pan 0.12
Authors: Toby A. Inkster
Authors: Charles Kerr

This document describes show to install Pan 0.12 and its prerequisites.

TODO: This is a draft, please report errors to address@hidden
TODO: Volunteers welcome to add SRPM instructions.
TODO: Volunteers welcome to add non-RPM binary (debs, slack) instructions.
TODO: Volunteers welcome to add Cooker/up2date instructions?

Prerequisites

   Pan 0.12 has five prerequisites, which need to be installed in this order:
   libxml2 (version 2.4.19 or higher), glib2 (2.0.1 or higher),
   atk (1.0.1 or higher), pango (1.0.1 or higher), and gtk2 (2.0.2 or higher).

Binaries or Source?

   There are two ways to install Pan: installing binaries (.rpm, .deb, etc.)
   or to build straight from the source code.  Binaries are usually easier,
   so use them if they're available.

   If they're not available, or if their dependencies require you to upgrade
   half your computer, don't worry -- building from source isn't as scary
   as it sounds.

Binaries

   RPMs for the five prerequisites can be found at rpmfind:

   libxml2  - http://rpmfind.net/linux/rpm2html/search.php?query=libxml2
   glib2    - http://rpmfind.net/linux/rpm2html/search.php?query=glib2
   atk      - http://rpmfind.net/linux/rpm2html/search.php?query=atk
   pango    - http://rpmfind.net/linux/rpm2html/search.php?query=pango
   gtk2     - http://rpmfind.net/linux/rpm2html/search.php?query=gtk2
   Pan      - http://pan.rebelbase.com/download/

   If some of these RPMs are available but others aren't, you can install
   what you've got and build the rest from source code.  If you do build
   anything from source, then each RPM you install will need its sibling
   "-devel" RPM installed (libxml2-devel, glib2-devel, and so on).  These
   can also be found at rpmfind.

   Make a temporary directory to hold everything you download from
   rpmfind, then from the command prompt:

        $ cd temp             [change the dir you saved everything]
        $ su                  [root access is needed to install rpms]
        $ rpm --upgrade *rpm  [installs the RPMs]

   If all six RPMs installed successfully, then you're done!

Source

   Go to this website and download the source tarball for pkg-config 0.12:
   http://www.freedesktop.org/software/pkgconfig/
   At the command line:

        $ tar zxf pkgconfig-0.12.0.tar.gz
        $ cd pkgconfig-0.12.0
        $ ./configure --prefix=/usr && make 
        $ su
        $ make install

    Now create a temporary directory on your hard disk and
    download the following files into it:
   
        
ftp://ftp.gnome.org/pub/GNOME/stable/sources/libxml2/libxml2-2.4.21.tar.bz2 
        ftp://ftp.gtk.org/pub/gtk/v2.0/glib-2.0.1.tar.bz2
        ftp://ftp.gtk.org/pub/gtk/v2.0/atk-1.0.1.tar.bz2
        ftp://ftp.gtk.org/pub/gtk/v2.0/pango-1.0.1.tar.bz2
        ftp://ftp.gtk.org/pub/gtk/v2.0/gtk+-2.0.2.tar.bz2
        And the Pan tarball from http://pan.rebelbase.com/download/

    Those are the latest versions as I'm writing this -- if you can find
    newer versions at those URLs, download the newer ones instead.
    Now, for each of the packages (in the same order as given above):

        $ tar jxf PACKAGENAME.tar.gz
        $ cd PACKAGENAME
        $ ./configure --prefix=/usr && make
        $ su
        $ make install
    
    The glib/gtk documentation has detailed build instructions at
    http://developer.gnome.org/doc/API/2.0/glib/glib-building.html and
    http://developer.gnome.org/doc/API/2.0/gtk/gtk-building.html.
   
    One caveat: if you installed any of the requirements from source code
    instead of RPM, the RPM program won't know that new versions have been
    installed. So if RPM complains that you haven't got any of these installed:

        libatk-1.0.so.0
        libgdk_pixbuf-2.0.so.0
        libgdk-x11-2.0.so.0
        libglib-2.0.so.0
        libgmodule-2.0.so.0
        libgobject-2.0.so.0
        libgthread-2.0.so.0
        libgtk-x11-2.0.so.0
        libpango-1.0.so.0
        libpangox-1.0.so.0
        libpangoxft-1.0.so.0 

    Then you can override it using "rpm --nodeps".