
     list
        A list of items; the user clicks on one of the  items  to
        select it.  Syntax:

        list={ label=... value=... name=...  action=...  item=...
        itemlist=...        columns=... height=... width=... }

        The list object has a text label and a list of items.

        name  defaults to "list1", "list2"  etc.   label  appears
        adjacent to the list.  value is the initial value associ-
        ated with the list. It must match the value of one of the
        list items, or it defaults to be the same as the value of
        the first list item.   action  occurs  when  an  item  is
        selected.

        item and itemlist are used to  describe  the  items  con-
        tained  in  a list. You can either specify items one at a
        time with item, or  in  groups  with  itemlist.  See  the
        detailed  descriptions  of item and itemlist below. There
        is no limit on the number of items or itemlists used in a
        list  object.   columns  is  the number of columns in the
        list. The default is two.  It may be  useful  to  specify
        height  and  width  for  lists  with  many entries. These
        parameters will determine the size of the scrollable area
        within  which  the list will be displayed. Otherwise, the
        area will be made big enough to encompass all items.

        Assigning a new value to a list changes the list value to
        match  the new value. If the new value does not match any
        item's value the list will be unchanged.

        The entries in a  list  can  be  changed  using  the  SET
        action.  For example, suppose an action were of the form:
        action="SET mylist list "a b c d"

        This would cause the list of an object named mylist to be
        reset to the four entries a, b, c, d. The string contain-
        ing  the  list  values  must  have  the  individual  list
        entries,  separated  by spaces or newlines. When the list
        entries are reset in this way, the  values  corresponding
        to  the entries are assumed to be the same as the entries
        themselves. There is no way to have distinct  labels  and
        values as there is when the list is first created.

        example:
        list={ label="german color" action="PRINT benutze $val "
             item={ label=red value=rot }
                item={ label=green value=gruen }
                item={ label=blue value=blau }
                    }
