home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / new / util / boot / toolsdaemon / toolsdaemon.doc < prev    next >
Text File  |  1994-01-30  |  20KB  |  542 lines
  1.  
  2.  
  3.      
  4.  
  5.  
  6.                                 ToolsDaemon 2.1a
  7.  
  8.                                   User Manual
  9.  
  10.                                 January 30, 1994
  11.  
  12.  
  13.  
  14.      PREFACE 
  15.  
  16.         The programs   and   files   in   this   distribution   are  freely
  17.      distributable,  but  are also Copyright (c) Nico Francois. They may be
  18.      freely  distributed  as  long as no more than a nominal fee is charged
  19.      to cover time and copying costs.  
  20.         No commercial  usage  is  permitted without written permission from
  21.      the  author. Everything in this distribution must be kept together, in
  22.      original unmodified form.  
  23.         The above is generally known as freeware.  
  24.  
  25.         If you  have  suggestions  or remarks about this program, or if you
  26.      find any bugs, please let me know.  
  27.  
  28.         Contacting the author: 
  29.  
  30.           Internet:   nico@augfl.be
  31.           FidoNet :   2:292/603.10
  32.           AmigaNet:   39:120/102.10
  33.  
  34.           Snail-mail: Nico François
  35.                       Corbielaan 13
  36.                       B-3060 Bertem
  37.                       BELGIUM
  38.  
  39.         If you  can  please use e-mail. That way you'll stand a much better
  40.      chance of getting a reply quickly.  
  41.  
  42.         ToolsDaemon uses  and  requires  reqtools.library  V38 (or higher).
  43.      ReqTools is also Copyright © 1991-1994 Nico François.  
  44.  
  45.         NOTE: ToolsDaemon  2.1a requires Kickstart 2.0 and Workbench 2.0 or
  46.      higher to run! 
  47.  
  48.  
  49.      1. Introduction 
  50.      --------------- 
  51.  
  52.         Your Workbench  2.0  manual will tell you:  It is possible to run a
  53.      program  by  choosing  a  menu  item  from the Tools menu of Workbench
  54.      2.0.   But  only  if  your application software supports this feature.
  55.      Your  application software will have instructions on how to create the
  56.      new menu item.  
  57.  
  58.  
  59.  
  60.                                      Page 1
  61.  
  62.  
  63.      
  64.  
  65.  
  66.         But what  if  you  want  to  add programs to Workbench's menu strip
  67.      which do not have this feature?  Then there is ToolsDaemon 2.1a.  
  68.  
  69.         ToolsDaemon allows  you  to run programs simply by selecting a menu
  70.      item  from  the  menu  strip  of  Workbench  2.0.  Shell and Workbench
  71.      programs  are  supported,  including arguments and tool types for both
  72.      of  these.   The  menu  items  can  be arranged in several menus, with
  73.      sub-items and keyboard shortcuts.  
  74.  
  75.         ToolsPrefs is  designed as a preferences editor for the ToolsDaemon
  76.      menus.   It  features  a full intuition front-end and supports the 2.0
  77.      AppWindow  feature.   This  means  it allows you to drag programs into
  78.      its  window  and  they  will  be automatically added to the menu items
  79.      list.  
  80.  
  81.         ToolsDaemon is  the  background  program that will launch the tools
  82.      you  select  from  the menu strip.  It is meant to be dragged into the
  83.      WbStartup drawer so it will automatically be launched on startup.  
  84.  
  85.  
  86.      2. Installation 
  87.      --------------- 
  88.  
  89.         Installation is  very  easy.   Double-click  the  'Install' icon to
  90.      install ToolsDaemon.  
  91.  
  92.         You will  need  Commodore's  standard  Installer utility to run the
  93.      install  script.   If  you  have Workbench 2.1, 3.0 or higher you will
  94.      find  Installer  on  your Workbench installation disk.  Simply copy it
  95.      to  your  'SYS:Utilities'  directory  (or  anywhere  in your Workbench
  96.      command path).  
  97.  
  98.         To install  ToolsDaemon  manually simply copy 'ToolsDaemon-Handler'
  99.      to  'L:',  drag 'ToolsDaemon' to 'SYS:WbStartup' and drag 'ToolsPrefs'
  100.      to 'SYS:Prefs'.  
  101.  
  102.  
  103.      3. Usage 
  104.      -------- 
  105.  
  106.         Once everything   is   installed   run  ToolsDaemon  and  then  the
  107.      ToolsPrefs  program.  This will allow you to define the menus and menu
  108.      items  you  would  like  to  add  to  the menu strip of the Workbench.
  109.      ToolsPrefs  has  two  lists:   'Menu  Items' and 'Commands'.  The menu
  110.      items  list  corresponds  to  the  text  that  will appear in the menu
  111.      items.   Each  menu item has its own command list.  So by choosing one
  112.      menu item you can invoke several commands (asynchronously).  
  113.  
  114.         ToolsPrefs features  a  full  intuition front-end to edit the items
  115.      and  commands  lists.   Everything  is fairly self-explanatory, except
  116.      maybe  the  'Move  Up'  and 'Move Down' menu items in the 'Edit' menu.
  117.      These  allow  you  to  change the order of the menu items, by allowing
  118.  
  119.  
  120.                                      Page 2
  121.  
  122.  
  123.      
  124.  
  125.  
  126.      you  to  move  the  current item closer to the top or to the bottom of
  127.      the list.  
  128.  
  129.         Items can  be  set  to  be  a menu title, a sub-item or a seperator
  130.      bar.   Use  the  'Menu' and 'Sub' checkboxes to set an item's type (if
  131.      none  of  these is checked the item is a normal menu item).  The 'Bar'
  132.      button will set the current menu item to be a seperator bar.  
  133.  
  134.         The 'Key'  string  gadget can be used to assign a keyboard shortcut
  135.      to  an  item.  Note that you can only use keys that aren't used by the
  136.      Workbench.   You  are  not  limited to using letters, but you can also
  137.      use  numbers  or  other  symbols  (e.g.   '1',  '-', '/').  If you are
  138.      running  Kickstart  3.0  or  higher  there  will  be  an  extra gadget
  139.      underneath  the  'Key'  gadget.   In this gadget you can enter a short
  140.      description  string for the hotkey (see below), which will be shown in
  141.      the menu.  
  142.  
  143.         The hotkey  gadget  holds  an optional hotkey for the current item.
  144.      A  hotkey  entered  here will work even if the Workbench window is not
  145.      active.   Hotkeys  are described according to the Commodities standard
  146.      (for example: 'control alt t').  
  147.  
  148.         Commands can  be  run  as  Workbench  or  Shell commands.  Commands
  149.      indicated  as Workbench commands will be loaded and run by ToolsDaemon
  150.      just  as  if  you  had  double-clicked  them  in the Workbench.  Shell
  151.      commands  will  be  executed with a command line as if they were typed
  152.      in in a Shell window.  
  153.  
  154.         ToolsPrefs supports  the  use  of  arguments.  If you select one or
  155.      more  icons before selecting an item from the 'Tools' menu these files
  156.      will be passed as arguments.  
  157.  
  158.         If the  command is a Workbench command the arguments will be passed
  159.      as  if  you  selected  the program's icon and Shift-clicked some other
  160.      icons.   For  this  to  work  the  command  has to be followed by '[]'
  161.      indicating  it  expects  to  get  arguments.   For  example:   '(WB  )
  162.      C:PPMore []'.  
  163.  
  164.         If the  command  is  a Shell command the arguments will be expanded
  165.      onto  its  command line.  You should indicate with '[]' where you want
  166.      the arguments to appear.  For example:  '(CLI) Type [] HEX'.  
  167.  
  168.         The number  gadget next to the command string gadget determines the
  169.      stack  size  for  the  command  (in  case of a Shell command).  If the
  170.      command  is  launched  as a Workbench tool the stack size will be read
  171.      from the tool's icon.  
  172.  
  173.         The easiest  way  to  add an item is to pick up an icon and drop it
  174.      in  the  ToolsPrefs  window.   This will create a new item named after
  175.      the  program with a command list to run the program.  Dropping an icon
  176.      in  the  'Commands'  listview will not result in the creation of a new
  177.      item, but in adding a new command to the current command list.  
  178.  
  179.  
  180.                                      Page 3
  181.  
  182.  
  183.      
  184.  
  185.  
  186.  
  187.         When you  select  'Save'  ToolsPrefs  will  check if ToolsDaemon is
  188.      running  and  will  tell  it  to  update  the  menus  if it is.  It is
  189.      therefore  advisable  to  call ToolsPrefs if ToolsDaemon is already up
  190.      and  running.   If  you  have  dragged  ToolsDaemon  to your WbStartup
  191.      drawer  as  suggested  above it will always be running and you'll have
  192.      nothing to worry about.  
  193.  
  194.         Double-clicking the  icon  of  a  menu file saved with 'Save As...'
  195.      will  result  in  adding  the  menus to the Workbench's menu strip (if
  196.      ToolsDaemon  is  already  running the previously added menu items will
  197.      be removed first).  
  198.  
  199.      NOTE: - ToolsDaemon will search the path for Shell commands and
  200.