home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 458.lha / ToolManager_v1.1 / ToolManager.doc < prev    next >
Text File  |  1991-01-02  |  3KB  |  81 lines
  1. Documentation for ToolManager 1.1                                   01.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 to add a tool to the list.
  11.  
  12. BEWARE: This program makes heavely use of the new 2.0 functions, so its
  13.         completely useless to all people who are still forced to use 1.3 :-)
  14.  
  15.  II. How to start ToolManager
  16. - From CLI:  Run ToolManager [<program 1>] ... [<program n>]
  17. If you want to use it in your Startup-Sequence, you will need to redirect its
  18. standard I/O or use RunBack. The name of program x will also be the name of its
  19. corresponding menu item.
  20.  
  21. - From Workbench: <Click on ToolManager's icon>
  22.                   [<Click on program 1's icon>] ...
  23.                   [<Double click program n's icon>]
  24. If you selected a Tool icon, its name will also be the name of the menu item.
  25. If you selected a Project icon, the icon name will be the name of the menu
  26. entry. The default tool of this icon will be called if the menu item is
  27. selected.
  28.  
  29. After the program has started, you will see a neat icon. Only one ToolManager
  30. can be active at a time, so every try to start it a second time will fail!
  31.  
  32.  III. The configuration file
  33. ToolManager scans also a file called "S:ToolManager.config". It consists of
  34. lines which look as follows:
  35.  
  36.     <Menu entry name>[;<Real program name>]
  37.  
  38. If only one name is given, it will be the name of the menu entry and also of
  39. the program to be called for this entry. If two names are given, the first will
  40. be the name of the menu entry and the second one will be the name of the
  41. program to be called. Look at the example configuration file.
  42.  
  43.  IV. How to use ToolManager
  44. When ToolManager is active, you can see additional entries in the Workbench
  45. Tools menu. To start a tool you select its entry. Easy, isn't it? There is a
  46. special menu entry called "Quit ToolManager", which causes ToolManager to quit.
  47. It also quits if you send his process a break signal.
  48.  
  49. If you double-click the ToolManager icon, it opens the status window. To add a
  50. new tool, you just drag a Tool (or Project) icon on ToolManager's icon or on
  51. the status window and it will be added to the menu.
  52.  
  53. The status window contains a list of all tool names. To remove a tool, you
  54. select a name from the list and click the "Remove Tool" button.
  55.  
  56.  V. How to compile ToolManager
  57. This program was developed with DICE (nice job Matt!). You will need the
  58. registered version, because I used the __chip keyword, but DICE is worth its
  59. $40 anyway. Of course you need the 2.0 include files and a 2.0 amiga.lib.
  60.  
  61.  TODO
  62. - Icon for Workbench usage
  63. - Better looking internal icon (hey, I'm not a painter :-)
  64. - Support for different configuration files
  65. - Add tools at runtime with a second call of ToolManager
  66.  
  67.  HISTORY
  68. 1.1 Release version (01.01.1991)
  69.    - Icons can be dropped on the status window
  70.    - Status window contains a list of all tool names
  71.    - Tools can be removed from the list
  72.  
  73. 1.0 Release version (04.11.1990)
  74.    - Initial release
  75.  
  76.    Send comments or bug reports to:
  77.  
  78. Domain: stefanb@informatik.rwth-aachen.de
  79. Bang  : ..mcvax!unido!rwthinf!cip-s02!stefanb
  80. FIDO  : 2:242/7.6
  81.