1STREADME.TXT			MAO			2-Dec--87
 
	The files on this tape are the sources for the FLECS and ALECS
structured language preprocessors for DEC FORTRAN and MACRO respectively.
On the VAX both preprocessors now run in native mode.  FLECS now generates
DEC F77 output code.
 
				NOTE
 
Unlike previous versions of FLECS & ALECS, there are now two task
images:  FLE & ALE.
 
The files and sources have been used under VMS V4.2-4.5;
I have not tested them under any other systems.
 
	For a VMS version (native mode) of FLECS/ALECS:
 
	1. Restore all files from the BACKUP tape.  Common sources are
under [.FLEALECOM], FLECS specific things are under [.FLEALECOM.FLECS],
and ALECS specific things are under [.FLEALECOM.ALECS].
 
	2. Execute the file [.FLEALECOM.FLECS]FLEBLD.COM.  This will
compile the sources and link FLE.EXE.  Do NOT answer "Y" to the question
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.  Execute the file FLETST.COM.  The file will tell if the
new version of FLECS works correctly.
  
	4.  At this point you may wish to execute FLEBLD.COM and answer
"Y" to the question; this 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.
 
	5.  To get ALECS, use [.FLEALECOM.ALECS]ALEBLD.COM.
 
	6.  See files FLE.COM and ALE.COM for the method of running
FLECS/ALECS under VMS.

	Below is a list of files on the tape:
 
	        [.FLEALECOM]--Stuff common to FLECS and ALECS
 
1STREADME.TXT	This file, an ASCII text file.
 
A.FLX		Source file, line analyzer subroutine.
 
ASUB.FLX	Source file, special ALECS code generation.
 
FILDAT.INC	Include file used by FILE, etc.
 
FILE.FLX	Upper level file IO routines.
 
FILERSX.MAC	Lower level file IO for RSX-11M.
 
FILEVMS.MAR	Lower level file IO for VMS.
 
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.
 
FLECSUIM_UPDATE.RNO/MEM	Updates to the above manuals.
 
FLECS_FUTURE.RNO/MEM My future plans for FLECS.

FLERSX.MAC	Source file, FLECS/ALECS MACRO routines (old code).
 
FSUB.FFF	Source file, FLECS/ALECS FORTRAN support routines.
 
INCDAT.INC	Include file for .INCLUDE statement.
 
ISUB.FLX	Source file, .IMPLICIT NONE processor.
 
L.FLX		Source file, listing subroutine.
 
LAMPFI.FLX	Source file, image initialization.
 
M.FLX		Source file, main routine.
 
STRING.FLX	Source file, string handling.
 
*II.*           Special versions of FLECS files that generate FORTRAN II
		code instead of DEC FORTRAN 77 (for use with some 
		microprocessor Fortrans we have)

	          [.FLEALECOM.FLECS]--FLECS specific
 
A.FLL,.FTN,.LST	Files from translating/compiling A.FLX.
 
FILE.FLL,.FTN,.LST Files from translating/compiling FILE.FLX.
 
FILE[VMS]/[RSX]	Files from assembling FILE[VMS]/[RSX].
 
FLE.BLD		Scratch file generated by FLETKB.COM

FLE.CMD/COM	Command file to use FLECS under RSX-11M/VMS
  
FLE.EXE		VMS V4.5, FOR V4.6 executable for FLECS.

FLEBLD.CMD/COM	Command file to compile and link FLE.TSK/EXE.
 
FLECMP.CMD/COM	Command file to compile FLECS/ALECS sources
		(used by FLEBLD.CMD/COM).

FLEPRT.CMD/COM	Command file to list all FLECS/ALECS command files
		and listing files on LP:.
 
FLETKB.CMD/COM	Command file to taskbuild/link FLE.TSK/EXE
		(used by FLEBLD.CMD/COM).
 
FLETST.CMD/COM	Command file to test newly created FLE.TSK/EXE.
 
FSUB.LIS,.OBJ	Files from compiling FSUB.FFF.

ISUB.FLL,.FTN,.LST Files from translating/compiling ISUB.FLX.
 
L.FLL,.FTN,.LST	Files from translating/compiling L.FLX.
 
LAMPFI.FLL,.FTN,.LST Files from translating/compiling LAMPFI.FLX.
 
M.FLL,.FTN,.LST	Files from translating/compiling M.FLX.
 
STRING.FLL,.FTN,.LST Files from translating/compiling STRING.FLX.
 
TST*.FLX	Used to test translation of FLECS keywords.

	      [.FLEALECOM.ALECS]--ALECS specific files
 
See the list for [.FLECS]--files are similar, but because of
Conditional translations contain some differences.
 
	       [.FLEALECOM.FLECSII]--FORTRAN II related stuff

	       [.FLEALECOM.OLD]--Old compatibility mode version

	       [.FLEALECOM.QLIB]--QLIB library sources
 
Library QLIB contains subroutines called by FLECS/ALECS.  Sources
for these subroutines and a copy of the library are in this directory.
 
	       [.FLEALECOM.TRAN]--Translate old FLECS to DEC F77

NOT completely debugged!!!  Converts old FLECS statements (like WHEN/ELSE)
into DEC F77 (like IF/THEN/ELSE).  Internal procedures and FLECS
directives (eg. .PASSIF) are left untranslated, due to lack of F77
equivalents.

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