>ReadMe for MenUtils
:
SWI's supported:

MenUtils_BuildMenu                         

        purpose: create a menu structure from a string describing it.
                 see format of descriptor below.
        in:  r0  pointer do string description
             r1  pointer to buffer to put menu structure
             r4  pointer to end of buffer

        out: r4  pointer to end of used buffer

MenUtils_CreateMenu     
                       
        purpose: create and open a menu from a string describing it.
                 the format of the string is the same as for BuildMenu
                 also, position said menu on the screen at x-64,y+40
                 if y is given -1 calculate y for a menu on iconbar.
        in:  r0  pointer do string description                        
             r1  pointer to buffer to put menu
                 structure, or -1 to use own buffer
             r2  x position on screen
             r3  y position on screen or -1  
             r4  pointer to end of buffer if r1<>-1

        out: r1  pointer to buffer
             r2  calculated x
             r3  calculated y
             r4  pointer to end of used buffer


                                                

Format of menu descriptor string: 
Title\tpars,item0\parameter0,item1\parameter1....itemn\parametern

where Title               is title of menu
      item0,item1..itemn  are the items on menu
      tpars               title parameters have not been implemented yet
                          but may become:
                                Hh      h is height of each item
                                Gg      g is gap
                                Tc      c is menutitle foreground colour
                                tc      c is menutitle background colour
                                Mc      menuitem foreground
                                mc      menuitem background
                                Ff      Fancy font f in title
                                ff      Fancy font f in items
      parameter0,1..n     are parameters associated to item0,1..n
                          parameters are:
                                D       dotted line
                                T       ticked item
                                S       shaded item
                                In      input writable item. n (opt) maxlen
                                Bn      icon bounding box max n chars
                                w       issue menu warning
                                Wh      submenuwindow handle h
                                |p      p is pointer to submenu structure
                                {menu}  menu is a submenu descriptor string
                          W,{ and | are mutually exclusive and should be
                          the last parameter of item.
                          W and | are of course functionally identical.
                          the B parameter is intended to be used in
                          conjunction with the I parameter. \I250B10 means
                          a writeable field of 250 chars with only 10 chars
                          showing.

exaple of descriptor string:
ADFS::4,Name disc\{Disc name,\I10},Dismount,Format\S,Backup\S,Verify,Free

note: { and } characters are not allowed in menu titles and items
      commas and \ can be specified, if preceded by \
