PURPOSE

  Prefs is a GoldED menu converter for computer addicts who prefer to edit
  a cryptic menu definition file instead of using GoldED's menu requester.

COPYIGHT

  1995  Dietmar  Eilert  (e-mail:  DIETMAR@TOMATE.MBP.OCHE.DE).  All  Rights
  Reserved.  Code  may not be reused/reproduced without written permission of
  the author.

  Dietmar Eilert
  Mies-v-d-Rohe-Str.31, 52074 Aachen, Germany
  E-Mail: DIETMAR@TOMATE.MBP.OCHE.DE
  Tel: +49-(0)241-81665
       +49-(0)2525-7776
  Fax: +49-(0)241-81665

USAGE & CONFIGURATION

  This utility is able read GoldED's menu preset files and  convert  them  to
  ASCII  menu  description files (or vice versa). Use the <dump ASCII> button
  to convert GoldED preset files to ASCII menu  description  files.  Use  the
  <create preset> button to create a GoldED menu preset file according to the
  contents of a menu description file.

ASCII FILE SYNTAX

  Menu  description  files  may  consist  of  empty  lines,  comments  (lines
  introduced  by  a  semicolon)  and  commands.  Please have a look at a menu
  description file created by Prefs to  get  a  rough  idea  of  the  command
  syntax. The following commands are available:


  command    option        description
  --------------------------------------------------------------------------
  GUIDE      GUIDE/K/A     set menu's guide (STRING: file name)


  command    option        description
  --------------------------------------------------------------------------
  MENU       MENU/K/A      add new (sub)menu (STRING: menu name)


  command    option        description
  --------------------------------------------------------------------------
  ENDMENU    ENDMENU/S     terminate (sub)menu


  command    option        description
  --------------------------------------------------------------------------
  BAR        (none)        add barlabel entry to menu


  command    option        description
  --------------------------------------------------------------------------
  ITEM       ITEM/K/A      add (sub)item: (sub)item name (STRING)
             COMMAND/F     command string: internal command (STRING)
             DOS/F         command string: DOS command      (STRING)
             AREXX/F       command string: ARexx command    (STRING)
             TEXT/F        command string: text command     (STRING)
             LEAVEOUT/S    add gadget to window's title bar
             KEY/K         shortcut (STRING)
             DIR/K         current directory (STRING)
             OUTPUT/K      output handle (STRING, e.g. "con:")
             SHANGHAI/N    shanghai time (UWORD: seconds)
             ASYNC/S       run DOS commands asynchronously
             GUIDE/K       guide entry related to this menu (STRING)
             CHECKMARK/K   display checkmark (STRING: variable name)
             Q/K           Qualifier (not supported)
             QM/K          Qualifier (not supported)

             Comment: Valid CHECKMARKs are  INSERT,  WRAP,  INFOS,  BRACKET,
             CHKCASE,  ALEFT,  INDENT, SOLID, SINDENT, BACKUP, ABAK, ASKBAK,
             ACENTER, AFOLD,  ALOAD,  USER1,  USER2,  USER3,  USER4,  USER5,
             USER6,  USER7,  USER8,  USER9,  USER10, USER11, USER12, USER13,
             USER14,  USER15,  USER16,  USER17,  USER18,   USER19,   USER20,
             PREVIEW, TEMLATES, REVERSED, WILDCARDS and UNDO.


  command    option        description
  --------------------------------------------------------------------------
  NEXT       COMMAND/F     add further command to last (sub)item: internal
             DOS/F         add further command to last (sub)item: DOS
             AREXX/F       add further command to last (sub)item: ARexx
             TEXT/F        add further command to last (sub)item: text


  command    option        description
  --------------------------------------------------------------------------
  SEPARATE   SEPARATE/N    turn barlabels on/off (UWORD: 0 or 1)


  command    option        description
  --------------------------------------------------------------------------
  FILELIST   FILELIST/N    select file menu (UWORD: menu ID or 0 = <off>)
