Loading the UofO LOTOS Toolkit tape


The tape, cartridge or e-mail you received contains the executable files
that compose the Ottawa University's LOTOS Toolkit.  The following steps
describe how to install it.

1) Create a directory were the files from the tape will be downloaded.
   the path may have any length;  for the sake of readability, 'TAPE'
   is used in the next examples, but any correct path may be substituted
   to it:

        % mkdir TAPE

2) Change to the directory previously created:

        % cd TAPE

3) Mount the tape or cassette (or unpack the e-mail) and extract the files.
   In the example, "/dev/rst0" is the device used ( Raw SCSI tape Interface,
   1/4" ).  If you have a 1/2" tape, use "/dev/rmt8" ( Raw Magnetic Tape
   Interface, 1/2" ).  If you have an e-mail file, use the full path of that
   file, and omit then density (126) from the command.

   Here is a list of the files that shoud be contained on the tape:

	% tar tf TARFILE
	./Toolkit/
	./Toolkit/README
	./Toolkit/lib/
	./Toolkit/lib/Makefile
	./Toolkit/lib/is.x
	./Toolkit/lib/is.l
	./Toolkit/exmpls/
	./Toolkit/exmpls/bitaltern.l
	./Toolkit/exmpls/constraint.l
	./Toolkit/exmpls/enable.l
	./Toolkit/exmpls/max.l
	./Toolkit/exmpls/mod1.l
	./Toolkit/exmpls/mult_exit.l
	./Toolkit/exmpls/mult_exit.ms
	./Toolkit/exmpls/multiplex.l
	./Toolkit/exmpls/multiplex_tester.l
	./Toolkit/exmpls/nat.l
	./Toolkit/exmpls/multisynch.l
	./Toolkit/exmpls/nat2.l
	./Toolkit/exmpls/paper.l
	./Toolkit/exmpls/parity_check.l
	./Toolkit/exmpls/stenning_prot.l
	./Toolkit/exmpls/ts_handler.l
	./Toolkit/exmpls/vending.l
	./Toolkit/exmpls/Makefile
	./Toolkit/exmpls/bitaltern.pl
	./Toolkit/exmpls/constraint.pl
	./Toolkit/exmpls/enable.pl
	./Toolkit/exmpls/max.pl
	./Toolkit/exmpls/mod1.pl
	./Toolkit/exmpls/nat.pl
	./Toolkit/exmpls/mult_exit.pl
	./Toolkit/exmpls/multiplex.pl
	./Toolkit/exmpls/multiplex_tester.pl
	./Toolkit/exmpls/multisynch.pl
	./Toolkit/exmpls/nat2.pl
	./Toolkit/exmpls/paper.pl
	./Toolkit/exmpls/parity_check.pl
	./Toolkit/exmpls/stenning_prot.pl
	./Toolkit/exmpls/ts_handler.pl
	./Toolkit/exmpls/vending.pl
	./Toolkit/lotos.c
	./Toolkit/Makefile
	./Toolkit/doc/
	./Toolkit/doc/lotos.man
	./Toolkit/doc/Refs
	./Toolkit/doc/xeludo.man
	./Toolkit/doc/xeludo.usrman
	./Toolkit/bin/
	./Toolkit/bin/sun4-4/
	./Toolkit/bin/sun4-4/lotos
	./Toolkit/bin/sun4-4/lotos0
	./Toolkit/bin/sun4-4/lotos1
	./Toolkit/bin/sun4-4/xeludo
	./Toolkit/bin/sun4-4/.message

4) Listing the directory 'TAPE/Toolkit' should reveal the following:

        % ls -F
	Makefile        bin/            exmpls/         lotos.c
	README          doc/            lib/

5) Before initiating the compilation precedures, edit the shell variables
   of the file 'TAPE/Toolkit/Makefile' according to your setup:

        LOTHOME    Full path of the directory where the tape was loaded

   ( and possibly one of the following, where the installer is asked to
     verify consistency of directory names provided and their existence:

        DESTDIR    Full path of the directory where programms will be installed
        LOTLIB     Full path of the directory where lotos library file will
                   premanently reside
   )

   No further edition should be required.

6) If LOTLIB was changed, recompile the command parser (lotos):
        % make c

7) Complete with the installation of the executable files:

        % make install

   which will install the files into the directory DESTDIR.

7) Before calling 'isla' or 'lotos', make sure that the DESTDIR directory
   is included in your search path (.cshrc or .login).

   In DESTDIR, you will find the following executables installed:

   sun4:

        lotos       Command parser of the LOTOS translator
        lotos0      LOTOS translator, first pass
        lotos1      LOTOS translator, sedond pass
        xeludo      ELUDO (Environnement LOTOS de l'Universite D'Ottawa),
		    interfaced for the X window system (X11R5).