Category : Files from Magazines
Archive   : AIOCT86.ZIP
Filename : ASSE.DOC

A Brief Guide to A Simple Structure Editor (ASSE)
by
Jeffrey M. Jacobs

Copyright (c) 1986, CONSART Systems Inc.
P.O. Box 3016, Manhattan Beach, CA (213)376-3802
All rights reserved. Permission granted for
non-commercial distribution.
CompuServe: 75076,2603
BIX: jeffjacobs
UUCP: [email protected]

Keywords are in UPPER CASE, i.e. REPLACE, INSERT etc.

"n" is an integer.

"form" is a user's form, i.e. an atom list or number.

The ASSE editor is invoked by:

(EDITV symbol) ; To edit the value of "symbol".
(EDITF symbol) ; To edit the function definition of "symbol").

If no "symbol" is specified, ASSE will use the state from the last
session.

Command Action
_______________________________
n A non-zero integer "n" changes ASSE's view to be
the nth element of the current view.
0 0 (zero) changes ASSE's view to be the expression
containing the current view.

UP Similar to 0; if the current view is a tail
of the containing expression, it will be the first
element in the new view.

NEXT Change the view to the expression following the
current view. Similar to UP 2.

TOP Change the view to the "top" of the form being
edited.

UNDO Undo the last destructive operation.

DELETE n Delete the nth element of the current view.
"D" and "DEL" are abbreviations for DELETE.

INSERT form BEFORE n To insert a new element in the list. "I" and "INS"
INSERT form AFTER n are abbreviations for INSERT, "B" and "BEF" for BEFORE,
"A" and "AFT" for AFTER.

REPLACE n WITH form To replace the nth element. "R" and "REP" are also
accepted.

EMBED n Embed the nth element in parends. "EMB" is also
accepted.

EXTRACT n Remove a set of parends from around the nth element.
"EXT" and "XTR" are also accepted.

TEST Places a "BLOCK" on the *UNDO_LIST* (see REVERT).

REVERT Undoes all destructive commands since the last TEST.
Allows the user to test new versions and to back up
to a previous version. REVERT cannot be undone.

UNBLOCK Removes the most recent BLOCK from the *UNDO_LIST*.

SAVE Exits the editor, saving the current state of the
editing session on the property list of the symbol
being edited.

OK Exits the editor, but DOES not save the current state.

P Prints the current expression to the depth specified
by *PRINT_LEVEL*.

PL n Prints the current expression to level "n".

PP Pretty Prints the current expression. May require
modifications for various dialects.

?? Prints out the history of destructive commands.