Move an Element

The commands

MOVE,SELECTED,BY=by-expression;
MOVE,ELEMENT=place,BY=by-expression;
MOVE,ELEMENT=place,TO=to-expression;
MOVE,ELEMENT=place,TO=to-expression,FROM=from-name;

move element(s) to new location(s). Three cases are possible:

SELECTED,BY=by-expression

All currently selected elements are moved by by-expression.

ELEMENT=place,BY=by-expression

The (unique) element at place is moved by by-expression.

ELEMENT=place,TO=to-expression

The (unique) element at place is moved to the absolute position to-expression.

ELEMENT=place,TO=to-expression,FROM=from-name

The (unique) element at place is moved to position to-expression relative to element from-name. A relative position may be negative.

Except in the first case, it is an error to move more than one element with one MOVE command. The MOVE command must not attempt to change the order of elements in the sequence; elements can not ``hop'' over each other.