• The name of a file, including path if needed.

• An asterisk (*) indicating the message window. If preceded by a right angle bracket (>*), the output is appended to the message window instead of replacing its contents.

• -ct — Specifies how the document will write changes that have been made with change tracking turned on:

◦ original — Writes the document as if all pending changes were rejected.

◦ changesapplied — Writes the document as if all pending changes were accepted.

◦ changeshighlighted — Writes the document with all pending changes displayed.

• -sgml — Writes a version of the document conforming to the SGML standard, ISO 8879. Unless the -noheader option is specified, the standard DOCTYPE header listing any private ENTITY declarations will appear at the top of this version. By default, SGML documents are written as SGML documents.

• -untagged — Writes a text-only version of the document which contains no tags. No entity expansion or substitution is attempted. write -untagged does not write equations.

• -xml — Writes the file as an XML document. By default, XML documents are written as XML documents.

• -encoding — Specifies with string the encoding of the file being written. The setting of this option overrides the encoding declaration in an XML file.

◦ If the original document is an SGML document and the -xml option is specified, the resulting XML file will use the original encoding if the SGML document has a byte-order mark (an ISO-10646-UCS-2 file) or a special encoding was set using edit -encoding. If there was no special encoding or it isn't an ISO-10646-UCS-2 file, then the resulting XML file will use UTF-8 encoding. UTF-8 is the default encoding for XML documents.

◦ If the original document is an SGML document and either no option is specified or the -sgml option is specified, the resulting SGML file will use the same encoding as the original document.

◦ If the original document is an XML document and the -sgml option is specified, the resulting SGML file will use the encoding used by the operating system.

◦ If the original document is an XML document and either no option is specified or the -xml option is specified, the resulting XML file will use the same encoding as the original document.

• -paste — Writes the contents of the current paste buffer to the specified file.

• -buffer — Writes the contents of the named paste buffer to the specified file.

• -all — Writes the entire document to the new file name. This is the default option.

• -ok — Writes the file without prompting you if a file with the same name already exists. The existing file will be overwritten. Alternatively, the file name may be preceded with an exclamation point (!) to suppress the prompt.

• -header — Specifies that the DOCTYPE header and any private ENTITY declarations that normally appear at the top of a standard DOCTYPE header are maintained.

• -noheader — Removes the DOCTYPE header and any private ENTITY declarations that normally appear at the top of a standard DOCTYPE header.

• -pi — Writes processing instructions specific to Arbortext Editor.

• -nopi — Removes all processing instructions (except change tracking processing instructions) specific to Arbortext Editor.

• -eoc — Turns on entity conversion, letting you specify how you want Arbortext Editor to write out character entities. This setting overrides the value of the set entityoutputconvert command.

• -noeoc — Turns off entity conversion, and, if set entityinputconvert is off, Arbortext Editor writes out character entities as they were read in. This option overrides the value of the set entityoutputconvert command.

• -nonasciichar — Specifies how Arbortext Editor writes out non-ASCII characters. -nonasciichar has the following arguments:

◦ entref — Writes out non-ASCII characters as character entity references. If Arbortext Editor cannot find matching character entity references, it writes out the non-ASCII characters as numeric character references. This is the default setting.

◦ char — Writes out non-ASCII characters as characters in the target encoding. If Arbortext Editor cannot find the characters in the target encoding, it writes out the non-ASCII characters as numeric character references.

◦ numref — Writes out non-ASCII characters as numeric character references.

• -public — Writes the alternate public identifier pubident on the DOCTYPE declaration instead of the original value (if any). pubident is not checked for validity as a minimum literal. If pubident is <none>, then the PUBLIC identifier will be omitted.

• -sysid — Writes the alternate system identifier sysident on the DOCTYPE declaration instead of the original value if any. For XML files, sysident should be a valid URL (as created by the filename_to_url function). If sysident is <none>, the SYSTEM identifier will be omitted. Using this option overrides the setting of the set writeabsolutesysid command.

• -nobreakattag — Specifies that breaks not be inserted at element boundaries or before the tag close character (applies to XML documents only). Such breaks may not be properly ignored by web browsers. Avoiding breaks at element boundaries tends to produce many breaks within elements. This may produce a file that is difficult to read when viewed with a text editor. Using this option overrides the setting of the set writenobreakattag command.

• -flatten — Specifies that Arbortext Editor expand entity references on write, replacing references with the text of the entity type as specified by one of the following arguments:

◦ file — Expands all file entities recursively. Declarations for all file entities are omitted from the internal subset.

◦ text — Expands all text entities recursively. Declarations for all text entities are omitted from the internal subset.

◦ both — Expands both file and text entities. This is a shorthand combination of -flatten file -flatten text.