CONTENTS | INDEX | PREV | NEXT
SYNTAX : ARG ;U FILE TERM
: ARG ;U TERM
RESULTING ARGUMENT: None
FUNCTION : Create an output file containing a number of lines from
the current buffer. The lines written to file are
removed from the buffer.
The file name is taken from the command string, and
consists of all characters immediately following the
command up to the first ESC or RETURN encountered. If
the file name is empty, the default file for the buffer
is used. If this is not set, an error is reported. The
file name may include a directory specification.
ARGUMENT : The number of lines to process, starting at the current
cursor position, counting forward (backward if negative).
EXAMPLE : Z j -3 ;u new_file ESC
This command will write the last three lines of the
current buffer to file new_file and remove them from
the buffer.
NOTE 1 : Short-hand arguments Z and -Z specify all lines up to
the end (or beginning) of the buffer.
NOTE 2 : If the file already exists, it is silently overwritten,
inheriting the protection from the original.
NOTE 3 : The default file name is not affected.
NOTE 4 : If writing the file does not succeed, the original will
be available under the same name, extended with .TVB.
MATRIX