insert_tag (Command)
insert_tag { [ -pendingdelete | -nopendingdelete] tagname | [ -type] [ -panel]}
This command inserts the specified tag or tag pair (tagname) around the cursor or around currently selected text, if any. Note that paired tags are inserted as a pair.
|
|
If you have applied an alias map to the document, tagname can be either an alias or a real name. |
If typed alone at the command line, insert_tag (or simply it) brings up the Insert Markup dialog box that provides a list of tags that are valid at the cursor. The panel is context-sensitive meaning the tags in the panel will change as you move the cursor.
If you have applied an alias map to your document and Tags is the selected Mode, the list in the Insert Markup dialog box will display aliases, rather than real names, for tags that have been assigned an alias.
You can keep the Insert Markup dialog box on-screen and use it across editing windows.
|
|
After performing an insert_tag, cursor placement depends on whether the inserted tag has required elements, and on the setting of the set addrequiredtags option. |
Note that paired tags are inserted around a highlighted selection regardless of whether pending delete is on or off. However, if pending delete is on, the default for single (unpaired) tags is to replace highlighted text. If no arguments are given in the it command, then -panel is assumed and simply brings up the Insert Markup dialog box.
For insert_tag-[type]-[panel], the command specifies the initial markup type to be displayed in the Insert dialog box. Replace -type with one of the following: -dtd (for tags defined in the DTD), -usertags (for user-defined tags), -pi (for processing instructions), -text (for text (general) entities), -file (for file (external) entities), or -ms (for marked section parameter entities).
it is a synonym for insert_tag.
Examples
insert_tag
it comment
it -pd tabstop
it -nopd enspace
Related Topics
