Copyright: Copyright © 1997 by Jeff Evans. All Rights Reserved.


Copyright

CacheCompactor 4.0 is Copyright © 1997 by Jeff Evans. All Rights Reserved. You may not modify, alter, or change this program, its associated code (in any form), or any included files, including, but not limited to, documentation, help files, supporting DLL’s, and other modules.

Please refer to the license agreement for more information on using this program. If you are interested in distributing CacheCompactor on a cd-rom, Internet web or ftp site, file archive, online service, or other shareware distribution service, book, magazine etc. Please refer to the distribution agreement.


Welcome to CacheCompactor!

CacheCompactor is a utility for Windows 95 and Windows NT that automates the process of cleaning temporary, cache and other folders.

While browsing the Internet, or just during the normal day-to-day operations of your computer, you acquire a large number of temporary files on your hard drive – which are not always removed! Over time you can accumulate dozens of megabytes in temporary files –consuming precious hard drive space.

CacheCompactor can be configured to find these temporary files and remove them from your system, potentially recovering large amounts of space.

For more information on CacheCompactor, please browse through this help file, or visit the product web site at:

http://www.triceris.com/CacheCompactor/default.asp


What's New in CacheCompactor 4.0?
What’s new in CacheCompactor 4.0?

This release is a major improvement over previous releases, and includes several powerful new features such as:

The Scheduler - Automate the process of removing temporary files and cached files.

Faster Cleaning - Deleting files is now substantially faster than previous releases, allowing you to remove temporary files and get on with your work. The cleaning routines have also been improved to eliminate error dialogs that used to appear when files could not be deleted.

Improved Documentation - We have spent a great deal of time updating and writing more documentation, and ensuring that users can quickly and easily find information on how to run and configure CacheCompactor.


License Agreement

CacheCompactor 4.0

END-USER LICENSE AGREEMENT FOR SOFTWARE

IMPORTANT-READ CAREFULLY. This End-User License Agreement ("EULA") is a legal AGREEMENT between you (either as a registered individual or as the registered representative and on behalf of a single entity) and Jeff Evans (“THE AUTHOR”) for the software product identified above, which product includes computer software and may include associated media, printed materials, and "online" or electronic documentation ("SOFTWARE PRODUCT"). By installing, copying, or otherwise using the SOFTWARE PRODUCT, you agree to be bound by the terms of this EULA. If you do not agree to the terms of this EULA, then DO NOT install or use the SOFTWARE PRODUCT, you may, however, return it to your place of purchase for a full refund.

SOFTWARE PRODUCT LICENSE

The SOFTWARE PRODUCT is protected by copyright laws and international copyright treaties, as well as other intellectual property laws and treaties. The SOFTWARE PRODUCT is licensed, not sold.

1. GRANT OF LICENSE.

This EULA grants you, the registered end user, the following rights:

Applications Software

The SOFTWARE PRODUCT may be installed and used on any

computers owned directly by the licensee.

STORAGE/NETWORK USE

You may also store or install a copy of the SOFTWARE PRODUCT on a storage device, such as a network server.

2. DESCRIPTION OF OTHER RIGHTS AND LIMITATIONS.

Limitations on Reverse Engineering, Decompilation, and Disassembly

You may not reverse engineer, decompile, or disassemble the SOFTWARE PRODUCT, except and only to the extent that such activity is expressly permitted by applicable law notwithstanding this limitation of components. The SOFTWARE PRODUCT is licensed as a single product. Its component parts may not be separated.

Rental

You may not rent, lease, or lend the SOFTWARE PRODUCT to any party.

Software Transfer

You may permanently transfer all of your rights under this EULA, provided you:

(a) retain no copies

(b) transfer all of the SOFTWARE PRODUCT (including all

component parts, the media and printed materials, any upgrades, this EULA, and, if applicable, the Certificate of Authenticity), and

(c) the recipient agrees to abide by all of the terms of this EULA. If the SOFTWARE PRODUCT is an upgrade, any transfer must include all prior versions of the SOFTWARE PRODUCT and all of your rights therein, if any.

Support Services

Technical support will be provided only by e-mail. No additional support is guaranteed. Difficulties encountered during the use of the software should be sent to evansj@cadvision.com.

You are entitled to technical support only if you have acquired a valid registration code for this program by purchasing CacheCompactor.

Termination

This EULA may be terminated if you fail to comply with the terms and conditions of this EULA. In such event, you must destroy all copies of the SOFTWARE PRODUCT and all of its component parts;

3. COPYRIGHT AND TRADEMARKS.

All title, trademarks and copyrights in and pertaining to the SOFTWARE PRODUCT (including but not limited to any images, photographs, animation, video, audio, music, text, and applets incorporated into the SOFTWARE PRODUCT), the accompanying, printed materials and any copies of the SOFTWARE PRODUCT are owned by THE AUTHOR. The SOFTWARE PRODUCT is protected by copyright and trademark laws and international treaty provisions. You must treat the SOFTWARE PRODUCT like any other copyrighted product for archival purposes, and you may not copy the printed materials accompanying the SOFIWARE PRODUCT.

4. LIMITED WARRANTY

LIMITED WARRANTY

No warranties are made as to the safety of the SOFTWARE PRODUCT. Users will use at their own risk and discretion.

CUSTOMER REMEDIES

No remedies are offered for this software product. Users should test the product before purchase to ensure compatibility and that the SOFTWARE PRODUCT works as expected. Limited technical support will be provided as described above. Technical support does not imply or guarantee that a remedy will be reached.

NO OTHER WARRANTIES

TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, THE AUTHOR DISCLAIMS ALL OTHER WARRANTIES AND CONDITIONS, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE, AND NON-INFRINGEMENT, WITH REGARD TO THE SOFTWARE PRODUCT AND THE PROVISION OF OR FAILURE TO PROVIDE SUPPORT SERVICES. THIS LIMITED WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS. YOU MAY HAVE OTHERS, WHICH VARY FROM STATE/JURISDICTION TO STATE/JURISDICTION.

5. LIMITATION OF LIABILITY

TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT, OR CONSEQUENTIAL DAMAGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR ANY OTHER PECUNIARY LOSS) ARISING OUT OF THE USE OF OR INABILITY TO USE THE SOFTWARE PRODUCT OR THE PROVISION OF OR FAILURE TO PROVIDE SUPPORT SERVICES, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. IN ANY CASE, THE AUTHOR'S ENTIRE LIABILITY UNDER ANY PROVISION OF THIS EULA SHALL BE LIMITED TO THE GREATER OF THE AMOUNT ACTUALLY PAID BY YOU FOR THE SOFTWARE PRODUCT OR FIVE UNITED STATES DOLLARS (U.S. $5.00)


Distribution Agreement

If you are interested in distributing CacheCompactor on an online resource (web site, ftp site, file archive etc.), an online service (such as a BBS), a magazine, book, shareware distribution service, kiosk, diskette, or cd-rom, please contact the author at: evansj@kagi.com.

We accept most requests for distribution, except where the distributor makes a considerable profit on the sale of our program. Please attempt to include as much information about your service as possible before contacting us.


Press Information

If you are a member of the press, a publisher, or are an individual wanting more information on CacheCompactor, please e-mail us at: info@triceris.com.

You can also visit the CacheCompactor web site for product information, reviews, and documentation:

http://www.triceris.com/CacheCompactor/default.asp


Product Web Site

You can visit our web site at any time for more information on our product, bug reports, and information about future versions and upgrades.

Please visit us at:

http://www.triceris.com/CacheCompactor/default.asp


Comments and Suggestions

We welcome your comments and suggestions! If you have a comment about CacheCompactor, or have a suggestion on how to improve the program, please e-mail us at: info@triceris.com.

We cannot respond to every individual comment and suggestion, but we carefully read and review all e-mails.


Bug Reports

If you have discovered unexpected behavior while running CacheCompactor, please send a detailed e-mail to: info@triceris.com including:

What you did to cause the problem

The contents of any error dialogs

Your computer configuration

The version of CacheCompactor you are running

You can also use our online bug report web site, which is available at:

http://www.triceris.com/Comments/BugReports.asp


Wish List

Have a great idea for a feature? Think we should be doing something differently? Let us know!

We welcome your comments and suggestions on how to improve the program. Contact us at any time at: info@triceris.com.


What is Kagi?

Kagi is company that processes shareware registration services for authors. In other words, they allow shareware authors to offer customers the ability to pay with credit cards, cheques, cash etc.

Kagi processes the payments for authors, notifying the authors of new registrations. At the end of each month, the author receives a cheque for the months registrations.

The service currently offers a wide range of payment options, including:

Secure online credit card transactions

Cash

Cheque

Offline Credit Card Transactions

Telephone Orders

More information on the Kagi service is available at: http://www.kagi.com/


Understanding Shareware

Shareware is a distribution method where users are allowed to try the product for a trial-period before having to purchase it. This allows users to evaluate a program without having to actually purchase a copy of it.

In most cases, shareware programs are just as useful as commercial applications, but in most cases are less expensive. You can find shareware applications for almost every purpose for just about any computer platform.

CacheCompactor is a shareware program. You can try CacheCompactor for 30 days before purchasing a licensed copy, or removing it from your system.


Using the Registration Wizard

The registration wizard allows you to quickly and easily purchase CacheCompactor (using either the online transaction system or by generating a registration form and mailing it with payment).

You can also use the registration wizard to enter your registration information and remove the 30-Day trial limit.

To start the registration wizard, select the “Registration Wizard” icon in the CacheCompactor program group.

To complete the registration wizard, simply follow the on screen instructions. If you require help at any time, press the ‘?’ in the title bar and click on an item for a detailed description of its purpose.


The CacheCompactor Components

CacheCompactor consists of a number of different components. Each component has a specific purpose, and has been designed so that you can easily get to the features you need without having to load a large program.

All of the components are accessible from the CacheCompactor program group in the Windows start menu group. The components consist of:

CacheCompactor 	- You can use this to “manually” clean folders. When you run

this program, CacheCompactor automatically cleans any folders

that you have marked for “manual” cleaning. If the scheduler is already loaded, it will start the scheduler in Manual mode.

Registration Wizard	- Use this to purchase CacheCompactor, and to enter your

registration code after you receive it.

Scheduler	- If you want to take advantage of the scheduling features

available in CacheCompactor 4.0, you’ll need to load the scheduler first. You do not have to run the scheduler if you only use the “manual” cleaning mode.

Configuration Wizard	- Use this component to modify settings, change your

configuration, and add and remove folders from the cleaning list.


After Installation

After installing CacheCompactor, you should have a new program group in your start menu. To access this program group:

1. Click on the start menu

2. Select “Programs”

3. Select “CacheCompactor”

From this menu, you can access all of the features available in CacheCompactor.

During the initial installation, you were presented with a configuration wizard. This wizard gave you the opportunity to configure CacheCompactor for the first time. If you want to change any of your settings, you can use the Configuration wizard to do so.

The first part of this tutorial will show you how to start the configuration wizard and add a new folder.

First, highlight the “Configuration Wizard” option in the CacheCompactor program group, and then click it. This will start the configuration wizard.

To add a folder: 	Next >


Adding a Folder

Once you have loaded the Configuration Wizard, read the on screen instructions, and press the “Next >” button (located at the bottom right hand corner of the wizard) to move to the Add Folders page.

You will see a display of all of the folders currently in your cleaning list. The display shows several different elements (you may have to scroll to see all of them). They are:

Display Name	- This is a friendly name that you give to the folder. This name is used

whenever CacheCompactor needs to display a progress or notification dialog. For example, if you have added your Windows Temporary directory to the cleaning list, the display name could be “Windows Temporary Folder”.

Path	- This is the full path to the folder.

Event	- This specifies what event will occur before the folder is cleaned. This is

also the cleaning “mode” for the folder.

Enabled	- This tells you if the folder is Enabled (CacheCompactor will remove

files from this folder).

If you have specified multiple events (or modes) for a folder, the folder will appear more than once.

To add a new folder, press the “Add” button.

You will be presented with a “New Folder” dialog. This dialog allows you to specify the settings for a new folder.

CacheCompactor offers two types of folders. You can use “Preset Folders” or “Custom Folders”. A preset folder is a folder that CacheCompactor “knows” how to find. You can use preset folders to prevent you from having to manually type in the full path to a folder.

For example, to add the Netscape Cache to the cleaning list, select “Preset Folder”, then select “Netscape Cache” from the drop down window. Once it is selected, press the “Ok” button. You have just added a new folder!

If the folder you want to add is not listed in the “Preset Folder” window, you can select “Custom Folder”. Enter a display name (a name that you will see in dialogs and other notifications) in the Display Name box. Then enter the full path in the Path box, or press Browse to search for it.

To remove a folder:	Next >


Removing a Folder

Removing a folder is easy. Simply select the folder in the cleaning list and press the “Remove” button.

If you have accidentally removed the wrong folder, simply press the “Cancel” button at the bottom of the wizard and restart the configuration wizard.

To Change a Folder’s Settings:	Next >


Changing a Folders Settings

To change a folders settings, select the folder in the cleaning list and press the “Properties” button. You will see the same dialog that was shown when you added a folder. Simply change the settings that you want to alter and press the “Ok” button to save them.

The Scheduler tab contains advanced features that allow you to specify “events” that trigger the cleaning of this folder. For more information on the Scheduler, please read the Schduler Tutorial.

To clean typed urls:	Next >


Cleaning Typed URL's
Cleaning Typed URL’s

The next step of the Configuration Wizard is the “Clean Typed URL’s Step”. This gives you the opportunity to have CacheCompactor clean your web browser’s Typed URL list (which appears at the top of your web browser in the Address box).

If you want CacheCompactor to clean your web browser’s Typed URL list, click on the appropriate box.


Finalizing Your Settings

If you have changed any settings, you must press the “Finish” button before they will be saved. You can press the “Cancel” button at any time prior to pressing Finish to reset your configuration and remove any changes that you have made.

If you press the “Cancel” button, you will have to restart the Configuration Wizard.


Security of Safety Features
Security and Safety Features

CacheCompactor 4.0 offers a number of security and safety features. Each of those features is described in detail below. To enable any of those features within the Configuration Wizard, simply select the option.

Ask before removing Files	- You will be prompted before removing any directory.

This gives you the opportunity to avoid cleaning a folder.

Move to Recycling Bin	- This option will move files to the recycling bin instead

of deleting them.

Do not delete files ending in	- Use this to specify a string of file extensions that you

do not want to remove. For example, if you want to

prevent HTML and GIF files from being removed, type:

html;gif

Fill with Garbage	- When enabled, it replaces the contents of each file

with randomly generated characters before deleting them. This provides a high level of protection against “undelete” utilities.

Run Silently	- This option, when selected, prevents CacheCompactor

from displaying any progress dialogs.

Show Scheduler	- Causes the Scheduler to display an icon on the

Windows taskbar whenever it is running.


Closing the Scheduler

To close the scheduler, right click on the Scheduler icon in the taskbar and select “Close”. This will shut down the scheduler.


The Scheduler Taskbar Icon

If you have enabled the Scheduler taskbar Icon, you will see it in the taskbar (next to your clock) whenever the Scheduler is running. The icon looks like the Windows 95 recycling bin.

Left-Clicking on the icon will start the Scheduler in “Manual” mode. Any folders that have been marked for manual cleaning will be cleared.

Right-Clicking on the icon will display a menu with several options. The options include:

Pause	- If a checkmark appears next to this option, the scheduler will not

respond to any events (except when you Manually start the scheduler).

Invoke	- This starts the Scheduler in Manual mode, and cleans any folders that

have been marked for “Manual” cleaning.

Reset	- If you have specified periodic cleaning, this resets the timers on those

folders. As the scheduler runs, it increases an elapsed time counter for every folder. The reset option will reset those counters to zero.

Configure	- Starts the configuration wizard

Exit	- Closes the Scheduler


Starting the Scheduler

You can start the scheduler at any time by clicking on it’s icon in the CacheCompactor program group.

If you only have folders marked for “Manual” cleaning, you do not have to run the scheduler. The scheduler is responsible for detecting events such as:

Elapsed Time

Programs Closing

Windows Shutting Down


The Scheduler Modes

The Scheduler allows folders to be cleaned based on certain events. The events (or “modes”) are:

Elapsed Time	- You can specify a specific interval of time that the scheduler

will wait before cleaning a folder. For example, specifying “30 minutes” will clean a folder every half hour.

Program Close	- This occurs when a specific program closes. You can configure the

scheduler to clean a folder whenever you close the program. For example, you can clean the Internet Explorer cache whenever you close Internet Explorer.

Windows Shutdown - This occurs whenever windows is shut down. You may want to,

for example, clean your temporary folder just before turning off your machine.


What is the Scheduler?

The Scheduler is a powerful new feature in CacheCompactor 4.0 that allows you to specify certain “events” that can trigger cleaning of a specific folder.

If you want to take advantage of the Scheduling features, first use the “Schedule” tab in the Add Folder or Folder Properties dialog (part of the Configuration Wizard) to specify the event that should trigger cleaning a folder.

You also need to start the Scheduler. Without the Scheduler, CacheCompactor cannot respond to the events as they occur.