2. Installation

You can get sgml-tools-1.0.x.tar.gz from:

• http://pobox.com/~cg/sgmltools

2.1 What SGML-Tools Needs

The file sgml-tools-1.0.x.tar.gz contains everything that you need to write SGML documents and convert them to groff, LaTeX, PostScript, HTML, GNU info, LyX, and RTF. In addition to this package, you will need some additional tools for generating formatted output.

1. groff. You need version 1.08 or greater. You can get this from ftp://prep.ai.mit.edu/pub/gnu. There is a Linux binary version at ftp://sunsite.unc.edu/pub/Linux/utils/text as well. You will need groff to produce plain text from your SGML documents. nroff will not work! You can find the version of your groff from groff -v < /dev/null.
2. TeX and LaTeX. This is available more or less everywhere; you should have no problem getting it and installing it (there is a Linux binary distribution on sunsite.unc.edu). Of course, you only need TeX/LaTeX if you want to format your SGML documents with LaTeX. So, installing TeX/LaTeX is optional.
3. flex. lex will probably not work. You can get flex from ftp://prep.ai.mit.edu/pub/gnu.
4. gawk and the GNU info tools, for formatting and viewing info files. These are also available on ftp://prep.ai.mit.edu/pub/gnu, or on ftp://sunsite.unc.edu/pub/Linux/utils/text (for gawk) and ftp://sunsite.unc.edu/pub/Linux/system/Manual-pagers (for GNU info tools). awk will not work.
5. LyX (a quasi-WYSIWYG interface to LaTeX, with SGML layouts), is available on ftp://ftp.via.ecp.fr.

2.2 Installing The Software

The steps needed to install and configure the SGML-Tools are:

1. First, unpack the tar file sgml-tools-1.0.x.tar.gz somewhere. This will create the directory sgml-tools-1.0.x. It doesn't matter where you unpack this file; just don't move things around within the sgml-tools-1.0.x directory.
2. Read the INSTALL file - it has detailed installation instructions. Follow them. If all went well, you should be ready to use the system immediately once you have done so.