*** This file describes the installation of the linuxdoc-tools package ***
You need to do the following things to get linuxdoc-tools installed:
o Get, make and install jade or openjade. This software needs
nsgmls or onsgmls command from jade or openjade.
The source of jade can be downloaded from
<URL:ftp://ftp.jclark.com/pub/jade/>.
This source archive contains source for both jade and sp.
The website for openjade is <URL:http://openjade.sourceforge.net/>.
Currently, openjade seems to be the way to go, but if your system
has working jade already, you can use it safely.
o Configure linuxdoc-tools for your system:
./configure
You can specify different installation prefixes during installation,
the default prefix is `/usr/local'.
For example: install linuxdoc-sgml to `/usr':
./configure --prefix=/usr
If you have sgmls-1.1 already installed, you can leave
out their compilation:
./configure --with-installed-sgmlsasp
If you have entity-map already installed, you can use it:
./configure --with-installed-entity-map
If you have iso-entities already installed, you can use it:
./configure --with-installed-iso-entities
Other interesting configuration options
--disable-docs No not build or install any doc
--enable-docs[=type] Explicitly set doc formats to build.
Possible values:
txt pdf info lyx html rtf dvi+ps.
(Default: enabled with "txt pdf
info lyx html rtf" value)
o Compile SGML-Tools:
make
or
gmake
whatever calls GNU make on your system. If you don't have GNU make installed,
get the sources from prep.ai.mit.edu now and install it - SGML-Tools needs
it to compile.
o Install SGML-Tools:
make install
(You must probably be root to install in /usr/local and other system
directories).
Note:
In order to use TeX/PS/PDF output, TeX style files in ./lib
subdirectory (linuxdoc-sgml.sty, linuxdoctr-sgml.sty, null.sty,
and qwertz.sty) are to be installed your LaTeX input directory,
such as "/usr/share/tex/latex/misc/".
Also url.sty and epsf.tex are required. Newer version of them
are available from recent teTeX distribution. If you wish to
have old ones, check the "./obsoleted" subdirectory.
It might be a good idea to install in a temporary directory for testing,
first (/tmp perhaps).
o the contrib directory has some interesting patches and scripts that may be
useful to you.
o there is a guide on the linuxdoc-tools documentation directory, it
describes how to use this package, read it next...