COMMAND NAME:

        POPUP

USAGE:

        POPUP CREATE <name of popup>
        POPUP DELETE <name of popup>
        POPUP ENTRY  <name of popup> <label> [<cmd string>]
        POPUP PATH   <name of popup> <name of dest.> [<label>]
        POPUP        <name of popup> [<x coord> [<y coord>] ]

        The POPUP command is used to define and invoke user popup menus.

CREATE:
        Before adding entries to a popup, it is first necessary to create one.
This is done via the 'CREATE' option of the POPUP command.
A textual name must be specified, and
this is the name which is used by subsequent popup commands.

DELETE:
        This keyword simply removes the specified popup.

ENTRY:
        This is used to add an entry into a popup.
You must specify the popup name as well as the textual label
which will appear in the popup.
This command also accepts an optional string which is the command to be
executed if the entry is selected.

PATH:
        Some entries in popups may have additional data associated with them
which can be specified by a nested popup.
An entry of this type will contain an arrow pointing to the right.
If the cursor is placed over this arrow, a new popup will appear alongside
the original popup.

        The keyword 'PATH' is used to create an entry of this type.
The command requires a destination popup name,
as well as an optional label.

NO KEYWORDS:
        This variant of the command causes the specified popup
to appear on the screen.
If no X/Y coords are given,
the popup appears with its top left corner at the last
digitized point on the screen.

EXAMPLES:
        POPUP CREATE mypopup
        POPUP ENTRY mypopup "just a comment"
        POPUP ENTRY mypopup "redraw the screen" "window fit"
        POPUP PATH mypopup anotherpopup ", to 2nd popup!"
        POPUP mypopup
        POPUP mypopup 100 200
        POPUP DELETE mypopup
