home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / IOC / HELLO2 / README < prev   
Text File  |  1995-06-09  |  6KB  |  164 lines
  1. ***************************************************************************
  2. * HELLO WORLD SAMPLE PROGRAM - Version 2: Readme File readme              *
  3. *                                                                         *
  4. * COPYRIGHT: Copyright(C) International Business Machines Corp.,1992,1995.*
  5. *                                                                         *
  6. * DISCLAIMER OF WARRANTIES:                                               *
  7. *   The following [enclosed] code is sample code created by IBM           *
  8. *   Corporation.  This sample code is not part of any standard IBM product*
  9. *   and is provided to you solely for the purpose of assisting you in the *
  10. *   development of your applications.  The code is provided "AS IS",      *
  11. *   without warranty of any kind.  IBM shall not be liable for any damages*
  12. *   arising out of your use of the sample code, even if they have been    *
  13. *   advised of the possibility of such damages.                           *
  14. ***************************************************************************
  15. Hello World
  16.  
  17.    These samples, which begin with hello1 and increase in complexity and
  18.    function up to hello6, progressively demonstrate many of the
  19.    capabilities of the User Interface Class Library.
  20.  
  21.    o   "Hello World 1"
  22.    o   "Hello World 2"
  23.    o   "Hello3"
  24.    o   "Hello4"
  25.    o   "Hello5"
  26.    o   "Hello World 6"
  27.  
  28. Hello World 2
  29.  
  30.    DESCRIPTION:
  31.  
  32.         The second version of Hello World replaces the trivial
  33.         implementation of hello1 with a more common programming approach.
  34.         The frame window used in the main portion of the application is a
  35.         subclass of IFrameWindow that has a static text control and a new
  36.         status area at the bottom of the frame which is created using the
  37.         IInfoArea class.  The specification for this new frame window
  38.         class is stored separately in a C++ file with an extension of
  39.         .hpp.  Also, text strings are stored outside the application in a
  40.         .rc resource file.
  41.  
  42.         Visually, however, the hello1 and hello2 samples are identical
  43.         except for the information area.
  44.  
  45.  
  46.    PROJECT LOCATION:
  47.         Inside the IOC Samples folder (inside the VisualAge C++ Samples
  48.         folder). 
  49.  
  50.    SOURCE FILE LOCATION:
  51.         X:\ibmcpp\samples\ioc\hello2
  52.  
  53.         where X: is the drive you installed the samples and document
  54.         component of VisualAge C++.
  55.  
  56.    HOW TO RUN THE SAMPLE:
  57.  
  58.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  59.              To run the prebuilt project, open the Samples folder on your
  60.              OS/2 desktop then double-click on the project's icon to open
  61.              the project view of the sample.  Click on the RUN button of
  62.              the project's toolbar.
  63.  
  64.         FROM THE COMMAND LINE:
  65.              Simply type the name of the .EXE file, that is:
  66.  
  67.                  HELLO2
  68.  
  69.              If the sample fails to execute or abnormally ends, you can
  70.              get more information about the failure by turning on the
  71.              ICLUI trace.  This is done by setting the environment
  72.              variable ICLUI_TRACE as follows:
  73.  
  74.                    set ICLUI_TRACE=ON
  75.                    set ICLUI_TRACETO=STDERR
  76.  
  77.              The second export controls where the trace information is
  78.              reported.  With tracing turned on, ICLUI exception text will
  79.              be written to a standard error file. For example:
  80.  
  81.                    hello1 >hello1.out 2>&1
  82.  
  83.              The exception data is now in the file hello1.out.
  84.  
  85.    HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
  86.  
  87.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  88.              Open the Samples folder on your OS/2 desktop then
  89.              double-click on the project's icon to open the project view
  90.              of the sample. In the upper half of the project window you
  91.              will see the icons of the files associated with the sample.
  92.              From the Project pulldown, select Build -> Rebuild All.  To run
  93.              the sample project, see HOW TO RUN THE SAMPLE PROJECT above.
  94.  
  95.         FROM THE COMMAND LINE:
  96.            - A command file is provided to allow rebuilding of the
  97.              WorkFrame projects from the command line.  Simply type:
  98.  
  99.                  BUILD
  100.  
  101.              To run the sample project, see HOW TO RUN THE SAMPLE PROJECT 
  102.              above.
  103.  
  104.            - The sample application can also be built by entering:
  105.                  NMAKE
  106.              with no options while in the directory containing the
  107.              sample application files.  The makefile is named
  108.                  Makefile
  109.              To clean up the files generated from running make, enter:
  110.                  NMAKE CLEAN 
  111.              while in the directory containing the sample program files. 
  112.  
  113.    SOFTWARE/HARDWARE PREREQUISITES:
  114.  
  115.         o   IBM VisualAge C++
  116.         o   OS/2 2.1 or Warp
  117.         o   IBM or compatible 386 and up.
  118.  
  119.    ADDITIONAL INFORMATION:
  120.  
  121.         o   For more information on the creation and use of projects in
  122.             the WorkFrame environment, see the VisualAge C++ for OS/2
  123.             User's Guide.
  124.         o   For more information on the User Interface Classes, see the
  125.             VisualAge C++ for OS/2 Open Class Library User's Guide.
  126.  
  127.         Both books can be found online.  To access an online book, simply
  128.         open the main VisualAge C++ desktop folder, then open the
  129.         Information Folder inside.  To view a book, double-click on that
  130.         book's icon.
  131.  
  132.  
  133.  
  134.    REQUIRED FILES - HELLO2:
  135.  
  136.    README
  137.         description and instructions for sample
  138.  
  139.    BUILD.CMD
  140.         command file for building in project form from the command line
  141.  
  142.    HELLO2.EXE
  143.         sample's executable
  144.  
  145.    AHELLOW2.CPP
  146.          source code for main() and AHelloWindow class
  147.  
  148.    AHELLOW2.HPP
  149.         class header file for AHellowWindow 
  150.  
  151.    AHELLOW2.H
  152.         symbolic definition file
  153.          
  154.    AHELLOW2.RC
  155.         resource file
  156.  
  157.    AHELLOW2.ICO
  158.         icon file
  159.  
  160.    MAKEFILE
  161.         make file to build the sample program    
  162.  
  163.  
  164.