SGMLtools INSTALL, version 2.0.x
$Id: INSTALL,v 1.6 1998/10/17 20:26:36 cg Exp $

** For more uptodate information, visit the SGMLtools homepage
   at http://www.sgmltools.org/

** Start reading doc/environment.txt first if you want to know how
   this works!

The installation process is mostly driven by Python scripts that read
RPM .spec file templates in order to determine what's going on. The
normal sequence is:

% ./configure
% make
% make install

Of course, for the last step you'll likely need extra privileges.

./configure has a load of options for directory specification. At the moment,
only "--prefix" is known to work, you're on your own for the rest. See 
./configure --help for any other options.

You can add targets to "make" in order to get commands executed for
single targets (plus dependencies, of course). Example:

% make prep-sgmltools

will configure "sgmltools", and

% make build-jade

will build "jade". See the Makerules file generated by configure for
full details. Markers are created in .deps/ so if you want to repeat
a command, either clean .deps/ or append .force:

% make build-jade.force

Will build Jade, again.


Other issues
==============

1. /etc/sgml
------------
The configure stage could result in your being asked to become root in order
to have /etc/sgml setup for you. Read doc/sgml-dir-standard.sgml for more
information on this directory. 

This directory is configurable with the configure --with-etcsgml switch. Note 
that although no other tools currently use it, you may want to install
'sgmlwhich' in a location that's in everybody's PATH, because that script will
help tools to find your alternate --with-etcsgml location.

2. TeX location
---------------
In tools/findTeX.py there is a simple script that tries to find out where
TeX lives. If you have a non-standard (non-teTeX or TeX Live) TeX installation
or don't want SGMLtools to install components in the main TeX directory,
set the environment variable TEXMF_DIR to point to the base directory
where you want SGMLtools to install TeX stuff.

3. SGML location
----------------
The default install location is, for the moment, /usr/local/{bin,share/sgml}.
If you want to install to another location, set SGML_BIN_DIR and
SGML_SHARE_DIR to something else. Something more sophisticated will
follow later on. There's a SGML_DOC_DIR as well, for documentation
stuff (default /usr/local/doc).

Note that some subpackages want a prefix (like in ./configure --prefix). In
these cases, we take SGML_BIN_DIR minus the "/bin" at the end.

Directories are a mess. I have written the "directory standard" to allow
as much freedom as possible, and this seems to conflict with autoconf (or
at least makes things complicated). Until I straighten this out, we won't
read /etc/sgml.conf for directory locations :-(.

4. Ports
--------
At least on Digital Unix, there seems to be a problem building Jade
with either gcc 2.8 or egcs. We don't know whether this is a 64bit issue
(and thus occurs only on 64bit platforms) or has to do with optimization
(and thus could occur using gcc 2.8 or egcs on any platform), so use
gcc 2.7 to be sure. Any updates are welcome.

