home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / commod / appmenu1.lha / AppMenu / AppMenu.doc < prev    next >
Text File  |  1993-02-25  |  5KB  |  138 lines
  1.                           AppMenu - Version 1.1
  2.                   Copyright © 1993 by Marius Chwalczyk
  3.  
  4.  
  5.    AppMenu is FREEWARE but copyrighted © 1993 by Marius Chwalczyk. It's freely
  6. distributable as long as all of its files are included in their original form
  7. without modifications of any kind. Only a moderate copying charge is allowed
  8. for its distribution. This program is "as-is", all use is at your own risk.
  9.  
  10.    AppMenu is a utility for Workbench. It runs only under Release 2 (V37) and
  11. later versions of the Amiga operating system. It's a commodity that adds menu
  12. items to the Workbench Tools menu. When a menu item is activated, AppMenu
  13. starts up a program you chosed. You can free define the items and programs to
  14. execute. All programs are started as separate, asynchronous processes. You can
  15. also choose arguments for these programs through icons or file requester.
  16.  
  17. Installing and running.
  18. -----------------------
  19.  
  20.    To install AppMenu simple copy it where you want it to have. You can start
  21. it from Workbench or from Shell. Or just place it in the WBStartup drawer.
  22. The following arguments in the line command or the tool types in the icon are
  23. all optional.
  24.  
  25.    CX_PRIORITY=n
  26.    CX_POPUP=YES|NO
  27.    CX_POPKEY=hotkey
  28.  
  29. See Workbench handbook for this commoditiy tool types. Defaults are pririty 0,
  30. popup 'YES' and popkey 'shift f3'.
  31.  
  32.    FROM=prefs
  33.  
  34. 'prefs' is the preferences file (default "ENVARC:AppMenu/AppMenu.prefs"), where
  35. AppMenu saves the items. Each item contain a menu item text, a command text and
  36. a arguments specification.
  37.  
  38. The interface.
  39. --------------
  40.  
  41.    AppMenu's window presents a list gadget with its scroller and a string field
  42. below, a separate string field, a cycle gadget, two buttons and a bank of four
  43. buttons. To call the window press the hothey, activate 'AppMenu...' item in
  44. Tools menu, run AppMenu again or use the Exchange program. Exchange can be use
  45. for some other things too (see its docs).
  46.  
  47.    The functions of the gadgets are:
  48.  
  49. Menu Items
  50.    This listview gadgets show the item list. To change a item just select it.
  51.    Now you can update the command text. Press Return or Tab key or change 'Arg'
  52.    gadget to activate the string field below the listview gadget. Here you can
  53.    modify the item text and press Return to take the item back to the list.
  54.  
  55. Command
  56.    Type the program name and its arguments you want to execute. Note that you
  57.    must specify the full path of the command when you start AppMenu from
  58.    Workbench.
  59.  
  60. Arg
  61.    Select if and from where you want arguments to a command. The possibilities
  62.    are:
  63.    
  64.    Requester   If you activate the item a file requester appears and you can
  65.                choose a file name as an argument to the command. You can cancel
  66.                the execution too.
  67.  
  68.    Icons       The names of selected icons in Workbench (if any) will be
  69.                arguments.
  70.  
  71.    Icons/Req   Same as above. If no icon selected as 'Requester'.
  72.  
  73.    None        Execute command without extra arguments.
  74.  
  75. New
  76.    Add a new item to the list. Just type a command text, choose 'Arg' and write
  77.    a menu item text. To quick add a program put its icon in the AppMenu window.
  78.    Its name will be the item text and its path with the name the command. The
  79.    number of items you can add is limited only by available memory, the system
  80.    (V37) however creates only 63 selectable menu items.
  81.  
  82. Del
  83.    To remove a item from the list select it and press the 'Del' gadget.
  84.  
  85. Save
  86.    Save the itm list to the preferences file. Further as 'Use'.
  87.  
  88. Use
  89.    Close window, use current list to create item in Tools menu and execute
  90.    commands of the chosen items.
  91.  
  92. Cancel
  93.    Undo all changes in the list since the window is open, close it and use the
  94.    old list. Note that window's Close gadget and Exchange's Hide command have
  95.    the equal function.
  96.  
  97. Quit
  98.    Quit AppMenu. Ctrl-C makes it too. If the changed items are not saved first
  99.     appears a requester.
  100.  
  101. The last four buttons have menu equivalences with short-cuts.
  102.  
  103. The Program and its Author.
  104. ---------------------------
  105.  
  106.    Localization is to do in the next release.
  107.  
  108.    AppMenu is written in C and compiled with SAS/C 6.2. It's tested on an
  109. Amiga 3000 (KS 37.175, WB 37.71) with Enforcer and Mungwall.
  110.  
  111.    If you have some comments, additional ideas and/or bug reports, feel free to
  112. send e-mail a letter or to give me a call.
  113.  
  114.    You can reach me via
  115.  
  116.         E-mail: m_chwalc@informatik.uni-kl.de
  117.                    (Note that I'm unable to send any messages since
  118.                    it's at my university and not allowed. :-( )
  119.  
  120.           Mail: Marius Chwalczyk
  121.                 Zigelstr. 59/165
  122.                 D-6750 Kaiserslautern (Germany)
  123.  
  124.          Phone: (Germany)0631-10944
  125.  
  126. History.
  127. --------
  128.  
  129. 1.0 Internal release.
  130.       
  131. 1.1 First public release.
  132.  
  133.    The preferences are saved in separate file instead of in tool types.
  134.    Added prefs-not-saved-requester.
  135.    Added 'Icons' as arguments.
  136.  
  137. -
  138.