CONTENTS | INDEX | PREV | NEXT

SYNTAX            : ;X FILE TERM
                  : ;X TERM

RESULTING ARGUMENT: None

FUNCTION          : Create an output file containing the current buffer.
                    Read the next input-file (if any) or exit.

                    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.

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

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

NOTE 3            : After command completion, TV commences exit-processing.
                    It will exit unless (in this order):
                    1) More input-files are specified.
                       If so, the next one is read into the same buffer, and
                       the default file associated with the buffer is set to
                       its name.
                    2) Any modified non-empty buffers with associated files
                       remain.
                       If so, an automatic switch into that buffer is
                       performed, an error is displayed, and TV continues to
                       accept commands.
                    3) Protected registers remain.
                       If so, an error is displayed, and TV continues to
                       accept commands.
                    4) Registers with an associated stack are popped until
                       their stack is empty, or until an error-situation
                       as described above occurs. BEWARE: exit-processing
                       may already have discarded other buffers (which did
                       not prevent an exit)!

MATRIX