==================================== X-Trash v1.2 The trashcan maintenance utility © 1994/95 by Rudi Chiarito ==================================== Contents ^^^^^^^^ 1. Introduction 2. Usage 3. Odds and ends 4. Program history Remember... "Most people don't act stupid: it's the real thing!" - Alfred E. Neuman * · * · * · * · * · * · * · * · * · * · * · * · * · * /* *\ * 1 * Introduction \* */ ^^^^^^^^^^^^^^ 1.1. Preface ^^^^^^^^^^^^^^ The programs and files in this distribution are FREEWARE. That is: they are copyright © Rudi Chiarito, but they may be freely distributed as long as no more than a nominal fee is charged to cover distribution costs. Moreover they can't be distributed separately or in a commercial package without written permission from the author. That's all. 1.2. I'm Trash, X-Trash ^^^^^^^^^^^^^^^^^^^^^^^^^ NOTEZ BIEN: This mighty program was born thanks to an interesting article by one Digito, "Data e Trashcan", which appeared in the May 1994 issue of the italian "Amiga Magazine". A big thank you is due. How many Amigans actually use the notorious Trashcan? Is it any good? As to me, I could have been using it the first two-three times I toyed around with my old, luxuriant A500; i.e., a long long long time ago. It's unlikely a coincidence that hardly anybody uses the Trashcan drawer on the Amiga. Its use is anything but handy and here are some of the reasons: · Unlike the Mac, Amiga places the Trashcan drawer in the disk's root directory window (it would be far better if it could be left out) · A Trashcan is tied to the volume it is on: there must be a Trashcan for each of the mounted volumes · As a consequence, if you drag (e.g.) "Antani:Blinda/Patuo/Cuda" in the "Work:" Trashcan, it will simply be copied to the "Work:Trashcan" drawer, instead of being moved to "Antani:Trashcan/Cuda". · If (e.g.) you need to empty the "Work:" Trashcan, you'll have to open the root directory window of "Work:", click on "Trashcan" and then select the menu item "Icons/Empty trash..." · After all, many people have got used to live without the Trashcan, simply by deleting the file(s) Have you got enough of it? Never mind: X-Trash is here (to stay!). If you would like to use the Trashcan without worries, this brilliant program will be the answer to all of your needs (at least that's what I hope). /* *\ * 2 * Usage \* */ ^^^^^^^ 2.1. Requirements ^^^^^^^^^^^^^^^^^^^ X-Trash has no special requirements: it needs 2.0+ OS and (if you want to choose from the requester the Trashcans to be emptied) reqtools.library V38+ (by Nico François). Since it adds an AppIcon and an AppMenu to the WB, it also needs the Workbench to be running at launch [lunch? :)] time. As of v1.1, it also supports localization. 2.2. Installation ^^^^^^^^^^^^^^^^^^^ Pretty tricky, this. Just drag the icon wherever you want. That's all. In order to have the program running automatically upon every reboot, move the icon into the WBStartup drawer. 2.3. Getting started ^^^^^^^^^^^^^^^^^^^^^^ When run, X-Trash will show up a new, gaudy, icon in the main Workbench window. Drop the icons you want to get rid of on it: you can use multiple selection, if you want. It will also accept icons from different drawers/ volumes. Icons will then be moved from their original place to the correspondent Trashcan. Try and have a good look at the "Tools" menu. You should notice a new item, called "Empty trashcan(s)...". A requester will pop up asking you how many trashcans you're going to flush. · "All" · "Many" If you've selected one/more volume icons, it'll empty the correspondent Trashcan(s). It ONLY WORKS WITH VOLUME ICONS: directories or files just won't do! If you have selected no icons, it'll pop up a volume requester, which will show you ONLY those volumes whose Trashcan is not empty. Choose the volume whose Trashcan you want to empty. It will carry on asking you volumes until you enter an empty string, close the window or select the "Cancel" gadget. · "One" It's pretty similar to "Many". If you've selected one or more icons, it will behave as above. If you have selected no icons, it will pop up the requester just once. · "Multiple" Pretty useless this. It can be handy only with removable devices (e.g. floppies). It will pop up the volume requester. Select a suitable device: its Trashcan will be wiped. A requester will appear: insert one by one the disks whose Trashcans you want to be emptied. Click on "Cancel" when you're done with it. It was urgently demanded by Michele "King of the Trash" Nappa, but one day probably it will be pitilessly removed. Is it any good to you? NOTEZ BIEN: At the moment it seems like there's no way to notify WB when a file without the .info file has been modified/moved/deleted. Therefore, WB won't update correctly such files (you can easily tell'em: they only appear if you selected the menu item "Windows/Show/All files"). In a nutshell: you have opened the "Work:Trashcan" drawer and "Windows/Show/All files" is selected. If you tell X-Trash to empty it, some of the icons may still be there, even if they've been successfully deleted. That's because those files don't have a real icon, which is simulated by WB by using a fake one. WB should be notified when an icon has to be modified/moved/deleted, but since there's no real one, there will be no notify: i.e., no update, the icon will stay there. Hint #1: use only files with real icons. Hint #2: select the Trashcan window and then the menu item "Windows/Update". If you had opened any of the Trashcan subdirectories (provided they exist), you could have to repeat the operation for each of them. Hint #3: Do not open Trashcan subdirectories. You're supposed to use X-Trash because you're too lazy... Well, so be it! 2.4. Kiss my ass goodbye ^^^^^^^^^^^^^^^^^^^^^^^^^^ Double-click on the X-Trash icon (be it the AppIcon or the real one) and it will remove itself from memory. 2.5. Tool Types ^^^^^^^^^^^^^^^^^ Version 1.1 adds support for two Tool Types: · CONFIRM If set to YES or ASK, X-Trash will ask you for a confirmation before flushing a Trashcan. Defaults to NO. · PROTECT If set to ASK, X-Trash will ask you for a confirmation before resetting delete-protection on a file/directory. IF set to YES, it will always make sure the file/drawer is delete-able. Defaults to NO. /* *\ * 3 * Odds and ends \* */ ^^^^^^^^^^^^^^^ 3.1. X-Trash: the making ^^^^^^^^^^^^^^^^^^^^^^^^^^ X-Trash was written using Amiga-E v3.1 by Wouter van Oortmerssen. I wrote the Assembly port but the source is strangely hiding itself somewhere... as soon as I find it, I will release vX.Ya (where 'a' means 'Assembly-coded'!). If you have translated the catalog file, please send it to me: it will be included in the next release! By the way, here's a $29.000.000.000.000.000 question... Does anybody how to notify WB when a fake icon (i.e. which has no .info file) has been modified? Help me! 3.2. Acknowledgements ^^^^^^^^^^^^^^^^^^^^^^^ I would like to thank... · Commodore-Amiga... · Wouter van Oortmerssen... · Nico François... · Michele Nappa... Beta-testing, whatever that means to him (and me) · Cinzia Montuori... Unconscious bug-fixing suggestions! (she's NOT my girl/woman/wife!) · Sting, D. Fagen, Queen, D. Bowie, G. & P. Conte, Yes, Bangles, INXS, Elio e le storie tese, Dire Straits, Cure, D. Byrne, W.A. Mozart, B52's, Toto, L. Dalla, The Who, J.M. Jarre, Fleetwood Mac, L. van Beethoven... · D. Adams, M. Serra, K. Vonnegut, A. Rice, E. Queen, H. Hesse... · Elaine... Kimi wa kizi o kaita ka... tonikaku watasi wa kimi o ai suru! Their contribution has been invaluable to the development of this program! 3.3. Future improvements ^^^^^^^^^^^^^^^^^^^^^^^^^^ "If it's a future world we fear We have tomorrow's seeds right here For you can hold them in your hand Or let them fall into the sand" - Sting Any suggestions, as usual, would be very appreciated. Meanwhile *please* also check its stability and let me know about it... 3.4. The author ^^^^^^^^^^^^^^^^^ This program is FREEWARE. I don't ask anything, but if you like, you can send me PD programs, sources, money (why not?) or anything you can think of (I'd like to receive sweetmeats, anyway). Oh, yes, you can send me nice postcards, too. Here's my address... of course you can also send me suggestions, comments, questions, bug reports (Aaaaargh! God Forbid()!) and gossips! Email is far better: I study in Pisa (550kms from home) and most of the time I'm there. As if it weren't enough, mail delivery in Italy is sooooo sloooooooooooow... SnailMail: Rudi Chiarito Via Malpighi, 8 I-80014 Giugliano (NA) E-Mail: chiarito@cli.di.unipi.it WorldWideWeb: http://www.cli.di.unipi.it/~chiarito/ IRC: Nutello (Ooops, I almost forgot: excuse me for my bad English!!!) /* *\ * 4 * Program history \* */ ^^^^^^^^^^^^^^^^^ **************************************************************************** * v. 1.00 [1.000] - 27/06/94 - First public release!!! * * · Code cleanup. * * · Fancy icon (by Michele) added. Don't put the blame on me! * * == - == - == - == - == - == - == - == - == - == - == - == - == - == - == * * v. 1.10 [1.042] - 13/7/94 - First public update!!! * * · Added CONFIRM and PROTECT Tool Types support. * * · Improved WB icon update upon deletion. * * · Added locale.library support * * · New icon design. Now you can put the blame on me... * * == - == - == - == - == - == - == - == - == - == - == - == - == - == - == * * v. 1.10+ [1.043] - 26/2/95 * * · Recompiled using AmigaE v3.0a. Program size is 1400 bytes shorter!!! * * == - == - == - == - == - == - == - == - == - == - == - == - == - == - == * * v. 1.2 [1.045] - 13.6.95 * * · Removed a nasty BUG which appeared when CONFIRM was on * * · Now adds just ONE AppMenu which pops up a requester * **************************************************************************** * akes it possible! Only Amiga makes it possible! Only Amiga makes it poss * **************************************************************************** * · * · * · * · * · * · * · * · * · * · * · * · * · * "Per fortuna che c'è uno Legge solo la Sacra Bibbia Ore ed ore, notte e giorno Ha un'indice d'ascolto fra i più bassi · *** · *** Ma pazienza..." · * · * · * · * · * · * · * - Giorgio Conte & Elio e le Storie Tese · * · * · ** · * · * · * See you at the Restaurant at the End of the Universe! · **** · **