Jason's Home Page - Linux HOWTOs

scrollkeeper - Documentation catalogging system, used by Gnome ChangeLog

Web site:

http://scrollkeeper.sourceforge.net/

HOWTO

# scrollkeeper 0.3.14
# ===================
# Slackware 9.0's 'scrollkeeper' package includes 0.3.11, 9.1's includes
# 0.3.12, 10.0 and 10.1's include 0.3.14  As of Slackware 10.2, Gnome is
# no longer included (so neither is scrollkeeper).

# FYI, at least Gnome >= 2.6 (up to 2.12) all list scrollkeeper version
# 0.3.14 in their prerequisites list.

# If you ever want to uninstall scrollkeeper, or clean up files from
# an old version before installing a new one, skip down to the bottom
# for instructions.

# Prerequisites:
# gawk
# intltool >= 0.8.4
# perl
# libxml2 >= 2.4.19
# libxslt
# docbook-dtd412-xml, docbook-xsl-1.48
#   For these you can either install Slack's 'sgml-tools' package (Slack 9.0
#   includes 'sgml-tools' in extra, 9.1 includes it as a regular package in
#   'ap', they're both version 1.0.9), or you can install these:
#   http://scrollkeeper.sourceforge.net/data/docbookx412.tgz
#   http://scrollkeeper.sourceforge.net/data/docbook-xsl-1.48.tgz
# gettext
# libiconv
# bison

cd
test -f installed/scrollkeeper-0.3.14.tar.bz2 &&
mv installed/scrollkeeper-0.3.14.tar.bz2 .
test ! -f scrollkeeper-0.3.14.tar.bz2 &&
wget http://ftp.gnome.org/pub/gnome/sources/scrollkeeper/0.3/\
scrollkeeper-0.3.14.tar.bz2

# Verify tarball w/ md5sum:
echo "b175e582a6cec3e50a9de73a5bb7455a  scrollkeeper-0.3.14.tar.bz2" | \
md5sum -c

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

# Become root to install it
su

test -x /sbin/removepkg && /sbin/removepkg scrollkeeper
find /usr/doc -maxdepth 1 -type d 1 -name "scrollkeeper-*" \
-exec rm -r {} \;
rm -f /usr/lib/libscrollkeeper.*
test -d /var/lib/scrollkeeper && ( cd /var/lib/scrollkeeper ; rm -r ./* )
make install
ldconfig

# Update the scrollkeeper databases with the omf files that currently exist.
# You should also run this any time you install/upgrade something that adds
# an omf file (ie. an XML-based User's Guide) to /usr/share/omf.
/usr/bin/scrollkeeper-update -p /var/lib/scrollkeeper > /dev/null 2>&1

# Become yourself again
exit

cd
mkdir -p -m 0700 installed
rm -f installed/scrollkeeper-*.tar.*
mv scrollkeeper-0.3.14.tar.bz2 installed/

# If you ever want to uninstall scrollkeeper, this should do it:
cd
su
test -d src/scrollkeeper-* && ( cd src/scrollkeeper-* ; make uninstall )
rm -f /etc/scrollkeeper.conf /usr/bin/scrollkeeper-* \
/usr/lib/libscrollkeeper.* /usr/man/man1/scrollkeeper-*.1 \
/usr/man/man5/scrollkeeper.conf.5 /usr/man/man7/scrollkeeper.7 \
/usr/man/man8/scrollkeeper-*.8
find /usr/doc -maxdepth 1 -type d -name "scrollkeeper-*" -exec rm -r {} \;
test -d /usr/share/omf/scrollkeeper && rm -r /usr/share/omf/scrollkeeper
test -d /usr/share/scrollkeeper && rm -r /usr/share/scrollkeeper
test -d /usr/share/xml/scrollkeeper && rm -r /usr/share/xml/scrollkeeper
ldconfig
exit
find ~/src -maxdepth 1 -type d -name "scrollkeeper-*" -exec rm -r {} \;
rm -f ~/installed/scrollkeeper-*.tar.*