COMMAND NAME:

        REPLAY

USAGE:

        REPLAY 
        REPLAY <filename[.replay]>

        This command allows the user to execute a REPLAY file 
which is normally generated as a "log" file by the application 
each time it is run.  If no filename is specified, you are prompted 
for one.  The filename must end with the extension ".replay", which 
need not be typed (it is automatically appended if needed). 

        REPLAY files can be generated by copying or renaming
a ".log" file.  For example, if you are running an application 
named "compose" you may execute the following statements (% is
an operating system tty terminal or UNIX "shell" prompt):

            % cp compose.log test.replay
            % compose

            COMPOSE> replay test


FILE FORMAT:

        The files are presumed to be generated automatically by the
application's logging capability.  It is similar to a normal SCRIPT 
file with some exceptions.  Basically all ambiguities of commands
typed into the session are resolved by the syntax.  In addition,
the results of popup menus and consumed strokes are recorded in 
using an unSCRIPTable directive syntax, marked by a leading number 
sign (#).

DIRECTIVES:

        The directive statements all begin with a leading number
sign. The syntax of a directive is:

            <'#'><NAME_OF_DIRECTIVE><' '><DIRECTIVE_SPECIFIC_DATA>

        Note that a space character must immediately follow the 
directive "name".  Additional lines of specific data may follow this 
line, each also marked by a leading number sign.
	
        The special directive:

            #PAUSE [your message here]

        can be inserted into a REPLAY file to cause a blocking pause
of a REPLAY.  A popup window or menu will appear when this is 
encountered and the REPLAY will pause until an appropriate interactive
action is taken to dismiss the popup.  This directive is never
automatically generated, so its insertion should be carefully analyzed.
Do not insert a directive inside of another directive, for example.
