Jason's Home Page - Linux HOWTOs

docbook2x - Converts DocBook documents to man pages and Texinfo documents ChangeLog

Web site:	http://docbook2x.sourceforge.net/
Repository:	http://docbook2x.sourceforge.net/#cvs

HOWTO

# docbook2X 0.8.8
# ===============
# Prerequisites:
# Perl
# iconv
# sgml2xml, osx (the linuxdoc-tools package)
# texinfo's makeinfo
# groff
# libxml2's xmllint
# HTML Tidy
# xsltproc
# Java

# Install required Perl modules
# I failed one one of the 76 tests for XML::LibXML and did
# 'force install XML::LibXML' to be able to continue, with no
# time for troubleshooting right now...

su -c "perl -MCPAN -e shell"
install Bundle::CPAN
install XML::LibXML::SAX::Parser
exit

# Get the source
cd
test -f installed/docbook2X-0.8.8.tar.gz &&
mv -f installed/docbook2X-0.8.8.tar.gz .
test ! -f docbook2X-0.8.8.tar.gz &&
wget http://downloads.sf.net/docbook2x/docbook2X-0.8.8.tar.gz

# Extract it
mkdir -p -m 0700 ~/src
cd ~/src
find -maxdepth 1 -type d -name "docbook2X-*" -exec rm -r {} \;
tar xzvf ~/docbook2X-0.8.8.tar.gz
cd docbook2X-0.8.8
test $UID = 0 && chown -R root:root .

# Do this to make it actually use the path specified by --htmldir (or
# --docdir if not specified)
cd doc
test -f Makefile.am.orig || cp -a Makefile.am Makefile.am.orig
cat Makefile.am.orig |
sed 's%^$htmldir = $$.*$$%\1@htmldir@%' > Makefile.am
cd ..
autoreconf -f -i

# Configure the build
./configure \
--docdir=/usr/local/doc/docbook2X \
--infodir=/usr/local/info \
--mandir=/usr/local/man

# Build it
make

# Install it
su -c "make install"

# Save the source for later
cd
mkdir -p -m 0700 installed
rm -f installed/docbook2X-*.tar.*
mv docbook2X-0.8.8.tar.gz installed/

# If you ever want to uninstall docbook2X, this should do it
# 'make uninstall' in the source directory as root should do it
# The rest is just in case anything old is left behind
cd
su
test -d src/docbook2x-* && ( cd src/docbook2x-* ; make uninstall )
( cd /usr/local/bin
  rm -f db2x_manxml db2x_texixml db2x_xsltproc docbook2man docbook2texi \
   sgml2xml-isoent utf8trans )
test -d /usr/local/doc/docbook2X && rm -r /usr/local/doc/docbook2X
( cd /usr/local/info ; rm -f docbook2man-xslt.info docbook2X.info )
( cd /usr/local/man/man1
  rm -f db2x_manxml.1 db2x_texixml.1 db2x_xsltproc.1 docbook2man.1 \
   docbook2texi.1 sgml2xml-isoent.1 utf8trans.1 )
test -d /usr/local/share/docbook2X && rm -r /usr/local/share/docbook2X
exit
find ~/src -maxdepth 1 -type d -name "docbook2x-*" -exec rm -r {} \;
rm -f ~/installed/docbook2x-*.tar.*