home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / misc / trashit.lha / TrashIt.doc < prev    next >
Text File  |  1992-08-15  |  7KB  |  143 lines
  1.                 TrashIt
  2.  
  3. TrashIt is a Commodity to supplement the TrashCan and the Delete... command
  4. from the Icon menu.  It has two basic functions, which you can mix and match
  5. according to your desires.
  6.  
  7. (1) It can start an AppIcon on your WorkBench screen, onto which you can drop
  8. files.  It will immediately delete the file(s), or drawer(s) and all of their
  9. contents, without showing a requester to make sure you didn't mess up and
  10. without storing them on your disk until you tell it to Empty the Trash.  The
  11. only exception to this is that it will NOT delete files that are protected.
  12.  
  13.               !!! So Be Careful !!!
  14.  
  15.     Do not drop anything on the AppIcon unless you absolutely
  16.     want it out of your life _NOW_.  If you delete any files
  17.     accidentally, it's your fault, not mine...
  18.     
  19. (2) It can also keep an eye on any directory you want.  You can either have
  20. it immediately delete all the files in the drawer every time you copy a file
  21. into it, or delete all the files in the drawer after a certain amount of
  22. time elapses.  This is basically so you can tell it to watch your TrashCan
  23. drawer and have it delete the files immediately or every so often.
  24.  
  25.             !!! Again, Be Careful !!!
  26.             
  27.     TrashIt will completely empty this drawer.  Not just the
  28.     new files in the drawer will be deleted.  Note that if you
  29.     don't specify a time interval, then this option is almost
  30.     exactly like the AppIcon, with the exception that dropping
  31.     a file from another device (disk drive) will not delete the
  32.     original file, just the copy made by WorkBench.  It is easy
  33.     to forget that TrashIt is keeping an eye on this drawer,
  34.     because there is no visual clue except perhaps the AppIcon.
  35.     
  36.  
  37. Anyway, TrashIt can be run from either a CLI, shell, or WorkBench. It is not
  38. resident, so if you want your shell back, you have to
  39.  
  40.     RUN >NIL: <NIL: TrashIt
  41.  
  42. or whatever is appropriate for your setup.  There are currently five
  43. arguments, which can be given either on the command line or in the TrashIt
  44. icon ToolTypes using the Information... command from the Icon menu.  They
  45. are:
  46.  
  47. ICONXPOS=    This option lets you specify the x coordinate of the TrashIt
  48.         AppIcon.  If you don't specify a valid position, or the
  49.         position you specify is over another icon, the icon will be
  50.         placed in the next available spot on the screen.
  51.         Example:  ICONXPOS=200
  52.  
  53. ICONYPOS=    The same as ICONXPOS, except that this is for the y
  54.         coordinate of the TrashIt AppIcon.  I know, this is terribly
  55.         confusing, but stick with me...
  56.         Example:  ICONYPOS=100
  57.  
  58. ICONNAME=    This option lets you specify the name of the AppIcon. If you
  59.         don't specify a value, the name of the icon will be the name
  60.         of the program (i.e., TrashIt).  If you set ICONNAME to OFF,
  61.         then there will be no AppIcon.
  62.         Example:  ICONNAME=MyTrashCan
  63.  
  64. TRASHDIR=    This option lets you specify the name of the drawer to use as
  65.         an automatic disposal.  I you do not specify a drawer, then
  66.         there will be no automatic disposal drawer.  
  67.         Example:  TRASHDIR=Sys:TrashCan
  68.  
  69. EMPTYTIME=    This option lets you specify the time, in minutes, that
  70.         TrashIt will wait before it empties the TRASHDIR.  If you do
  71.         not specify a time, or if the time is not more than zero
  72.         minutes, then TrashIt will empty the TRASHDIR whenever you
  73.         add or delete a file from that dir.  If you use this option,
  74.         TrashIt will flash the screen and beep twice before it
  75.         deletes anything.
  76.         
  77.             !! Flash...Beep...Delete !!!
  78.                 
  79.     If your screen flashes and/or beeps twice, DO NOT reboot or
  80.     turn off your computer.  Give TrashIt a little time to take
  81.     care of business.
  82.         
  83.         This is to give you warning so you don't reboot or power off
  84.         while TrashIt is deleting your files, because this could
  85.         corrupt your disk.
  86.         Example:  EMPTYTIME=30
  87.  
  88. If you forget these options, typing a question mark (?) in the command line
  89. will give you a template.  These tooltypes should already be present in the
  90. TrashIt icon ToolTypes.  The DONOTWAIT ToolType should also be present so you
  91. can simply copy TrashIt to the WBStartup drawer of your system disk.  Note
  92. that if you run TrashIt from a shell, it will only read options from the
  93. command line, not from the icon, if one exists.
  94.     
  95. If the TrashIt icon exists (in the drawer where TrashIt resides), TrashIt
  96. will use that icon image for its AppIcon.  Otherwise, it will use the
  97. standard TrashCan icon found in the Amiga ROMs.  If that somehow does not
  98. exist, there will be no AppIcon.
  99.  
  100. NOTE:     TrashIt requires the Delete command to be present in C:.  This should
  101.     be no problem, I hope.  I also hope to change this in future
  102.     versions.
  103.     
  104. Assuming TrashIt is up-and-running, whenever you want to immediately delete a
  105. file from WorkBench, simply drag it onto the TrashIt AppIcon (if there is
  106. one).  The file and it's icon will be deleted, but the icon will not
  107. disappear.  Select Update from the Window menu if you want to update the
  108. display.  If you have the EMPTYTIME option set, it is usually a better idea
  109. to drop files that you want to delete into the TRASHDIR.  This gives you a
  110. little time to change your mind in case you messed up.  The only reason to
  111. use the AppIcon is if you absolutely need the space on your disk right away,
  112. or if you are absolutely sure you don't need the file.
  113.  
  114. To quit TrashIt, simply double click on its AppIcon or send it a Control-C.
  115. From the CLI, you can just hit Control-C or use the Break command if you
  116. used Run to start TrashIt.  And, of course, since TrashIt is a Commodity,
  117. you can use the Commodities Exchange program to Enable, Disable, or Kill
  118. Trashit.
  119.  
  120. Also, TrashIt will exit by itself if there is no AppIcon and no TrashDir.
  121.  
  122. One final note: this is version 1.0 of this program.  What that means is that
  123. there are certain to be bugs, which, in a program like this, could be very
  124. dangerous.  Please cease to use it if you notice any strange behavior, and
  125. PLEASE send me any bugs you find.  I really hope you don't lose an files
  126. because of this program.  Please don't use it if you do not have backup
  127. copies of all your files.  Rest assured, though, that I use this program
  128. regularly, so I will find and fix any bugs that may exist.
  129.  
  130. Benbuck Nason
  131. 1156 High St. - Oakes #608
  132. Santa Cruz, CA 95064
  133.  
  134. email:  torp@cats.ucsc.edu
  135.  
  136. I'm also on Cal's Amiga Den (408-688-4074) as Ben Nason.
  137.  
  138. So, this program is completely freely distributable, but please be sure to
  139. include this document if you distribute the program, so that nobody has to
  140. experiment with this and end up erasing an entire disk.  (Easy to do - just
  141. drop a disk onto the AppIcon.)  You don't have to send me anything except
  142. bug reports and suggestions for future versions.
  143.