═══ 1. Title Page ═══ Workplace Shell TrashCan Version 2.7.1 (c) Kai Sommerfeld 1993-2000 ═══ 2. License Agreement ═══ Workplace Shell TrashCan is shareware. You are allowed to test and use this program for 30 days. You must register TrashCan if you wish to continue using it after 30 days. You may freely distribute the shareware version of TrashCan, but only the complete and unaltered distribution archive. You may install the registered version on more than one machine, but your copy may be used on only one machine at a time. If you run TrashCan on more than one machine at a time, you must register additional licenses. The author does not guarantee the correctness of the program. The author may not be held responsible for any loss of data or other damages caused by the use of TrashCan. The author does not guarantee that the program can be used for a specific purpose. If you wish to distribute the program in conjunction with commercial software or hardware, you must have written permission of the author to do so. A license is always a version license. It is valid for all versions of the program that have the same major version number. You must acquire a new license when upgrading to a new major version. You are not allowed to give a registration key to third parties. A word to shareware: Developing TrashCan has taken much of my spare time. Consequently, I decided to release all new versions as shareware with some restrictions to encourage registration. How to register: Information on how to register and Order Forms can be found in the file Register.TXT provided as part of WPS TrashCan's distribution archive. Simply complete one of the order forms and send it to the appropriate address. Once I have received the registration fee, you will get a unique registration number used to remove the shareware restrictions from TrashCan. All users who sent me a postcard for any 1.x version of WPS TrashCan until September 11, 1995 can register for free! Just let me know that you've already sent a postcard and that you want to register for free. If I really did get your card, you will receive your registration information as soon as possible. Thank you once again for supporting TrashCan! ═══ 3. Shareware Restrictions! ═══ The unregistered version has a few restrictions that make TrashCan a little less convenient, but allow you to evaluate all the features. After every system reboot, the settings for user defined icons, capacity, and most trash options will be reset to default values. Using DeskMan/2 or Object Desktop's Object Packages to restore any of the settings mentioned above is not possible. However, any Trashed objects will never be deleted without confirmation as a result of these restrictions. ═══ 4. Trademarks ═══ The following terms used in this book are trademarks of companies as follows. Other trademarks are trademarks of their respective companies. IBM International Business Machines Corporation OS/2 International Business Machines Corporation System Object Model International Business Machines Corporation Workplace Shell International Business Machines Corporation MMPM/2 International Business Machines Corporation Macintosh Apple Computer, Inc. Lotus SmartCenter Lotus Development Corporation OS/2 Essentials Stardock Systems, Inc. (SDS) Object Desktop Stardock Systems, Inc. (SDS) DeskMan/2 Development Technologies, Inc. (DevTech) ═══ 5. Introduction ═══ TrashCan is a replacement for the OS/2 Warp Version 3 (or higher) Shredder object. It brings a Macintosh-like trash can to your desktop. Unlike the Shredder, TrashCan won't immediately delete objects dropped on it. You can delete them yourself later, or configure TrashCan to delete them according to options in its settings notebook. This way, you will be able to recover Trashed objects and get them back for normal use. TrashCan features:  Use of 3 different icons to easily detect the current state of TrashCan. These icons can be replaced by your own favorites.  Additional drag and drop features like 'Shred objects on drop' or 'Remove objects from LaunchPad'.  Modified views providing information about Trashed objects, current size of trash, number of Trashed objects, and more.  Ability to restore Trashed objects to their original location.  Destruction of objects which are generally not deletable.  Capacity adjustable from 1 MByte to 'Unlimited'.  Ability to delete old Trashed objects automatically when the capacity set is exceeded.  Ability to delete old Trashed objects automatically after an adjustable time period.  You may select the drives to be supported by TrashCan.  Interception of 'Delete' operations for ALL WPS objects. When activated, objects will not really be deleted but appear in TrashCan.  Optional use of MMPM/2 system sounds when adding new objects, empty trash, etc.  Interface to DeskMan/2 and Object Desktop's Object Packages to backup and restore ALL the common and private settings of TrashCan. How TrashCan differs from Undelete programs: Only Workplace Shell software can deal with every object on your desktop. TrashCan not only handles files and directories but also recognizes other objects such as shadows, program objects, and color palettes, ... which are not represented by files on any storage media. ═══ 6. System Requirements ═══ To use Workplace Shell TrashCan you need OS/2 Warp Version 3 (or higher). It will not run on previous versions of OS/2. Why? 1. It is an application based on IBM's System Object Model Version 2 (SOM2), first introduced in Warp. 2. It uses several methods, API calls, etc., which are new in Warp. 3. The TrashCan library file is compressed using an algorithm unknown in OS/2 2.x. It cannot be loaded by operating system versions older than Warp. It wasn't easy deciding not to support OS/2 2.x. But only Warp offers all the programming stuff I needed for TrashCan's sophisticated feature set. There was no other way, unfortunately. ═══ 7. Installation, Uninstallation And Update ═══ This section describes how to install, uninstall and update Workplace Shell TrashCan. Important Note: Being a Workplace Shell class and not a 'normal' application, TrashCan requires special installation and uninstallation procedures. Please use the Installation Utility (InstUtil.EXE) only to perform these actions. ═══ 7.1. Installation ═══ Before you install Workplace Shell TrashCan make sure ALL files of the TrashCan distribution package are located in the same directory. To install, follow the steps below:  Run InstUtil.EXE from the OS/2 Command Prompt or double-click the InstUtil.EXE icon.  Adjust the installation path to where you want to keep the files belonging to WPS TrashCan.  In the WPS objects field, type in the directory where you want to create the TrashCan object and the object for the on-line documentation. The default is your desktop.  Push the Install button.  All necessary files will now be copied to the selected destination, the class library will be registered with WPS and the new objects will be created.  If requested to reboot, please do so. ═══ 7.2. Uninstallation ═══ To uninstall Workplace Shell TrashCan, do the following:  Run InstUtil.EXE from the OS/2 Command Prompt or double-click the InstUtil.EXE icon.  The program detects automatically whether WPS TrashCan is already installed.  Push the Uninstall button.  All files installed along with TrashCan will be deleted now, the WPS classes belonging to TrashCan will be deregistered, and the appropriate objects will be destroyed.  If confirmed, all entries for paths added to your config.sys during installation will be removed from this file. Note: For data security reasons, the uninstallation process will not delete any Trashed objects within hidden trash folders. ═══ 7.3. Update ═══ To update Workplace Shell TrashCan to another version, follow the steps below:  First of all, uninstall the old version as described under Uninstallation.  Install the new version like described under Installation. Note: Your registration information will still be present after an update. ═══ 8. Using the TrashCan object ═══ This section describes the basics of using the TrashCan object and gives an overview of all of the new features it introduces. ═══ 8.1. Basics ═══ Working with the TrashCan object is similar to working with a 'normal' Folder object on your desktop. Any function of a folder that makes sense for a trash can is available and will work as usual. Putting objects into TrashCan is as easy as into a "normal" folder. Simply use your mouse to drag any object over TrashCan's icon or one of its open views and drop it there. Recovering objects also works as usual. Note: You may put objects of almost any kind into TrashCan, even those the Shredder won't accept (for instance files marked as read-only). TrashCan offers a simple way of showing its current state by using different icons. Thus, there is no need to open it to see whether it has any Trashed objects or not. There are three different states, represented by the following default icons: 1. TrashCan is empty. There are no objects inside. 2. TrashCan is not empty, but there is enough space for adding more trash. 3. TrashCan is full. This means there is no space left to put new objects into. If you want to put new objects inside, you will have to empty the trash, shred one or more Trashed objects or increase TrashCan's capacity. Special Drag & Drop features:  You may make TrashCan behave like an advanced shredder and destroy objects immediately upon deposit. Just hold down the left mouse button in addition to the right one when dropping an object and TrashCan will delete it. Note: If you are using a left handed mouse or the left mouse button for dragging objects, you will have to press the right button. Just try it out!  You may remove objects from your LaunchPad on drop, even if they are broken (Those with a icon.).  Simply remove items from WarpCenter (Lotus SmartCenter for OS/2) by dropping them on TrashCan!  Other applications are known to cooperate with TrashCan - for instance DragText by Rich Walsh (Delete text on drop). Note: All the actions described above will immediately destroy the dropped items. These items therefore never appear inside TrashCan. ═══ 8.2. Pop-up Menu Actions ═══ This will describe all the pop-up menu actions available for the TrashCan object, except items that have no new functionality. A TrashCan object with its typical pop-up menu opened is shown in the picture below: The following pop-up menu items are added by TrashCan: Empty Select this item to destroy all objects currently held by TrashCan. If you activated Confirm on trashcan empty in TrashCan's settings notebook, you'll have to confirm this action before it performs. Remember, TrashCan acts like an advanced shredder when doing this. Note: This menu item is only available if there are currently objects inside TrashCan. Product information This item can be found after selecting the arrow to the right of Help. Usually it will be the last item in the help menu. When selected, it shows a dialog with information about Workplace Shell TrashCan version, copyright, etc. TrashCan also comes with new sort criteria for its contents. They are applicable after selecting the arrow to the right of the Sort menu item. This item is only available when one or more of TrashCan's views is opened: Total Size Sorts TrashCan's contents by the disk space usage in descending order. Trash Date Sorts TrashCan's contents by the time they were trashed in ascending order. Origin Sorts TrashCan's contents by the names of the folders they came from, in alphabetical order. ═══ 8.3. Views ═══ Workplace Shell TrashCan does not provide any completely new views, but it modifies the existing Icon view and Details view known from folder objects to match the needs for a TrashCan object. In particular, it adds an area to the top of these views, which contains information about how many objects are currently inserted and how much disk space they are using. The pictures below show a typical Icon view and Details view of a TrashCan object: In addition to the enhancements described above, the Details view of TrashCan contains new information related to Trashed objects: Total Size Information on how much disk space is used by a Trashed object. Note: The size of trashed folders is calculated accurately, which means that the real amount of disk space that they and all contained objects occupy will be reported. Trash Date The date the object was trashed. Trash Time The time the object was trashed. Origin The name of the folder which contained the object before trashing. This is the location for recreating the object when performing a Restore. Note: This information may not be available in some special cases - Refer to Reasons for missing origin for additional information. These new view items are customizable using the Details view settings notebook page of a TrashCan object. ═══ 8.4. Settings ═══ Workplace Shell TrashCan introduces new notebook pages to give you the opportunity to customize its behavior to your own needs. To adjust any of TrashCan's settings use its settings notebook as usual. Common to all new pages are the Undo, Default, and Help buttons, which have the same functionality here as they do in settings notebook pages of other WPS objects. TrashCan also provides new criteria for sorting its contents, customizable via its Sort settings notebook page. The following section describes in detail all of the new pages and what they are used for. ═══ 8.4.1. The 'Options' Notebook Page ═══ This notebook page is used to customize features for trash management, like the capacity of TrashCan and confirmations. The picture below shows TrashCan's Options settings notebook page: The section Capacity is used to adjust settings related to the amount of trash TrashCan will be able to hold. You may decide whether a limit of trash will be imposed or not. Here is a detailed explanation of the available controls: No limit Select this if you do not want a special capacity. TrashCan will then keep as much trash as possible. It stores Trashed objects as long as space is left on storage media. Limited to Select this if you want to set a limit for the size of TrashCan. TrashCan will never exceed the capacity limit. Use the spin field to the right of this control to adjust the capacity. Values from 1 MByte up to the overall capacity of all currently supported drives are selectable. Auto delete This is only used in conjunction with limited capacity and therefore not selectable unless Limited to is chosen. If selected, TrashCan will automatically delete old Trashed objects as you trash new objects, if the trash size exceeds the capacity specified. Old objects are destroyed depending on their Trash Date and Trash Time information - starting with the oldest one, until there is enough space for the new objects you want to insert. This guaranties TrashCan will never be full and you'll never have to empty the trash yourself if you don't want to do so. Note: Trashing objects does not require additional disk space, but doesn't free any either! Disk space is only freed if Trashed objects are destroyed. The section Other is used to adjust any additional features. The following controls are available: Empty on system startup If selected, the trash will be emptied every time the operating system is restarted. 'Delete' support If activated, choosing Delete from the pop-up menu of any object on your desktop will not destroy this object but put it into TrashCan. This also works if you press the Del key after selecting an object (which generally would destroy the object). Note: This option only affects objects on supported drives. Objects that do not reside on a supported drive will be physically deleted. Confirm on empty You will have to confirm every time you empty TrashCan, if you set a check mark here. Confirm on auto delete When this option is selected, you'll have to confirm every time TrashCan wants to destroy any old Trashed objects by itself. Use this if you want to prevent deleting old objects which may still be important to you. ═══ 8.4.2. The 'Time' Notebook Page ═══ This notebook page is used to customize features for trash management, like the hold time for Trashed objects. The picture below shows TrashCan's Time settings notebook page: The section Time is used to adjust the time Trashed objects will stay in TrashCan. You may decide whether a time limit will be imposed or not. Here is a detailed explanation of the available controls: No limit Select this if you do not want a time limit. TrashCan will then keep Trashed objects as long as they are not destroyed according to other settings or user actions. Auto delete after Select this if you want to set a limit for the time TrashCan holds Trashed objects. TrashCan will automatically destroy objects older than the limit set here, if this feature is activated. Use the two spin buttons to select the hold time you want. You can assign any value from 1 day up to 51 weeks and 6 days. Auto rescan every This is only used in conjunction with limited time and therefore not selectable unless Auto delete after is chosen. When activated, TrashCan periodically looks for outdated objects and not only once at system startup. A periodic rescan is especially useful for machines which are shut down very seldom. You can adjust the rescan interval by using the three spin buttons. Values from 1 minute up to 30 days, 23 hours, 59 minutes are possible here. ═══ 8.4.3. The 'Drives' Notebook Page ═══ This notebook page is used to customize the drives to be supported by TrashCan. To use this feature properly, it is important to understand the following: 1. Where does TrashCan store the Trashed objects? 2. What does it mean - support a drive? The picture below shows TrashCan's Drives settings notebook page: The following controls are available to customize the drives supported by TrashCan: Available drives This is a list of drives which are supportable but not supported at this time. Supported drives This is a list of all currently supported drives. Add >> This button is for adding a drive to the list of supported drives. << Remove Use this button to remove a drive from the list of supported drives. To add / remove support for a special drive, do the following:  Mark a drive in the list of available / supported drives.  Push the Add >> / << Remove button or double-click the selected drive to perform. Note: For reasons of data security, Trashed objects within Hidden trash folders will not be deleted at this time. ═══ 8.4.4. The 'Conflicts' Notebook Page ═══ This notebook page is used to customize what to do in the case that an object is added to TrashCan and it already contains an object of the same title. The picture below shows TrashCan's Conflicts settings notebook page: Here is a detailed explanation of the available controls: Act according to system settings Select this if you want to have the action defined in system settings. The system setting for duplicate titles can be adjusted using the System object located in the System Setup folder. Prompt for appropriate action Select this to have the system display a message with choices to determine system behavior for dealing with object title conflicts. Auto-rename object Select this to have the system rename the new object by adding a colon and a number next to the original name. Replace existing object Select this to have the system replace the existing object with the new one. ═══ 8.4.5. The 'Icons' Notebook Page ═══ This notebook page is used to customize the icons to be used by TrashCan to show its current state. The picture below shows TrashCan's Icons settings notebook page: Changing icons is done the same way as for any other Workplace Shell object. The Create another, Edit and Find buttons work as usual. Dropping any object on the Current icon field to change an icon is also supported. Note: The controls for changing icons are generally located in the Icon page of the settings notebook of a Workplace Shell object. Because TrashCan uses 3 icons, it has its own page for dealing with this. To change an icon, do the following:  Select the icon you want to change by pushing the appropriate radio button in the Icons section of this page.  You will see the icon currently assigned to the selected state in the Current icon field.  Perform the action of changing the currently displayed icon like known from other WPS objects (for instance by using drag and drop). ═══ 8.5. System Sound ═══ Workplace Shell TrashCan introduces 2 new system sounds: Empty trash This will be played every time you empty TrashCan. Drop trash You will hear this every time you put a new object into TrashCan. In addition, the predefined system sound Shred will be played every time objects located in TrashCan are destroyed. Changing, enabling or disabling of the new or predefined sounds is done using the Sound object, located in your System Setup and Multimedia folder. Note: The sound capabilities of TrashCan are only available if Base Multimedia Support (a part of MMPM/2) is installed on your system. This is a feature you may have chosen during installation of the operating system or after this using Selective Install. ═══ 8.6. Saving / Restoring Settings Using DeskMan/2 or Object Packages ═══ TrashCan provides an interface to the popular Workplace Shell backup utility DeskMan/2, as well as to Object Desktop's Object Packages. If you use this software, refer to its documentation for further details. By calling the interface implemented in TrashCan, DeskMan/2 or Object Packages obtain all information about the private settings of a TrashCan object and are able to backup, update and restore the object complete with these settings. The following additional settings will be saved when backing up a TrashCan object:  The 3 icons used by TrashCan.  The drives supported by TrashCan.  The options for auto-delete of outdated objects.  TrashCan's capacity.  Information about confirmations and all other user adjustable options for trash management. ═══ 9. Using Trashed Objects ═══ This section describes how to use Trashed objects and gives an overview of all of its features. ═══ 9.1. Basics ═══ What are Trashed objects? Trashed objects are objects that were 'deleted' by putting them into TrashCan. Those objects can only be found inside a TrashCan object - they will not exist anywhere else on your desktop. A Trashed object is a representation of a 'deleted' object. It offers special functionality, quite different from the object it represents. Otherwise, being a Workplace Shell object, it is manipulated as usual. ═══ 9.2. Pop-up Menu Actions ═══ This will describe all the pop-up menu actions available for Trashed objects, except items that have no new functionality. A Trashed object with its typical pop-up menu opened is shown in the picture below: The following pop-up menu items are introduced or modified by Trashed objects: Move... This works most similar to the normal Move, except this action ends in recovering a Trashed object in the destination folder you select. Restore Use this to recreate a Trashed object at the location (the folder) it resided in before it was trashed. Upon a successful restore, the folder the object was recreated in will automatically open so that you can verify the result. Note: This menu item may not be present if there is no origin information available for a Trashed object. Shred Select this item to permanently destroy a Trashed object. After this, the object can not be recovered using TrashCan. Remember, TrashCan acts like an advanced shredder when doing this. Details... This item can be found after selecting the arrow to the right of Open and shows the Trash Details View of a Trashed object. ═══ 9.3. Views ═══ Trashed objects provide a new view called Trash Details. A typical Trash Details view is shown in the picture below: The following information is available: Object Class This is the title of the Workplace Shell class the Trashed object belongs to. Origin The name of the folder the Trashed object was located in before being trashed. This is the place the object will be recreated when you perform a Restore. Note: This information may not be available in some special cases - Refer to Reasons for missing origin for additional information. Total Size Gives information on how much disk space is used by a Trashed object. Note: The size of trashed folders is calculated correctly. This means that the real amount of disk space they and all contained objects occupy will be reported - not just zero! Time Stamp This is the date and time the object was trashed. ═══ 9.4. Settings ═══ There are currently no settings available for customizing the behavior of Trashed objects. ═══ 10. Frequently Asked Questions ═══ I have activated the 'Delete' support feature. But after I select 'Delete' from the pop-up menu of an object, it really is destroyed and does not appear in TrashCan, regardless of whether it resides on a supported drive or not. Your TrashCan object may have lost its OBJECTID. When performing a delete the WPS object searches a TrashCan object with an object id of . If no such object can be found the delete operation will destroy the object. Use one of the several tools available to reassign the correct object id. One last way to solve this problem would be to reinstall WPS TrashCan. To register my copy of WPS TrashCan I'm asked to open the 'Help' sub menu of TrashCan's pop-up menu. But there is no menu item called 'Help'! Most likely you have the statement SET MENUSTYLE=SHORT in your config.sys file. This removes the Help item. To get it back, please comment the above statement out and reboot. After that you will be able to register your copy. ═══ 11. Known Bugs / Limitations ═══ 1. TrashCan does not intercept delete operations done from 'outside' the WPS. If you delete files or directories using file manager programs or the Command Line, they will really be destroyed and therefore never appear in TrashCan! 2. Currently there is no handshake with or any other support for the DELDIR feature of OS/2. ═══ 12. Comments ═══ Workplace Shell TrashCan is still under development. It seems to run well on the most systems, but there may be some bugs anyway! Please feel free to send any comments / suggestions / bug reports to me. Not being a native English speaker, I probably made some mistakes. I'm always interested in getting information on grammatical errors still in WPS TrashCan's documentation, in the online help or in the program itself. If you are interested in translating TrashCan into your language, please contact me (You should be familiar with the IPF Tag Language and the Resource Description Language to do the translation). Feel free to ask me whether there is a version in your language available already. ═══ 13. Revision History ═══ The following is a list of all versions of Workplace Shell TrashCan, describing the changes made over time: 01/10/2000 - Version 2.7.1 1. New Features:  n/a 2. Bug Fixes:  Version 2.7 did not run on Warp 3.  Y2K bug. TrashCan's Details View and the Details dialog of trashed objects displayed '100' instead of '2000' for the year the object was deleted. Note that this was only a bug at the user interface. All internal time calculations were correct. 3. Other Changes:  n/a 03/08/99 - Version 2.7 1. New Features:  The action to be taken in case an object is added to TrashCan and it already contains an object with the same title now is customizable. For this, the new "Conflicts" page was added to TrashCan's property notebook. 2. Bug Fixes:  TrashCan and TaskBar (another nice WPS extension) did not work properly together. TrashCan posted messages around, which TaskBar interpretes as program errors. Thanks to Rick Yoder for his help.  TrashCan did not display columns with special information for Trashed objects in its Details View, unless "Default" was selected in its "Details View" property notebook page.  Sometimes "Drive not ready" error messages where displayed during WPS startup. This happened, if removeable drives were marked "supported" in TrashCan's "Drives" property notebook page and the drive was empty at the moment the WPS started. 3. Other Changes:  TrashCan now can be registered via Compuserve. Refer to the file "Register.txt" for details.  WPS TrashCan is now available in Spanish. 02/09/98 - Version 2.6 1. New Features:  Added support for network drives and for drives that claim to be network drives (like TVFS drives and ZipStream drives). TrashCan automatically will adapt itself after actions that change drive configuration, like mounting and unmounting drives. 2. Bug Fixes:  TrashCan did not restore customized icons after a system restart, if total size of data for all icons exceeded 64K Bytes. 3. Other Changes:  OS/2 Warp v4 (Merlin) adaptions: - Added support for new notebooks. - Added support for new folder menu bar.  Major changes in almost all code parts of TrashCan were done for optimized performance and fault tolerance. 08/31/96 - Version 2.5.2 1. New Features:  n/a 2. Bug Fixes:  In 'Time' settings notebook page, there after setting the time limit to 'unlimited', closing and then reopening the notebook page, the 3 spin buttons for adjusting the rescan interval sometimes were erroneously not disabled. Thanks to Masahiro Fujimoto for his report.  In the 'location' entry fields of the Installation Utility, there only could be entered up to 32 characters! Now you can put in even the longest possible paths.  The problem with the disappearing status area of TrashCan's Icon view when changing the Format or Icon display settings in TrashCan's Icon view notebook page is solved now.  Some other small fixes in the Installation Utility. 3. Other Changes:  WPS TrashCan is now available in Japanese.  The Installation Utility and TrashCan itself are now fully DBCS-enabled. (Users from countries using DBCS should know what this means)  Initialization of TrashCan now completely works in a separate thread, so the WPS starts up significantly faster if much trash is stored in TrashCan. One can work with the WPS already while TrashCan still is initializing in the background.  If you drag objects out off TrashCan, they now exactly appear at the position you dropped them. 07/05/96 - Version 2.5.1 (No public release) 1. New Features:  n/a 2. Bug Fixes:  There was a very special bug which caused an extended WPS clock object (radio controlled) to hang. Maybe this bug also effected other WPS components which uses OS/2 system timers. Thanks to Frank Schwedler for reporting this. 3. Other Changes:  n/a 06/29/96 - Version 2.5 1. New Features:  Auto delete of Trashed objects after a period of time.  If 'Confirm on trashcan empty' is activated, then you will have to confirm on 'Empty trash on system startup' now. This is useful in case the system was restarted after a crash, trap, hang, or other 'nice' reasons.  A 'Cancel' button was added to the 'Auto delete confirmation' dialog, which aborts the entire auto-delete operation. 2. Bug Fixes:  'Delete support for WPS objects' feature: - Transient objects (like Object Desktop's 'Object Archive' elements) will now be deleted as usual. Former, TrashCan tried to intercept deletion of these objects, which could cause errors.  There was a bug in the interface to DeskMan/2 which (under special circumstances) caused not to restore a TrashCan object completely.  In case of a name clash when adding new objects to TrashCan, cancelling the 'name clash dialog' (displayed according to system settings) did not work. 3. Other Changes:  n/a 03/26/96 - Version 2.4 1. New Features:  TrashCan now handles dropped items which support the DRM_DISCARD rendering mechanism exactly like the Shredder does (This was implemented only partially in former versions.), which means: - TrashCan can now remove broken items from LaunchPad objects. - Support for "DragText - Drag and Drop Text for OS/2" by Rich Walsh. TrashCan is able to delete text which is dropped on it. - Cooperation with other apps which use the 'Discard' rendering mechanism in a 'clean' way.  A real delete can be enforced, even if 'Delete support for WPS objects' is activated, by holding down the CTRL key on keyboard when selecting 'Delete' from an objects pop-up menu. 2. Bug Fixes:  If 'Delete support for WPS objects' was activated: - Deleting elements from inside an Object Desktop 'Object Archive' was not possible (nothing happened). - Removing objects from LaunchPad via selecting 'Delete' from the pop-up menu of the objects didn't work properly.  When removing the installation path from the HELP statement in config.sys, the Installer appended a ';' at the end of all lines containing 'SET HELP' (e.g. SET HELPNDX).  If the ESC key on keyboard was pressed when TrashCan's "Options" notebook page was displayed, the page disappeared. Thanks to Guillaume Gay for reporting this.  If an Audio CD was inserted in a CD-ROM drive, then several actions (like opening TrashCan's Icon View, Opening the "Drives" notebook page, etc.) were delayed for up to several seconds. On some CD-ROM drives, even dropouts in audio playback occurred. This is fixed now - thanks to Francis Morley for his report.  TrashCan did not work properly with Workplace Security by Maple Valley Software. If this product was installed, putting objects into TrashCan via drag and drop sometimes caused an access violation (SYS3175) and the 'Delete' support feature sporadically did not work. Many thanks to Jose Hissa Ferreira for his bug report. 3. Other Changes:  WPS TrashCan is now available in French and German, in addition to English.  Shredding Trashed objects via its 'Shred' pop-up menu item now works in a separate thread, so the WPS is not blocked when performing the task (Multithreading for this was already implemented from Version 1.4 to 1.0 pro, but removed from 2.0 to 2.3. The code needed to be completely rewritten for the 2.x versions). 11/04/95 - Version 2.3 1. New Features:  Added 'TrashCan - support' for all WPS objects. If you delete any WPS object (i.e. by selecting 'Delete' from its context menu), it will not be destroyed but will appear in TrashCan. 2. Bug Fixes:  n/a 3. Other Changes:  Registering TrashCan from outside Germany is much easier now by using the service of BMT Micro. Refer to the file 'Register.TXT' for further details. 10/21/95 - Version 2.2 1. New Features:  TrashCan now is able to remove objects from the LaunchPad and from " Lotus SmartCenter". However, broken LaunchPad items (? icon) are not supported in this version.  You may now drop objects with opened views on TrashCan. All the views will be closed when trashing. However, currently TrashCan will not terminate any running apps! If you try to trash a running program, TrashCan refuses to do so. 2. Bug Fixes:  TrashCan didn't care about the default action for title clashes set in the 'System' object's 'Title' settings notebook page. When moving objects to TrashCan or when restoring Trashed objects to their original location, in case of title clashes, there always was displayed the prompt dialog. - Thanks to Gordy Thompson for reporting this bug.  There were some bugs, caused by using DeskMan/2 to update / restore the TrashCan object: - An animation icon was added to TrashCan - even, if there was never assigned one. When opening any of TrashCan's views after that, its icon changed to that animation icon. For instance, the bulged out icon changed to the slim one. TrashCan now prevents such an assignment. - TrashCan had the 'empty' icon assigned after performing an update / restore, even it was not empty.  Some other minor fixes. 3. Other Changes:  Performance improvement when dealing with large amount of Trashed objects. (Detecting any "Dirty Command Line Tricks" and adding / removing Trashed objects for any "Bad Boys" after that works MUCH faster now !)  Removed the message boxes saying 'Object will be restored ...' and 'Object restored successfully...' when a Restore was performed. I think, this gets somewhat nerving when restoring more than one object?!  Documentation was completely rewritten. The on-line book 'Workplace Shell TrashCan - User's Guide' has replaced the ASCII file 'TrashCan.DOC'.  The installer was - once again - completely reworked: - There is no longer need for the file 'InstUtil.CFG'. - The new on-line documentation will be installed along with the TrashCan class. - Updating TrashCan is easier now. New versions may be installed without rebooting after uninstallation. - The installer handles all necessary changes to config.sys. - Uninstall will generally delete all the old files installed along with TrashCan and the installation directory, too. 09/12/95 - Version 2.1 1. New Features:  n/a 2. Bug Fixes:  Fixed a major bug (Arrgh!) in v2.0! Sometimes after reboot, there were duplicated Trashed objects in TrashCan! Means, when you opened a view of TrashCan, there possibly were multiple objects with the same name. Result was calculating of wrong total trash size and some strange things depending on this - Sorry for such an ugly bug - I hope, it's fixed now! 3. Other Changes:  Added file "SDS-OE.TXT" to distribution archive, which gives users of the commercial version of TrashCan information on how getting updates. 09/11/95 - Version 2.0 (Initial shareware release) 1. New Features:  Now TrashCan has its own Details view with information about the Trashed objects.  Trashed objects now have an own view which gives detailed information about them.  You now may restore Trashed objects to the location they originally came from.  Objects inserted into TrashCan now can be sorted by several criteria.  Configuration of drives to support by TrashCan (New 'Drives' notebook page).  Added XGA/8514 format to all icons. This is useful for users of display resolutions higher than 800x600 only (no longer ugly looking icons as a result of rendered VGA-format). 2. Bug Fixes:  Fixed a small bug occurred when assigning an icon via drag and drop - If the dropped object is a data file, in some cases the wrong icon (that of the program object possibly associated with the data file) was assigned to TrashCan. 3. Other Changes:  Ported TrashCan to SOM2.  Major rewrite of TrashCan for improved performance, memory usage and user comfort (only some visual changes but a lot of functional).  Enhanced functionality to ensure the integrity of TrashCan's contents (for instance when deleting an object in a trash folder from the command line).  There is no longer any reason for not creating the TrashCan object on the desktop - It now will be created there by default! The "Archive desktop" feature of Warp can be used without any problems now.  Enhanced interface to DeskMan/2 (esp. for restoring / updating TrashCan via DeskMan/2).  Minor changes in TrashCan's notebook page dialogs.  'General' notebook page #2 (animation icon) was removed from TrashCan's settings notebook, because there is no need for this.  Completely changed the way user defined icons will be saved, because of former problems when storing large icon data. 05/02/95 - Version 1.0 pro (Only available with SDS OS/2 Essentials) 1. New Features:  Shred objects on drop.  Completely redesigned TrashCan's sound capabilities. There is no longer need for an own 'Sound' page in TrashCan's settings notebook. All the sound caps. are now controlled via the 'Sound' object coming with the operating system. 2. Bug Fixes:  n/a 3. Other Changes:  Made TrashCan more "Warp"-aware, esp. improved dealing with lazy drag and drop operations.  'General' notebook page #2 (animation icon) now will be inserted behind the 'Icons' notebook page, instead behind the last 'File' page. 11/22/94 - Version 1.5 (Only available with SDS OS/2 Essentials) 1. New Features:  During installation, now a location for the TrashCan object may be specified. If this location is different from the desktop folder, TrashCan automatically creates a shadow of itself on your desktop. Note: Creating the TrashCan folder in the root of boot drive is now the default!  'Confirm on auto delete' mode.  Added DeskMan/2 interface. DM/2 now may save all private settings of TrashCan, like the 3 icons or the trash options. So it can restore not only the data common to all WPS objects, but also those specific for TrashCan.  If you want to change the icons of TrashCan via drag and drop, there is no longer a limitation to *.ico files! You may drop ANY objects on the 'Current icon' field in 'Icons' notebook page.  The 'Icon' object is now preselected in find dialog, if you push the 'Find ...' button in 'Icons' notebook page.  The 'Sound' notebook page now only will be displayed, if you have installed MMPM/2 on your system. 2. Bug Fixes:  Some users reported problems when assigning 256 colored icons to TrashCan via drag and drop. I think, this bug is fixed now!? 3. Other Changes:  Minor (non-functional) changes in drag/drop interface.  The class dll file (TrashCan.DLL) no longer needs to be located in a path included in LIBPATH statement of config.sys.  The Installer was completely redesigned.  Did some testing with TrashCan and OS/2 Warp v3 (Syslevel XR03000) - no problems. 06/07/94 - Version 1.4 1. New Features:  Added a 'Change' button to 'Sound' notebook page, which opens the 'Sound' notebook in the 'System Setup' folder.  Added a 'Find ...' button to 'Icons' notebook page. Now searching works most similar to all other WPS objects.  'Confirm on trash can empty' mode.  The current trash size and the count of objects are now displayed in the icon view of TrashCan. 2. Bug Fixes:  Fixed a bug in 'install.exe' - If the old trashcan.dll and/or trashcan.hlp are/is set 'read only', a reinstallation/update failed.  Changed a small "dirty" code fragment ( Ooops! ) - So this and coming versions of TrashCan will work fine with "OS/2 Performance Beta I" (and higher), too. 3. Other Changes:  'Empty' TrashCan and 'Shred' of object(s) via pop-up menu work now in a separate thread. So the WPS doesn't block while performing these tasks.  Did some testing with TrashCan and OS/2 2.11 (OS/2 2.1 Service Pak: Syslevel XR06200) - found no problems. 02/26/94 - Version 1.3 1. New Features:  Added some sound to TrashCan ('Sound' notebook page). - Thanks to Robert Novitskey (Big Bad BoB) for the hint, how to do this! 2. Bug Fixes:  Dropping objects on TrashCan from other processes than the WPS (e.g. from FileManager/2) was not possible. (always stop sign when dragging over). 3. Other Changes:  If 'auto delete on limit reach' is active, and an object larger than the specified trash can capacity is put into the trash can, this object will be deleted immediately, instead of deleting first all old objects and then the new object too (result in version 1.2 was an empty trash can).  Validation check for TrashCan's capacity on installing, moving (to another drive) of the trash can folder. Now there will always be a valid capacity. 02/18/94 - Version 1.2 1. New Features:  New default icons. (I've heard about any copyrights for the original Macintosh icons!)  'auto delete on limit reach' mode. 2. Bug Fixes:  Drag and drop of large icon files (> 10K) caused an error. 3. Other Changes:  In 'Icons' notebook page: A frame is drawn around the icon displayed in 'Current icon' field while any WPS object is dragged over it. 02/01/94 - Version 1.1 1. New Features:  User customizable icons for TrashCan. (Sounds simple - but believe me, it was a hard job!) 2. Bug Fixes:  Some fixes in 'undo' feature in the new notebook pages. 3. Other Changes:  n/a 01/07/94 - Version 1.0 (Initial release) ═══ 14. Contacting The Author ═══ You may contact the author using following addresses: Mail: Kai Sommerfeld Moorburger Elbdeich 401 21079 Hamburg Germany E-mail: kaisommerfeld@yahoo.com ═══ ═══ If you put an object into TrashCan, it moves this object from its original location to a hidden folder named 'Trash', located in the root of the drive the object is on. A reference to the object - a Trashed object - is then added to TrashCan's contents. This guarantees an optimal performance, because simply moving objects from one directory to another on the same drive is very fast. You may find a folder of this kind on every drive currently supported by TrashCan. Note: The hidden folders mentioned above will be created and deleted dynamically. That is, if there is no trash on a specific drive, no folder will be present there. ═══ ═══ In case of a request to trash an object, TrashCan looks at whether this object resides on a drive currently marked as supportable. If it is so, the object will be stored, if not, it will be destroyed immediately. In the last case you will get a notification and may decide to cancel the action or allow the object to be destroyed. ═══ ═══ Under some circumstances, there is no origin information available for a Trashed object. This will happen very seldom, but is possible. Known conditions for missing origin information are:  You've updated TrashCan to another version or reinstalled it. If there were any stored objects at this time, they will reappear, but the origin information will be missing.  You put objects directly into hidden Trash folders or the TrashCan folder itself, for instance using the OS/2 Command Line (e.g. 'copy stuff.txt e:\Trash' or 'copy stuff.exe d:\Desktop\TrashCan'). ═══ ═══ TrashCan tries to destroy any kind of objects when requested to do so. This means that it also deletes trash that is generally not deletable (like non-deletable templates, read-only files, ...). ═══ ═══ A commercial version of Workplace Shell TrashCan is shipped with "SDS OS/2 Essentials" by Stardock Systems, Inc.. ═══ ═══ The Workplace Shell TrashCan distribution package contains the following files: InstUtil.EXE Program for installing, uninstalling and updating WPS TrashCan. TrashCan.DLL WPS class library containing TrashCan's whole functionality. ObjPlus.DLL WPS class library containing 'TrashCan support' for all WPS objects. TrashCan.HLP TrashCan's on-line help. TrashCan.INF TrashCan's on-line book (which you are reading now). ReadMe.1st Basic information (ASCII file). Register.TXT Information related to registration and order forms (ASCII file). SDS-OE.TXT ASCII file containing information for users of the version of WPS TrashCan shipped with 'SDS OS/2 Essentials'.