home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / IOC / HELLO1 / README < prev   
Text File  |  1995-06-09  |  6KB  |  147 lines
  1. ***************************************************************************
  2. * HELLO WORLD SAMPLE PROGRAM - Version 1: 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.  
  16. Hello World
  17.  
  18.    These samples, which begin with hello1 and increase in complexity and
  19.    function up to hello6, progressively demonstrate many of the
  20.    capabilities of the User Interface Class Library.
  21.  
  22.    o   "Hello World 1"
  23.    o   "Hello World 2"
  24.    o   "Hello3"
  25.    o   "Hello4"
  26.    o   "Hello5"
  27.    o   "Hello World 6"
  28.  
  29.  
  30. Hello World 1
  31.  
  32.    DESCRIPTION:
  33.  
  34.         Hello1 is the typical hello world program that is intentionally
  35.         trivial to show you the basics of what is needed to get started.
  36.         This particular implementation uses the IFrameWindow,
  37.         IStaticText, and IApplication classes to create a typical desktop
  38.         window that contains the text "Hello World".  You can interact
  39.         with the program only by using frame window functions, for
  40.         instance, minimize, maximize, and close.
  41.  
  42.  
  43.    PROJECT LOCATION:
  44.         Inside the IOC Samples folder (inside the VisualAge C++ Samples
  45.         folder). 
  46.  
  47.    SOURCE FILE LOCATION:
  48.         X:\ibmcpp\samples\ioc\hello1
  49.  
  50.         where X: is the drive you installed the samples and document
  51.         component of VisualAge C++.
  52.  
  53.    HOW TO RUN THE SAMPLE:
  54.  
  55.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  56.              To run the prebuilt project, open the Samples folder on your
  57.              OS/2 desktop then double-click on the project's icon to open
  58.              the project view of the sample.  Click on the RUN button of
  59.              the project's toolbar.
  60.  
  61.         FROM THE COMMAND LINE:
  62.              Simply type the name of the .EXE file, that is:
  63.  
  64.                  HELLO1
  65.  
  66.              If the sample fails to execute or abnormally ends, you can
  67.              get more information about the failure by turning on the
  68.              ICLUI trace.  This is done by setting the environment
  69.              variable ICLUI_TRACE as follows:
  70.  
  71.                    set ICLUI_TRACE=ON
  72.                    set ICLUI_TRACETO=STDERR
  73.  
  74.              The second export controls where the trace information is
  75.              reported.  With tracing turned on, ICLUI exception text will
  76.              be written to a standard error file. For example:
  77.  
  78.                    hello1 >hello1.out 2>&1
  79.  
  80.              The exception data is now in the file hello1.out.
  81.  
  82.    HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
  83.  
  84.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  85.              Open the Samples folder on your OS/2 desktop then
  86.              double-click on the project's icon to open the project view
  87.              of the sample. In the upper half of the project window you
  88.              will see the icons of the files associated with the sample.
  89.              From the Project pulldown, select Build -> Rebuild All.  To run
  90.              the sample project, see HOW TO RUN THE SAMPLE PROJECT above.
  91.  
  92.         FROM THE COMMAND LINE:
  93.            - A command file is provided to allow rebuilding of the
  94.              WorkFrame projects from the command line.  Simply type:
  95.  
  96.                  BUILD
  97.  
  98.              To run the sample project, see HOW TO RUN THE SAMPLE PROJECT 
  99.              above.
  100.  
  101.            - The sample application can also be built by entering:
  102.                  NMAKE
  103.              with no options while in the directory containing the
  104.              sample application files.  The makefile is named
  105.                  Makefile
  106.              To clean up the files generated from running make, enter:
  107.                  NMAKE CLEAN 
  108.              while in the directory containing the sample program files. 
  109.  
  110.    SOFTWARE/HARDWARE PREREQUISITES:
  111.  
  112.         o   IBM VisualAge C++
  113.         o   OS/2 2.1 or Warp
  114.         o   IBM or compatible 386 and up.
  115.  
  116.    ADDITIONAL INFORMATION:
  117.  
  118.         o   For more information on the creation and use of projects in
  119.             the WorkFrame environment, see the VisualAge C++ for OS/2
  120.             User's Guide.
  121.         o   For more information on the User Interface Classes, see the
  122.             VisualAge C++ for OS/2 Open Class Library User's Guide.
  123.  
  124.         Both books can be found online.  To access an online book, simply
  125.         open the main VisualAge C++ desktop folder, then open the
  126.         Information Folder inside.  To view a book, double-click on that
  127.         book's icon.
  128.  
  129.  
  130.  
  131.    REQUIRED FILES - HELLO1
  132.  
  133.    README
  134.         description and instructions for sample
  135.  
  136.    BUILD.CMD
  137.         command file to build in project form from the command line
  138.  
  139.    HELLO1.EXE
  140.         sample's executable
  141.  
  142.    AHELLOW1.CPP
  143.         source code
  144.  
  145.    MAKEFILE
  146.   
  147.