***************************************************************************
* COMPOUND DOCUMENT FRAMEWORK OVERVIEW OF SAMPLES - Version 1: Readme File*
*                                                                         *
* COPYRIGHT: Copyright(C) International Business Machines Corp.,1992,1996.*
*                                                                         *
* DISCLAIMER OF WARRANTIES:                                               *
*   The following [enclosed] code is sample code created by IBM           *
*   Corporation.  This sample code is not part of any standard IBM product*
*   and is provided to you solely for the purpose of assisting you in the *
*   development of your applications.  The code is provided "AS IS",      *
*   without warranty of any kind.  IBM shall not be liable for any damages*
*   arising out of your use of the sample code, even if they have been    *
*   advised of the possibility of such damages.                           *
*-------------------------------------------------------------------------*
* See the IBM User Interface Class Library User's Guide                   *
*   for more information about this sample program.                       *
*                                                                         *
* CDF (Compound Document Framework) Samples - overview of all 6 samples   *
*                                             =========================   *
*  DESCRIPTION:                                                           *
*   - aCDF1 Sample 1 is a "Hello World" basic CDF server with fixed       *
*           data, model/view, streaming, full OLE server                  * 
*   - aCDF2 Sample 2 is a more advanced CDF server with 2 entry fields,   *
*           User Interface control handlers, notifications,               *
*           flattening/resurrecting of objects.                           *
*   - aCDF3 Sample 3 is a basic CDF container (and server)                *
*   - aCDF4 Sample 4 is a more advanced CDF container with iteration      *
*           through contained objects, resizing, etc.                     *
*   - aCDF5 Sample 5 used a CDF server to show collection operations      *
*           and collection streaming                                      *
*   - aCDF6 Sample 6 is a CDF port of the ICLUI HELLO5 sample including   *
*           graphics and help.                                            *
*                                                                         *
* TASK:                                                                   *
*                                                                         *
* CONCEPTS/FEATURES:                                                      *
* - These samples illustrate how to create derived model and view classes *
*   from the Compound Document Framework. Very few modifications are need *
*   to be made as the inherited classes provided most of the requirements.*
*   Thus it is easy to develop OLE based Compound Document Applications   *
*                                                                         *
* SPECIAL NOTES (BUILD OPTIONS):                                          *
* =============  =============                                            *
* - compile/link options used by all samples are in aCDFmake\aCDF.mak     *
* - "set CDF_STATIC=1" prior to running nmake if you wish to build an EXE *
*   which is statically linked to the ICLUI runtimes (otherwise the       *
*   default is to to use the ICLUI system DLLs).                          *
* - "set CDF_DEBUG=1" to build a debug version (/Ti+) with browser data   *
*   (/Fb+) and performance analysis (/Gh+) and no optimization (/O-).     *
*   This also creates a command-line output window (/pmtype:vio).         *
*   NOTE: the prebuilt debug EXE does not have a command-line window.     *
* - "set CDF_DEBUG=1" also enables ICLUI tracing in the samples since it  *
*   defines /dIC_TRACE_DEVELOP during compilation.                        *
* - "set ICLUI TRACETO=STDOUT" and "set ICLUI TRACE=ON" to view the trace.*
***************************************************************************
* HOW TO RUN THE PROJECT FROM THE COMMAND LINE:                           *
*                                                                         *
* All the sample applications can be built by entering:                   *
*     nmake                                                               *
* with no options while in the aCDFmake directory containing the Compound *
* Document Framework Makefile and aCDF.mak make flags.                    *
* Makefile This will generate sever executable files called:              *
*     aCDF1\aCDF1.exe                                                     *
*     aCDF2\aCDF2.exe                                                     *
*     aCDF3\aCDF3.exe                                                     *
*     aCDF4\aCDF4.exe                                                     *
*     aCDF5\aCDF5.exe                                                     *
*     aCDF6\aCDF6.exe                                                     *
* which can each be run from the command line.                            *
* To clean up the files generated from running make, enter:               *
*     nmake clean                                                         *
*                                                                         *
***************************************************************************
* HOW TO RUN THE PROJECT FROM WITHIN THE WORKFRAME ENVIRONMENT:           *
*                                                                         *
* WorkFrame needs to be run for each sample individually.  For example,   *
* The sample 1 WorkFrame project can be opened moving into the aCDF1      *
* sample directory and then entering:                                     *
*     iwf aCDF1.iwp                                                       *
* The sample can be rebuilt by selecting the WorkFrame menu items:        *
*     "Project" and "Build All" (or press the "Build ALL" toolbar button) *
* The sample can be run by selecting the WorkFrame menu items:            *
*     "Project" and "Run" (or double click on the aCDF1.exe icon)         *
***************************************************************************
* ADDITIONAL INFORMATION:                                                 *
*                                                                         *
* For additional information on this and other samples shipped            *
* with the VisualAge for C++ product, please see the Guide to Samples     *
* notebook.                                                               *
*                                                                         *
* To access the notebook from Program Manager, open the VisualAge for     *
* C++ product object, then open the Guide to Samples notebook.            *
***************************************************************************
* SHIPPED FILE LIST:                                                      *
*                                                                         *
*       Readme.txt      - Overview of all 6 samples and overall Make      *
*       aCDF.mak        - Generic build flags used by each sample Makefile*
*       Makefile        - Makefile which invokes all 6 sample Makefiles   *
***************************************************************************
