Marked Section Parameters Dialog Box

This feature is only available when editing SGML documents, and you must turn on full menus to access it (Tools > Preferences > Full Menus).

Use this dialog box to create, modify, and delete marked section parameter entities (marked sections).

The Marked Section Parameters dialog box contains the following options:

• Name — Displays the name of the marked section parameter entities. These names appear inside the markup icon that represents the marked section entity.

• DTD — This column is checked if the marked section parameter entity is declared in the document type definition.

• Status — Displays the status parameters for a marked section.

◦ INCLUDE — Includes the contents of the icon pair during document processing.

◦ IGNORE — Omits the contents of the icon pair during document processing.

◦ TEMP — Marks the contents of the icon pair as temporary. Use this status to mark text that you may change or modify later. Arbortext Editor treats the status of TEMP the same as INCLUDE.

◦ CDATA — Treats as text (character data) the contents of the icon pair that includes valid SGML characters. The parser does not process the contents as markup. Use a marked section with this status to mark an example of straight SGML code you want displayed “as is” in the document.

◦ RCDATA — Replaces references with the text the references represent. Use when the icon pair contains replaceable character data such as character, text, or file entity references. Arbortext Editor treats the data the same way as CDATA, except that it replaces the entity references with the data.

◦ References — Includes other marked section parameter entities. In essence this creates a marked section that includes the text specified in the declared entity and the referenced entities. A reference to two other marked section parameter entities called marked1 and marked2 would look like this in the References box:

The Status keyword values of the referenced marked sections are taken into account during processing, as well as those of the marked section from which they are referenced. IGNORE status has the highest priority, whether specified directly or through a reference.

• Count — Displays the number of times the marked section parameter entity occurs in the document. This column is displayed when you select the Count Uses button.

• Duplicate — Opens the New Marked Section dialog box containing the parameters from the selected marked section parameter entity.

• Delete — Deletes the selected marked section parameter entity. You must delete all entity markup tags for this marked section entity from the document before deleting it. Only entity declarations in your document can be deleted. If the entity was declared in the document type DTD, the delete button will be disabled.

• Insert — Inserts the marked section at the cursor location.

• Apply — Applies the changes you've made in the Modify marked section dialog box.

Note that you must save your document before you can apply changes to a marked section.

• Find — Searches the document for the selected marked section parameter entity, starting at the cursor location. Select Find again to continue searching the document. If the set entityscan option is set to on, the search will include any file entities referenced in the document.

• Count Uses — Counts and displays in the Count column the number of references to marked section parameter entities used in the document. The count includes uses in any file entities referenced in the document.