MARK

MARK returns a place holder for the current edit position. MARK can create either free or bound markers. Bound markers are tied to a specific character location in the buffer. As text is added or deleted, the marker and character locations are adjusted. Bound markers can have one of the following attributes:

NONE, REVERSE, BLUE, MAGENTA, BOLD, UNDERLINE, CYAN, RED, BLINK, BLACK, GREEN, WHITE, YELLOW

Free markers do not have video attributes or a specific character position. Once a free marker is given a character position, it is a bound marker. Bound markers cannot become free markers under any condition. Free markers can exist in the following locations: before the line, after the line, middle of a tab, and past the end of the buffer. The free marker is given a distance offset from the nearest character.

Syntax:

marker := MARK ( attribute )

marker := MARK ( FREE_CURSOR )

Example:

The following tells nu/TPU to place a BOLD MARK at the current cursor location and store information on that MARK into the variable m1.

m1 := MARK (BOLD);

Errors:

TPU$_BADKEY Invalid keyword.

TPU$_INSVIRMEM Insufficient memory.

TPU$_NOCURRENTBUF Not in a buffer.

TPU$_UNKKEYWORD Invalid keyword.

Related Builtins: