

     ============================README.==================================
                       SmartLog(TM) version 2.02
               Run-time Error Handler for CA-Clipper 5.x
                (c)Copyright 1992-93 MetaGroup Software
                          All Rights Reserved
     =====================================================================

     QUICK START:

     1. Read this file to get some background
     2. Run SLDEMO to see the benefits of SmartLog
     3. Read SL.DOC for detailed description of SmartLog
     4. Link SL.LIB to your applications and test it
     5. Go back to SLDEMO and print the order form (I hope!)

     SmartLog (SL) is a replaceable run-time error handling system for
     CA-Clipper development platform version 5.01 and higher. It provides
     the most comprehensive debugging and profiling information and allows
     for logging run-time errors to a text file on disk. Many aspects of
     SL operation can be customized. It is a perfect tool for Clipper
     power-users, developers and error trapping and reporting in a
     corporate environment. It proves to be especially useful and
     time-saving utility for remote program diagnostics and for bug
     reporting on complex CA-Clipper systems.

     All it takes to use SL with your application is a single call to
     SmartLog at the top of your program. You won't notice it's there
     until you need to track down that elusive and inconsistent bug your
     users have been reporting. You'll then learn to value the
     professional bug-reporting and system-profiling capabilities of
     SmartLog. SmartLog also allows for trapping errors not directly
     related to problems in your source code but rather problems in the
     general computing environment.

     SmartLog will surely pay for itself in time saved after just one
     phone call from a desperate user. Note that the complete error log
     can be immediately printed and either mailed, faxed or downloaded
     to you for close inspection.

     NOTE: SmartLog requires the presence of the FUNCky library at link
     time, and optionally the NetLib library if you use the network
     reporting features of SlErrorN(). While requiring the presence of
     one or two additional libraries may seem limiting, it may actually
     improve the size and performance of your application as opposed to
     using a stand-alone error handler. SmartLog uses FUNCky functions
     which are likely to be used elsewere in an application. A
     stand-alone handler would ony duplicate the code which does the
     same thing. The wide-spread use and a highly optimized code of
     these fine libraries is, in our opinion, a reasonable trade-off. If
     the demand warrants, support for other libraries will be added in
     the future. Note that you may use other network libraries to report
     the network status through the aCustom parameter.

     SmartLog is a shareware. You are allowed to use and test it free for
     30 days. If you decide to use it after that time please register your
     copy. You are also encouraged to spread the word about SL: please
     give a copy to your fellow Clipper developers, upload a copy to your
     favorite bulletin boards, or distribute copies at your Clipper user
     group meeting. For more information on the shareware concept see the
     SHARWARE.DOC file.
     



     BENEFITS OF REGISTRATION:

       * most current version of SL library with no confirmation box
       * technical support
       * notices of upgrades
       * substantial discounts on future versions
       * customizations available


     LIST OF DISTRIBUTION FILES:

       SL.LIB       - shareware version of SL in library format
       README.      - this file
       SL.DOC       - documentation for SL (formatted to print
                      by "COPY SL.DOC PRN")
       LICENSE.DOC  - license agreement for SL
       SHARWARE.DOC - information on shareware concept
       ORDER.FRM    - registration/order form
       SLDEMO.EXE   - SL demo program
       CUSTOMER.DBF - used by SLDEMO.EXE
       ORDERS.DBF   - used by SLDEMO.EXE
       FILE_ID.DIZ  - signature file for BBS

     IMPORTANT DEMO NOTES:

     1. SmartLog demo may be started in an extended video mode by typing
        SLDEMO /x where x can be 25, 43 or 50 lines. Check the error log
        for these switches too!

     2. To return to the main DEMO menu after generating an error choose
        the BREAK option. If BREAK has been disabled you must QUIT and
        restart SmartLog DEMO.

     3. GetSecurity() is a sample function (always returning "5") to show
        the use of code blocks in the custom environment section. Select
        [OPTIONS] in DEMO program to see its use.

     ---------------------------------------------------------------------

          MetaGroup Software                   Tel: (714)638-8663
          12103 S. Brookhurst St.              Fax: (310)495-0889
          Suite E-410                          CompuServe: 72400,2726
          Garden Grove, CA 92642-3065
          U.S.A.

        For volume discounts, user group discounts, site licenses and
      source code availability call MetaGroup Software at (714)638-8663.

     =====================================================================
