Thank you for evaluating Frankie v2.2x - the premiere library of mouseable
user interface engines for CA-Clipper 5.x.


Contents of this Evaluation Package
-----------------------------------
This evaluation package contains the following files:

1.  Readme      - this file
2.  Frankie.exe - self-extracting file containing the FULLY functional 
                  library, include and demo files.

    NOTE: You may also want to download FRANKG.ZIP which contains the
          Frankie NG database file.


Questions?
----------
Should you have any questions please contact Lito Dizon at:

   CompuServe:          71165,1023
   Internet:            adizon@us.net
   BBS                  (301)464-1372
                        Modem setting: 8-N-1
   Mailing address:     9753 Oatley Lane
                        Burke, VA 22015
   Phone:               (703) 569-0840


Users of older Frankie Versions
-------------------------------
If you are a user of an older version of Frankie please make sure you read
the 'What's New in v2.2x?' section of the NG file.


Quick Start
-----------
1.  Read the DISCLAIMER and LICENSE sections at the bottom of this file.  Do 
    not proceed with the rest of these steps if you do not agree with the 
    provisions therein.  By proceeding with the rest of these steps you 
    are explicitly indicating that you are in total agreement with the all 
    the DISCLAIMER's and LICENSE's provisions.

2.  Create a Frankie evaluation directory on your hard drive.  From here on,
    this directory will be referred to as the Frankie directory.

3.  Run FRANKIE.EXE in the Frankie directory.  This is a self-extracting 
    file containing all the Frankie library, include and demo files.  When
    the extraction process is done, you may delete Frankie.exe.  See the 
    section 'Frankie Files List' for a  complete listing of the extracted 
    files.

4.  Build F_TOUR.EXE.  A number of batch files were extracted onto the 
    Frankie directory.  Use them to build F_TOUR.EXE.  Select the batch file
    that corresponds to your linker.

    CRFRANK.BAT  - if you use .RTlink
    CBFRANK.BAT  - if you use Blinker earlier than 3.0
    CBFRANKP.BAT - if you use Blinker 3.0 or later
    CEFRANK.BAT - if you use Exospace
    CCFRANK.BAT - if you use Causeway

    NOTE.  If you use CA-Clipper 5.01, see also the section 'NOTE TO CLIPPER
           5.01 USERS' below.
    
5.  Run the F_TOUR.EXE that you just built.  This is a _live_ demo of the
    major features of Frankie.    

6.  If you do not already done so, download FRANKG.ZIP.  It contains the
    Frankie NG reference database.  Unzip the file onto your NG directory.  
    It will yield FRANKI22.NG.

7.  You are now ready to develop Clipper applications.  If you are reasonably
    comfortable with codeblocks and arrays, you will find Frankie easy to
    use.  The tutorial in the NG and the _tons_ of examples will greatly 
    speed up the learning curve.

8.  There is no registration information in this Readme file.  I am confident
    you will find this info somewhere else in the Frankie package when you
    are ready.  Till then, enjoy evaluating Frankie!  If it takes you more
    than two months to evaluate, you may want to find out if an updated
    version has been released.  Download FRANKN.ZIP from the same electronic
    site you downloaded Frankie from.  It contains up-to-date Frankie info.


Frankie Files List
------------------
   Files in \frankie
   -----------------
   ENGINES.F     -  text files discussing Frankie engines
   FUNCLIST.F    -
   OVERVIEW.F    -
   OVERVIEW.BM   -
   OVERVIEW.DB   -
   OVERVIEW.FV   -
   OVERVIEW.GM   -
   OVERVIEW.HM   -
   OVERVIEW.HP   -
   OVERVIEW.PB   -
   OVERVIEW.RB   -
   OVERVIEW.RD   -
   OVERVIEW.SB   -
   OVERVIEW.VM   -

   F2_501.LIB    -  Frankie library and include files
   FRANKIE.LIB   -
   F2_501.CH     -  
   FRANKIE.CH    -

   CBFRANK.BAT   -  Batch files for building F_TOUR.EXE
   CBFRANKP.BAT  -
   CCFRANK.BAT   -
   CEFRANK.BAT   -
   CRFRANK.BAT   -

   BM_DEMO.CLP   -  CLP, LNK and RMK files for building F_TOUR.EXE
   DB_DEMO.CLP   -
   FV_DEMO.CLP   -
   GM_DEMO.CLP   -
   HM_DEMO.CLP   -
   HP_DEMO.CLP   -
   NEWDEMOS.CLP  -
   PB_DEMO.CLP   -
   RB_DEMO.CLP   -
   RD_DEMO.CLP   -
   SB_DEMO.CLP   -
   USERDEMO.CLP  -
   VM_DEMO.CLP   -
   F_TOUR.LNK    -
   F_TOURC.LNK   -
   F_TOURE.LNK   -
   F_TOURP.LNK   -
   F_TOURR.LNK   -
   F_TOUR.RMK    -

   F_TOUR.CH     -  F_TOUR.EXE source files
   F_TOUR.PRG    -
   MISC.PRG      -
   TOURS.PRG     -

   CUSTOMER.DBF  -  F_TOUR.EXE data files
   DEMO.DBF      -
   EMPLOYEE.DBF  -
   HARDWARE.DBF  -
   HOTEL.DBF     -
   SOFTWARE.DBF  -
   STATES.DBF    -
   DEMO.DBT      -
   EMPLOYEE.DBT  -
   CUSTOMER.NTX  -
   EMP_FNAM.NTX  -
   EMP_NAME.NTX  -
   EMP_NUM.NTX   -
   HARDWARE.NTX  -
   H_STATE.NTX   -
   SOFTWARE.NTX  -
   STATES.NTX    -
   SW_NAME.NTX   -

   F_TOUR.HLP    -  F_TOUR.EXE Help files
   F_TOUR.HLX    -

   REGISTER.FRM  -  Registration forms
   UPGRADE.FRM   -

   DB_COLUM.TXT  -  Discussion of the ADdb_column() API
   TECHSUPT.TXT  -  Tech support info
   USERS.TXT     -  What Users Say About Frankie

   Files in \frankie\sample
   ------------------------
   BM_DEM01.PRG  -  Dialog Box examples
   BM_DEM02.PRG
   BM_DEM03.PRG
   BM_DEM04.PRG
   BM_DEM05.PRG
   BM_DEM06.PRG
   BM_DEM07.PRG
   BM_DEM08.PRG
   BM_DEM09.PRG
   BM_DEM10.PRG
   BM_DEM11.PRG

   DB_DEM01.PRG  -  Database browser examples
   DB_DEM02.PRG
   DB_DEM03.PRG
   DB_DEM04.PRG
   DB_DEM05.PRG
   DB_DEM06.PRG
   DB_DEM07.PRG
   DB_DEM08.PRG
   DB_DEM09.PRG
   DB_DEM10.PRG
   DB_DEM11.PRG
   DB_DEM12.PRG
   DB_DEM13.PRG
   DB_DEM14.PRG
   DB_DEM15.PRG
   DB_DEM16.PRG
   DB_DEM17.PRG
   DB_DEM18.PRG
   DB_DEM19.PRG
   DB_DEM20.PRG
   DB_DEM21.PRG
   DB_DEM22.PRG
   DB_DEM23.PRG

   FV_DEM01.PRG  -  File viewer examples
   FV_DEM02.PRG
   FV_DEM03.PRG
   FV_DEM04.PRG

   GM_DEM01.PRG  -  Boxed Gets examples
   GM_DEM02.PRG
   GM_DEM03.PRG
   GM_DEM04.PRG
   GM_DEM05.PRG
   GM_DEM06.PRG
   GM_DEM07.PRG

   HM_DEM01.PRG  -  Horizontal menu examples
   HM_DEM02.PRG
   HM_DEM03.PRG
   HM_DEM04.PRG

   HP_DEM01.PRG  -  Help facility examples
   HP_DEM02.PRG
   HP_DEM03.PRG
   HP_DEM04.PRG

   PB_DEM01.PRG  -  Push buttons examples
   PB_DEM02.PRG
   PB_DEM03.PRG
   PB_DEM04.PRG
   PB_DEM05.PRG
   PB_DEM06.PRG
   PB_DEM07.PRG

   RB_DEM01.PRG  -  Radio buttons examples
   RB_DEM02.PRG
   RB_DEM03.PRG
   RB_DEM04.PRG

   RD_DEM01.PRG  -  Get/Read examples
   RD_DEM02.PRG
   RD_DEM03.PRG
   RD_DEM04.PRG
   RD_DEM05.PRG
   RD_DEM06.PRG
   RD_DEM07.PRG
   RD_DEM08.PRG
   RD_DEM09.PRG
   RD_DEM10.PRG
   RD_DEM11.PRG
   RD_DEM12.PRG
   RD_DEM13.PRG
   RD_DEM14.PRG
   RD_DEM15.PRG
   RD_DEM16.PRG
   RD_DEM17.PRG
   RD_DEM18.PRG
   RD_DEM19.PRG

   SB_DEM01.PRG  -  Scroll bar examples
   SB_DEM02.PRG
   SB_DEM03.PRG

   VM_DEM01.PRG  -  Vertical menu examples
   VM_DEM02.PRG
   VM_DEM03.PRG
   VM_DEM04.PRG
   VM_DEM05.PRG
   VM_DEM06.PRG
   VM_DEM07.PRG
   VM_DEM08.PRG
   VM_DEM09.PRG
   VM_DEM10.PRG
   VM_DEM11.PRG
   VM_DEM12.PRG
   VM_DEM13.PRG
   VM_DEM14.PRG
   VM_DEM15.PRG
   VM_DEM16.PRG
   VM_DEM17.PRG
   VM_DEM18.PRG
   VM_DEM19.PRG
   VM_DEM20.PRG
   VM_DEM21.PRG
   VM_DEM22.PRG
   VM_DEM23.PRG

   CB.BAT        -  Batch files for building the sample programs
   CR.BAT

   RD_TOUR.HLP   -  Help files
   RD_TOUR.HLX

   Files in \frankie\newdemo
   -------------------------
   FDEM03.PRG  -  More examples
   FDEM04.PRG
   FDEM05.PRG
   FDEM06.PRG
   FDEM07.PRG
   FDEM08.PRG
   FDEM09.PRG
   FDEM10.PRG

   FDEM03.DBF  -  Data file

   NEWDEMOS.HLP  -  Help Files
   NEWDEMOS.HLX

   CB.BAT  -  Batch files to build the examples
   CR.BAT

   Files in \frankie\userdemo
   --------------------------
   UDEM01.PRG  -  Examples submitted by Frankie users
   UDEM02.PRG
   UDEM03.PRG
   UDEM04.PRG

   PAM.DBF   -  Data files
   PAM1.NTX

   CB.BAT  -  Batch files to build the examples
   CR.BAT

NOTE TO CLIPPER 5.01 USERS
--------------------------
If you are using Clipper 5.01,  #include F2_501.CH in your programs.
Its correct placement is "before" FRANKIE.CH, like this:

    #include F2_501.CH
    #include FRANKIE.CH

If you do not do so, the mouse will not work properly with ADread(), which
is the Frankie replacement of the GetSys.Prg.

Also link F2_501.LIB, together with, but ahead of FRANKIE.LIB.
Your link command may thus look like this:

    blinker file MYFILE lib F2_501, FRANKIE

or:

    rtlink  file MYFILE lib F2_501, FRANKIE

If you do not properly link F2_501.LIB, you may get "undefined symbols"
warnings during linking, and the resulting .exe file may not work
properly.  However, if "CLIPPER520" is the only undefined symbol
encountered, you need not worry about it.


DISCLAIMER
----------
THE PROGRAMMER'S DESK DISCLAIMS ALL WARRANTIES RELATING TO THIS SOFTWARE,
WHETHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, AND ALL
SUCH WARRANTIES ARE EXPRESSLY AND SPECIFICALLY DISCLAIMED.  NEITHER
THE PROGRAMMER'S DESK NOR ANYONE ELSE WHO HAD BEEN INVOLVED IN THE CREATION,
PRODUCTION, OR DELIVERY OF THIS SOFTWARE SHALL BE LIABLE FOR ANY INDIRECT,
CONSEQUENTIAL, OR INCIDENTAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO
USE SUCH SOFTWARE EVEN IF THE PROGRAMMER'S DESK HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES OR CLAIMS.  IN NO EVENT SHALL THE PROGRAMMER'S
DESK'S LIABILITY FOR ANY DAMAGES EVER EXCEED THE PRICE PAID FOR THE LICENSE
TO USE THE SOFTWARE, REGARDLESS OF THE FORM OF CLAIM.  THE PERSON USING THE
SOFTWARE BEARS ALL RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE.



LICENSE
-------
Frankie is copyrighted material (COPYRIGHT (c) 1992-94 by Angelito Dizon,
All rights reserved.)  Frankie is not public domain nor free software.  The
registered version of Frankie may not be duplicated other than for backup
purposes.  The same registered copy of Frankie may not be used in more than
one computer at the same time.

