Short Description Of Important Scripts
--------------------------------------

This directory contains a number of executable programs and scripts which
either constitute the PROGRES environment or are useful extensions in the
form of additional utilities. Almost all scripts offer possibilities to
access the underlying database system of PROGRES, which is called GRAS.
The following ones may be important for users of the PROGRES system:

Progres		is a script for starting the PROGRES environment which defines
                default settings for a number of environment variables and
                creates initial directory structures etc. for new PROGRES
                users, i.e. it is a front-end to the Modula-2 program
                ProgControl.

StartGanimed	starts the central GRAS database control server if it
		is not already running. Any script which needs GRAS
		calls StartGanimed.  Therefore, you  may start Ganimed
		in advance but you are not forced to do it.
		The scripts acts as a front-end to the programs gexed
		(graph database server), starter (script for starting
		gexeds on remote machines), and ganimed itself.

StopGanimed     terminates the central GRAS database control server. This 
                process will be created automatically whenever the PROGRES
                environment or the script TestPoolDir are called. 

CompressPool	creates a compact backup of a complete graph pool
		(project data bases) and is a more convenient front-end
		to the Modula-2 program GRASlin.

UncompressPool	is the inverse program to CompressPool which is a more
		convenient front-end to the Modula-2 program linGRAS.

TestPoolDir	is a very primitive tty-based tool for inspecting and
		manipulating GRAS graphs (project data bases). It's
		the front-end to a rather undocumented Modula-2 program
		AGTest. Two functions of its main menu are important:
		* Reorganize: Activates "soft" recovery for a project
		  database based on temporary log files.
		* Reset: Activates "hard" reset/recovery for a
		  project database when temporary log files are no
		  longer accessible (in the case of disk failures,
		  manual deletion of temporary files, ... ).

M2Pretty	a small program for pretty-printing Modula-2 programs
		which is internally used for translating PROGRES spec.
		into readable plain Modula-2 code.

For further information about the above mentioned utilities see directory
man (and its subdirectories).


The directory contains also a number of foreign programs:
---------------------------------------------------------

hglayout	a software package for layout of hierarchical graphs which
		was developed at the University of Toronto as part of the
		Graphite project (contact noik@db.toronto.edu).

strace		a very valuable tool which reports all system calls of
		programs. Maybe you will need the tool for giving us
		more specific information about installation problems
		(written by Paul  Kranenburg,  Branko  Lankester,
		and Rick Sladkey).
