home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 634.lha / NewDefTool_v1.01 / Doc.pp / Doc
Encoding:
Text File  |  1992-05-16  |  9.7 KB  |  283 lines
  1.  
  2.  
  3. ****************************************************************************
  4. *                                                                          *
  5. * NewDefaultTool V1.01 by Kjell Cederfeldt               92-Jan-01         *
  6. *                                                                          *
  7. * Copyright (C) by Kjell Cederfeldt 1992. All rights reserved.             *
  8. *                                                                          *
  9. * Change Default tool in a project icon.                                   *
  10. *                                                                          *
  11. * Written in  DevPac assembler with CygnusED Pro on Amiga 3000.            *
  12. *                                                                          *
  13. *  Kjell Cederfeldt           Phone  +46 31 - 306334        home           *
  14. *  Hammarkulletorget 39              +46 31 - 139316        office         *
  15. *  S-442 37  ANGERED   SWEDEN        +46 31 - 306310/307610 support BBS    *
  16. *                                                                          *
  17. *  UseNet ...{uunet|pyramid|rutgers}!cbmvax!cbmehq!cbmswe!datac!kjell      *
  18. *                                                                          *
  19. ****************************************************************************
  20. $VER: NewDefaultTool V1.01 (92-Jan-01) © by Kjell Cederfeldt 1992
  21.  
  22. The filesize of NewDefTool is 5888 bytes.
  23. Checksum according to BRIC is 3888892034b.
  24.  
  25.  
  26. WHAT IS NEWDEFAULTTOOL?
  27. =======================
  28.  
  29. NewDefaultTool is Public Domain, and it may be spread for non-commercial
  30. purposes only. (It's OK to copy, spread and use it, but not to make money
  31. from doing so).
  32.  
  33.  
  34. Disclaimer:
  35.  
  36. NewDefaultTool is "as is". You run this program on Your own risk. I will
  37. not be held responsible for damage caused by the program. I have done my
  38. best to make it as safe as possible, and much time is spent on testing it.
  39. There are no bugs that I know of. Should You find any, please let me know.
  40.  
  41. Good Luck!
  42.  
  43.  
  44. WHAT IT DOES?
  45. =============
  46.  
  47. NewDefaultTool changes the default tool in a project icon. I'm sure that You
  48. have been annoyed more than once when You try to read a docfile or start a
  49. script and AmigaDOS pops up a requester telling You that it can't find the
  50. default tool specified for the icon. (ie. "Can't find :C/MuchMore"). To get
  51. things working You normally will have to choose info from the WorkBench menu
  52. and change the default tool and try again. NewDefaultTool has another
  53. approach to this problem. In the configuration file NewDefTool.cfg, which
  54. should be placed in S:, You simply type the default tools that NewDefaultTool
  55. will look for and the tools to change them to. You can use wildcards in
  56. the configuration, this way You can deal with all kinds of More-programs
  57. in one single line by typing #?More. NewDefaultTool takes up very little
  58. amount of memory and only occupies the processor when it is changing tools.
  59.  
  60.  
  61. HOW TO START IT?
  62. ================
  63.  
  64. NOTE! NewDefaultTool can only run under DOS 2.0 or later!
  65.  
  66. NewDefaultTool (from now on called NDT) can be run both from WB or CLI. 
  67.  
  68.  
  69. FROM CLI
  70. =======
  71.  
  72. type: NewDefTool <filename|dir> [filename|dir]...
  73.  
  74. <filename> is the name of the icon to change. Remember to type the whole
  75. path to the file. You don't have to type the suffix .info since NDT will
  76. handle this for You.
  77.  
  78. <dir> is the directory name to work upon. All project icons in the
  79. directory will be changed if a match is found in the configuration file.  
  80.  
  81. You can type several files and directories and even mix files and
  82. directories on the command line as long as You put a space between each of
  83. them. If names have spaces imbedded You must "quote them". If You want to
  84. change all icons in the current directory You can simly type:
  85. NewDefTool ""
  86.  
  87. From CLI You can get help with the -?, ? or -h option. Wildcards in
  88. filenames are not supported from CLI.
  89. If NDT finds a project icon it will print: Found tool... whatever
  90. and if the tool has a match in the configuration, thus changed, it will
  91. print: Changed to...newtool.
  92.  
  93. Example: Found tool... :c/MuchMore
  94.          Changed to... SYS:Utilities/More
  95.  
  96. If no filename is typed the ASL file requester will be invoked. You use
  97. the file requester to get to the file You want to change in the usual manner.
  98. If You don't select a file, all the project icons in the directory specified
  99. in the requester's drawer gadget will be changed. 
  100.  
  101. NOTE! NTD never changes a default tool unless a match is found in the
  102. configuration file. 
  103.  
  104.  
  105. FROM WORKBENCH
  106. ==============
  107.  
  108. Simply double-click the NDT icon. If the configuration has no APPICON
  109. specified (described later) the ASL file-requester will be invoked.
  110.  
  111. If You have specified an APPICON in the configuration the NDT will put an
  112. Application icon on the WorkBench screen. You can tell NDT where to put
  113. the icon by specifying X and Y values in the configuration file. To use
  114. the appicon simply drag the icon You want to change over the appicon and
  115. drop it. It's a good idea to put NDT in the WBStartup-drawer and use the
  116. same icon as appicon. Remember to set DONOTWAIT in the tooltypes list.
  117.  
  118. You can drop files as well as drawers and disks. You can use multiple select
  119. by holding down the shift button and select several icons and drag them over
  120. the appicon. It is the mouse pointer that determines where icons are dropped
  121. so be sure to get it right. It is totally safe to drop any icon on the
  122. appicon. NDT always checks that icons are project icons and that a match is
  123. found in the configuration before it changes anything.
  124.  
  125. The appicon stays on the WorkBench screen until You quit the program. This
  126. is done by double clicking the appicon.
  127.  
  128.  
  129. WHAT ICONS ARE PROJECT ICONS?
  130. =============================
  131.  
  132. Project icons are usually files created by a program. For example a textfile
  133. created with a word-processor or an editor, a painting made with a
  134. paint-program etc. You can check an icon by selecting the icon and
  135. choosing Information from the WorkBench Icon menu. If the icon is a
  136. project icon the word (project) will appear after the filename.
  137.  
  138.  
  139. CONFIGURATION
  140. =============
  141.  
  142.  
  143. The configuration file (NewDefTool.cfg) should be placed in S: but NDT
  144. will also look for it in the current directory.
  145.  
  146. The configuration file contains keywords, these are:
  147.  
  148. APPICON:   Tells NDT to use an appicon and the path to it.
  149. X:         x-position for the appicon.
  150. Y:         y-position for the appicon.
  151. TOOLS:     arguments for defaulttools starts here.
  152. FILENAME:  list of filenames starts here.
  153.  
  154. TOOLS: This is where You type the default tools to look for and after each
  155. tool You type the complete path to the tool to replace the old tool with.
  156. The path can be omitted if the tool and the project icon are in the same
  157. directory. If You don't know how to write the path, look it up in Your
  158. AmigaDos manual.
  159.  
  160. FILENAME: This is where the filenames to look for are typed. After each
  161. filename You type the complete path to the tool to use for these
  162. filenames. This is handy when files are named ReadMe, ReadMeFirst etc. You
  163. can then set Your favourite textviewer as default tool for these files but
  164. a c-source file ending in .c can have an editor as default tool even if
  165. they had the same default tool before You ran NDT.
  166.  
  167. APPICON: The path to the icon You want to use as appicon (without .info
  168. suffix).
  169.  
  170. APPICON: = Sys:WBStartup/NewDefTool
  171. X: = 620
  172. Y: = 210
  173.  
  174. These  changes to These
  175.   |                 |
  176.   |                 |
  177.   |                 |
  178.   V                 V
  179.  
  180. TOOLS:
  181. #?MuchMore   Sys:Utilities/More
  182. #?less       Sys:Utilities/More
  183. #?XIcon      C:IconX
  184. #?DPaint#?   Work:Apps/Graphics/DPaint/DPaint
  185. :ced         Work:Util/ED
  186. FILENAME:
  187. ReadMe#?     Work:Util/View80
  188.  
  189. The length of the space between old tools and new tool are not
  190. important and it is OK to use tabs.
  191.  
  192. A complete configuration file can look like this:
  193.  
  194. APPICON: = Sys:WBStartup/NewDefTool
  195. X: = 620
  196. Y: = 210
  197. TOOLS:
  198. (#?MuchMore|#?less) Sys:Utilities/More
  199. #?XIcon             C:IconX
  200. #?DPaint#?          Work:Apps/Graphics/DPaint/DPaint
  201. :ced                Work:Util/ED
  202. FILENAME:
  203. (Read#?Me#?)        Work:Util/View80
  204. (#?.s|#?.asm|#?.c)  Work:Util/Ced
  205.  
  206.  
  207. WILDCARDS
  208. =========
  209.  
  210. Using wildcards will be of great help to make Your configuration as
  211. flexible as possible. In the example above, all tools ending in MuchMore
  212. or less will be changed to SYS:Utilities/More. Tools ending in XIcon
  213. changes to C:IconX and all tools that have the string DPaint in the name
  214. will be changed to Work:Apps/Graphics/DPaint/DPaint.
  215.  
  216. Files that are named ReadMe, ReadMeFirst etc. will be given the default
  217. tool Work:Util/View80. Filenames ending in .c or .s or .asm will have
  218. Work:Util/Ced as their new default tool.
  219.  
  220. Consult Your AmigaDOS manual on how to use wildcards if You are not
  221. familiar with it.
  222.  
  223. ==========================================================================
  224.  
  225. HISTORY
  226.  
  227. verison 0.33-.034
  228. -----------------
  229.  
  230. Worked OK except for a memory bug found by Robert Wahlström. Fixed in
  231. v0.90.
  232.  
  233. Version 0.32
  234. -------------
  235.  
  236. Improved CLI handling and CLI error messages.
  237.  
  238. Version 0.28-0.30
  239. -----------------
  240.  
  241. Many bug-fixes. Window now substituted with requester when doubleclicking
  242. the appicon. Requesters for many error messages.
  243.  
  244. Version 0.21
  245. ------------
  246.  
  247. All versions above 0.17k will not work on any OS less than 2.0. Only ASL
  248. filerequester supported. (Goodbye ARP and REQ).
  249. Appicon added as option. To quit NDT just double-click the appicon. 
  250.  
  251.  
  252. Version 0.17k
  253. -------------
  254.  
  255. Fixed Guru on 68000 Amigas when choosing all files in a directory.
  256. (Thanks Lorenz and Nicklas)
  257.  
  258.  
  259. Version 0.17
  260. ------------
  261.  
  262. Works partly under 1.3.
  263. This is the last version that will support 1.3. Added FILENAME as keyword
  264. in configuration file for future use. Not implemented in the actual
  265. program yet.
  266.  
  267. ==========================================================================
  268.  
  269. THANKS!
  270. -----
  271.  
  272. Thanks to the following for their help:
  273.  
  274. Patrik Holmsten
  275. Lorenz Einarsson
  276. Nicklas Pernblad
  277. Kjell Harnesk
  278. Robert Wahlström
  279. Jerry Sandstedt
  280.  
  281.  
  282. /Kjell Cederfeldt
  283.