CONTENTS | INDEX | PREV | NEXT

SYNTAX            : ARG ;S FILE TERM
                  : ARG ;S TERM

RESULTING ARGUMENT: None

FUNCTION          : Create an output file containing a number of lines from
                    the current buffer. The buffer remains unchanged, and
                    the current cursor position is not affected.

                    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 write, starting at the current
                    cursor position, counting forward (backward if negative).

EXAMPLE           : Z j -3 ;s new_file ESC
                    This command will write the last three lines of the
                    current buffer to file new_file.

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