COMMAND NAME:

        STBUTTON

USAGE:

        STBUTTON <comand string>

EXAMPLES:
        STBUTTON MOVE 2[PROPERTY] 3[BOUNDARY]
        STBUTTON DELETE 1[] 2[cell] 3[DIAGONAL]

EXPLANATION: (command short for 'Stroke Button')

        This command allows a command string to be executed
after modification based upon which button was
used to enter the most recent STROKE.

        The construction :
                <button number>[part of a command string]
        can be used repeatedly throughout the command string.
Whatever is enclosed within the square brackets will
not be seen by the parser unless the appropriate
mouse button was used for the most recent stroke.

        This command is used primarily as a STROKE command string.
For example, the string:
                'STBUTTON MOVE 2[BOUNDARY];($sx1 $sy1)
        when bound to a stroke, will allow the user
to employ the SAME stroke for moving cells OR the boundary line.
If the second (middle) mouse button is used for the stroke, then the parser
will see the string:
                MOVE BOUNDARY ;($sx1 $sy1)
        and will move a boundary line picked by the first
stroke point. If any other button was used, the parser will see the string:
                MOVE;($sx1 $sy1)
        and will move a cell which was selected by the first stroke point.

        Note that the '<n>[]' construction can be used in the
command string as many times as needed.  For example,
                STBUTTON MYCOMMAND 1[vers] ADD 1[fred] 2[george]
        could produce:
                STBUTTON MYCOMMAND vers ADD fred    (button 1)
        or:
                STBUTTON MYCOMMAND ADD george       (button 2)
        or:
                STBUTTON MYCOMMAND ADD        (any other button)
