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