CONTENTS | INDEX | PREV | NEXT
SYNTAX : ARG ;Y FILE TERM
: ARG ;Y TERM
RESULTING ARGUMENT: None
FUNCTION : Read a specified file into the current buffer, at a
specified position.
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.
The cursor (and implicitly the value of . ) is set to
the beginning of the newly read segment.
ARGUMENT : The position in the current buffer at which to include
the file.
DEFAULT : z
NOTE : The default file for the buffer is set to the new name.
MATRIX