---

HOWTO

# gnome-doc-utils
# ===============
# I include several versions below, each one for a different major release
# of Gnome, but keep in mind that I only actually use the Gnome 2.16.x one.

# If you ever want to uninstall gnome-doc-utils, or clean up files from
# an old version before installing a new one, cd into the source directory,
# run 'make uninstall' (as root), remove the source directory, then remove
# the tarball.

# Prerequisites:
# Perl
# iconv
# gettext
# Python >= 2.0
# pkg-config
# libxml2 >= 2.6.12
# libxslt >= 1.1.8


# Install/update the XML::Parser perl module:
su -c "perl -MCPAN -e shell"
o conf make_install_arg UNINST=1
o conf prerequisites_policy follow
install Bundle::CPAN
install XML::Parser
exit


# gnome-doc-utils 0.4.4 (for Gnome 2.12.x)
# =====================
cd
test -f installed/gnome-doc-utils-0.4.4.tar.bz2 &&
mv installed/gnome-doc-utils-0.4.4.tar.bz2 .
test ! -f gnome-doc-utils-0.4.4.tar.bz2 &&
wget http://ftp.gnome.org/pub/gnome/sources/gnome-doc-utils/0.4/gnome-doc-utils-0.4.4.tar.bz2

# Verify tarball w/ md5sum:
echo "b89d9e9830f5b3e0ead295104637a207  gnome-doc-utils-0.4.4.tar.bz2" | md5sum -c

mkdir -p -m 0700 src
cd src
find -maxdepth 1 -type d -name "gnome-doc-utils-*" -exec rm -r {} \;
tar xjvf ~/gnome-doc-utils-0.4.4.tar.bz2
cd gnome-doc-utils-0.4.4
test $UID = 0 && chown -R root:root .
./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var/lib
make
su -c "make install"
cd
mkdir -p -m 0700 installed
rm -f installed/gnome-doc-utils-*.tar.*
mv gnome-doc-utils-0.4.4.tar.bz2 installed/


# gnome-doc-utils 0.6.1 (for Gnome 2.14.x)
# =====================
cd
test -f installed/gnome-doc-utils-0.6.1.tar.bz2 &&
mv installed/gnome-doc-utils-0.6.1.tar.bz2 .
test ! -f gnome-doc-utils-0.6.1.tar.bz2 &&
wget http://ftp.gnome.org/pub/gnome/sources/gnome-doc-utils/0.6/gnome-doc-utils-0.6.1.tar.bz2

# Verify tarball w/ md5sum:
echo "c706b807b15e07e58561f903c0f20c26  gnome-doc-utils-0.6.1.tar.bz2" | md5sum -c

mkdir -p -m 0700 src
cd src
find -maxdepth 1 -type d -name "gnome-doc-utils-*" -exec rm -r {} \;
tar xjvf ~/gnome-doc-utils-0.6.1.tar.bz2
cd gnome-doc-utils-0.6.1
test $UID = 0 && chown -R root:root .
./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var/lib
make
su -c "make install"
cd
mkdir -p -m 0700 installed
rm -f installed/gnome-doc-utils-*.tar.*
mv gnome-doc-utils-0.6.1.tar.bz2 installed/


# gnome-doc-utils 0.8.0 (for Gnome 2.16.x)
# =====================
cd
test -f installed/gnome-doc-utils-0.8.0.tar.bz2 &&
mv installed/gnome-doc-utils-0.8.0.tar.bz2 .
test ! -f gnome-doc-utils-0.8.0.tar.bz2 &&
wget http://ftp.gnome.org/pub/gnome/sources/gnome-doc-utils/0.8/gnome-doc-utils-0.8.0.tar.bz2

# Verify tarball w/ md5sum:
echo "50726331fef362dc94921f366fcc8ed2  gnome-doc-utils-0.8.0.tar.bz2" | md5sum -c

mkdir -p -m 0700 src
cd src
find -maxdepth 1 -type d -name "gnome-doc-utils-*" -exec rm -r {} \;
tar xjvf ~/gnome-doc-utils-0.8.0.tar.bz2
cd gnome-doc-utils-0.8.0
test $UID = 0 && chown -R root:root .
./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var/lib
make

# Become root to install it
su

# Install it
make install

# I'm in the US and only read/write English (well), so I don't need these
find /usr/share/locale -type f -name gnome-doc-utils.mo -exec rm {} \;

# Become yourself again
exit

cd
mkdir -p -m 0700 installed
rm -f installed/gnome-doc-utils-*.tar.*
mv gnome-doc-utils-0.8.0.tar.bz2 installed/