-- Command: dirlist ID/K, COMMAND/K, PORT/K, HELP/K, NODE/K, PATH/K,
          PATTERN/K, REREAD/S ,TOGGLE/S, ATTRS/K/M
     Dirlist objects are created with this command.

        * ID [I..] - an id can be assigned to a dirlist for later
          reference. The id can be any combination of up to 5
          characters.  If the id is given without any other arguments,
          and the dirlist has been previously created, then the
          currently selected file (with path) will be returned in
          RESULT (if OPTIONS RESULTS is specified in the script).  If
          multiple files are selected then each file name (with path)
          will be returned with each dirlist command.  The file name
          entry in the list will be deselected.  A null string ("")
          will be returned if no files are selected (or the last
          selected file has been reached).

        * COMMAND [I..] - if given, the command will be executed
          whenever an item in the dirlist is double clicked.  For a
          complete description of this option see Command-Port Options.
           Note that the full path of the selected item will be used to
          replace a `%s' contained in the command string.

        * PORT [I..] - a specific host port may be specified by this
          argument. For a complete description of this option see
          Command-Port Options.

        * HELP [I..] - with this argument help text may be defined
          which will be displayed as balloon help whenever the pointer
          is over the associated dirlist. Of course, this is dependant
          on whether the user set up balloon help in the MUI preference
          settings.

        * NODE [I..] - this argument is used to specify a node in the
          guide file given in the command line argument HELP for
          `MUIRexx'. If the user positions the mouse pointer over the
          dirlist and presses the help button on the keyboard then the
          guide file will be displayed at the node location.

        * PATH [ISG] - at creation this argument specifies the initial
          directory path. When the dirlist command is issued with just
          the ID argument a fully qualified path name is returned for
          the file or directory selected in the listview.

        * PATTERN [IS.] - this argument sets the accept pattern for the
          directory list.  Any standard AmigaDOS pattern may be given. 
          Note that if a path is set (see PATH argument) or the
          directory is reread (see REREAD argument) then this pattern
          will be reflected.

        * REREAD [.S.] - if this switch is given then the dirlist will
          be updated with the current directory.

        * TOGGLE [.S.] - if this switch is given then the select state
          of each displayed file will be toggled.

        * ATTRS [ISG] - with this option any MUIA attribute TAGs may be
          set or retrieved (see Attribute TAGs).

     Some useful TAGs for use with this command are:

          TAG_Name =                        TAG_id          Flags Type
          
          Dirlist_Directory =               0x8042ea41 /* V4  isg STRPTR */
          Dirlist_DrawersOnly =             0x8042b379 /* V4  is. BOOL */
          Dirlist_FilesOnly =               0x8042896a /* V4  is. BOOL */
          Dirlist_FilterDrawers =           0x80424ad2 /* V4  is. BOOL */
          Dirlist_MultiSelDirs =            0x80428653 /* V6  is. BOOL */
          Dirlist_NumBytes =                0x80429e26 /* V4  ..g LONG */
          Dirlist_NumDrawers =              0x80429cb8 /* V4  ..g LONG */
          Dirlist_NumFiles =                0x8042a6f0 /* V4  ..g LONG */
          Dirlist_RejectIcons =             0x80424808 /* V4  is. BOOL */
          Dirlist_SortDirs =                0x8042bbb9 /* V4  is. LONG */
          Dirlist_SortHighLow =             0x80421896 /* V4  is. BOOL */
          Dirlist_SortType =                0x804228bc /* V4  is. LONG */
          Dirlist_Status =                  0x804240de /* V4  ..g LONG */
          List_Active =                     0x8042391c /* V4  isg LONG */
          List_AdjustHeight =               0x8042850d /* V4  i.. BOOL */
          List_AdjustWidth =                0x8042354a /* V4  i.. BOOL */
          List_AutoVisible =                0x8042a445 /* V11 isg BOOL */
          List_DragSortable =               0x80426099 /* V11 isg BOOL */
          List_DropMark =                   0x8042aba6 /* V11 ..g LONG */
          List_Entries =                    0x80421654 /* V4  ..g LONG */
          List_First =                      0x804238d4 /* V4  ..g LONG */
          List_Format =                     0x80423c0a /* V4  isg STRPTR */
          List_InsertPosition =             0x8042d0cd /* V9  ..g LONG */
          List_MinLineHeight =              0x8042d1c3 /* V4  i.. LONG */
          List_Quiet =                      0x8042d8c7 /* V4  .s. BOOL */
          List_ShowDropMarks =              0x8042c6f3 /* V11 isg BOOL */
          List_Title =                      0x80423e66 /* V6  isg char * */
          List_Visible =                    0x8042191f /* V4  ..g LONG */
          Listview_ClickColumn =            0x8042d1b3 /* V7  ..g LONG */
          Listview_DefClickColumn =         0x8042b296 /* V7  isg LONG */
          Listview_DoubleClick =            0x80424635 /* V4  i.g BOOL */
          Listview_DragType =               0x80425cd3 /* V11 isg LONG */
          Listview_Input =                  0x8042682d /* V4  i.. BOOL */
          Listview_MultiSelect =            0x80427e08 /* V7  i.. LONG */
          Listview_ScrollerPos =            0x8042b1b4 /* V10 i.. BOOL */
          Listview_SelectChange =           0x8042178f /* V4  ..g BOOL */
          CycleChain =                      0x80421ce7 /* V11 isg LONG */
          Disabled =                        0x80423661 /* V4  isg BOOL */
          HorizDisappear =                  0x80429615 /* V11 isg LONG */
          HorizWeight =                     0x80426db9 /* V4  isg WORD */
          ShowMe =                          0x80429ba8 /* V4  isg BOOL */
          VertDisappear =                   0x8042d12f /* V11 isg LONG */
          VertWeight =                      0x804298d0 /* V4  isg WORD */
          Weight =                          0x80421d1f /* V4  i.. WORD */
          
          Note: Consult MUI:Developer/Autodocs/MUI_List.doc, MUI_Listview.doc,
                MUI_Dirlist.doc, MUI_Area.doc and
                MUI:Developer/C/Include/libraries/mui.h

     Example use of this command:

          window TITLE '"MUIRexx Demo"' COMMAND '"quit"' PORT DEMO
              dirlist ID DIR1 PATH '"ram:"' PRESS APP DROP,
                  COMMAND '"dirlist ID DIR1 PATH %s"' PORT DEMO NODE '"dirlist"',
                  ATTRS Frame Frame_Text Listview_DragType Listview_DragType_Immediate
              .
              .
              .
          endwindow
          
          dirlist ID DIR1 ATTRS Dirlist_Directory
          say result