CONTENTS | INDEX | PREV | NEXT

SYNTAX            : ARG @;U

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

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 a file for which a requester is
                    generated, 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