home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 102 / af102a.adf / MoreTools / MoreTools.doc < prev    next >
Text File  |  1997-07-20  |  4KB  |  139 lines
  1.  
  2.   Short:       adds items to the 'tools' menu - V 1.5
  3.   Uploader:    md2133@mclink.it
  4.   Author:      md2133@mclink.it (Luca Di Massimo)
  5.   Type:        util/wb
  6.   Requires:    Wb 3.x
  7.   Version:     1.5 (20/7/1997)
  8.  
  9.  
  10.     What it does:
  11.     -------------
  12.  
  13.     MoreTools is a simple utility able to add items  to the Workbench
  14.   "Tools" menu to run programs or execute commands; you can also pass
  15.   them a parameter by selecting some icons before.
  16.  
  17.  
  18.     Disclaimer:
  19.     -----------
  20.  
  21.     This program is provided "as is", without any kind of warranty. I
  22.   have taken every care  in developing it,  but I am not  renponsible
  23.   of any damage it can cause. Use it a your own risk.
  24.  
  25.  
  26.     Copyright:
  27.     ----------
  28.  
  29.     MT is freeware/e-mailware:it can be copied and distributed freely
  30.   on the condition that no profit is gained from its distribuition.
  31.   If you find it useful please send me an e-mail or a postcard;
  32.     my snail-mail address is:
  33.   Luca Di Massimo - Via A.Silvani 69 - 00139 Rome (Italy)
  34.  
  35.  
  36.     Usage:
  37.     ------
  38.  
  39.     MT can be started:
  40.   - from Wb,  double-clicking  on its icon or putting it  in the "Wb-
  41.     startup" drawer;
  42.   - from CLI,  using the command  "run >NIL: MoreTools".  You can put
  43.     this command in your startup-sequence too (_after_ "LoadWb").
  44.  
  45.     The configuration  file  is "s:MTData"  by default;  you can  use
  46.   another file specifying it in tooltypes or passing it as parameter.
  47.  
  48.  
  49.     Configuration file:
  50.     -------------------
  51.  
  52.     You can write it with whatever text-editor; for every item to add
  53.   you have to write two lines:
  54.  
  55.   - the first  must start  with the word "ITEM", followed by the name
  56.     of the item;
  57.   - the second must start  with the word  "COMMAND",  followed by the
  58.     program to run with full path:
  59.     ITEM      Calculator
  60.     COMMAND   Workbench:tools/calculator
  61.  
  62.     To pass selected icon like a parameter you have to insert "%s" in
  63.   the COMMAND line:
  64.     ITEM     Show
  65.     COMMAND  Workbench:utilities/Multiview %s
  66.     So,  selecting  an icon  and then  the item "Show",  MultiView is
  67.   started and the object linked to the icon is loaded.
  68.  
  69.     To pass a filename or a directory as parameter using a filerequester
  70.   use "%f" instead of %s:
  71.     ITEM     Ed text
  72.     COMMAND  Ed %f
  73.  
  74.     It is possible  to use only one "%s" per line;  there is no limit 
  75.   for "%f".
  76.  
  77.     There are two other commands you can use:
  78.   "MTQUIT":   adds "quit MoreTools" like last item; you can select it
  79.               to quit the program;
  80.   "MTCHANGE": adds "MoreTools" like last item; it permits to quit the
  81.               program or to reconfigure  the menu selecting  the data
  82.               file (it needs asl.library to work).
  83.  
  84.     If both of them are present, "MTQUIT" is ignored; if none is pre-
  85.   sent you can quit only using the DOS command "break".
  86.  
  87.     In this archive you should find  an example of configuration file
  88.   named "MTData.example".
  89.  
  90.  
  91.     Parameters and tooltypes:
  92.     -------------------------
  93.  
  94.     The template is "FILE/K,REQUESTER/S,MTCHANGE/s,MTQUIT/S"
  95.     FILE <filename>: MT uses the specified file to build menu.
  96.     REQUESTER:       MT asks for a filename when started.
  97.     MTCHANGE:        MT puts always "MoreTools" as last item.
  98.     MTQUIT:          MT puts always "quit MoreTools" as last item.
  99.  
  100.  
  101.     Known problems:
  102.     ---------------
  103.  
  104.     Malfunctions have been reported with Brilliance, AdPro and Bomb!.
  105.   I hope to fix it in a future release.
  106.  
  107.  
  108.     Greetings:
  109.     ----------
  110.  
  111.      Thanks to Lamar Mclouth, Pierre Sylvestre and Hans Peter Koegler
  112.    for suggestions and bug reporting.
  113.  
  114.  
  115.     Changes from older versions:
  116.     ----------------------------
  117.  
  118.    1.5  Fixed a strange bug  (it not appears on my A1200;  I've found
  119.         it trying MT on a A4000): if an item is chosen but no icon is
  120.         selected, a wrong string is passed as parameter;
  121.         now you can use %f to use to choose a file or a directory
  122.         using the asl filerequester.
  123.  
  124.    1.4  It's possible to specify the configuration file  using a file
  125.         requester or passing it using ToolTypes;
  126.         fixed a bug (if the given configuration file was without data
  127.         MT didn't clean the menu).
  128.  
  129.    1.3  It is possible to reconfigure the menu using the asl.requester
  130.         to choose a data file.
  131.  
  132.    1.2  Item "quit MoreTools" is now optional;
  133.         it is possible to quit also using the "break" DOS command.
  134.  
  135.    1.1  Added the possibility  to pass  the configuration-file name as
  136.         parameter.
  137.  
  138.  
  139.