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