[VAX82B.CLEXTRACT]AAAREADME.TXT

	Submitted by:
		Joy Dorman
		Republic Management Systems
		Code 935
		Goddard Space Flight Center
		Greenbelt, MD  20771

CLEXTRACT is a utility to extract command definitions from a CLI tables
file and build an output file suitable for input to the Command Language
Editor (SET COMMAND).  The following caveats apply:
 
	1.  CLEXTRACT is version dependent.  It works under VMS V3.0 and
	    V3.1.  If the format of the CLI tables files changes in a 
	    future release, CLEXTRACT will not work.  If the list of
	    the DCL or MCR internal images changes, the macros DCLIMAGES
	    and MCRIMAGES must be modified to match and CLEXTRACT must be
	    rebuilt.
 
	2.  MCR command definitions are extracted by CLEXTRACT when /CLI=MCR
	    is specified.  I have not tried modifying MCR commands and
	    writing them back to MCRTABLES.EXE.  To do so one would use the
	    undocumented /CLI switch on SET COMMAND.  Again--- I have not
	    tried this.  CLEXTRACT is very sketchy in its dealings with MCR.
 
	3.  A comparison of the command definitions built by CLEXTRACT with
	    those on the fiche will yield some differences:
		.  CLEXTRACT cannot build prefix statements.  These statements
		   cause symbols to be defined when the /SYMBOLS switch is used.
		   The omission of prefix statements hurts nothing.
		.  CLEXTRACT defines synonyms as separate verbs (with identical
		   definitions).  An example of this is RUN, RU and R.  Again
		   this hurts nothing.
		.  The verb definitions generated by CLEXTRACT are only 4 
		   characters long.  This is the length of the verbs as stored
		   in the CLI tables.  Again this hurts nothing.
 
	4.  The generated command definitions for commands which are
	    "immediate" or "foreign" include a warning message not to use
	    the definition as input to the command language editor.  These
	    commands require different internal processing by DCL and should
	    not be changed. DEPOSIT, DSM, EXAMINE, EOD, EXIT, HELP, IF, INQUIRE,
	    MCR, ON, and WAIT are currently in this category.
 
	5.  CLEXTRACT is very lazy and will not find specific verbs unless they
	    are specified as a full four characters (unless the full verb is
	    less than four characters). For example /VERB=ACCO must be used
	    for ACCOUNTING, /VERB=ACC will not work.  More than four characters
	    can be specified.
 
 
CLEXTRACT.BLD is a command file to build CLEXTRACT.  It contains all the
installation instructions.
 
CLEXTRACT.HLP describes the format and qualifiers of CLEXTRACT.
 
CLNOTES.TXT contains some miscellaneous notes on undocumented CLEDITOR
features and some hints on modifying DEC commands.