Installation

Abstract

Package install procedure

Unpack the tarball, then run ./configure, and then make, make install, as usual.

You need GNU make to build docbook2X properly.

If you are using the CVS version, you will also need the autoconf and automake tools, and must run ./autogen.sh first. But see also the note below about the CVS version.

If you want to (re-)build HTML documentation (after having installed Norman Walsh's DocBook XSL stylesheets), pass --with-html-xsl to ./configure. You do not really need this, since docbook2X releases already contain pre-built HTML documentation.

Some other packages also call their conversion programs docbook2man and docbook2texi; you can use the --program-transform-name parameter to ./configure if you do not want docbook2X to clobber over your existing docbook2man or docbook2texi.

Installation problems

Abstract

Possible problems when installing and building docbook2X and how to solve them

1.

Where is XML::Handler::SGMLSpl?

It's included in the docbook2X package. If Perl says it cannot find it, something went wrong with the install, or you tried to run the docbook2X Perl scripts in some other directory without installing. If you want to do the latter, you have to set PERLLIB manually to point to where-you-put-docbook2X/perl/XML.

2.

I get an error when compiling the things under libxslt/. Or a segmentation fault occurs running db2x_xsltproc.

Either I made a bad mistake in the code, or the libxslt people changed their programming interfaces. You can try using the same version of libxslt (and libxml) I used when this version of docbook2X was released and see if that helps. Please tell me about this, so that I can release a new update to docbook2X.

3.

db2x_xsltproc tells me that “one input document is required” when building docbook2X.

Use GNU make to build docbook2X (as opposed to BSD make).

I could fix this incompatibility in the docbook2X make files, but some of the default automake rules have the same problem, so I didn't bother.

4.

When docbook2X attempts to build its documentation, I get errors about "attempting to load network entity", etc.

You will need to set up the XML catalogs for the DocBook XML DTDs correctly. This tells libxml where to find the DocBook DTDs on your system. Recent Linux distributions should already have this done for you.

This error (or rather, warning) is harmless in the case of docbook2X documentation — it does not actually require the DTD to build. But your other DocBook documents might (mainly because they use the ISO entities).

libxml also understands SGML catalogs, but last time I tried it there was some bug that stopped it from working. Your Mileage May Vary.

5.

I cannot build from CVS.

If the problem is related to HTML files, then you must pass --with-html-xsl to configure. The problem is that the HTML files are automatically generated from the XML source and are not in CVS, but the Makefile still tries to install them. (This issue does not appear when building from release tarballs.)

For other docbook2X problems, please also look at its main documentation.