This document describes the directories and files dealing with the scan
utilities.  The "root" directory contains only this document and the 
directory files themselves.

NOTE: many of the scan programs, during compilation, need access to include
some of the files in the [.scn_rtl_defs] directory via the logical name
SYSDEFLIB$SCN.

Most programs are more fully defined in their source or accompanying 
documentation.

Directory SYS$SYSROOT:[SYSMGR.DKR.LTSIG_TAPE]

AAAREADME.TXT
CALCULATOR.DIR
SAM.DIR
SCN_RTL_DEFS.DIR
SUBSTITUTION.DIR
UTILITIES.DIR

Directory SYS$SYSROOT:[SYSMGR.DKR.LTSIG_TAPE.CALCULATOR]

This is an on-line calculator that allows parenthetical nesting of expressions.
It operates on integers, dollars/cents, picas/points, and hours/minutes.

CALC.DOC;1         
	Describes the operation of the calculator
CALCULATOR.EXE
	The executable file
CALCULATOR.LOG
	The batch job output from submitting the "run" file
CALCULATOR.RUN
	A batch job file showing some examples including errors
CALCULATOR.SCN
	The source program for the calculator
CALC_INSTALL.DOC
	A brief note about installing the command system-wide

Directory SYS$SYSROOT:[SYSMGR.DKR.LTSIG_TAPE.ROMAN]

The subroutine contained here will take a string argument that is to be 
parsed to determine if it is a roman numeral.  If so, the value is 
returned; otherwise, an error status results.

ROMAN.DEF
	A scan "include" file to define the subroutine call for roman
ROMAN.OBJ
	The linkable object file for the following roman subroutine
ROMAN.SCN
	The subroutine source for parsing a roman numeral and returning 
	the value

Directory SYS$SYSROOT:[SYSMGR.DKR.LTSIG_TAPE.SAM]

The subroutines provided here simulate some of the features of an indexed
sequential file by using trees to accomplish this in memory.

SAM.OBJ
	The linkable object file for the following subroutines
SAM.SCN
	The subroutines source file for simulating indexed sequential files.
	The comments document the operation and features.

Directory SYS$SYSROOT:[SYSMGR.DKR.LTSIG_TAPE.SCN_RTL_DEFS]

These are useful definitions of some services from RMS or the VMS RTL.

$RMSDEF.SCNDEF
	Defines some statuses for use with find_file
LIB$DO_COMMAND.SCNDEF
LIB$FIND_FILE.SCNDEF
LIB$ICHAR.SCNDEF
LIB$TRA_EBC_ASC.SCNDEF
RECOVERY_PACKET.SCNDEF
	standard definition for the scan error record structure

Directory SYS$SYSROOT:[SYSMGR.DKR.LTSIG_TAPE.SUBSTITUTION]

MACROS.DAT
	the list of codes and their replacement text
MACROS.IN
	a sample input file for running through the macro preprocessor
MACROS.OUT
	the resultant output file from the sample input
MACRO_PREPROCESSOR.EXE
	the executable macro preprocessor
MACRO_PREPROCESSOR.SCN
	the scan source code for the macro preprocessor
SUB.SCN
	a "generic" string substitutor (this must be compiled to be used)

Directory SYS$SYSROOT:[SYSMGR.DKR.LTSIG_TAPE.UTILITIES]

FILE_TIDY.EXE
	the executable for the tidy a file program
FILE_TIDY.SCN
	the source program for the tidy a file program; it will compress
	multiple blanks, remove trailing blanks, and optionally rewrap
	line to a specified margin
NONPRINT_ASCII.EXE
	the executable for the find nonprintable ascii characters program
NONPRINT_ASCII.SCN
	the source code for the find nonprintable ascii characters program
TIDY.DAT
	the output of file tidy's sample file using a margin of 50
TIDY.SAVE
	a sample file to run through the file_tidy program; read its text
	to find out how to do it