CONTENTS | INDEX | PREV | NEXT
SYNTAX : RANGE ;U FILE TERM
: RANGE ;U TERM
RESULTING ARGUMENT: None
FUNCTION : Create an output file containing a selection from the
current buffer. The selection is removed from the buffer
after it is written to file.
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.
RANGE : START,END
START : the buffer position to start at
END : the buffer position to stop at
DEFAULT : h
EXAMPLE : 1 , 2 ;u new_file ESC
This command will write the second character of the
current buffer to file new_file and remove it from the
buffer.
NOTE 1 : If the file already exists, it is silently overwritten,
inheriting the protection from the original.
NOTE 2 : The default file name is not affected.
NOTE 3 : If writing the file does not succeed, the original will
be available under the same name, extended with .TVB.
MATRIX