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

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

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.22 or higher), glib2 (2.0.4 or higher),
   atk (1.0.1 or higher), pango (1.0.1 or higher), and gtk2 (2.0.5 or higher).

   Now that Gnome 2 is released, it's only a matter of time before most Linux
   distributions will bundle all these libraries.  However you don't have to
   wait until then, because installing/upgrading these libraries yourself
   is not hard.

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.22.tar.bz2 
        ftp://ftp.gtk.org/pub/gtk/v2.0/glib-2.0.4.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.5.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".


Troubleshooting

     * Red Hat Rawhide appears to be no longer binary compatibly with RH7.x,
       causing many dependency problems. RH users are recommended to use
       alternative upgrade paths (e.g. www.gtk.org, www.ximian.com).
       
     * Some Red Hat users installing from RPM find that Pan will not build,
       getting four or five errors that it can't find symbol
       FT_something_or_other.  If you get this, try upgrading the freetype
       library to the latest one, available from rpmfind.

     * Please report other problems to pan@rebelbase.com.