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 [email protected].