CONTENTS | INDEX | PREV | NEXT

SYNTAX            : ARG @;S

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 picked from a requester, active on the
                    current directory.

ARGUMENT          : The number of lines to write, starting at the current
                    cursor position, counting forward (backward if negative).

EXAMPLE           : Z j -3 @;s ESC
                    This command will write the last three lines of the
                    current buffer to a file for which a requester is
                    generated.

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