home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / fish / enhancements / workbench&intuition / toolmanager / toolmanager.doc < prev    next >
Text File  |  1991-01-20  |  4KB  |  102 lines
  1. Documentation for ToolManager 1.2                                   13.01.1991
  2.  
  3. This is program is FreeWare. The author is not responsible for any damage
  4. caused by the use of this program.
  5.  
  6.  I. What is ToolManager?
  7. With ToolManager you can add your own programs to the Tools menu of the 2.0
  8. Workbench. The name of the programs can be given at startup (CLI or Workbench
  9. parameters) or in a configuration file. Furthermore the user can drop a Tool or
  10. Project icon on the program's icon (or its status window) to add a tool to the
  11. list.
  12.  
  13. BEWARE: This program makes heavely use of the new 2.0 functions, so its
  14.         completely useless to all people who are still forced to use 1.3 :-)
  15.  
  16.  II. How to start ToolManager
  17. - From CLI:  Run ToolManager [<program 1>] ... [<program n>]
  18. If you want to use it in your Startup-Sequence, you will need to redirect its
  19. standard I/O or use RunBack. The name of program x will also be the name of its
  20. corresponding menu item.
  21.  
  22. - From Workbench: <Click on ToolManager's icon>
  23.                   [<Click on program 1's icon>] ...
  24.                   [<Double click program n's icon>]
  25. If you selected a Tool icon, its name will also be the name of the menu item.
  26. If you selected a Project icon, the icon name will be the name of the menu
  27. entry. The default tool of this icon will be called if the menu item is
  28. selected.
  29.  
  30. After the program has started, you will see a neat icon. Only one ToolManager
  31. can be active at a time, so every try to start it a second time will fail!
  32.  
  33.  III. The configuration file
  34. ToolManager scans also a file called "S:ToolManager.config". It consists of
  35. lines which look as follows:
  36.  
  37.     <Menu entry name>[;<Real program name>]
  38.  
  39. If only one name is given, it will be the name of the menu entry and also of
  40. the program to be called for this entry. If two names are given, the first will
  41. be the name of the menu entry and the second one will be the name of the
  42. program to be called.
  43.  
  44. To create a dummy entry without function, use:
  45.  
  46.     <Dummy menu entry name>;
  47.  
  48. Look at the example configuration file.
  49.  
  50.  IV. How to use ToolManager
  51. When ToolManager is active, you can see additional entries in the Workbench
  52. Tools menu. To start a tool you select its entry. Easy, isn't it? There is a
  53. special menu entry called "Quit ToolManager", which causes ToolManager to quit.
  54. It also quits if you send his process a break signal.
  55.  
  56. If you double-click the ToolManager icon, it opens the status window. To add a
  57. new tool, you just drag a Tool (or Project) icon on ToolManager's icon or on
  58. the status window and it will be added to the menu.
  59.  
  60. The status window contains a list of all tool names. To remove a tool, you
  61. select a name from the list and click the "Remove Tool" button. If you select
  62. the "Save configuration" button, the actual tool list will be saved in the
  63. configuration file. The window remembers its position when you close it.
  64.  
  65.  V. How to compile ToolManager
  66. This program was developed with DICE (nice job Matt!). You will need the
  67. registered version, because I used the __chip keyword, but DICE is worth its
  68. $40 anyway. Of course you need the 2.0 include files and the 2.0 amiga.lib.
  69.  
  70.  TODO
  71. - Icon for Workbench usage
  72. - Better looking internal icon (hey, I'm not a painter :-)
  73. - Support for different configuration files
  74. - Add tools at runtime with a second call of ToolManager
  75.  
  76.  HISTORY
  77. 1.2: Release version (13.01.1991)
  78.    - Status window changed to a no-GZZ & simple refresh type
  79.      (this should save some bytes)
  80.    - Status window remembers its last position
  81.    - New status window gadget "Save Configuration": saves the actual tool
  82.      list in the configuration file
  83.    - Small bugs removed in the ListView gadget handling
  84.    - Name of the icon hard-wired to "ToolManager"
  85.  
  86. 1.1 Release version (01.01.1991)
  87.    - Icons can be dropped on the status window
  88.    - Status window contains a list of all tool names
  89.    - Tools can be removed from the list
  90.  
  91. 1.0 Release version (04.11.1990)
  92.    - Initial release
  93.  
  94.  THANKS TO
  95.    - Brian Wright (IRCnick: VanHalen) for his suggestions
  96.  
  97.    Send comments or bug reports to:
  98.  
  99. Domain: stefanb@informatik.rwth-aachen.de
  100. Bang  : ..mcvax!unido!rwthinf!stefanb
  101. FIDO  : 2:242/7.6
  102.