modify_tag [ -local [tagname] | -global [tagname] | -quick | -quickattr] { [[attr=value] …] | [ -inline] [ -modal] [ -attrattrname]}

In the Edit view, this command opens the Modify Attributes dialog box for modifications to either the tag or entity reference immediately before the cursor, or the specified tag or entity reference. In the Document Map view, this command applies to the tag to the right of the cursor if the cursor is at the start of a line (that is, between the element icon and the element name); you can control this behavior with the set docmapcurrenttag=off option.

For tags defined by your DTD, local modifications can be made to SGML/XML attributes. Unless you are modifying a user-defined tag, attributes can only be modified locally. Tags supplied by Arbortext Editor, such as _link, have attributes that can be modified with this command.

If -local is specified (the default), only the current instance of the tag will be affected. Attributes that are set locally override attributes that are set globally.

The -global option is generally able to modify non-DTD markup such as user-defined file and text entities, marked sections, and processing instructions. It cannot modify attributes or elements of a DTD. Where -global is allowed and specified, it modifies every occurrence of the tag in the entire document.

The -quick (or -quickattr) option will launch the Quick Attribute dialog box, where you can modify a single attribute for the specified element.

The -inline option causes the Column view attribute value cell with focus, if any, to be opened for modification. The command fails silently if the current view is not a Column view or if no cell has focus.

If -modal is specified, the Modify Attributes dialog box is launched as a modal dialog box.

The attr=value option modifies attributes without opening the Modify Attributes dialog box. Up to 50 attr=value pairs can be specified with a single command. You can determine the names of attributes from SGML/XML files.

The attr=value option can be used to set invalid attributes to new values. New invalid attributes cannot be added using this technique.

In a Free-form document type instance, the attr=value option can be used to alter the value of existing attributes and to add new attributes and values. New attribute names must be valid XML names.

If the -attrattrname option is specified, then the keyboard focus for the Modify Attributes dialog box is set to the value field for the specified attribute name. By default, the focus is set to the first attribute field.

mt is a synonym for modify_tag.

Examples