home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 575.lha / ToolsDeamon_v1.0 / ToolsDeamon.doc.pp / ToolsDeamon.doc
Text File  |  1991-12-06  |  7KB  |  173 lines
  1.  
  2.  
  3.  
  4.                                ToolsDeamon 1.0
  5.  
  6.                                  User Manual
  7.  
  8.                                  Oct 19, 1991
  9.  
  10.  
  11.  
  12. Preface
  13. =======
  14.  
  15. The programs and files in this distribution are freely distributable, but are
  16. also copyright (c) Nico François.  They may be freely distributed as long as
  17. no more than a nominal fee is charged to cover time and copying costs.
  18.    No commercial usage is permitted without written permission from the
  19. author.  Everything in this distribution must be kept together, in original
  20. unmodified form.
  21.    The above is generally known as freeware.
  22.  
  23.    If you have suggestions or remarks about this program, or if you find
  24. any bugs, please let me know.
  25.  
  26.    Write to the following address:
  27.  
  28.                                 Nico François
  29.                                 Corbielaan 13
  30.                                 B-3060 Bertem
  31.                                 BELGIUM
  32.  
  33.    These programs only run on Amigas with Kickstart & Workbench 2.0!
  34.  
  35.  
  36. Contents
  37. ========
  38.  
  39. 1. An introduction
  40.  
  41. 2. Installation
  42.  
  43. 3. Usage
  44.  
  45.  
  46. 1. An introduction
  47. ==================
  48.  
  49. Your Workbench 2.0 manual will tell you:  It is possible to run a program by
  50. choosing a menu item from the Tools menu of Workbench 2.0.  But only if your
  51. application software supports this feature.  Your application software will
  52. have instructions on how to create the new menu item.
  53.  
  54.    But what if you want to add programs which do not have this feature?  Then
  55. there is ToolsDeamon.
  56.  
  57.    ToolsDeamon allows you to run programs simply by selecting a menu item from
  58. the Tools menu of Workbench 2.0.  Shell and Workbench programs are supported,
  59. including arguments and tool types for both of these.
  60.  
  61.    ToolsPrefs is designed as a preferences editor for the 'Tools' menu.  It
  62. features a full intuition front-end.
  63.  
  64.    ToolsDeamon is the background program that will launch the tools you
  65. select from the 'Tools' menu.  It is meant to be dragged into the WbStartup
  66. drawer so it will automatically be launched on startup.
  67.  
  68.  
  69. 2. Installation
  70. ===============
  71.  
  72. Installation is very easy.  Double-click the 'Handler' icon to install
  73. 'ToolsDeamon-handler'.  Then drag 'ToolsDeamon' to your WbStartup drawer so it
  74. will be launched by Workbench each time you reboot.
  75.  
  76.    'ToolsPrefs' requires 'reqtools.library' to run, so make sure this is
  77. present in your Libs: directory.  Double-click the 'Install_ReqTools' icon
  78. for an automatic installation.  reqtools.library exists in two versions, one
  79. for Kickstart 1.2/1.3 and one for 2.0.  Note that only the version for 2.0 is
  80. included since ToolsDeamon only runs on Kickstart 2.0 or higher.
  81.  
  82.    'ToolsPrefs' can be dragged to the Prefs drawer of your Workbench, but
  83. you can install it anywhere you want.
  84.  
  85.  
  86. 3. Usage
  87. ========
  88.  
  89. Once everything is installed run the ToolsPrefs program.  This will allow you
  90. to define the menu items you would like to add to the 'Tools' menu.
  91. ToolsPrefs has two lists:  'Menu Items' and 'Commands'.  The menu items list
  92. corresponds to the text that will appear in the menu items of the Tools menu.
  93. Each menu item has its own command list.  So by choosing one menu item you can
  94. invoke several commands.
  95.  
  96.    ToolsPrefs features a full intuition front-end to edit the items and
  97. commands lists.  Everything is fairly self-explanatory, except maybe the
  98. 'Bubble Up' and 'Bubble Down' menu items in the 'Edit' menu.  These allow you
  99. to change the order of the menu items, by allowing you to move the current
  100. item closer to the top ("bubble up") or to the bottom of the list ("bubble
  101. down").
  102.  
  103.    Commands can be run as Workbench or Shell commands.  Commands indicated
  104. as Workbench commands will be loaded and run by ToolsDeamon just as if the
  105. Workbench had loaded them.  Shell commands will be executed with a command
  106. line as if they were run from a Shell (or CLI).
  107.  
  108.    ToolsPrefs supports the use of arguments.  If you select one or more
  109. icons before selecting an item from the 'Tools' menu these files will be
  110. passed as arguments.
  111.  
  112.    If the command is a Workbench command the arguments will be passed as if
  113. you selected some icons and SHIFT-double-clicked the program's icon.  For this
  114. to work the command has to be followed by '[]' indicating it supports
  115. arguments.  For example:  '(WB ) C:PPMore []'.
  116.  
  117.    If the command is a Shell command the arguments will be expanded onto its
  118. command line.  You should indicate with '[]' where you want the arguments to
  119. appear.  For example:  '(CLI) Type [] HEX'.
  120.  
  121.    The integer gadget next to the command string gadget determines the stack
  122. size for the command (in case of a Shell command).  If the command is launched
  123. as a WB tool the stack size will be read from the tool's icon.
  124.  
  125.    The easiest way to add an item is to pick up an icon and drop it in
  126. ToolsPrefs's window.  This will create a new item named after the program with
  127. a command list to run the program.  Dropping an icon in the 'Commands'
  128. listview will not result in the creation of a new item, but in adding a new
  129. command to the current command list.
  130.  
  131.    When you select 'Save' ToolsPrefs will check if ToolsDeamon is running
  132. and will tell it to update the menus if it is.  It is therefore advisable to
  133. call ToolsPrefs if ToolsDeamon is already up and running.  If you have dragged
  134. ToolsDeamon to your WbStartup drawer as suggested above it will always be
  135. running and you'll have nothing to worry about.
  136.  
  137.    Double-clicking the icon of a menu file saved with 'Save As...' will
  138. result in adding the menu items to the 'Tools' menu (if ToolsDeamon is already
  139. running the previously added menu items will be removed first).
  140.  
  141. NOTE: - ToolsDeamon will search the path for Shell commands, but not for
  142.         Workbench commands!
  143.       - Start ToolsDeamon again to quit it.
  144.  
  145.  
  146.                        As always, I hope you find these programs useful!
  147.  
  148.  
  149.                               PROGRAM HISTORY:
  150.  
  151. *****************************************************************************
  152. VERSION 1.0
  153.  
  154.      First release.
  155.  
  156. *****************************************************************************
  157.  
  158. ToolsMenu 1.0 written by Nico François (Yes, Nico is my first name :-)
  159.               thanks to Marc Duponcheel, Jorrit Tyberghein and Peter Stuer
  160.                         for beta-testing and all the useful suggestions,
  161.                         Johan Van Houtven for the editing of this manual.
  162.  
  163.  
  164. "He was struck by a bullet
  165.  and he melted into fluid named extinction" - The Pixies
  166.  
  167.  
  168. (c) 1991 Nico François
  169.  
  170.                                    //
  171.                        Thanks to \X/ Amiga for being the best computer ever !
  172.  
  173.