Gulam Shell Scripts for the Atari Simula System

INSTRUCTIONS

         Gulam shell scripts for the Atari SIMULA system

                R. Klute / W. Rupflin, 1990-03-21



The following Gulam shell scripts accompany the Atari SIMULA 
system:

SIMA.G   Archive one ore more SIMULA object modules in a library

SIMC.G   Compile a SIMULA source module

SIMCA.G  Compile one ore more SIMULA source modules and archive 
         the generated object modules in a library

SIMCL.G  Compile and link a SIMULA program

SIMCLG.G Compile, link and execute ('go') a SIMULA program

SIMG.G   Execute a SIMULA program

SIML.G   Link a SIMULA program

SIMLG.G  Link and execute a SIMULA program



Unfortunately the Gulam parameter passing mechanism is buggy and 
string comparison is not (yet) implemented. This makes it impos-
sible to write some cute shell scripts to support the compile, 
link, execute cycle. Those scripts accompanying the current Atari 
SIMULA release are therefore rather crude.

However, some control about shell script execution can be 
achieved by using certain environment variables. They are used to 
hold options for compiler, linker, runtime system and archiver 
and serve to adopt the Atari SIMULA system to a specific 
environment and to specific needs. In Gulam environment variables 
are set with the 'setenv' command. See the default GULAM.G file 
for examples.

The following environment variables are used:

$SIMA_OPTIONS     Holds additional options for the archiver 'ar'. 
                  Allowed values are 'c', 'v' and 'V'. No 
                  default.

$SIMC_OPTIONS     Holds compiler options. Default: '-l -p'.

$SIMG_OPTIONS     Holds runtime system options. No default.

$SIML_OPTIONS     Holds linker options. Default: '-p'.

$SIMULA_HOME      Name of the SIMULA directory, where SIMULA 
                  compiler, SIMULA runtime system and the SIMULA 
                  shell script folder COMMANDS are located. 
                  Default: Directory where Gulam was started.

$SIMULA_COMMANDS  Name of the directory where the shell scripts 
                  are located. Default: $SIMULA_HOME\COMMANDS.

$SIMULA_RTSLIB    Name of the SIMULA runtime system library. 
                  Default: $SIMULA_HOME\SIMULA.A.