README.md
README.1ST MAO 18-Nov-82

The files on this tape are the sources for the FLECS and ALECS
structured language preprocessors for FORTRAN and MACRO-11 respectively.

NOTE

There is but a single task for FLECS & ALECS called FLE.TSK; install it
as ...FLE to get FLECS, install it as ...ALE to get ALECS!!

The files and sources have been used under RSX-11M 3.2 and 4.0; I have not
tested them under any other systems.

In order to produce a working copy of FLECS/ALECS from these files
the following steps are necessary:

1. Transfer all files from the tape to some disk, UIC.

2. Execute the file FLECRE.CMD. This will compile the FTN files
(Note F4P is used--FOR should work too), assemble the MAC file and
task build FLE.TSK. Do NOT use FLEBLD.CMD at this stage; because of the
use of in-line comments in the .FLX sources on this tape, old versions of
FLECS cannot properly translate the .FLX files on this tape.

3. Install the copy of FLE.TSK as ...FLE and execute the file
FLETST.CMD. The file will tell if the new version of FLECS works
correctly. To test ALECS you can perform a similar test using the
supplied example MCRREQ.ALX.

4. At this point you may wish to execute FLEBLD.CMD which will
give you a completely new set of files for FLECS/ALECS (and destroy
the distribution copies on the disk). This file is actually intended
for use if you wish to modify FLECS/ALECS after you have a working version.

Below is a list of files on the tape:

A.FLX,.FTN,.FLL Source file, line analyzer subroutine.

ALE.CMD Command file to use ALECS.

ASUB.FLX,.FLL,.FTN Source file, special ALECS code generation.

FLE.CMD Command file to use FLECS.

FLEBLD.CMD Command file to recreate FLE.TSK once FLECRE.CMD
has been used to create the initial version.

FLECMP.CMD Command file to compile FLECS/ALECS sources
(used by FLEBLD.CMD).

FLECRE.CMD Command file to create FLE.TSK from distribution.

FLECSUIM.MEM A copy of the UIM in text format for those who don't have
DSR.

FLECSUIM.RNO FLECS/ALECS User Instruction Manual in Digital Standard
Runoff format.

FLEPRT.CMD Command file to list all FLECS/ALECS command files
and listing files on LP:.

FLERSX.MAC Source file, FLECS/ALECS MACRO routines.

FLETKB.CMD Command file to taskbuild FLE.TSK
(used by FLEBLD.CMD).

FLETST.CMD Command file to test newly created FLE.TSK.

FSUB.FTN Source file, FLECS/ALECS FORTRAN support routines.

L.FLX,.FTN,.FLL Source file, listing subroutine.

LAMPFI.FLX,.FTN,.FLL Source file, task initialization.

M.FLX,.FTN,.FLL Source file, main routine.

MCRREQ.ALX A sample routine written in ALECS.
MCRREQ.ALL An ALECS listing file for MCRREQ.
MCRREQ.MAC ALECS MACRO-11 output for MCRREQ.

README.1ST This file, an ASCII text file.

Michael A. Oothoudt (505) 667-4354 or (505) 667-5241
P.O. Box 1663, Mail Stop H828
Los Alamos, NM 87545

END OF FILE README.1ST