CONTENTS | INDEX | PREV | NEXT

SYNTAX            : RANGE ;U FILE TERM
                  : RANGE ;U TERM

RESULTING ARGUMENT: None

FUNCTION          : Create an output file containing a selection from the
                    current buffer. The selection is removed from the buffer
                    after it is written to file.

                    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.

RANGE             : START,END
                    START         : the buffer position to start at
                    END           : the buffer position to stop at

DEFAULT           : h

EXAMPLE           : 1 , 2 ;u new_file ESC
                    This command will write the second character of the
                    current buffer to file new_file and remove it from the
                    buffer.

NOTE 1            : If the file already exists, it is silently overwritten,
                    inheriting the protection from the original.

NOTE 2            : The default file name is not affected.

NOTE 3            : If writing the file does not succeed, the original will
                    be available under the same name, extended with .TVB.

MATRIX