Installation
============

* This program runs under Win95\Word97.
 
* How to install the program: Unzip the package. You can drag the template to a directory of your choice, or you can execute the supplied Instl*.dot template by double-clicking on it.
 
* Status of the program: Shareware. To register send $U.S. 25.00 to 
Chris Greaves Inc. 
3 Foxcote Crescent
Etobicoke; Ontario
CANADA; M9C 4B9
 
* The distribution status of the program: Please distribute this package.
 
* To contact the author in the event of questions or problems: cgreaves@vif.com or (416) 621-9348
 
Un-Installation
===============

* How to un-install the program: Delete the host directory..
 
Why these products are good
===========================

There are several reasons:

* Each was written to satisfy a real need in the business world. If you think you need this product, you probably do and it is going to be of real use to you.
 
* I strive to make my work self-contained and self-supporting. Each product arrives in its own self-extracting ZIP file which you can distribute to other users. 
 
* The self-extracting ZIP files which contain the current application template and all documentation, including the most up-to-date lists of problems (WhatProb.doc) and innovations (WhatsNew.doc).
 
* I make no use of the Windows system registry files - customization takes place in ASCII text INI files, which you are fee to inspect and modify. 
 
* Working files are developed within the directory holding the Word template file. De-installation is as easy as deleting the directory that holds the application. 
 
* INI files and rules tables will be generated by the application if it cannot find suitable files. Thus you can always delete the INI file or rules tables if they get cumbersome; the application will generate a fresh set on your next call.
 
* The application and all supplied and generated data files sit in a single directory. De-installation is as simple as deleting the host directory.
 
* Automatic generation of INI files. Each application generates its INI file from internal default values. The user need never edit the file. A user-corrupted INI file can be repaired simply by deleting the corrupt file. Amazing!
 
* Automatic generation of Rules Tables. Each application is capable of generating a basic Rules table from internal default values. The user can then augment the rules by inspection of the table. Further, a user-corrupted Rules table can be repaired simply by deleting the corrupt file.
 
Modular Ideas
=============

Chris has developed an extensive array of modular ideas. Analysis of document structures ranges from the word level (TrailBlazer, Indexer) through phrase analysis (CodeText, Thinker) and extends to the LAN/WAN sphere (Files, HyperWord, WebWord).

In particular you, the user, can combine several applications to build a larger application. The Document Cleanser cleans and converts the active document; the Indexer builds an index for the active document; The Masker hides confidential words in a document. The Files application runs a process on a set of document files on a hard drive. You can, therefore, build a small macro which calls Document Cleanser, Indexer and Masker in sequence on an active document, and apply that process to a set of document files. Clean up all your documents overnight. Yippee!!

Imagine what can happen when Indexer can identify all the interesting words in a document, and TrailBlazer can make hyperlinked trails of all the interesting words throughout a document.

Then imagine what you can do when the Files processor processes all documents in any specified directory tree on your network!

User Interface
==============

Three levels of user interface are supplied- GUI forms, Rules tables and an INI file.

* GUI forms are configurable in real-time. Chris's fun-for-all package allows the user to change GUI form colours, fonts, pointers and captions on-the-fly.
 
* Rules tables form the backbone idea of all applications. The initial table is built in consultation with the user, after which the user can customize the rules as required.
 
* INI files are preferred to the system registry. We have no problem with users being able to see under-the-hood, since each application can easily regenerate an INI file.
 
General Installation Notes

This package is a file prepared in PKZip format. You will see a Word97 template. You can execute this template by double-clicking on it from Windows File Explorer.

Directories
===========

At your discretion you can unzip the application into its own directory and then add in the template from within Word (Tools, Templates and add-ins, Add). The application is smart enough to know where it lives. It will create its INI file and other supporting documents such as rule stables and log files right there in its home directory.

You can uninstall the application by deleting the directory. Poof! All-be-gone! You will elect for the "own" option in selecting a Target template path (Rather than Startup, User or Workgroup).

Of course, an application like Files, whose job it is to wander around the hard drive system doing things on your behalf may well be generating copies or translations of your documents elsewhere, but you'll be aware of that, that's why you're using that application.

The application's working files will all be found in its home directory.

INI files
=========

I have a personal distaste for the Windows System Registry and the problems associated with uninstalling an application. Accordingly I made a design decision to use the ASCII text INI files of old. You, the user, own the INI files. You can inspect and tweak them to your hearts content.

Each application has the ability to re-create its INI file on the fly, an idea I stole from Microsoft and the way they recreate a Normal.dot if it goes missing.

If you mess up your INI file, just rename or delete it and re-run the application.

I use the INI files to store switches, text of latest error message, and a variety of things.

General Operational Notes
=========================

The bulk of the testing is done on my old Office97/SR2 system running under Win95. It ought to work on your system. From time to time I try an application on a WinNT system or Office 2000. I have a small group of mentors who also essay with these applications to humour me. I have no idea what they run on.

Fun For All (Fun4X)
===================

I wrote a little bit of code to demonstrate dynamic changes to GUI forms, and liked the code so much I decided to incorporate it into all my GUI forms.

On each GUI form you will find four tiny command buttons, 4 pixels wide by 4 pixels high. Each of the four buttons has a Control Tip Caption; if you hover the mouse over a button a caption will pop up.

Colours: The top-right button when clicked will bring about a random change in the colour scheme. Chances are you will not like the combination. Click the command button until you find a combination that is pleasing to you.

Each choice is recorded (saved) in the INI file, so the next time you fire up the application, you'll be delighted with your puce-on-salmon colour scheme.

Fonts: Moving clockwise, the lower-right button when clicked will build a list of all fonts on your system. Select a type face and a size and then inspect the "Orright!" button. If you can live with that font, click on Orright. Your GUI form has new fonts.

Each choice is recorded (saved) in the INI file, so the next time you fire up the application, you'll be delighted with your Amazone BT type face in 7.5 point. I hope.

Mouse Pointer: Moving clockwise, the lower-left button when clicked will build a list of all icons on your system C drive. If you have a faster directory search routine than I, we'll talk and I'll release code that hunts across all available drives. The code for drive C takes long enough as it is.

Select an icon name and then hover the mouse over the OK button. Observe the proposed icon shape. If you can live with that icon, click on Orright. Your GUI form has a new mouse pointer.

People choose crazy icons, and my system doesn't have many neat pointers, so your choice will not be recorded (saved) in the INI file. The next time you fire up the application, you'll be presented with the boring standard Windows pointer again.

Captions: Each control (list box, text box, command button etc.) on the GUI has a Control Tip text. If you hover the mouse over a control, a little help box will pop up briefly describing what that control does.

If you get bored with this, click on the upper-left button. The next time you fire up the application, you'll be presented with the boring standard Control Tips again.

Toolbars: I have provided a small toolbar with each application. If you can think of better toolbar button images, please let me know.

Each toolbar comes with a couple of tiny buttons at the left-hand end. 

The "?" button is visible when the rest of the toolbar is squashed off the end of the screen. It tells you the name of the application and the template file name. Also the build number. (During development, the build number increases from zero, but you don't see that!).

The "!" button pops up the GUI form, allowing you to edit your application configuration. It's an easy way to make changes to the application's INI file.

The Trash button deletes the current INI file and re-creates it with useful default values.

Rules Tables
============

Several applications make use of rules tables held in regular Word documents. Indexer and Document Cleanser are classic examples. If you run either one of those applications, it will look for a suitable table; if it can't find one, it will create a default table for you that should get you started. 

The table is yours. You can delete it or edit it at any time. If you edit it so that it is unrecognizable to the application, watch out!

I try to supply a set of sample tables with each application, this, with Indexer you'll find a set of documents with names like Rules01.doc, Rules02.doc and so on. Document Cleanser will come with documents like ROR6.DOC and RORDCW1.DOC (The prefix ROR stands for Rules Of Recognition).

The particular application will include documentation on how to construct and modify the rules tables for that application.

Rules tables are powerful devices. They allow you, the user, to customize an application. For example, the Document Cleanser Rules tables lets you specify non-existent styles and the application will create them on the fly; you can specify macros of your own to be hooked in to the process. You can even tell the application to switch INI files in mid-stream - always a lot of fun, since the application uses the INI file to get the job done.

I generally develop a working rules table for a client, and then train a local user in the maintenance and enhancement of the table; it's not a big job.

Thanks to
=========

Andrew Lockton, Gary Frieder and the gang in Woody's Lounge for especial help in making this a better product.

Auxiliary documentation
=======================

Please inspect the WhatFAQ.DOC for a history of problems, and how they have been solved. You may find listed here some suggestions that had not been implemented at the time of release. If you have an especial need, please contact me by email or telephone as shown in the ReadMe.txt file.

If you are downloading an updated version, please inspect the WhatsNew.DOC for a litany of new features. If you have an especial need, please contact me by email or telephone as shown in the ReadMe.txt file.

The ReadMe.TXT file contains basic information about where to contact me, what files are in the distribution set, and so on.

End User License Agreement

License

Chris Greaves Inc. grants you a non-exclusive license to use this Software free of charge.

If you are using the Software free of charge under the terms of this Agreement, Chris Greaves Inc. may agree to, but is not committed to provide hard-copy documentation, support or telephone assistance.

Disclaimer Of Warranty. 

Free of charge Software is provided on an "AS IS" basis, without warranty of any kind, including without limitation the warranties of merchantability, fitness for a particular purpose and non-infringement. The entire risk as to the quality and performance of the Software is borne by you. Should the Software prove defective, you and not Chris Greaves Inc. assume the entire cost of any service and repair. 

Scope Of Grant

You may: 
 use the Software on one or more computers; 
 use the Software on a network
 copy the Software for archival purposes, provided any copy must contain all of the original Software's proprietary notices.

You may not: 
 modify, translate, reverse engineer, de-compile, disassemble (except to the extent applicable laws specifically prohibit such restriction), or create derivative works based on the Software; 
 rent, lease, grant a security interest in, or otherwise transfer rights to the Software; or 
 remove any proprietary notices or labels on the Software. 

Title

Title, ownership rights, and intellectual property rights in the Software shall remain in Chris Greaves Inc. The Software is protected by copyright laws and treaties. Title and related rights in the content accessed through the Software is the property of the applicable content owner and may be protected by applicable law. This License gives you no rights to such content. 

Termination

The license will terminate automatically if you fail to comply with the limitations described herein. On termination, you must destroy all copies of the Software. 

Limitation Of Liability

Under no circumstances and under no legal theory, tort, contract, or otherwise, shall Chris Greaves Inc. or its suppliers or resellers be liable to you or any other person for any indirect, special, incidental, or consequential damages of any character including, without limitation, damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses. In no event will Chris Greaves Inc. be liable for any damages in excess of the amount Chris Greaves Inc. received from you for a license to the software, even if Chris Greaves Inc. shall have been informed of the possibility of such damages, or for any claim by any other party. This limitation of liability shall not apply to liability for death or personal injury to the extent applicable law prohibits such limitation. Furthermore, some jurisdictions do not allow the exclusion or limitation of incidental or consequential damages, so this limitation and exclusion may not apply to you. 

High Risk Activities

The Software is not fault-tolerant and is not designed, manufactured or intended for use or resale as on-line control equipment in hazardous environments requiring fail-safe performance, such as in the operation of nuclear facilities, aircraft navigation or communication systems, air traffic control, direct life support machines, or weapons systems, in which the failure of the Software could lead directly to death, personal injury, or severe physical or environmental damage ("High Risk Activities"). Chris Greaves Inc. and its suppliers specifically disclaim any express or implied warranty of fitness for High Risk Activities. 

Miscellaneous

If the copy of the Software you received was accompanied by a printed or other form of "hard-copy" End User License Agreement whose terms vary from this Agreement, then the hard-copy End User License Agreement governs your use of the Software. This Agreement represents the complete agreement concerning this license and may amended only by a writing executed by both parties. If any provision of this Agreement is held to be unenforceable, such provision shall be reformed only to the extent necessary to make it enforceable. This Agreement shall be governed by the laws of the Canada.

The software and the associated documentation are copyright (c) 1998-2001 Chris Greaves Inc., all rights reserved. The software may not be circulated in any incomplete or modified form, nor sold for profit, without written permission of Chris Greaves Inc. The software refers to the package in which this license was packed.

If you distribute this software to others, you are required to distribute the ENTIRE package.

Chris Greaves Inc.  (416) 621-9348