home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / programs / workbench / trashmaster / docs / trashmaster.doc < prev    next >
Encoding:
Text File  |  1995-02-27  |  9.1 KB  |  224 lines
  1.  
  2.  
  3.                              TRASHMASTER V1.5
  4.  
  5.               The *ultimate* in byte disposal for the Amiga.
  6.  
  7.           Copyright (C) 1993 By Aric R Caley and Greywire designs
  8.  
  9.                                16 July 1993
  10.  
  11. Who, what, where, when, why
  12. ***************************
  13.  
  14. WHO
  15. ===
  16.  
  17.    Written by Aric R Caley, AKA Dances V2.0, Dances With Coyotes, Major, Mr
  18. Coyote, and other handles/nicknames.  :) See the readme file if you wish to
  19. contact me.
  20.  
  21. WHAT
  22. ====
  23.  
  24.    See readme.guide/Readme!
  25.  
  26. WHERE
  27. =====
  28.  
  29.    Best place is in your WBStartup drawer!
  30.  
  31. WHEN
  32. ====
  33.  
  34.    The current version, 1.5, was released on 16 July 1993.  The first public
  35. release of Trashmaster was Jan 23 1992.
  36.  
  37. WHY
  38. ===
  39.  
  40.    I had always wanted to write something like this but until now, I couldnt
  41. do it.  Not that it was particularly easy to do, even under Workbench 2.0.
  42.  
  43. How I did it
  44. ************
  45.  
  46.    The main problem is with getting finicky old Workbench to stay "in sync"
  47. with the filing system..  IE, removing its icons when a file is deleted.
  48. Thanks to a new function called `DeleteDiskObject()', it's possible to get
  49. workbench to remove an icon.  Unfortunately Workbench still is kinda
  50. brain-dead...  when you have it display ALL files, it spontaneously creates
  51. icons in memory for files that dont have them...  which results in
  52. `DeleteDiskObject()' not working (no file on disk) and Workbench not
  53. removeing the icon.  The only solution I could come up with is to
  54. `PutDiskObject()' and then delete this icon, which works more or less
  55. pretty well.  There are still, however, problems.  Workbench, it seems,
  56. will "lock" a directory if its window is open on the Workbench screen.
  57. This means I can't delete it until it's closed...  not too big a deal,
  58. since when you delete the icon the window closes automaticaly.  But what if
  59. something *else* has that directory locked?  Then I couldn't delete it
  60. after all...  that means I need to put the icon back!  heheh.  But I think
  61. I've come up with a good solution.
  62.  
  63.    Another problem is that there's no way to find out where the AppIcon is,
  64. within the WorkBench window -- so there is no way to implement a snapshot
  65. option within your application (of course, the root problem is that
  66. Workbench doesn't provide any way to "hook" into the Workbench operations
  67. like snapshot, info, etc.  See below for my solution to this).
  68.  
  69.    This seems like a good place to voice some opinions on Workbench 2.0, and
  70. what I'd like to see in the future.
  71.  
  72.    Wish list
  73.  
  74. Wish list
  75. *********
  76.  
  77.    * DiskObjects should be a BOOPSI class.
  78.  
  79.         * A BOOPSI class would have methods for all the normal Workbench
  80.           operations; like info, double click, delete, snapshot, copy/move,
  81.           etc.  That way, an AppIcon could give an "about" requester with
  82.           the info menu function, and behave in every way just like a
  83.           regular icon.  Say you had an icon for a network machine...  info
  84.           could put up a requester saying what the node's name was, CPU
  85.           class, whether it was Ethernet or serial, etc.  neat huh?  A
  86.           Drawer could open it's own type of list window..  perhaps one
  87.           with a "tree" display.  You could replace the standard operation
  88.           with new ones (via hooks into the DiskObject class).  This makes
  89.           Workbench extremely flexible and extendable and would allow third
  90.           party people to add tons of functionality to Workbench (I should
  91.           be able to make Workbench as powerfull as DiskMaster or DirOpus!)
  92.  
  93.         * This BOOPSI icon would be able to have more than just a bitmap
  94.           image; like actual structured drawing objects.  Of course, this
  95.           introduces the problem of how to store objects on disk..  which I
  96.           myself am working on.
  97.  
  98.         * *Any* application would now be able to use icons easily (they
  99.           dont have to have anything to do with Workbench).  You could even
  100.           drag icons *from* an application *to* a Workbench window to save
  101.           a file.
  102.  
  103.    * Clipboard support, with a "view clipboard" window.
  104.  
  105.    * Definable default tools for projects, with file recognition so it knows
  106.      what tool to run (in case there's no icon or the normal tool cant be
  107.      found).  And how about a small database that contains application
  108.      names and then a path to where it is?  Actualy, I guess you could have
  109.      a "Applications" directory, with icons that are linked to whereever
  110.      the app is -- and Workbench would check here first for tools.
  111.  
  112.    * "Left out" icons could be done in the same way, so that the app's icon
  113.      is still visible in it's Drawer, and so that Snapshoting the left out
  114.      icon doesn't ruin it's original coordinates.
  115.  
  116.    * Something needs to be done about the list windows..  they are slow and
  117.      clumsy, and are missing what I think is a great feature:  a "Tree"
  118.      mode.
  119.  
  120.    * Better tracking of when other apps change/add/delete files.
  121.  
  122.    OK, I'll step down off my soapbox now!
  123.  
  124. Using Trashmaster
  125. *****************
  126.  
  127. Usage
  128. =====
  129.  
  130.    To run Trashmaster, simply double click its icon, or run it from a CLI
  131. (it will detach from the CLI of course).  Obviously, Workbench must be
  132. running (and will be, unless you were naughty and modified your
  133. startup-sequence).  Trashmaster will open an icon on the Workbench screen;
  134. this icon will look the same as the icon you ran Trashmaster from.  If you
  135. want to change it, you can, by modifying the Tooltypes in Trashmaster's
  136. icon (see below about the Tooltypes available).  BTW, the icon is supposed
  137. to look like a black hole...
  138.  
  139.    If you want to be able to format disks with Trashmaster, you must have
  140. `WBStart-Handler' installed in your `L:' directory.  The WBStart-Handler is
  141. included with ToolManager, a must-have utility, or in it's own separate
  142. distribution, both of which should be available on a Fish disk or any good
  143. FTP site, or failing that, from me.  ToolManager and WBStart are Copyright
  144. (C) 1991-93 Stefan Becker.  The default formating program is the same as
  145. Workbench's formatter.
  146.  
  147.    To use Trashmaster, simply drag files and drop them on the icon.  A
  148. requester will come up, similar to Workbench's Delete confirmation
  149. requester.  If you really want to delete the file(s) or dir(s), click `OK';
  150. if not, hit `CANCEL'.  Remember, once you hit `OK', the files are deleted..
  151. they're *gone*!  For reals.  Not like the Trashcan.  If you have the
  152. `VERIFY=OFF' tooltype set, you *won't* get this requester!
  153.  
  154.    One difference from the Workbench Delete, is the extra option for
  155. Interactive deletion.  With interactive delete, you will get a confirmation
  156. requester for each file you dropped into Trashmaster.  For each file, you
  157. can choose to either delete it, delete all the rest of the files
  158. non-interactively, skip this file, or abort completely.
  159.  
  160.    If Trashmaster comes across a file that is protected from deletion, it
  161. will bring up a requester with two options, `FORCE' and `CANCEL'.  If you
  162. select `FORCE', Trashmaster will un-protect the file and delete it!
  163. Selecting `CANCEL' will of course cancel the operation.  If you have the
  164. `FORCE=ON' tooltype set, you *won't* get this requester, the file will
  165. simply be deleted without warning.
  166.  
  167.    To quit Trashmaster (which you dont really want to do, do you?  :),
  168. double click the AppIcon and select the remove option.
  169.  
  170.    If you want Trashmaster started automaticly (you DO, dont you?), place it
  171. into the "WBStartup" drawer on your boot disk.
  172.  
  173. Tooltypes.
  174. ==========
  175.  
  176.    There are 8 Tooltypes you can add/modify:
  177.  
  178. `X=<##>'
  179.      This is the X coordinate of the icon.  A -1 will tell workbench to
  180.      find a suitable place for the icon.
  181.  
  182. `Y=<##>'
  183.      This is the Y cooridnate of the icon.  A -1 will tell workbench to
  184.      find a suitable place for the icon.
  185.  
  186. `ICON=<name>'
  187.      This is the name of a custom icon to be used instead of the default
  188.      icon (the default being Trashmaster's icon)
  189.  
  190. `NAME=<name>'
  191.      Set this to change the name under Trashmaster's AppIcon.
  192.  
  193. `FORMATTER=<name>'
  194.      Set to the name of the disk-formatting program of your choice.  The
  195.      program will be started as a Workbench application and passed the disk
  196.      icon to format.
  197.  
  198. `VERIFY=<ON|OFF>'
  199.      If set to `OFF', the initial verification requester will *not* appear.
  200.      If set to anything else, or not present, verify will default to `ON'.
  201.      The action performed will be the one defined by the `TYPE' tooltype.
  202.      Use at your own risk.
  203.  
  204. `TYPE=<INTERACTIVE>'
  205.      Applicable only when `VERIFY=OFF' is set.  If set to `INTERACTIVE',
  206.      deletes will default to interactive deletes (requireing confirmation
  207.      for every file and directory).
  208.  
  209. `FORCE=<ON|OFF>'
  210.      If set to `ON', files that have their protection flags set to
  211.      delete-protected will be deleted without warning.  If set to anything
  212.      else, or not present, you'll get a requester whenever you try to
  213.      delete a protected file.
  214.  
  215.    `VERIFY', `TYPE' and `FORCE' can work in conjuction.  If you don't want
  216. *any* anoying verification requesters, you can turn `VERIFY' off, `TYPE' to
  217. nothing (leave it out), and `FORCE' on.  If you always want interactive
  218. deletes, have `VERIFY' off but `TYPE' set to `INTERACTIVE'.
  219.  
  220.    Be carefull with these!  If you turn off verification and use the
  221. `FORCE' option, anything that gets dropped on TrashMaster will be simply
  222. deleted without warning, even if it's protected from deletion.
  223.  
  224.