***************************************************************************
*  RTTI SAMPLE PROJECT: Readme File (README)                              *
*                                                                         *
* COPYRIGHT: Copyright(C) International Business Machines Corp.,1992,1995.*
*                                                                         *
* DISCLAIMER OF WARRANTIES:                                               *
*   The accompanying code is sample code created by the 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.                 *
***************************************************************************
SAMPLE - RTTI
   DESCRIPTION:
        RTTI is a C++ program that uses the new runtime type information 
        supported by the compiler. The test case uses the new 'typeid'
        and the new 'dynamic_cast' operator'.

   TASK:
        The program creates a company with a list of employees.
        The list is traversed at runtime to calculate the company payroll.

   CONCEPT/FEATURE:
        The new 'typeid' operator is used to identify at runtime the type 
        an object pointed to by a pointer, that is, the type of of employee 
        (either manager or programmer) found in the company's list. 

        The new 'dynamic_cast' operator is used to perform a safe down cast, 
        from a pointer to a base class type to a pointer to a derived class
        type, that is, from a pointer to 'employee', which is the generic 
        type describing the employees of the company, to a pointer to a
        manager or programmer type, which describes in more specific 
        details the attributes of each company's employees.
 
   PROJECT LOCATION:
        Inside the COMPILER Sample folder (inside the VisualAge C++ 
        SAMPLES folder).

   SOURCE FILE LOCATION:
        X:\ibmcpp\samples\compiler\rtti

        where X: is the drive you installed the samples and document
        component of VisualAge C++.


HOW TO RUN THE SAMPLE:

   FROM THE COMMAND LINE:
        Simply type the name of the .EXE file, that is:

            MAIN


HOW TO BUILD THE SAMPLE PROJECT YOURSELF:

   FROM THE COMMAND LINE:
        A makefile file is provided to allow rebuilding of the WorkFrame
        projects from the command line.  Simply type:

            NMAKE /f RTTI_PPC.mak

        To run the sample project, see HOW TO RUN THE SAMPLE
        project above.


SOURCE FILES - RTTI

   Required files:

   READ.ME
        Description and instructions for the sample.

   RTTI_NT.mak
        This makefile builds the RTTI application.

   MAIN.EXE
        Sample's executable file.

   USER.H
        User defined classes.

   IMPL.H
        Classes provided by a library vendor.

   USER.CPP
        Definitions of member functions for user defined classes.

   IMPL.CPP
        Definitions of member functions provided by library vendor.

   MAIN.CPP
        The applications main CPP source file.

