Thank you for evaluating Clipper Functions 2.0 for Delphi!

This is a trial version of Clipper Functions.  The only differences between
this trial version and the release version are:

    1.  This version requires the Delphi IDE be running in order to work.
    2.  The release version includes full, well-commented source code.

The steps for installation remain the same for both versions; simply ignore
the references to source (.PAS) files, as the trial version does not include
them.  See the end of this file for order information.

Installing Clipper Functions 2.0 for Delphi can be done in a couple of ways,
depending on whether you want the TPrintScreen and TEnvironment components
added to the Components Palette or not.  Note that in the following
instructions, xx refers to either 16 or 32, depending on which version of
Delphi you are using.  The filenames ending in 16 are for Delphi 1.0x; the
filenames ending in 32 are for Delphi 2.0.  They are not interchangeable!

Regardless of which method you select for using Clipper Functions, you will
start with the following steps:

16-bit for Delphi 1.0x:

    Copy CLIPFN16.* and PRSCRN16.* to a directory on your hard disk where
    you store your 16-bit third party components, or if you desire, a
    new directory.

	Copy CLIPFUNC.HLP to the \DELPHI\HELP directory.

	Copy CLIPFUNC,KWF to the \DELPHI\BIN directory.

32-bit for Delphi 2.0:

    Copy CLIPFN32.* and PRSCRN32.*  to a directory on your hard disk where
    you store your 32-bit third party components, or if you desire, a new
    directory.

    Copy CLIPFUNC.HLP and CLIPFUNC.KWF to the \Borland\Delphi 2.0\Help
    directory.

NOTE:  While it is easier to install two copies of the CLIPFUNC.HLP file,
if disk space is at a premium and you can't afford the approximately 120K
of wasted disk space, you can use one copy of CLIPFUNC.HLP.  Simply install
it in one of the above locations.  When you access it through the Delphi
IDE, Delphi will look in the help index file (DELPHI.HDX) and tell WinHelp
to open the help file; when WinHelp can't find it, you'll be prompted to
find it yourself.  Once you've browsed to the location of CLIPFUNC.HLP and
double-clicked its icon, WinHelp will store the information concerning the
file's location, and you're all set!

To install the CLIPFUNC.HLP file into the Delphi IDE's context sensitive
help system:

1.	Close Delphi if it's running.

2.	For Delphi 1.0x:

    a)  Copy CLIPFUNC.HLP to the \DELPHI\BIN directory.

    b)  Copy CLIPFUNC.KWF to the \DELPHI\HELP directory.

    c)  From the Program Manager Delphi Group, launch HELPINST.  Click the
        Open button (or use the File|Open menu item) and select DELPHI.HDX
        (located in either \DELPHI\BIN or \DELPHI\HELP.  When the file is
        opened, you'll see a list of .KWF files.  Click the Add button (the
        plus sign), and then select CLIPFUNC.KWF from the \DELPHI\HELP
        directory.  Click the Save button (or use the File|Save menu option).

3.	For Delphi 2.0:

    a)  Copy CLIPFUNC.HLP and CLIPFUNC.KWF to the \Program Files\Borland\
        Delphi 2.0\Help folder.

    b)  From Windows Explorer, start \Program Files\Borland\Delphi 2.0\Help\
        Tools\HelpInst.  Click the Open button (or use the File|Open menu
        item) and select DELPHI.HDX (located in \DELPHI\BIN by default).
        When the file is opened, you'll see a list of .KWF files.  Click
        the Add button (the plus sign), and then select CLIPFUNC.KWF from
        the \DELPHI\HELP directory.  Click the Save button (or use the
        File|Save menu option).

4.  Unfortunately, Borland did not provide any progress indicator for the
HDX compilation process; you'll have to monitor disk drive access to tell
when HELPINST is finished (you can almost tell by watching the status bar).
The process doesn't take long - on a P75 with 16MB RAM, the compilation
takes about two seconds. Once HELPINST has finished rebuilding the DELPHI.HDX
file, close down HELPINST and start Delphi.  To make sure that the context-
sensitive help has been sucessfully installed, switch to the Code Editor and
type in the name of any Clipper Functions function (such as AllTrim),
highlight it, and press F1.  WinHelp should load CLIPFUNC.HLP and take you
to the appropriate page.  You're done!

NOTE FOR WINDOWS 95 USERS:  If you get a WinHelp error 'WinHelp cannot
locate CLIPFUNC.HLP. Would you like to find it yourself?', you should
answer 'Yes', and then browse to the location of the CLIPFUNC.HLP file
and double-click the CLIPFUNC.HLP icon.  The help file will load.  This
error is due to Windows 95 storing the help file locations in the Windows
Registry database; once it has been found the first time, WinHelp creates
the Registry entry in which to store the path to the filename.

If you don't wish to utilize the components:

    a)  Add the directory where you placed CLIPFNxx.DCU to Delphi's search
        path using the Project|Options menu selection.  Alternatively, you
        can copy the appropriate DCU file to the Delphi Lib directory.

    b)  To use Clipper Functions in your application, simply add CLIPFNxx
        to the Uses clause in each unit that accesses any of the functions;
        preferably, this should be done in the  Implementation section of
        your unit, to avoid any potential for circular reference errors.

To add the components to the palette (the recommended method):

    a)  Make a backup copy of COMPLIB.DCL (for Delphi 1.0x) or CMPLIB32.DCL
        (for Delphi 2.0), located in the BIN directory.

    b)  From the Delphi IDE menu, select either Options|Install Components
        for Delphi 1.0x or Components | Install for Delphi 2.0.  Click the
        'Add' button, and Browse to the directory where you copied the
        DCU/DCR files. You'll need to change the default file extension in
        the File Open dialog from *.PAS to *.DCR.  Double-click either the
        CLIPFNxx or PRSCRNxx file, or single-click the filename and then
        click the OK button.  Repeat this process for the other DCU file.

    c)  Next, click OK from the Install Components dialog, and wait while Delphi rebuilds the Component Library.  When the rebuild is complete, you'll see a new 'ClipFunc' page on your Components Palette, containing two components; the red toolbox is TEnvironment, the camera is TPrintScreen.
The files included on the diskette are:

CLIPFN16.DCU   16-bit Clipper Functions and TEnvironment compiled unit for Delphi 1.0x
CLIPFN16.PAS*  16-bit Clipper Functions and TEnvironment source code
CLIPFN32.DCU   32-bit Clipper Functions and TEnvironment compiled unit for Delphi 2.0
CLIPFN32.PAS*  32-bit Clipper Functions and TEnvironment source code
PRSCRN16.PAS*  16-bit TPrintScreen component source code for Delphi 1.0x
PRSCRN16.DCU   16-bit compiled TPrintScreen unit for Delphi 1.0x
PRSCRN16.DCR   16-bit TPrintScreen component palette resource file
PRSCRN32.PAS*  32-bit TPrintScreen component source code for Delphi 2.0
PRSCRN32.DCU   32-bit compiled TPrintScreen unit for Delphi 1.0x
PRSCRN32.DCR   32-bit TPrintScreen component palette resource file
CLIPFUNC.KWF   Help Key Word File for installation into Delphi's help system for 
               context sensitive help in the IDE
CLIPFUNC.HLP   Documentation in WinHelp 3.x format
README.TXT     Readme file in ASCII text format
README.DOC     Readme file in Word for Windows format

* Indicates source code files included only in the release version.

In addition to the above files, the MAIN_16.* and CFDEMO16.* files are a demonstration 
application for Delphi 1.0; MAIN-32.* and CFDEMO32.* files are the demonstration app for 
Delphi 2.0.  To view the demo, you can simply open the appropriate project file in the 
appropriate Delphi IDE, and then run the demo.  If you receive any error messages, it is 
most likely because you either have not yet installed the components, or you have elected 
not to install the components and did not add the location of the DCU files to the project's 
search path.

Ordering Clipper Functions 2.0 for Delphi
-----------------------------------------
Clipper Functions 2.0 is priced at $69.00 US, and is available from the following sources:

    ZAC's Delphi Only Tools Catalog          1-800-GO-DELPHI (1-800-463-3574) or
                                             sales@zaccatalog.com

    Direct from Author:

    Visa/MasterCard Orders:                  NorthStar Solutions (my credit card processors)
    (10:00AM - 10:00PM EST)                  1-800-699-6395 (US Only)
                                             1-803-699-6395 (Outside US)
                                             CompuServe: 71561, 2751
                                             AOL: STARMAIL
                                             Internet:  71561.2751@compuserve.com

    Check or Money Order (US Funds)          Ken White
                                             68A Champlain Street
                                             Plattsburgh, NY 12901
                                             USA

Shipping via US or International Mail is free when ordering direct; Federal Express shipping is
also available at an additional charge.  ZAC makes their own arrangements for shipping; if 
ordering from ZAC, please discuss shipping arrangements with their sales staff when placing the
order.

Please note that NorthStar Solutions is only a credit card processing company, and does not 
provide answers to technical questions; they also do not process payments other than via 
Visa or MasterCard.
