create_file

This alias creates a new document of the same type as the document being edited and then inserts, at the cursor, an entity reference to the new document. Any selected (highlighted) text is moved to the new document. If you simply enter create_file_entity with no arguments, you are prompted for an entity name and for the system and public identifiers (which are optional).

name is the file entity name, which is used to construct the reference. If you enter the name of a file entity that has already been declared and there are no conflicts with system and public identifiers for that entity, information from the existing declaration is used. If there are conflicts, you are prompted to resolve them. If the name you supply is unique, this alias constructs a file entity declaration for the new document and adds this declaration to the private markup section of the document instance being edited.

sysid is the system identifier for the file entity, which is also used as the path name for the document instance being created. If no system or public identifier is specified, the entity name is used as the file name, and the file is placed in the current working directory.

If a text string, the system identifier, or the public identifier includes spaces or special characters (characters other than letters, digits, and underscores), it needs to be enclosed in quotation marks.

pubid is the public identifier for the file entity. An attempt is made to find this identifier in one of the catalog files in the directories identified by the set catalogpath option (typically the doctypes subdirectory of Arbortext-path). If a mapping for the identifier is found in one of these files, then the path name to which the identifier is mapped is used as path name for the new document.

When both system and public identifiers are given, if a mapping for the public identifier can be found in an entity map file, the public identifier takes precedence and the system identifier is not used.