========================================================================
           ApplyIt! Software Reporting Engine (ARE) ReadMe.txt
                         Package Description

Thank you for choosing ARE for use or evaluation purposes.

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

                        System Requirements


To run ARE run-time your system must comply with these requirements
    - IBM Compatible PC
    - MS Windows 95, NT 4.0, or later versions of Windows
    - Installed and configured Windows printer 
    - MFC run-time libraries: MSVCP60.DLL (can be downloaded from
      http://www.applyitsoftware.com/download/mfc.zip 116Kb)
    - 500 Kb free disk space.

Please note that Windows 3.1 with Win32s is not supported.

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

                   Installation and Distribution Guide


To install ARE on your computer you need:
1) Download ARE installation package.
   http://www.applyitsoftware.com/download/are.zip
2) Extract downloaded archive in any temporary folder.
3) Run setup.exe from this folder to automatically install ARE and follow
instrunctions on the screen.

To uninstall ARE from your computer run uninstall.exe from ARE home
folder, created previously.

To distribute your application with built-in report generation
functionality from ARE you need to put ARE run-time (Reports.dll) in the
same folder with your application and deliver them together.
Please note that ARE run-time still requires MFC run-time libraries as
described in System Requirements.

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

			  Summary Feature List


This section provides you with brief overview of ARE features. For more
information please read Reporting Engine Documentation.

Version 1.1

Report Functions
    New functions: {Report Preview}
   
Report Layout
    New allowed objects: {Image, Rectangle}

Version 1.0

Data Source
    "External"
    You must provide ARE with callback functions to retrieve data to be
    presented in the report

Data Fields
    You can define up to 1024 fields to present data.
    
    Allowed field types: {String}

Styles
    You can define up to 1024 styles to describe colors and text faces.
    Style inheritance is not allowed.

Report Layout
    Report layout is organized of bands. Band is rather logical object,
    which is not presented in report. Every band is organized of
    presentation objects.
    You can specify style for whole band or assign it individually to
    every object on band.

    Allowed bands: {Header, Detail, Footer}
    Allowed objects: {Field, Label, Line}

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

			Summary File Description


Please, read summary description of files, which are delivered to you in
ApplyIt! Reporting Engine package.

Doc/
    This folder contains documentation for ARE. You can also access this
    documentation on-line at http://www.applyitsoftware.com/.

Doc/ANSI.shtml
    Specification of Reports.DLL exported interfaces with usage hints.
    http://www.applyitsoftware.com/ANSI.shtml
Doc/CPP.shtml
    Specification of wrapper-classes to use with your C++ IDE.
    http://www.applyitsoftware.com/CPP.shtml
Doc/XML.shtml
    Specification of XML Report Definition with examples and hints.
    http://www.applyitsoftware.com/XML.shtml

Library/
    This folder contains run-time and development files.

Library/Reports.dll
    This is a run-time library of ARE, which implements all report
    generation functionality.

Library/cReport.h
Library/cReport.cpp
    These files are declaration and implementation of cReport wrapper-class,
    which presents Report object in your application through access to ARE
    run-time (Reports.DLL).

Library/cReportsDLL.h
Library/cReportsDLL.cpp
    These files are declaration and implementation of cReportsDLL 
    wrapper-class to access ARE run-time (Reports.dll).

Library/RepCBFunctions.h
    This header file declares prototypes of your data-retrieval
    procedures.

Sample/MSVC/
Sample/MSVC/SampleApp.dsw
Sample/Borland/
Sample/Borland/SampleApp.bgp
    Sample/ folder contains ready-to-go sample applications, which will
    learn you how to generate reports in your application with use of
    Reporting Engine.
    To open a sample project you must open project file, corresponding
    to your IDE, as listed above, build it and run sample application
    either from your IDE or command line.

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

                          How to Register


If you are satisfied with evaluation of ARE you can become a registered
user.
Just jump to http://www.applyitsoftware.com/order.shtml and follow
instruction on the page.
For your convenience we let you to choose one of registrators to put
your order.

We price ARE as follows
1 development license		$25 (*)

* including unlimited distribution


When you will be registered to use ARE you have to put Registration Key
into resource list of every application you will create.

    Sample Application (Microsoft Visual C++)
    To add Registration Key into your application, open ResourceView tab,
    then open String table, find string ID = ARE_D_REGISTRATIONKEY, copy
    your registration key into a clipboard and paste it into highlighted
    string resource.

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

                          Important Notes


If you are using Borland Delphi, Microsoft Visual Basic or other not C++
IDEs and you would like to add ARE functions into your application, you
must use ANSI C specification of Reports.DLL
http://www.applyitsoftware.com/ANSI.shtml

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