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