Installation instructions
=========================

This is ADE-based software. That means that the installation
instructions are divided into two parts: a generic part and an
application-specific part.

The generic part is described in the file INSTALL.generic,
distributed as part of ADE. 

The application-specific part (if there is any) is below.

You should read both parts before starting the installation,
because there may be instructions in the application-specific 
part which overrule instructions in the generic part.

Application-specific installation instructions
==============================================

Prerequisite software
---------------------

Obvious ADE does not require ADE, as the generic instructions 
in INSTALL suggest :-)

The following software is not a hard requirement, but does
mean that some ADE library functions will function correctly:

	sendmail (or something which provides /usr/lib/sendmail)
	gzip/gunzip
	compress/uncompress

Preparing to compile
--------------------

This goes as per the generic instructions specified in INSTALL,
except that the commands to run are:

	make
	bin/ade-config --format=make

and the file to edit to modify the paths is bin/ade-config.sh.

Installation
------------

This goes as per the generic instructions specified in INSTALL.
Once ADE is installed, optionally you can install the template
module lxperl or lxshell as lx. To do this run:

	adegmt lxperl /var/tmp/lx
	cd /var/tmp/lx

and then see the README.1ST file there for further instructions.
(Change lxperl to lxshell if you want; they are functionally
identical.)

In order to display the man pages of ADE and any ADE-based
software correctly, you must ensure that man(1) calls groff(1) 
and troff(1) with the '-U' option. Generally this means editing 
/etc/manpath.conf and changing this:

	DEFINE 	troff 	groff -mandoc
	DEFINE 	nroff	nroff -mandoc

to this:

	DEFINE 	troff 	groff -mandoc -U
	DEFINE 	nroff	nroff -mandoc -U

Although other options include writing small wrapper scripts.