home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 2 / FFMCD02.bin / new / amigalibdisks / disk946 / trashicon / trashicon.doc < prev    next >
Text File  |  1993-12-21  |  14KB  |  323 lines
  1.  
  2.                   TrashIcon V2.2  © 1993 Mark McPherson
  3.                  =======================================
  4.  
  5. Overview
  6. ========
  7.  
  8.    TrashIcon is a program which places an icon on the WorkBench, and will
  9. delete any files dragged to that icon by the user - ie it uses the WB2
  10. feature of AppIcons.  Because of this it will only work under WB2.04 and
  11. above.
  12.  
  13.    The standard trashcan in use on the Amiga has several difficulties.  It
  14. can only delete files on the disk containing the trashcan, and also doesn't
  15. delete files immediately.  TrashIcon overcomes these difficulties.
  16.  
  17.    TrashIcon is highly configurable and gives the user great flexibility
  18. over what is deleted.  It will, unlike some other similar programs, keep
  19. the WorkBench in step with what you are deleting.  You can also format disks
  20. either quickly or fully.
  21.  
  22.  
  23. Distribution
  24. ============
  25.  
  26.    All code is Copyright © 1993 Mark McPherson.  It may be copied and
  27. distributed so long as no commercial profit is made out of it.  it may not
  28. be modified, sold, or included in any commercial distribution without my
  29. written permission.  Public Domain vendors are not allowed to sell this
  30. program for more than the price of a regular disk, which should be no
  31. more than the equivalent of 5 Dollars.  The author takes no responsibility
  32. for any loss or damage resulting from the use of this program.
  33.  
  34.    This distribution should contain the following files:
  35.  
  36.       TrashIcon
  37.       TrashIcon.info
  38.       TrashIcon.doc
  39.       TrashIcon.doc.info
  40.  
  41. though they may of course be archived with a program such as LhA.
  42.  
  43.  
  44. Installation
  45. ============
  46.  
  47.    TrashIcon works best when started from the WBStartup drawer of your
  48. boot disk.  It can also be started simply by double clicking on the
  49. TrashIcon program icon.  It should not be started from the CLI.
  50.  
  51.    To automatically run, simply copy the program and its icon to the
  52. WBStartup drawer.  Otherwise just copy them to where you want the program
  53. to reside.  Make sure that the program and its icon stay together else
  54. TrashIcon will most likely fail to work.  You can copy the documentation
  55. to anywhere you like, or simply deleted if you never want to use it again.
  56.  
  57.  
  58. Usage
  59. =====
  60.  
  61.    TrashIcon has many different features available making it flexible
  62. and configurable to how you want to use it.
  63.  
  64.    The icon that is placed on the WorkBench is simple the program icon,
  65. and may be changed if you don't like the icon supplied.  All of the
  66. program options are set by the icon's ToolTypes, but can be changed and
  67. set completely from within the program.  The position of this icon can be
  68. set on the WorkBench if you want.
  69.  
  70.    The main use of TrashIcon is obviously to delete files.  This is done
  71. by dragging an icon (or selection of icons) of the objects to delete, to
  72. the icon on the WorkBench.  If you drag a disk icon to TrashIcon, then
  73. you will be given the option of formatting that disk.  You can choose, if
  74. the confirm option is set, to delete some or all of the files you have 
  75. dragged.  If you drag a drawer, you can choose to delete both the drawer 
  76. and all its contents or only delete it if it is empty. Some files may be
  77. protected from deletion and you can choose whether you want to delete
  78. these automatically, not delete them, or be asked whether you want to
  79. delete them.
  80.  
  81.    By double clicking on the TrashIcon icon, you will bring up an options
  82. window where you can change the current settings of the program.  You can
  83. also make these changes permanent or simply temporary, or even forget them.
  84. Repeatedly double clicking on the icon will close and reopen this window.
  85. Note that while this window is open you can still drag icons to be deleted
  86. to the TrashIcon on the WorkBench, or even drag them into the window itself.
  87. It is this feature which is one of the major differences between this version
  88. of TrashIcon and earlier versions, or other similar programs.
  89.  
  90.  
  91. Options
  92. =======
  93.  
  94.    TrashIcon has many different options, all of which may be changed from
  95. its options window.  Each option is detailed below.
  96.  
  97.    The window itself is controlled by clicking on the buttons marked:
  98.  
  99.        QUIT - this will cause TrashIcon to finish all deletion of files
  100.               and then close the window, remove the icon, and quit.
  101.  
  102.       ABOUT - this will bring up an "about" requestor with details about
  103.               the version of the program etc.
  104.  
  105.         USE - this will close the options window, retaining any changes
  106.               to the current options that you have set.
  107.  
  108.        SAVE - this will cause the current options to be saved, so that the
  109.               next time TrashIcon is run, those will be the default options.
  110.               It also saves the current position of the options window.  This
  111.               is all done by setting the ToolTypes of the program icon.  You 
  112.               should never have to set these manually, except to add those
  113.               such as DONOTWAIT which are used by the WorkBench and
  114.               not TrashIcon.  Clicking on this button will also close the
  115.               options window.
  116.  
  117.      CANCEL - this will close the options window and revert to the original
  118.               settings before the window was opened.
  119.  
  120.  
  121.      Icon X Position - this is the horizontal coordinate on the WorkBench
  122.                        of TrashIcon's icon.  If something else occupies 
  123.                        this position then the WorkBench will decide where
  124.                        to put the icon.
  125.  
  126.      Icon Y Position - same as above, but for the vertical coordinate.
  127.  
  128.            Icon text - this is the text that appears below the icon on
  129.                        the WorkBench.  It defaults to the program name,
  130.                        but can be changed to anything else, including
  131.                        a blank name.
  132.  
  133.          Open Window - if this is set, then when the program is started,
  134.                        the options window will open immediately.
  135.  
  136.    Ignore Protection - this is set to what should happen if you try to
  137.                        delete a file that is protected from deletion.
  138.                        if set to ASK, then you will be given the option
  139.                        of deleting the file.  If set to YES, then such
  140.                        files will always be deleted.  If set to NO, then
  141.                        such files will never be deleted.
  142.  
  143.     Recursive Delete - if this is set, then when you drag a drawer to
  144.                        TrashIcon, both it and its contents will be 
  145.                        deleted.  If not, then the drawer will only
  146.                        be deleted if it is empty.
  147.  
  148.     Confirm Deletion - if this is set, then before any deletion takes
  149.                        place, you will be given the choice of either 
  150.                        continuing (OK) in which case the deletion will 
  151.                        take place as normal, stopping (CANCEL) and not
  152.                        deleting anything, or CONFIRM EACH where you
  153.                        will be asked before deleting every file.  If
  154.                        CONFIRM EACH is selected, then for every file you
  155.                        will be asked if you want to delete that file and
  156.                        continuing (YES), deleting that file and every one
  157.                        after it without any more prompting (ALL), not
  158.                        deleting that file and continuing (NO), or stopping
  159.                        at that point (NONE).
  160.  
  161.  
  162. Technical Notes
  163. ===============
  164.  
  165.    To delete a particular file, TrashIcon goes through the following steps:
  166.  
  167.  - it will first check if the file has an icon.
  168.  - if so then it will delete the file and its icon.
  169.  - if it is a drawer, and WorkBench has its window open, then TrashIcon will
  170.    first delete the icon in order to get WorkBench to close the window. It
  171.    will then try to delete the drawer.  If it still can't delete the drawer,
  172.    then it will put the icon back.
  173.  - if the file has no icon or if it is an icon with no associated file then
  174.    it will delete this.
  175.  - if the object is a drawer icon but there is no associated drawer, then 
  176.    TrashIcon will open its options window.  This isn't a bug in TrashIcon, 
  177.    but an unfortunate side-effect of the way WorkBench tells TrashIcon what
  178.    to de