set docmappastecaret= { on | off}

This option determines the position of the caret (cursor) in the Document Map view after a paste, insert_string , or insert_entity command or insert() function completes. This option is provided for backward compatibility with certain pre-Adept 7.0 ACL scripts.

In the Edit view, the caret is always positioned immediately after the pasted region.

In the Document Map view, the caret is placed immediately before the pasted region if the docmappastecaret option is set to on (the default). This default setting in the Document Map minimizes horizontal scrolling after a paste or insert operation. If docmappastecaret is set to off, the caret is positioned at the end of the region after the paste or insert.

If you have an ACL script from a pre-7.0 version of Adept that relies on the cursor being placed after pasted regions, you should set the set docmappastecaret=off command at the beginning of the script. This will guarantee that the “current tag” will always be to the left of the cursor, even if the cursor is at the start of a line in the Document Map view. When your script completes, it should execute the set docmappastecaret=on command to restore the default value.