Additionally to the programs given in Section 28.1, the following chunks list paths to programs that we need for building an ALLPROSE project. All these programs should be made accessible through the PATH environment variable.
In short, the necessary programs are GNU make, a working Aldor compiler, Perl, Noweb, a LATEX environment, and some common UNIX commands.
The variable ALDORROOT should be defined in the environment, see Section 29.1. The following variable points to the Aldor compiler executable.
In fact, we require all the programs that are necessary to produce an executable from an Aldor source file. Consult the Aldor User Guide for more details. For example, you should be able to compile and execute the following program via
aldor -grun -laldor hello.as
|
Since ALLPROSE builds on Noweb, it should be installed and accessible. Furthermore Perl, grep and cp should be available, see Section 28.1.
Instead of shell scripting we use Perl in several places. At the time of writing version 5.8.4 was used.
We use some programs that are commonly available in a UNIX like operating system.
We simulate the a program similar to the touch program via PERL. The only difference is that we do not modify the date of the file if the file already exists.
In order to compile the documentation it is vital to have a reasonably recent version of LATEX installed. ALLPROSE is able to produce a .dvi file via LATEX, a .pdf file via PDFLATEX, and a website via TEX4ht.
The TEX4ht software compiles the .tex file via LATEX and finally postprocesses the resulting .dvi file by the two programs TEX4HT and T4HT to get the final .html file(s). See the Makefile target html for the calling sequence. We need the plain TEX command in order to generate the index for the .html output.
Of course, for viewing the compiled files a viewer is necessary. These programs are, however, not vital to produce the documentation.