home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / misc / deftool2.lha / DefTool2.doc < prev    next >
Encoding:
Text File  |  1992-06-20  |  4.2 KB  |  101 lines
  1.  
  2. DefTool2 (requires Workbench2.0, V37 or greater)
  3. ~~~~~~~~
  4.     by Robert Lang.
  5.  
  6. This program is ⌐ Robert Lang, 1992, and remains the property of Robert
  7. Lang, but may be freely distributed under non-commercial distribution links,
  8. at no more charge than that of Fred Fish or Megadisc Australia.  I take
  9. no responsibility for damage done through the use of this program.  Commercial
  10. use requires the written permission of the author.
  11.  
  12. Now that that's all over, what does it do ?
  13.  
  14. A program I wrote a while back (mid '91), allowed the easy setting of the
  15. "Default Tool" field of project icons, by executing the command
  16. 'deftool file tool' from the shell.
  17.  
  18. Now, I've finally got around to doing what I wanted to do all along, provide
  19. a workbench version.  Using the excellent "AppMenuItem" feature of Workbench 2,
  20. I've now written DefTool2.
  21.  
  22. The only thing it does from the shell now is start itself or display an
  23. "About" message if ? is supplied as an argument.
  24.  
  25. DefTool2 is designed to run from the Workbench, and is a Workbench 2 Commodity.
  26. (This means it can be controlled from the Commodity Exchange !).
  27.  
  28. The best method of starting DefTool2 is to put it into the sys:wbstartup
  29. directory, and when you boot your machine it will always be there !
  30.  
  31. DefTool2 adds the menu item "Set Default Tool" to the Tools menu of Workbench 2,
  32. and this is of course its main feature.
  33.  
  34. When a series of icons are selected and the "Set Default Tool" menu item
  35. selected, then the user is prompted for a default tool to be entered,
  36. and then DefTool2 goes to work, changing the Default Tool of all "Project"
  37. icons to the text entered.
  38.  
  39. If any of the icons which are selected are not project icons, then DefTool2
  40. calls DisplayBeep() for each of these. (hence, by default, the screen flashes).
  41.  
  42. Note that unfortunately, Workbench2 doesn't seem to pass me icons for
  43. which there is no actual corresponding file....ie. if 'rob.info' is selected
  44. and 'rob' is non-existant, Workbench2 doesn't tell DefTool2 anything
  45. about 'rob.info' and so no processing will occur.  If you need this feature,
  46. use my original shell-version, DefTool.
  47.  
  48. If a single project is selected, then the current Default Tool of that
  49. project is copied into the text requester and so you can edit it as if
  50. you used the "Information" option of Workbench 2.
  51.  
  52. When editing the Default Tool, clicking return in the text box or hitting
  53. SAVE set DefTool2 to work, CANCEL or closing the window cancels the operation.
  54.  
  55. DefTool2 reports serious errors with Recoverable Alerts, and simple errors
  56. (such as nothing selected !) as screen flashes.
  57.  
  58. If DefTool2 is already running, no action is taken by running it again.
  59.  
  60. You can set the Commodity Priority using the CX_PRIORITY argument in the
  61. tool types of the icon for DefTool2, and in addition you can set the
  62. DEFTOOL to be the default text entered into the text requester when setting
  63. Default Tools. (e.g. DEFTOOL=:c/fullview)
  64.  
  65. (Oh, and the little path requester was easily whipped up using GadToolsBox
  66. from Jaba Development, available from the Fish Disks.)
  67.  
  68. If you like DefTool2, perhaps a contribution towards my programming will
  69. keep me writing utilities in the future !
  70.  
  71. Send comments, bug reports, money, porsches, '040 cards, 24bit Graphics
  72. cards, 1 Gigabye harddrives or anything non explosive to :
  73.  
  74.             Robert Lang
  75.             EdgeWare
  76.             P.O. Box 127
  77.             CARDIFF NSW 2285
  78.             AUSTRALIA
  79.  
  80. Oh, and as always, this is dedicated to my girlfriend, Suzanne !
  81.  
  82. Enjoy !
  83.  
  84. Robert Lang, 8th June 1992, V1.20.
  85.  
  86. ------------------
  87.  
  88. History :
  89.  
  90. 31st May 1992  - First Release V1.00
  91. 3rd June 1992  - Bug fix to V1.10, was failing to set all default tool types
  92.                  randomly, couldn't figure out exactly why, but worked
  93.                  a way around it...a pointer from a WB2 function was changing
  94.                  when I didn't want it to...so I used my own, works fine now.
  95.                  (I probably wasn't supposed to use that pointer anyway...)
  96. 8th June 1992  - Update to V1.20, removed my routine for making a path from a 
  97.                  lock and switched to the WB2 function "NameFromLock" !
  98. 14th June 1992 - Fixed a bug introduced in the previous change,
  99.                  which meant that files too deep in a directory
  100.                  structure didn't work...hopefully this is it !
  101.