home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / new / amigalibdisks / d985 / newtool / newtool.doc < prev    next >
Text File  |  1994-04-04  |  5KB  |  154 lines
  1. NewTool v2.6
  2.  
  3. NewTool and this documentation are Copyright © 1994 by Michael Barsoom.
  4.  
  5. -+- License  -+-
  6.  
  7. NewTool may be freely distributed as long as no charge is made other
  8. than to cover time and copying costs.  This should be no higher than what
  9. Fred Fish charges from one of his freely redistributable disks.
  10.  
  11. You may not copy and/or distribute this program without the accompanying
  12. documentation unless you get permission from the author to do so.
  13.  
  14. Fred Fish and Walnut Creek have permission to include this program on there
  15. FD disks/CDRoms.
  16.  
  17. -+- Disclaimer -+-
  18.  
  19. This product is sold "as is" without representation or warranty of
  20. any kind, either expressed or implied. The user assumes all risks and
  21. responsibilities related to its use.
  22.  
  23. -+- Introduction -+-
  24.  
  25. NewTool will change the default tool of project and disk icons automatically
  26. in one of three ways:
  27. 1) You can specify the default tool to use
  28. 2) You can use a file requester to pick the default tool
  29. 3) You can have new tool automatically pick the right default tool depending
  30.    on the file type.
  31. I wrote it to be used from DOpus or from programs that add programs to the
  32. Tools menu (ie. ToolManager © Stefan Becker or ToolDaemon © Nico Francois)
  33.  
  34. New for v2.5+ a GUI preference editor.
  35.  
  36. -+- Requirements -+-
  37.  
  38. 1) Workbench 2.0+
  39. 2) ReqTools library v38+  (© Nico Francois)
  40. 3) WhatIs library (© S.R. & P.C.)
  41. 4) some icons.
  42.  
  43. -+- Usage -+-
  44.  
  45. From CLI only.
  46.  
  47. NewTool Icons/M/A,Tool/K,Req=Requester/S
  48.  
  49. 1) Replace default tool with specified tool.
  50. Must specify keyword Tool
  51. For example:  NewTool newtool.doc Tool=multiview
  52. Will replace the default tool of newtool.doc.info to multiview.
  53.  
  54. 2) Use file requester to choose new default tool.
  55. You can also use the ReqTools file requester to choose the default tool.
  56. To do this specify the switch Req=Requester, this will bring up the file
  57. requester for you to choose the default tool you want for all the icons you
  58. have specified.
  59.  
  60. For example:  NewTool newtool.doc Requester
  61. Will let give you a file requester to choose the new default tool for
  62. newtool.doc.info.
  63.  
  64. 3) Have NewTool automaticaly choose the new default tool depending on the
  65. configuration file and what the file type is.
  66. (see example config file to see how to configure this to your liking)
  67.  
  68. For example:  NewTool newtool.doc
  69. Will parse the file determine what type of file it is and change the
  70. default tool to the one specified in ENV:NewTool.prefs or S:NewTool.prefs
  71.  
  72. The switch All will cause NewTool to scan directories recursively.
  73.  
  74. -+- PrefsEditor -+-
  75.  
  76. The prefs editor is pretty self explanatory.  The top is a scrolling list
  77. of all the FileTypes that WhatIt currently recognizes in your system; this
  78. includes all the built in types and those defined in the S:FileTypes file.
  79.  
  80. Under the list is a string gadget.  Here will be displayed the name of the
  81. tool that the currently highlighted FileType is assigned to.  You can edit
  82. it by hand, or press on Get to use the filerequester to pick the tool.
  83.  
  84. Save - will present you with a requester asking if you want to save to ENV:
  85. or S:.  The default responce will be where it found the prefs file when first
  86. run.
  87.  
  88. ReLoad - Restore the last saved config.
  89.  
  90. Cancel - cancel all changes and quit (same as pressing the close gadget)
  91.  
  92. -+- Shareware -+-
  93.  
  94. AddInfo is shareware, if you use it regularly you are asked to pay
  95. the shareware fee of $2 US.
  96.  
  97. -+- Thanks -+-
  98.  
  99. To my loving wife Barbara.
  100.  
  101. -+- Bugs, Suggestions -+-
  102.  
  103. you can reach me at:
  104.  
  105. 5524 Pine Street
  106. Omaha NE 68106
  107. USA
  108.  
  109. Internet:  mbars@bluejay.creighton.edu
  110. Fidonet:   Mike Barsoom @ 1:285/11.9
  111. AmigaNet:  Mike Barsoom @ 40:200/10.9
  112.  
  113. -+- History -+-
  114. v37.100
  115.  
  116. v37.201
  117.  
  118.   o Now requires WhatIs library. Can change the default tool according to
  119.     what the file type is.
  120.   o If one of the required libraries was not found, the other libraries
  121.     were not closed before exiting (fixed).
  122.  
  123. v37.203
  124.  
  125.   o Cleaned up code a bit making the executable shorter.
  126.  
  127. v2.4 (v37.204)
  128.  
  129.   o Version numbering changed, to conform to RCS program that I started
  130.     using from.  All I did was drop the 37 and move the decimal to the
  131.     right one.  So v2.4 is equivalent to what would have been 37.204
  132.   o Now uses ReadArgs() to parse command line and config file.
  133.   o Must use Tool keyword to specify default tool on command line.
  134.   o Prefs file format has changed.
  135.   o Was not looking in S: if it could not find prefs file in ENV:
  136.   o Saves a few bytes on executable.
  137.  
  138. v2.5
  139.  
  140.   o When using automode, NewTool will now check to see if the icon is
  141.     a project icon before examining it.
  142.   o Includes new preference editor (NewTool Prefs v1.0)
  143.  
  144. v2.6
  145.  
  146.   o Removed auto switch, now auto is default unless Tool or Req are
  147.     specified.
  148.   o NewTool would scan the same icon twice when auto was specified
  149.     (fixed)
  150.   o Added wild cards and All switch (requested by Roberto Agria)
  151.   o Added control-c breaking
  152.   o Cursor is now hidden when running
  153.   o Includes NewToolPrefs v1.2
  154.