home *** CD-ROM | disk | FTP | other *** search
/ Amiga Games 1996 January / amigagames-cdrom-1996-01.iso / userbox / publicdomain / toolmanager / docs / tm_english.doc < prev    next >
Text File  |  1994-10-18  |  59KB  |  1,625 lines
  1.  
  2. ToolManager 2.1 Documentation
  3. ******************************
  4.  
  5.  
  6. Copyright and other legal stuff
  7. ********************************
  8.  
  9.    Copyright (C) 1990-93 Stefan Becker
  10.  
  11.    Permission is granted to make and distribute verbatim copies of this
  12. manual provided the copyright notice and this permission notice are
  13. preserved on all copies.
  14.  
  15.    No guarantee of any kind is given that the programs described in
  16. this document are 100% reliable. You are using this material at your
  17. own risk. The author *can not* be made responsible for any damage which
  18. is caused by using these programs.
  19.  
  20.    This package is freely distributable, but still copyright by Stefan
  21. Becker. This means that you can copy it freely as long as you don't ask
  22. for a more than nominal copying fee. This fee *must not* be more than
  23. US $5 or 5 DM.
  24.  
  25.    *This limit applies to German Public-Domain dealers too!!*
  26.  
  27.    Permission is granted to include this package in Public-Domain
  28. collections, especially in Fred Fishs Amiga Disk Library (including CD
  29. ROM versions of it). The distribution file may be uploaded to Bulletin
  30. Board Systems or FTP servers. If you want to distribute this program
  31. you *must* use the original distribution archives
  32. `ToolManager2_1bin.lha', `ToolManager2_1gfx.lha' and
  33. `ToolManager2_1src.lha'.
  34.  
  35.    None of the programs nor the source code (nor parts of it) may be
  36. included or used in commercial programs unless by written permission
  37. from the author.
  38.  
  39.    *None* of the programs *nor* the source code (nor parts of it) may
  40. be used on any machine which is used for the research, development,
  41. construction, testing or production of weapons or other military
  42. applications. This also includes any machine which is used for training
  43. persons for *any* of the above mentioned purposes.
  44.  
  45.  
  46. Important notes
  47. ****************
  48.  
  49.    Welcome to the wonderful world of ToolManager 2.1 :-)
  50.  
  51.    - ToolManager and its concepts have drastically changed (see History)
  52.      since the release 1.5.
  53.  
  54.    - Starting with the ToolManager 2.0 release, this program has a
  55.      *GiftWare* option. If you like the program and use it very often,
  56.      you should consider to send a little donation to honor the work
  57.      that the author has put into this program. I suggest a donation of
  58.      US $10-$20 or 10-20 DM. Please don't send cheques or money orders
  59.      from outside Europe, because most often cashing those items costs
  60.      more than what they amount to.
  61.  
  62.      If you don't send the donation or can't afford it, you needn't
  63.      feel bad about it. Please send me a note saying that you are using
  64.      ToolManager anyway (I like to get fan mail :-). See Authors
  65.      address.
  66.  
  67.    - Users of ToolManager 1.X/2.0 can start with the quick installation
  68.      chapter (see Quick installation). Some features haven't changed
  69.      and the rest is fairly easy to find out by trial & error. For a
  70.      detailed description of the new concept & features browse the
  71.      reference part of this document (see Objects).
  72.  
  73.      You *must* remove any running ToolManager 1.X/2.0 or the new
  74.      version won't work. The new version cannot read the old 1.X
  75.      configuration file format (Sorry).
  76.  
  77.    - First-time users should read the entire document to understand the
  78.      concept and purpose of the program. Start with Introduction.
  79.  
  80.    - ToolManager 2.1 uses some features of AmigaOS Release V38 (and
  81.      higher) and it supports the new AmigaOS networking features, which
  82.      will (hopefully) be available soon to all Amiga users. If you are
  83.      still using Release 2.0 (referred to as V37 in this document), you
  84.      need not worry since ToolManager doesn't rely on these features.
  85.      All extended features are marked in this documentation.
  86.  
  87.  
  88. Where to send bug reports, comments & donations
  89. ************************************************
  90.  
  91.    The author can be reached at the following addresses:
  92.  
  93. Postal address:
  94.  
  95.                Stefan Becker
  96.                Holsteinstrasse 9
  97.           5100 Aachen
  98.                GERMANY
  99.  
  100.      Please use the following address after the 1-July-93:
  101.  
  102.  
  103.                 Stefan Becker
  104.                 Holsteinstrasse 9
  105.           52068 Aachen
  106.                 GERMANY
  107.  
  108. InterNet Electronic Mail:
  109.  
  110.           stefanb@pool.informatik.rwth-aachen.de
  111.  
  112.  
  113. How to install ToolManager 2.1 the fast way
  114. ********************************************
  115.  
  116.    The basic ToolManager 2.1 installation consists of the following
  117. four parts:
  118.  
  119. `Libs/toolmanager.library' => `LIBS:'
  120.      This is the main program of ToolManager. It handles all programs,
  121.      menus, icons and docks (see Library).
  122.  
  123. `Prefs/ToolManager*' => `SYS:Prefs'
  124.      This is the editor for the configuration (see Preferences).
  125.  
  126. `WBStartup/ToolManager*' => `SYS:WBStartup'
  127.      With this utility you can start and stop ToolManager. If it
  128.      resides in the WBStartup drawer, ToolManager gets always loaded
  129.      when your machine boots up.
  130.  
  131. `L/WBStart-Handler' => `L:'
  132.      This program starts programs by the Workbench startup method. It
  133.      is a seperate process, so that you can quit ToolManager even if
  134.      you have still programs running that were started by it with the
  135.      WB method.
  136.  
  137.    After copying these files, you should quit any older version of
  138. ToolManager running on your machine and double-click the ToolManager
  139. icon in the `WBStartup' drawer. Now you can start the preferences
  140. editor and play around (Use the "Test" button instead of the "Use"
  141. button while testing). You should be able to figure out most features
  142. with trial & error, for further information look into the ToolManager
  143. object descriptions (see Objects).
  144.  
  145.    The distribution includes an example configuration file called
  146. `TM_Demo.prefs'. You can load it into the preferences editor with the
  147. `Open' menu item.
  148.  
  149.  
  150. What is ToolManager?
  151. *********************
  152.  
  153.    ToolManager is a flexible program to manage the tools in your working
  154. environment. It can start Workbench and CLI programs, ARexx scripts and
  155. generate HotKey events. It even can issue commands to a ToolManager
  156. running on a remote machine. The user interface consists of menus,
  157. icons or dock windows. If you like a noisy computer, you can associate
  158. a sound to each of these items. See Sound.
  159.  
  160.    ToolManager can add items to the Workbench `Tools' menu. If you
  161. select such a menu item, the program associated with it will be
  162. started. Every selected icon on the Workbench will be used as an
  163. argument for the program. This feature is only available when the
  164. Workbench is running. See Menu.
  165.  
  166.    ToolManager can add icons to the Workbench window. When you
  167. double-click such an icon, the program associated with it will be
  168. started. If you drop some icons on this icon, the program will be
  169. started with these icons as arguments. This feature is only available
  170. when the Workbench is running. See Icon.
  171.  
  172.    ToolManager can create a dock window from a collection of programs.
  173. This window can be opened on every public screen. Each program is
  174. represented by an image or a button gadget. To start a program you
  175. simply click on the image or the button gadget. If the dock window has
  176. been opened on the Workbench screen and the Workbench is running, you
  177. can also drop some icons on the image or the button gadget to start the
  178. program with arguments. See Dock.
  179.  
  180.    Additionally you can assign a Hot Key to each program. If you press
  181. this Hot Key, the program will be started. Note that *no* arguments can
  182. be passed to the program if you use this startup method. See Exec.
  183.  
  184.  
  185. The concepts behind ToolManager
  186. ********************************
  187.  
  188.    ToolManager 2.1 uses a new object-oriented approach to provide a
  189. flexible and extendable system. This approach made it possible to
  190. enhance several ToolManager features of the 1.X versions, e.g. you can
  191. now have multiple docks.
  192.  
  193.    An object is a collection of data which describes its features. Each
  194. object has a name and a type. You can create as many objects of each
  195. type as you want, but the name of each object has to be unique, because
  196. it is used as a reference to this object.
  197.  
  198.    Currently there are seven different types of objects: Exec, Image,
  199. Sound, Menu, Icon, Dock and Access. The first three of them are basic
  200. objects; that means they don't reference other objects. They provide
  201. data or services for the complex objects.
  202.  
  203.    The last four object types are complex objects; that means they
  204. reference simple objects and rely on them to get access to data or
  205. services. The reference is done by name, and if no simple object with
  206. this name exists, the complex object will ignore it. Note that this may
  207. reduce the functionality of the complex object, e.g. an Icon object
  208. *needs* the data from an Image object, so if this object doesn't exist
  209. it won't create an icon.
  210.  
  211.    For a detailed description of all object parameters see Objects.
  212.  
  213.  
  214. A guided tour through ToolManager
  215. **********************************
  216.  
  217.    So you haven't understood a word until now? Confused by objects,
  218. programs and links? Don't despair, help is on the way.
  219.  
  220.    I will now guide you through a step-by-step example on how to
  221. configure ToolManager. All you need is to install ToolManager and to
  222. run the preferences editor. After each step, use the "Test" button in
  223. the main window to test the configuration.
  224.  
  225.    As an example we use the text display program More in the drawer
  226. `SYS:Utilities'. First we must tell ToolManager which program we want to
  227. use. Information about programs is stored in Exec objects. Just select
  228. "Exec" as object type in the main window of the preferences editor and
  229. press the "New" button.
  230.  
  231.    After pressing the button you will see the "Edit Exec Object"
  232. window. Now open the Utilities drawer in your Workbench partition, move
  233. the More icon out of the drawer and drop it on the edit window. As you
  234. can see, the editor has now set the name of the object and the command
  235. to the program name, and the current directory to System:Utilities.
  236. Press the "OK" button to use the settings.
  237.  
  238.    You can't do much with the Exec object alone, so as next step we
  239. want to add this program to the "Tools" menu of the Workbench. Select
  240. "Menu" as object type and press the "New" button. Now you will see the
  241. "Edit Menu Object" window. Change the name of the object to "Display
  242. Text".
  243.  
  244.    ToolManager has to know which program it should start when the menu
  245. item is selected, so we link an Exec object to the menu object. Press
  246. the "Exec Object" button and select the object "More" from the
  247. requester. Now press "OK" button and the "Test" button in the main
  248. window. You can now see an entry in the "Tools" menu. Select a text
  249. file from the Workbench and choose the new menu entry. The program
  250. "More" should start and display the text. This is easy, isn't it?
  251.  
  252.    Now we can go a step further and create an icon object on the
  253. Workbench. For an icon we need some image data, which is stored in an
  254. image object. Select "Image" as object type and press the "New" button.
  255. The "Edit Image Object" window will open. Change the name to "Image for
  256. More" and drop the More icon from the Utilities drawer on the window.
  257. Press "OK" to use the settings.
  258.  
  259.    In the next step we will create the icon object. Select "Icon" as
  260. object type and press the "New" button. Change the name of the object
  261. to "Show Text". Press the "Exec object" button and select the object
  262. "More" from the requester. Press the "Image object" button and select
  263. the object "Image for More" from the requester. Set the X position to
  264. 100 and the Y position to 50. Press the "OK" button and the "Test"
  265. button. After a short delay an icon will appear on the Workbench, on
  266. which you can drop the icons of your text files to display them.
  267.  
  268.    I'm sure you now have an idea how to use ToolManager objects and in
  269. which way you have to link them together to build your environment. Now
  270. you can figure out the rest of the features by trying them out one by
  271. one. You may also look at the demo configuration in the file
  272. `TM_Demo.prefs'.
  273.  
  274.  
  275. Description of all files in the distribution
  276. *********************************************
  277.  
  278.    The complete ToolManager 2.1 distribution consists of several
  279. directories which are explained below. Note that the distribution is
  280. split up into three parts, so you may not have all directories which
  281. are mentioned below.
  282.  
  283.  
  284. The Docs directory
  285. ===================
  286.  
  287.    This directory contains the documentation for ToolManager. The
  288. documentation is available in four different formats and several
  289. languages. Additionally there is a file in AutoDoc format describing
  290. the ToolManager shared library interface.
  291.  
  292. Prefix `TM_<language>'
  293.      This file contains the documentation for the specified language.
  294.      Currently available languages are: Deutsch, English, Français,
  295.      Svenska.
  296.  
  297. Postfix `.doc'
  298.      This file contains the documentation as plain ASCII text.
  299.  
  300. Postfix `.dvi'
  301.      This file contains the documentation in TeXs DVI format. To get a
  302.      printed manual, run this file through a TeX printer driver.
  303.  
  304. Postfix `.guide'
  305.      This file contains the documentation in AmigaGuide format.
  306.      Although it is only plain ASCII with some commands, you need
  307.      AmigaGuide to exploit the hypertext links in it.
  308.  
  309. Postfix `.tex'
  310.      This file contains the documentation in Texinfo format, as
  311.      specified by the Free Software Foundation (FSF). Together with the
  312.      `texinfo.tex' macro package, you can use TeX and `texindex' to
  313.      create a file in DVI format (see above).
  314.  
  315. `toolmanager.doc'
  316.      This file contains the ToolManager shared library interface
  317.      description in AutoDoc format.
  318.  
  319.  
  320. The Goodies directory
  321. ======================
  322.  
  323.    This directory contains additional program packages which are useful
  324. for ToolManagers operation.
  325.  
  326. `GetPubName.lha'
  327.      This little program prints the name of the frontmost public screen
  328.      either to stdout or into an environment variable. It was written
  329.      by Michael "Mick" Hohmann.
  330.  
  331. `upd1_20.lha'
  332.      The program `upd' was written by Jonas Petersson. It is a small
  333.      program which opens an ARexx port and waits for commands. Via
  334.      ARexx you can order `upd' to play sampled files. ToolManager uses
  335.      this feature to implement its Sound objects. See Sound.
  336.  
  337.  
  338. The Graphics directory
  339. =======================
  340.  
  341.    This directory contains a rich collection of images from which you
  342. can choose your favourite ones. Just load them as Image objects into
  343. ToolManager (see Image).
  344.  
  345.    The files were contributed by various people (see Credits). Each of
  346. them got a seperate sub-directory in the distribution. As the files were
  347. created by different authors, they come from different environments
  348. (palette, depth, resolution, size) and have different design styles. So
  349. not all images may look good on your machine.
  350.  
  351.    To differentiate the image formats that are supported by
  352. ToolManager, each file has a postfix which describes the file format:
  353.  
  354. `.anmb'
  355.      This is an IFF ANIM file created by a paint/animation program. It
  356.      can contain several pictures. Although ToolManager can load
  357.      complete ANIM files, you must use something like DPaints
  358.      "AnimBrush" feature to cut out the interesting part of the
  359.      animation.
  360.  
  361. `.brush'
  362.      This is an IFF ILBM file created by a paint program. It contains
  363.      only one image.
  364.  
  365. `.info'
  366.      This is a normal Amiga Icon created with IconEdit (or something
  367.      similiar). It can contain two images.
  368.  
  369.  
  370. The L directory
  371. ================
  372.  
  373.    This directory contains only one file, namely `WBStart-Handler'. You
  374. *must* copy this file to the `L:' directory, or otherwise ToolManager
  375. won't be able to start any Exec objects by the WB startup method (see
  376. Exec).
  377.  
  378.    The complete package WBStart 1.2 may be found on Fish Disk #757.
  379.  
  380.  
  381. The Libs directory
  382. ===================
  383.  
  384.    This directory contains only one file, `toolmanager.library'. This
  385. is the main program for ToolManager and must be copied to the `LIBS:'
  386. directory.
  387.  
  388.  
  389. The Locale directory
  390. =====================
  391.  
  392.    This directory contains all files for ToolManagers Locale support. As
  393. locale.library is new with V38, you need not copy these files if you are
  394. using V37. If you are using V38, choose the files for your language and
  395. copy them to the appropriate places.
  396.  
  397. `Catalogs/<language>/toolmanager.catalog'
  398.      This is a translation file for the specified language. Copy the
  399.      file for your language to the directory
  400.      `LOCALE:Catalogs/<language>'.
  401.  
  402. `Languages/<language>.language'
  403.      Some languages are not supported by the standard V38 Locale
  404.      distribution. So some of the translators have supplied a
  405.      `.language' file, so that ToolManager can use their translation
  406.      files. Copy the file for your language to the directory
  407.      `LOCALE:Languages'. Additional available languages are: Finnish
  408.      (suomi), Eefeler Platt (eifel).
  409.  
  410.  
  411. The Prefs directory
  412. ====================
  413.  
  414.    The ToolManager preferences editor and its icon reside in this
  415. directory. Copy both files to the directory `SYS:Prefs'. For further
  416. information on the editor see Preferences.
  417.  
  418.  
  419. The Programmers directory
  420. ==========================
  421.  
  422.    This directory contains all files which are needed by the various
  423. computer languages and their compilers to use the ToolManager shared
  424. library interface. Look into the sub-directory `examples' for some
  425. examples on how to use this interface. For a complete interface
  426. description read the file `Docs/toolmanager.doc'.
  427.  
  428.    Currently supported languages/compilers are: AmigaOberon, DICE C,
  429. M2Amiga Modula-2, MANX Aztec C and SAS C.
  430.  
  431.  
  432. The Scripts directory
  433. ======================
  434.  
  435.    This directory contains a collection of ARexx or Shell scripts which
  436. can be used in ToolManagers Exec objects. Note that they may be
  437. specific to the authors environment or shell, so you may have to modify
  438. them.
  439.  
  440.  
  441. The Source directory
  442. =====================
  443.  
  444.    This directory contains the complete source code to ToolManager 2.1
  445. and its utilities. Each program has its own sub-directory. The author
  446. provides the source code as an example for OS 2.x/3.0 programming.
  447.  
  448.    The `locale' sub-directory is of interest for translators. If your
  449. language is not supported in this release and you want to do the
  450. translation, look at the file `empty.ct'. Just fill in the empty lines
  451. and send the file to me. Maybe it will be included in the next release.
  452.  
  453.  
  454. The WBStartup directory
  455. ========================
  456.  
  457.    Only one program resides in this directory: `ToolManager'. This
  458. utility starts and stops ToolManager 2.1. Most of the time this utility
  459. will reside in the `SYS:WBStartup' directory, but it can be used from
  460. the Shell too.
  461.  
  462.  
  463. ToolManager objects reference
  464. ******************************
  465.  
  466.    This chapter describes the ToolManager objects in detail. Each
  467. object has a type and a name. The name is used to reference the object.
  468. There are six different types of objects:
  469.  
  470.  
  471. Exec objects
  472. =============
  473.  
  474.    Exec objects describe programs or actions which are started by
  475. ToolManager. Three different types of programs are supported: CLI,
  476. Workbench and ARexx. Three different types of actions are supported:
  477. Dock, Hot Key, Network. Each Exec object has the following parameters.
  478. The defaults are set in parantheses:
  479.  
  480. `Arguments' (Yes)
  481.      This switch controls the handing over of arguments to the program.
  482.      If a program doesn't support arguments or doesn't need them, you
  483.      can switch off the argument passing.
  484.  
  485. `Command'
  486.      The file name of the program or action to start. This name may be
  487.      relative to the current directory. If the type is Dock, the
  488.      command describes the name of the dock object, which should be
  489.      opened/closed. For the type Hot Key this string must be a
  490.      Commodities Input Description String (see Hot Keys). A remote
  491.      command (type Network) is described as `object@machine', which
  492.      tells the ToolManager running on `machine' to activate the Exec
  493.      object named `object'.
  494.  
  495. `Current Directory' (`SYS:')
  496.      The name of the current directory for the program. Note: ARexx
  497.      programs ignore this parameter.
  498.  
  499. `Delay' (0)
  500.      After activation of an Exec object, ToolManager waits `Delay'
  501.      seconds before it starts the program. If this value is negative,
  502.      the program will be started every `Delay' seconds. To stop an Exec
  503.      object which is waiting for execution, just activate it again.
  504.      Note: If `Delay' is set, the program will be started without
  505.      arguments.
  506.  
  507. `Exec Type' (CLI)
  508.      This specifies the type of the program or action. It can be one
  509.      of: CLI, WB, ARexx, Dock, Hot Key or Network.
  510.  
  511. `Hot Key'
  512.      You can set a Hot Key for each Exec object. If this Hot Key event
  513.      is generated, the program will be started. Note: The program will
  514.      be started with no arguments.
  515.  
  516. `Output File' (`NIL:')
  517.      This is the file name of the output file. This is only useful for
  518.      CLI programs.
  519.  
  520. `Path' (path from ToolManager process)
  521.      This string sets the command search path for the program. You can
  522.      specify several directories by seperating the names with a ";".
  523.      This is only useful for CLI programs.
  524.  
  525. `Priority' (0)
  526.      This sets the priority of the new process which runs the program.
  527.  
  528. `Public Screen' (default public screen)
  529.      You can set the name of the public screen which should be moved to
  530.      front before the program is started. This only works in
  531.      conjunction with the `To Front' parameter.
  532.  
  533. `Stack' (4096)
  534.      This sets the stack size of the new process which runs the program.
  535.  
  536. `To Front' (No)
  537.      If you set this parameter the public screen specified by `Public
  538.      Screen' is moved to front before the program is started.
  539.  
  540.  
  541. Image objects
  542. ==============
  543.  
  544.    Image objects specify the image data which is used by ToolManager
  545. for icons or docks. This object type has only one parameter:
  546.  
  547. `File Name'
  548.      This specifies the name of the file from which ToolManager should
  549.      read the image data. ToolManager tries to detect the type of image
  550.      data automatically:
  551.  
  552.        1. It tries to load it as IFF data. Currently ToolManager can
  553.           read ILBM (one image) or ANIM (two or more images) files.
  554.  
  555.        2. It tries to read in an icon file. An icon can have one or two
  556.           images.
  557.  
  558.    Animations are currently only supported by Dock objects. Icon
  559. objects only retrieve the first and the second image from the animation
  560. to build a two image icon. If you want to make an animation for
  561. ToolManager, you should follow these design rules:
  562.  
  563. Image 1
  564.      This should be an image which represents the inactive state.
  565.  
  566. Image 2
  567.      This should be an image which represents the selected state.
  568.      Normally this is an inverted copy of the first image.
  569.  
  570. Image 3 to N-1
  571.      These are the images for the animation. Each image will be shown
  572.      for 1/3 of a second.
  573.  
  574. Image N
  575.      The last picture of the animation will be shown one second. After
  576.      this the first picture will be shown again.
  577.  
  578.  
  579. Sound objects
  580. ==============
  581.  
  582.    A Sound object can be used to make ToolManager noisy. ToolManager
  583. itself has no ability builtin to play sound data, it uses ARexx to
  584. activate an external sound player daemon. This object type has two
  585. parameters:
  586.  
  587. `Command'
  588.      This sets the ARexx command which ToolManager sends to activate
  589.      the external sound player. For `upd' this could be something like
  590.      `file samples:boing' which instructs `upd' to play the IFF sample
  591.      `samples:boing'. See Goodies.
  592.  
  593. `ARexx Port'
  594.      This specifies the ARexx port where ToolManager should send
  595.      `command' to. The default is `PLAY' which is the port for the
  596.      program `upd'.
  597.  
  598.  
  599. Menu objects
  600. =============
  601.  
  602.    Menu objects control the entries in the Workbench Tools menu. The
  603. object name is used as the menu text. To activate such an object, just
  604. select the menu entry. Menu objects only work when the Workbench is
  605. running.
  606.  
  607.    This object type has two parameters:
  608.  
  609. `Exec Object'
  610.      This is the name of an Exec object which should be activated when
  611.      the menu entry is selected. Every icon which is selected at this
  612.      time will be used as an argument for the program.
  613.  
  614. `Sound Object'
  615.      This is the name of a Sound object which should be activated when
  616.      the menu entry is selected.
  617.  
  618.    Note to ToolManager 1.X users: To simulate the old tool type "Dummy"
  619. just create a Menu object and specify *no* Exec and Sound object.
  620.  
  621.  
  622. Icon objects
  623. =============
  624.  
  625.    Icon objects describe application icons in the Workbench window.
  626. Such an object can be activated by double-clicking the icon or by
  627. dropping some icons on the application icon. Icon objects only work
  628. when the Workbench is running.
  629.  
  630.    The parameters for this object type are as follows:
  631.  
  632. `Exec Object'
  633.      This is the name of an Exec object which should be activated when
  634.      the icon is selected. Every icon which is dropped on the
  635.      application icon will be used as an argument for the program.
  636.  
  637. `Image Object'
  638.      This is the name of an Image object. The image data of this object
  639.      is used to build the application icon.
  640.  
  641. `Left Edge' (default: 0)
  642.      This sets the left edge for the application icon.
  643.  
  644. `Show Name' (default: Yes)
  645.      If this parameter is set, the object name will be used as the name
  646.      for the application icon.
  647.  
  648. `Sound Object'
  649.      This is the name of a Sound object which should be activated when
  650.      the icon is selected.
  651.  
  652. `Top Edge' (default: 0)
  653.      This sets the top edge for the application icon.
  654.  
  655.    Note: The Workbench is *very* picky about the position of icons. If
  656. you specify coordinates which the Workbench doesn't like, it will
  657. ignore them and place the icon somewhere else.
  658.  
  659.  
  660. Dock objects
  661. =============
  662.  
  663.    Dock objects describe windows. These windows combine several tools
  664. which are represented by images or gadgets. To start such a tool just
  665. click on its image or gadget. Of course you can drop some icons on the
  666. image or gadget to supply arguments for the tool.
  667.  
  668.    Each dock object has several parameters. The defaults are set in
  669. parentheses:
  670.  
  671. `Activated' (Yes)
  672.      A dock window can be active (open) or not (closed).
  673.  
  674. `Backdrop' (No)
  675.      This tells the dock window to go immediately to the back after
  676.      opening.
  677.  
  678. `Centered' (No)
  679.      If this parameter is set, the window will always be centered to
  680.      the current mouse position when it opens.
  681.  
  682. `Columns' (1)
  683.      This parameter sets the the number of tool columns. Tools are
  684.      always sorted row-wise, starting at the leftmost column and
  685.      filling up to the rightmost column.
  686.  
  687. `Font' (Screen font)
  688.      If you have a dock window with the parameter `Text' set, you can
  689.      choose the font for the button gadgets with this parameter.
  690.  
  691. `Frontmost' (No)
  692.      If you set this parameter, the dock window will always open on the
  693.      frontmost public screen.
  694.  
  695. `Hot Key'
  696.      You can set a Hot Key for each Dock object. If this Hot Key event
  697.      is generated, the activation status of the dock window will be
  698.      toggled; that is it will be closed or opened.
  699.  
  700. `Left Edge' (0)
  701.      This parameter sets the left edge of the dock window. If the
  702.      parameter `Centered' is set, this parameter will be ignored.
  703.  
  704. `Menu' (No)
  705.      You can add a small menu to each dock window. This menu has two
  706.      items:
  707.  
  708.         * `Close Dock' Close dock window.
  709.  
  710.         * `Quit TM' Quit ToolManager
  711.  
  712. `Pattern' (No)
  713.      The dock window automatically adjusts its size to the largest
  714.      image. Each dock entry has the same size, and smaller images are
  715.      centered, so they have a blank border around them. If you don't
  716.      like this blank border, set this parameter and the border will be
  717.      filled with a pattern.
  718.  
  719. `PopUp' (No)
  720.      When this parameter is set the dock window will be closed
  721.      automatically after selecting one dock entry. This is especially
  722.      useful in conjunction with the parameters `Centered', `Frontmost'
  723.      and a Hot Key of the class `rawmouse' (see Hot Keys).
  724.  
  725. `Public Screen' (Default public screen)
  726.      Specifies the public screen on which the dock window should open.
  727.      If the dock window was opened via Hot Key, the public screen will
  728.      be moved to front after the window has been opened. This parameter
  729.      will be ignored if the parameter `Frontmost' is set.
  730.  
  731. `Sticky' (No)
  732.      Normally a dock window stores its last position when you close it
  733.      and pops up at the same position when you re-open it. If you want
  734.      the dock window to open always at the same position, you must set
  735.      this parameter.
  736.  
  737. `Text' (No)
  738.      You can choose between images and button gadgets in dock windows
  739.      with this parameter. Button dock windows are especially useful
  740.      when used in conjunction with the parameter `PopUp'.
  741.  
  742. `Title'
  743.      This specifies the dock window title. If you supply a title, the
  744.      dock window will be a normal OS 2.0 window with dragbar, close
  745.      gadget, depth gadget and a border. If you *don't* supply a title,
  746.      you will get a dock window with only a dragbar and *no* border.
  747.  
  748. `Top Edge' (0)
  749.      This parameter sets the top edge of the dock window. If the
  750.      parameter `Centered' is set, this parameter will be ignored.
  751.  
  752. `Vertical' (No)
  753.      If the dock window has the new window design (that is: only a
  754.      dragbar and no border), this parameter sets the orientation of the
  755.      dragbar. This parameter is ignored if you supplied a window title
  756.      with the parameter `Title'.
  757.  
  758.  
  759. Access objects
  760. ===============
  761.  
  762.    Access objects control the access rights for network requests. Per
  763. default *every* request is denied, so a remote ToolManager can't harm
  764. the operation of your machine by activating some of your Exec objects.
  765. With Access objects you can allow specific machines to activate some of
  766. your Exec objects.
  767.  
  768.    The name of an Access object has a special meaning. It is matched
  769. with the name of the remote machine from which a network request was
  770. sent. ToolManager uses the following three step matching scheme:
  771.  
  772.   1. Match with the complete host name
  773.  
  774.   2. Match with the realm name
  775.  
  776.   3. Look for the Access object named `anyone'
  777.  
  778.    If a corresponding object is found, then this object is used for the
  779. access rights of the remote machine. The object named `anyone' is used
  780. for any network request, for which a corresponding Access object can't
  781. be found.
  782.  
  783.    The Access object type has only one parameter:
  784.  
  785. `Exec Object'
  786.      This parameter can be used several times and specifies which Exec
  787.      objects can be activated from the remote machine. If you don't
  788.      specify *any* object name, then the remote machine can activate
  789.      *all* Exec objects on your machine.
  790.  
  791.  
  792. The ToolManager preferences editor
  793. ***********************************
  794.  
  795.    With the preferences editor you can manage the global configuration
  796. of ToolManager. This configuration gets automatically loaded when you
  797. start ToolManager. To start the editor just double click its icon. You
  798. will then see the main window.
  799.  
  800.    Most of the gadgets in the editor windows have keyboard shortcuts.
  801. They are marked with an underscore (`_'). Note that if a string gadget
  802. is active, you must first press the return key before you can use the
  803. keyboard shortcuts.
  804.  
  805.  
  806. Main window gadgets
  807. ====================
  808.  
  809.    The main window has several groups of gadgets:
  810.  
  811. Object type
  812.      With this cycle gadget you can choose the type of objects that you
  813.      want to create or edit.
  814.  
  815. Object list
  816.      This gadget shows the list of all objects of the current type. You
  817.      can select an object by clicking on its name. If you double-click
  818.      one item, an edit window will open.
  819.  
  820. Move object
  821.      When an object is selected, you can move it around in the list
  822.      with these gadgets. If you click on the `Sort' gadget, the items
  823.      in the list will be sorted alphabetically.
  824.  
  825. Manipulate object
  826.      These gadgets manipulate objects. The `New' gadget creates a new
  827.      object of the current type which is selected automatically. When
  828.      you click on the `Edit' gadget, an edit window for the selected
  829.      object will open. With the `Copy' gadget you can make a copy of
  830.      the selected object. The `Remove' gadget deletes the selected
  831.      object.
  832.  
  833. Configuration
  834.      You have several choices to save the configuration. With the `Save'
  835.      gadget you can save the configuration permanently into the file
  836.      `ENVARC:ToolManager.prefs'. For a temporary change use the `Use'
  837.      gadget, which will save the configuration into the file
  838.      `ENV:ToolManager.prefs'. This file will not survive a machine
  839.      reset. To test the new configuration without leaving the editor,
  840.      use the `Test' gadget. The `Cancel' gadget will quit the editor
  841.      without saving.
  842.  
  843.  
  844. Main window menus
  845. ==================
  846.  
  847.    The main window has several menu items:
  848.  
  849. `Project'
  850.      With the menu items `Open' and `Save As' you can load and save the
  851.      configuration. The `About' item opens an information requester.
  852.      Selecting the `Quit' item will leave the editor without saving.
  853.  
  854. `Edit'
  855.      With these menu items you can restore older configurations. The
  856.      `Last Saved' item loads the last saved configuration from the file
  857.      `ENVARC:ToolManager.prefs'. With the item `Restore' you can load
  858.      the configuration that was active before you started the editor
  859.      from the file `ENV:ToolManager.prefs'.
  860.  
  861. `Settings'
  862.      You can choose with the `Create Icons' item wether the menu item
  863.      `Save As' should create an icon or not.
  864.  
  865.  
  866. Create objects window
  867. ======================
  868.  
  869.    If you drop an icon on the main window, the "Create objects" window
  870. will open. Here you can choose what objects should be created from this
  871. icon. This can be used to add a program to your configuration very
  872. easily and fast.
  873.  
  874.    You can just create an Exec or Image object from the icon, if you
  875. select one of the first two choices. But you can also create a complete
  876. Menu and/or Icon object if you select one of the last three choices.
  877.  
  878.  
  879. Edit windows
  880. =============
  881.  
  882.    Each object type has a different edit window to set the object
  883. parameters. For a detailed list of all object parameters see Objects.
  884.  
  885.    Every edit window has a string gadget for the object name. This name
  886. is important, because it is used to reference this object. Note that
  887. there is currently no builtin cross-reference. So if you change the
  888. name of an object which is already referenced by another object, this
  889. reference will *not* be updated. You have to update this reference by
  890. hand.
  891.  
  892.    The button gadgets in the edit windows open different types of
  893. requesters. You can choose an item by clicking on it and pressing the
  894. `OK' gadget, or you simply double-click it. To leave a requester
  895. without changes, use the `Cancel' gadget. If you wish to clear a field
  896. which can only be choosen by a requester, open the requester and press
  897. the `OK' gadget *without* selecting an item.
  898.  
  899.    The edit windows for the object types Exec and Image have an
  900. additional feature. You can simply drop an icon on them to set the
  901. parameters from this icon.
  902.  
  903.  
  904. Tooltypes
  905. ==========
  906.  
  907.    When you start the preferences editor from the Workbench you can set
  908. several tooltypes in the program icon or configuration file icons to
  909. control it.
  910.  
  911. `USE'
  912.      If you set this tooltype in an icon for a preferences file, the
  913.      editor will install this file as current configuration file.
  914.  
  915. `SAVE'
  916.      If you set this tooltype in an icon for a preferences file, the
  917.      editor will install this file as current and as permanent
  918.      configuration file.
  919.  
  920. `PUBSCREEN'
  921.      This tooltype tells the editor to open its windows on a specific
  922.      public screen. If you don't supply this tooltype, the default
  923.      public screen will be used.
  924.  
  925. `CREATEICONS'
  926.      When this tooltype is set to `YES', the editor will create an icon
  927.      for every preferences file that is created with the `Save As' menu
  928.      item.
  929.  
  930. `DEFAULTFONT'
  931.      The editor normally uses the public screen font to draw its
  932.      gadgets. If you set this tooltype to `YES', the editor will use
  933.      the system default font instead.
  934.  
  935. `XPOS'
  936.      This specifies the initial X position of the editor main window.
  937.  
  938. `YPOS'
  939.      This specifies the initial Y position of the editor main window.
  940.  
  941. `MINLISTCOLUMNS'
  942.      This specifies the minimum number of columns in the list gadgets.
  943.  
  944. `MINLISTROWS'
  945.      This specifies the minimum number of rows in the list gadgets.
  946.  
  947.  
  948. CLI Arguments
  949. ==============
  950.  
  951.    When the preferences editor is started from the shell, it uses the
  952. following command line template:
  953.  
  954.      FROM,EDIT/S,USE/S,SAVE/S,PUBSCREEN/K,DEFAULTFONT/S
  955.  
  956. `FROM'
  957.      This parameter specifies the name of the preferences file which
  958.      the editor should load.
  959.  
  960. `USE'
  961.      If you use this parameter, the editor will install the file
  962.      specified as the `FROM' parameter as current configuration file.
  963.  
  964. `SAVE'
  965.      If you use this parameter, the editor will install the file
  966.      specified as the `FROM' parameter as current and as permanent
  967.      configuration file.
  968.  
  969. `PUBSCREEN'
  970.      This parameter tells the editor to open its windows on a specific
  971.      public screen. If you don't supply this tooltype the default
  972.      public screen will be used.
  973.  
  974. `DEFAULTFONT'
  975.      The editor normally uses the public screen font to draw its
  976.      gadgets. If you use this parameter the editor will use the system
  977.      default font instead.
  978.  
  979.  
  980. The ToolManager shared library interface
  981. *****************************************
  982.  
  983.    The ToolManager handler is embedded into a Amiga shared library.
  984. This library offers several functions to create and manipulate
  985. ToolManager objects, so that you can use them in your programs.
  986.  
  987.    There are currently six functions available:
  988.  
  989. `AllocTMHandle()'
  990.      In order to create ToolManager objects you must first allocate a
  991.      TMHandle. This handle stores all information about your objects
  992.      and is used to reference them. Note that the information stored in
  993.      this handle is *only* accessable by the program which creates it.
  994.  
  995. `FreeTMHandle()'
  996.      This function frees a TMHandle and all ToolManager objects
  997.      associated with it. Each `AllocTMHandle()' must be matched with a
  998.      `FreeTMHandle()'!
  999.  
  1000. `CreateTMObjectTags()'
  1001. `CreateTMObjectTagList()'
  1002.      This function creates a ToolManager object. You must supply a
  1003.      name, the object type and various tags for the object parameters.
  1004.      The name of the object is important, as it is used to reference
  1005.      the object.
  1006.  
  1007. `ChangeTMObjectTags()'
  1008. `ChangeTMObjectTagList()'
  1009.      You can modify the parameters of a ToolManager object with this
  1010.      function. The object state will be updated to reflect the new
  1011.      parameters. Note: Currently Image objects can't be modified.
  1012.  
  1013. `DeleteTMObject()'
  1014.      With this function you can delete a ToolManager object. If the
  1015.      object is linked to other objects, these objects will be notified
  1016.      to update their state.
  1017.  
  1018. `QuitToolManager()'
  1019.      This function tells the ToolManager handler to quit as soon as
  1020.      possible.
  1021.  
  1022.    The complete library interface description is available in AutoDoc
  1023. format (see Docs).
  1024.  
  1025.  
  1026. How to define a Hot Key
  1027. ************************
  1028.  
  1029.    This chapter describes how to define a Hot Key as an Input
  1030. Description String, which is then parsed by Commodities. Each time a
  1031. Hot Key is activated Commodities generates an event which is used by
  1032. ToolManager to activate Exec objects or to toggle Dock objects. A
  1033. description string has the following syntax:
  1034.  
  1035.      [<class>] {[-][<qualifier>]} [-][upstroke] [<key code>]
  1036.  
  1037.    All keywords are case insensitive.
  1038.  
  1039.    `class' describes the InputEvent class. This parameter is optional
  1040. and if it is missing the default `rawkey' is used. See InputEvent
  1041. classes.
  1042.  
  1043.    Qualifiers are "signals" that must be set or cleared by the time the
  1044. Hot Key is activated; otherwise no event will be generated. For each
  1045. qualifier that must be set you supply its keyword. All other qualifiers
  1046. are expected to be cleared by default. If you want to ignore a
  1047. qualifier, just set a `-' before its keyword. See Qualifiers.
  1048.  
  1049.    Normally a Hot Key event is generated when a key is pressed. If the
  1050. event should be generated when the key is released, supply the keyword
  1051. `upstroke'. When both press and release of the key should generate an
  1052. event, use `-upstroke'.
  1053.  
  1054.    The key code is depending on the InputEvent class. See Key codes.
  1055.  
  1056.    Note: Choose your hot keys *carefully*, because Commodities has a
  1057. high priority in the InputEvent handler chain (i.e. will override
  1058. existing definitions).
  1059.  
  1060.  
  1061. InputEvent classes
  1062. ===================
  1063.  
  1064.    Commodities supports most of the InputEvent classes that are
  1065. generated by the input.device. This section describes those classes
  1066. that are most useful for ToolManager Hot Keys.
  1067.  
  1068. `rawkey'
  1069.      This is the default class and covers all keyboard events. For
  1070.      example `rawkey a' or `a' creates an event every time when the key
  1071.      "a" is pressed. You must specify a key code for this class. See
  1072.      rawkey key codes.
  1073.  
  1074. `rawmouse'
  1075.      This class describes all mouse button events. You must specify a
  1076.      key code for this class. See rawmouse key codes.
  1077.  
  1078. `diskinserted'
  1079.      Events of this class are generated when a disk is inserted in a
  1080.      drive. This class has no key codes.
  1081.  
  1082. `diskremoved'
  1083.      Events of this class are generated when a disk is removed from a
  1084.      drive. This class has no key codes.
  1085.  
  1086.  
  1087. Qualifiers
  1088. ===========
  1089.  
  1090.    Some keyword synonyms were added to Commodities V38. These are
  1091. marked with an `*'.
  1092.  
  1093. `lshift', `left_shift' *
  1094.      Left shift key.
  1095.  
  1096. `rshift', `right_shift' *
  1097.      Right shift key.
  1098.  
  1099. `shift'
  1100.      Either shift key.
  1101.  
  1102. `capslock', `caps_lock' *
  1103.      Caps lock key.
  1104.  
  1105. `caps'
  1106.      Either shift key or caps lock key.
  1107.  
  1108. `control', `ctrl' *
  1109.      Control key.
  1110.  
  1111. `lalt', `left_alt' *
  1112.      Left alt key.
  1113.  
  1114. `ralt', `right_alt' *
  1115.      Right alt key.
  1116.  
  1117. `alt'
  1118.      Either alt key.
  1119.  
  1120. `lcommand', `lamiga' *, `left_amiga' *, `left_command' *
  1121.      Left Amiga/Command key.
  1122.  
  1123. `rcommand', `ramiga' *, `right_amiga' *, `right_command' *
  1124.      Right Amiga/Command key.
  1125.  
  1126. `numericpad', `numpad' *, `num_pad' *, `numeric_pad' *
  1127.      This keyword *must* be used for any key on the numeric pad.
  1128.  
  1129. `leftbutton', `lbutton' *, `left_button' *
  1130.      Left mouse button. See note below.
  1131.  
  1132. `midbutton', `mbutton' *, `middlebutton' *, `middle_button' *
  1133.      Middle mouse button. See note below.
  1134.  
  1135. `rbutton', `rightbutton' *, `right_button' *
  1136.      Right mouse button. See note below.
  1137.  
  1138. `repeat'
  1139.      This qualifier is set when the keyboard repeat is active. Only
  1140.      useful for InputEvent class `rawkey'.
  1141.  
  1142.    Note: Commodities V37 has a bug which prevents the use of
  1143. `leftbutton', `midbutton' and `rbutton' as qualifiers. This bug is
  1144. fixed in V38.
  1145.  
  1146.  
  1147. Key codes
  1148. ==========
  1149.  
  1150.    Each InputEvent class has its own key codes:
  1151.  
  1152.  
  1153. Key codes for InputEvent class `rawkey'
  1154. ----------------------------------------
  1155.  
  1156.    Some keywords and synonyms were added to Commodities V38. These are
  1157. marked with an `*'.
  1158.  
  1159. `a'-`z', `0'-`9', ...
  1160.      ASCII characters.
  1161.  
  1162. `f1', `f2', ..., `f10', `f11' *, `f12' *
  1163.      Function keys.
  1164.  
  1165. `up', `cursor_up' *, `down', `cursor_down' *
  1166. `left', `cursor_left' *, `right', `cursor_right' *
  1167.      Cursor keys.
  1168.  
  1169. `esc', `escape' *, `backspace', `del', `help'
  1170. `tab', `comma', `return', `space', `spacebar' *
  1171.      Special keys.
  1172.  
  1173. `enter', `insert' *, `delete' *
  1174. `page_up' *, `page_down' *, `home' *, `end' *
  1175.      Numeric Pad keys. Each of these key codes *must* be used with the
  1176.      `numericpad' qualifier keyword!
  1177.  
  1178.  
  1179. Key codes for InputEvent class `rawmouse'
  1180. ------------------------------------------
  1181.  
  1182.    These keywords were added to Commodities V38. They are not available
  1183. in V37.
  1184.  
  1185. `mouse_leftpress'
  1186.      Press left mouse button.
  1187.  
  1188. `mouse_middlepress'
  1189.      Press middle mouse button.
  1190.  
  1191. `mouse_rightpress'
  1192.      Press right mouse button.
  1193.  
  1194.    Note: To use one of these key codes, you must also set the
  1195. corresponding qualifier keyword, e.g.
  1196.  
  1197.      rawmouse leftbutton mouse_leftpress
  1198.  
  1199.  
  1200. Examples for Hot Keys
  1201. ======================
  1202.  
  1203. `ralt t'
  1204.      Hold right Alt key and press "t"
  1205.  
  1206. `ralt lalt t'
  1207.      Hold left *and* right Alt key and press "t"
  1208.  
  1209. `alt t'
  1210.      Hold either Alt key and press "t"
  1211.  
  1212. `rcommand f2'
  1213.      Hold right Amiga key and press the second function key
  1214.  
  1215. `numericpad enter'
  1216.      Press the Enter key on the numeric pad
  1217.  
  1218. `rawmouse midbutton leftbutton mouse_leftpress'
  1219.      Hold middle mouse button and press the the left mouse button
  1220.  
  1221. `diskinserted'
  1222.      Insert a disk in any drive.
  1223.  
  1224.  
  1225. Most asked questions about ToolManager
  1226. ***************************************
  1227.  
  1228.    Here are the answers to the most asked questions about ToolManager:
  1229.  
  1230.    - Why can't ToolManager create multiple "Tools" menus or sub-menus?
  1231.  
  1232.      Multiple menus or sub-menus are currently not supported by the
  1233.      system software. To create them, you have to *hack* them into the
  1234.      system software, which can result in an unstable system. I don't
  1235.      want to produce unstable software, so I won't implement such a
  1236.      thing in ToolManager.
  1237.  
  1238.    - WB programs won't start, but all other exec types work fine.
  1239.  
  1240.      ToolManager relies on the program `L:WBStart-Handler' to start WB
  1241.      programs. There are two reasons, why ToolManager can't execute
  1242.      this program:
  1243.  
  1244.         * The file `L:WBStart-Handler' doesn't exists. Please copy it
  1245.           from the distribution archive.
  1246.  
  1247.         * The execute flag (e) isn't set on this file. Use the
  1248.           following command to set this flag: `protect
  1249.           L:WBStart-Handler +e'
  1250.  
  1251.    - How can I create a horizontal dock window?
  1252.  
  1253.      Just set the number of columns to the number of entries in the
  1254.      dock object.
  1255.  
  1256.    - How can I create an output window for CLI programs?
  1257.  
  1258.      Output windows can be created by using the `CON:' device. Use the
  1259.      following file name to create an auto-open window with a close
  1260.      gadget which doesn't close after the program has quit:
  1261.  
  1262.           CON:10/10/640/100/Output-Window/AUTO/CLOSE/WAIT
  1263.  
  1264.      The `CON:' device has many options, please consult your AmigaDOS
  1265.      manual for further information.
  1266.  
  1267.    - How can I put the arguments in the middle of a CLI/Arexx command
  1268.      line?
  1269.  
  1270.      Normally all arguments are appended to the command line. To insert
  1271.      the arguments anywhere in the command line, ToolManager uses the
  1272.      same `[]' syntax, which is used by the AmigaShell command `alias'.
  1273.      So for example
  1274.  
  1275.           Dir [] all
  1276.  
  1277.      will insert all arguments before the keyword `all'.
  1278.  
  1279.    - How can I clear a link from a complex object to a simple object?
  1280.  
  1281.      After pressing the "xxx Object" button just press the "OK" button
  1282.      *without* selecting an object. This means that you choosed no
  1283.      object, and therefore the link will be cleared.
  1284.  
  1285.    - How can I create sub-docks?
  1286.  
  1287.      You must use Exec objects of the type Dock. Put such objects in
  1288.      the entries of your main dock and they will open/close the other
  1289.      docks.
  1290.  
  1291.    - ToolManager is dead after starting a Network command.
  1292.  
  1293.      There is currently a problem with the network software, which
  1294.      doesn't timeout local requests. So if your machine is called
  1295.      `Host1' and you have an Exec object of the type Network with the
  1296.      command `Object@Host1', ToolManager will run into a dead-lock when
  1297.      you activate it. Please use only names of remote machines!
  1298.  
  1299.  
  1300. The History of ToolManager
  1301. ***************************
  1302.  
  1303. 2.1, Release date 16.05.1993
  1304.         - New Exec object types: Dock, Hot Key, Network
  1305.  
  1306.         - New Dock object flags: Backdrop, Sticky
  1307.  
  1308.         - New object type: Access
  1309.  
  1310.         - Network support
  1311.  
  1312.         - Editor main window is now an AppWindow
  1313.  
  1314.         - Gadget keyboard shortcuts in the preferences editor
  1315.  
  1316.         - New tooltypes for the preferences editor
  1317.  
  1318.         - Several bug fixes
  1319.  
  1320.         - Enhanced documentation
  1321.  
  1322. 2.0, Release date 26.09.1992, Fish Disk #752
  1323.         - Complete new concept (object oriented)
  1324.  
  1325.         - (Almost) Complete rewrite
  1326.  
  1327.         - ToolManager is now split up into two parts
  1328.  
  1329.         - Main handler is now embedded into a shared library
  1330.  
  1331.         - Configuration is now handled by a Preferences program
  1332.  
  1333.         - Configuration file format has changed again :-) It is an IFF
  1334.           File now and resides in ENV:
  1335.  
  1336.         - Multiple Docks and multi-column Docks
  1337.  
  1338.         - Docks with new window design
  1339.  
  1340.         - Dock automatically detects largest image size
  1341.  
  1342.         - Sound support
  1343.  
  1344.         - Direct ARexx support for Exec objects
  1345.  
  1346.         - ToolManager can be used without the Workbench. If the
  1347.           Workbench isn't running, it won't use any App* features.
  1348.  
  1349.         - Locale support
  1350.  
  1351.         - Path from Workbench will be used for CLI tools
  1352.  
  1353.         - Seperate Handler Task for starting WB processes
  1354.  
  1355. 1.5, Release date 10.10.1991, Fish Disk #551
  1356.         - Status Window: New/Open/Append/Save As menu items for config
  1357.           file
  1358.  
  1359.         - Edit Window: File requesters for file string gadgets
  1360.  
  1361.         - Added a Dock Window (a la NeXT)
  1362.  
  1363.         - Added a DeleteTool
  1364.  
  1365.         - A list of all active HotKeys can be shown
  1366.  
  1367.         - Tools can be moved around in the list
  1368.  
  1369.         - Icon positioning in the edit window added
  1370.  
  1371.         - Name of the program icon can be set
  1372.  
  1373.         - CLI tools can have an output file and a path list
  1374.  
  1375.         - Uses UserShell for CLI tools
  1376.  
  1377.         - Maximum command line length for CLI tools is now 4096 Bytes
  1378.  
  1379.         - AppIcons without a name are supported now
  1380.  
  1381.         - Workbench screen will be moved to front if you pop up the
  1382.           Status window
  1383.  
  1384.         - Workbench screen can be moved to front before starting a tool
  1385.           via HotKey
  1386.  
  1387.         - TM will wait up to 20 seconds for the workbench.library
  1388.  
  1389.         - Added a DELAY switch which causes TM to wait <num> seconds
  1390.           before adding any App* stuff
  1391.  
  1392.         - renamed some tooltypes/parameters
  1393.  
  1394.         - some visual cues added
  1395.  
  1396.         - some internal changes
  1397.  
  1398. 1.4, Release date 09.07.1991, Fish Disk #527
  1399.         - Keyboard short cuts for tools
  1400.  
  1401.         - AppIcons for tools
  1402.  
  1403.         - Menu item can be switched off
  1404.  
  1405.         - Configuration file format completely changed (hopefully the
  1406.           last time)
  1407.  
  1408.         - CLI commandline parsing is now done by ReadArgs()
  1409.  
  1410.         - Status & edit window updated to new features
  1411.  
  1412.         - Safety check before program shutdown added
  1413.  
  1414.         - Menu item "Open TM Window" only appears if the program icon is
  1415.           disabled
  1416.  
  1417.         - WB startup method changed. Now supports project icons
  1418.  
  1419.         - several internal changes
  1420.  
  1421. 1.3, Release date 13.03.1991, Fish Disk #476
  1422.         - Now supports different configuration files
  1423.  
  1424.         - Format of the configuration file slightly changed
  1425.  
  1426.         - Tool definitions can be changed at runtime
  1427.  
  1428.         - Now supports CLI & Workbench startup method
  1429.  
  1430.         - Selected icons are passed as parameters to the tools
  1431.  
  1432.         - Now uses the startup icon as program icon if started from
  1433.           Workbench
  1434.  
  1435.         - The position of the icon can now be supplied in the
  1436.           configuration file
  1437.  
  1438.         - The program icon can now be disabled
  1439.  
  1440.         - New menu entry "Show TM Window"
  1441.  
  1442.         - Every new started ToolManager passes its startup parameters
  1443.           to the already running ToolManager process
  1444.  
  1445. 1.2, Release date 12.01.1991, Fish Disk #442
  1446.         - Status window changed to a no-GZZ & simple refresh type (this
  1447.           should save some bytes)
  1448.  
  1449.         - Status window remembers its last position
  1450.  
  1451.         - New status window gadget "Save Configuration": saves the
  1452.           actual tool list in the configuration file
  1453.  
  1454.         - Small bugs removed in the ListView gadget handling
  1455.  
  1456.         - Name of the icon hard-wired to "ToolManager"
  1457.  
  1458. 1.1, Release date 01.01.1991
  1459.         - Icons can be dropped on the status window
  1460.  
  1461.         - Status window contains a list of all tool names
  1462.  
  1463.         - Tools can be removed from the list
  1464.  
  1465. 1.0, Release date 04.11.1990
  1466.         - Initial release
  1467.  
  1468.  
  1469. The author would like to thank...
  1470. **********************************
  1471.  
  1472.    ToolManager has gone through many major evolutionary phases since
  1473. its first implementation in mid-1990. This development would have been
  1474. impossible if I hadn't received the enormous feedback from various
  1475. ToolManager users. Many ideas & features resulted from this source...
  1476.  
  1477.    Therefore I would like to thank:
  1478.  
  1479. For Alpha/Beta testing, ideas & bug reports:
  1480.      Amiga section of our local computer club (Computerclub an der RWTH
  1481.      Aachen), Olaf 'Olsen' Barthel, Georg Hessmann (Gucky), Markus
  1482.      Illenseer (ill), Klaus Melchior, Rickard Olsson (Richie), Matthias
  1483.      Scheler (Tron), Ralph Schmidt (laire), Roger Westerlund (Budda),
  1484.      Juergen Weinelt, Brian Wright (SteveVai), Petra Zeidler
  1485.      (stargazer) and many others...
  1486.  
  1487. Matthew Dillon
  1488.      Without your *excellent* C development system DICE and various
  1489.      other tools, ToolManager wouldn't exist!
  1490.  
  1491. For their excellent graphics work:
  1492.      Andreas Harrenberg, Georg Hessmann, Michael "Mick" Hohmann, Markus
  1493.      Illenseer, Oliver Koenen, Klaus Melchior, Rickard Olsson, Jan
  1494.      Peter, Matthias Scheler, Brian Wright
  1495.  
  1496. For the translations:
  1497.      Tomi Blinnikka (suomi), Jorn Halonen (norsk), Dr. Peter Kittel
  1498.      (deutsch), Jasper Kehlet (dansk), Klaus Melchior (eifel), Rickard
  1499.      Olsson (svenska), Rullier Pascal (français), Marc Schaefer
  1500.      (français), Tor Rune Skoglund (norsk), Reinhard Spisser
  1501.      (italiano), Andrea Suatoni (italiano)
  1502.  
  1503. All gals & guys at West Chester:
  1504.      For developing the Amiga and its superb operating system.
  1505.  
  1506. All users who sent me money:
  1507.      I didn't ask for it in the 1.X releases, but it's nice to see when
  1508.      someone appreciates my work.
  1509.  
  1510. All users who sent me a note:
  1511.      I really enjoyed reading your letters!
  1512.  
  1513. and all I forgot to mention...
  1514.  
  1515. Index
  1516. ******
  1517.  
  1518.  
  1519.  
  1520.  TeX                                    Docs
  1521.  Access objects                         Access
  1522.  Address                                Authors address
  1523.  AmigaGuide                             Docs
  1524.  Answers                                Questions
  1525.  ARexx scripts                          Scripts
  1526.  ASCII documentation                    Docs
  1527.  Bug reports                            Authors address
  1528.  Catalog files                          Locale
  1529.  CLI Arguments                          CLI Arguments
  1530.  Comments                               Authors address
  1531.  Compiler support                       Programmers
  1532.  Concepts                               Concepts
  1533.  Configuration                          Preferences
  1534.  Contributed images                     Graphics
  1535.  Copyright                              Copyright
  1536.  Credits                                Credits
  1537.  DeleteTool                             Goodies
  1538.  Diskinserted                           InputEvent classes
  1539.  Diskremoved                            InputEvent classes
  1540.  Distribution                           Copyright
  1541.  Distribution files                     Distribution files
  1542.  Dock objects                           Dock
  1543.  Docs directory                         Docs
  1544.  Documentation                          Docs
  1545.  Donations                              Authors address
  1546.  E-Mail                                 Authors address
  1547.  Example                                Tutorial
  1548.  Example images                         Graphics
  1549.  Examples for Hot Keys                  Hot Key examples
  1550.  Exec objects                           Exec
  1551.  Fast installation                      Quick installation
  1552.  GetPubName                             Goodies
  1553.  GiftWare                               Important
  1554.  Goodies directory                      Goodies
  1555.  Graphics directory                     Graphics
  1556.  Guided tour                            Tutorial
  1557.  History                                History
  1558.  Hot Keys                               Hot Keys
  1559.  Icon objects                           Icon
  1560.  Image objects                          Image
  1561.  Important notes                        Important
  1562.  InputEvent classes                     InputEvent classes
  1563.  Installation (quick)                   Quick installation
  1564.  InterNet address                       Authors address
  1565.  Introduction to Hot Keys               Hot Keys
  1566.  Introduction to ToolManager            Introduction
  1567.  Introduction to ToolManager objects    Concepts
  1568.  Key codes for rawkey                   rawkey key codes
  1569.  Key codes for rawmouse                 rawmouse key codes
  1570.  L directory                            L
  1571.  Language files                         Locale
  1572.  Languages                              Locale
  1573.  Legal stuff                            Copyright
  1574.  Library documentation                  Docs
  1575.  Library interface                      Library
  1576.  Libs directory                         Libs
  1577.  List: rawkey key codes                 rawkey key codes
  1578.  List: rawmouse key codes               rawmouse key codes
  1579.  List: Qualifiers                       Qualifiers
  1580.  Locale directory                       Locale
  1581.  Localization                           Locale
  1582.  Menu objects                           Menu
  1583.  Objects                                Objects
  1584.  Permissions                            Copyright
  1585.  Postal address                         Authors address
  1586.  Preferences editor                     Preferences
  1587.  Prefs directory                        Prefs
  1588.  Printed documentation                  Docs
  1589.  Probibitions                           Copyright
  1590.  Program concepts                       Concepts
  1591.  Programm versions                      History
  1592.  Programmers directory                  Programmers
  1593.  Qualifiers                             Qualifiers
  1594.  Questions                              Questions
  1595.  Quick installation                     Quick installation
  1596.  Rawkey                                 InputEvent classes
  1597.  Rawmouse                               InputEvent classes
  1598.  Reference: Distribution files          Distribution files
  1599.  Reference: Hot Keys                    Hot Keys
  1600.  Reference: Library interface           Library
  1601.  Reference: Preferences editor          Preferences
  1602.  Reference: ToolManager objects         Objects
  1603.  Scripts directory                      Scripts
  1604.  Shared library interface               Library
  1605.  Shell scripts                          Scripts
  1606.  Sound objects                          Sound
  1607.  Sound player                           Goodies
  1608.  Source code                            Source
  1609.  Source directory                       Source
  1610.  Texinfo                                Docs
  1611.  Thanks                                 Credits
  1612.  ToolManager objects                    Objects
  1613.  ToolManager shared library interface   Library
  1614.  Tooltypes                              Tooltypes
  1615.  Translations                           Locale
  1616.  Translators                            Source
  1617.  Tutorial                               Tutorial
  1618.  UPD                                    Goodies
  1619.  V38 (and higher) features              Important
  1620.  Versions                               History
  1621.  WBStart 1.2                            L
  1622.  WBStart-Handler                        L
  1623.  WBStartup directory                    WBStartup
  1624.  
  1625.