read [ { -paste | -buffer buffername} [ -append]] [ -sgml | -untaggedascii | [ -xml] [ -encoding string] [ -cc | -nocc] [ -pendingdelete | -nopendingdelete] filename

This command inserts the text of the requested file at the point of the cursor.

-paste loads the text of the requested file into either the current or a named paste buffer.

-buffer buffername forces the information that is read to be loaded into the named buffer specified by buffername. If the buffer already exists it will be overwritten, else it is created.

-append adds text to the end of the buffer file rather than replaces the contents of the buffer.

-sgml allows you to read in an SGML document that does not have the SGML header created by the write -sgml command, that is, starting with <!DOCTYPE.

-untaggedascii allows you to read in the named document as ASCII. Tagging, if any, are interpreted as literal text, not Arbortext Editor tags. -untagged is a synonym for -untaggedascii.

-xml reads an XML document into the current document (SGML or XML). When this option is selected, a completeness check will not be performed (that is, -nocc is implied), and specifying -cc will have no effect.

-encoding determines the encoding of the file being read, as specified by string; string may be one of the following strings:

-cc forces Arbortext Editor to do a completeness check when it opens a file created with Arbortext Editor. (By default, a completeness check is not done if the file being read in was saved in Arbortext Editor.) This option is recommended when opening documents which were created in Arbortext Editor but were later edited elsewhere and that may no longer be normalized or complete.

-nocc does not allow Arbortext Editor to do a completeness check when reading a document or file. (By default, a completeness check is done after the file is read in.) In this case, the document should be fully normalized.

-pendingdelete replaces any selected text in the document with the file being read.

-nopendingdelete preserves any selected text in the document and places the file being read to the right of the current selection.

filename is the file name and path (if needed).

Examples