CONTENTS | INDEX | PREV | NEXT

SYNTAX            : ARG ;H

RESULTING ARGUMENT: None

FUNCTION          : Abort the current buffer. Read a next input-file (if
                    any) or exit.

                    When called with argument -1, all changes to all
                    buffers are discarded, and TV is forced into an exit.

ARGUMENT          : number: Terminate the current buffer without saving and
                    (7.0) read in the file number positions forward in the
                    list of files to be processed. Only positive numbers are
                    acceptable, and only insofar as the list of files is not
                    exceeded. Up to release 7.0, only 1 was acceptable as
                    a number.
                    -1: Terminate all buffers (end session)

DEFAULT           : 1

NOTE 1            : After command completion, TV commences exit-processing.
                    It will exit unless (in this order):
                    1) More input-files are specified.
                       If so, the next one is read into the same buffer, and
                       the default file associated with the buffer is set to
                       its name.
                    2) Any modified non-empty buffers with associated files
                       remain.
                       If so, an automatic switch into that buffer is
                       performed, an error is displayed, and TV continues to
                       accept commands.
                    3) Protected registers remain.
                       If so, an error is displayed, and TV continues to
                       accept commands.
                    4) Registers with an associated stack are popped until
                       their stack is empty, or until an error-situation
                       as described above occurs. BEWARE: exit-processing
                       may already have discarded other buffers (which did
                       not prevent an exit)!
                    With argument -1, all these checks are omitted, and TV
                    exits unconditionally and immediately.

NOTE 2 (7.0)      : The function of
                       ARG ;H
                    is comparable to
                       ARG < ;H >
                    with the advantage that skipped files are not read,
                    making it considerably more efficient.
MATRIX