***************************************************************************
* HELLO WORLD SAMPLE PROGRAM - Version 6: Readme File (README6.TXT)       *
*                                                                         *
* COPYRIGHT: Copyright(C) International Business Machines Corp.,1992,1993.*
*                                                                         *
* 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.                           *
*                                                                         *
* Problems: - Setting a Color or Font does not allows work.               *
*           - Font Menu Item is not working in some cases.                *
*           - Enter Key does not work on the main window with buttons     *
*-------------------------------------------------------------------------*
* C++ Hello World Vision 6 Key Functions:                                 *
*                                                                         *
*      - Command Line option to use Enlish or Portuguese DLL resources    *
*      - Add Open Menu Item and use File Dialog                           *
*      - Show MessageBox when can not read input file from File Dialog    *
*      - Add Push Buttons & Set Canvas to change alignment                *
*      - Add Menu PopUp for changing the alignment                        *
*      - Change Status Area to Split Canvas and add Date & Time           *
*      - Add ATimeHandler & Update Time on Status Area                    *
*      - Add HELLOWPS.CMD to create Workplace Folder with Programs        *
***************************************************************************

***************************************************************************
* File list:                                                              *
*   README6.TXT  - readme command file for HELLO6.EXE                     *
*   AHELLOW6.CPP - source code for main() and AHelloWindow class          *
*   AHELLOW6.HPP - class header file for AHellowWindow                    *
*   AHELLOW6.H   - symbolic defintion file for HELLO6.EXE                 *
*   ADIALOG6.CPP - source code to create the ATextDialog class            *
*   ADIALOG6.HPP - class header file for ATextDialog                      *
*   AEARTHW6.CPP - source code to create the AEarthWindow class           *
*   AEARTHW6.HPP - class header file for AEarthWindow                     *
*   ACOLORW6.CPP - source code to create the AColorWindow class           *
*   ACOLORW6.HPP - class header file for AColorWindow                     *
*   ASPEEDW6.CPP - source code to create the ASpeedWindow class           *
*   ASPEEDW6.HPP - class header file for ASpeedWindow                     *
*   ATIMEHDR.CPP - source code to create the ATimeHandler class           *
*   ATIMEHDR.HPP - class header file for ATimeHandler                     *
*   AHELLOWE.RC  - English resource file for HELLO6.EXE                   *
*   AHELLOWP.RC  - Portuguese resource file for HELLO6.EXE                *
*   AHELLOW6.ICO - icon file for HELLO6.EXE                               *
*   BRAZIL.ICO   - icon file for Postuguese option of HELLO6.EXE          *
*   ADIALOGE.DLG - English dialog resource source file for HELLO6.EXE     *
*   ADIALOGP.DLG - Portuguese dialog resource source file for HELLO6.EXE  *
*   ADIALOGE.RES - dialog resource file for HELLO6.EXE                    *
*   AHELLOW6.IPF - help file for HELLO6.EXE                               *
*   AHELLOW6.INI - Profile for HELLO6.EXE                                 *
*   AHELLOW6.DEF - module definition file for HELLO6.EXE                  *
*   AHELLOWE.DEF - module definition file for AHELLOWE.DLL                *
*   AMAKE6.MAK   - make file to create HELLO6.EXE                         *
*   AMAKE6.CMD   - command file to create HELLO6.EXE                      *
*   BUILD6.CMD   - command file to compile, link and run HELLO6.EXE       *
 *  HELLOWPS.CMD - command file to create WPS Folder with Program Objects *
*   CLEANUP6.CMD - command file to cleanup (erase) generated files:       *
*                  HELLO6.EXE, AHELLOW6.OBJ, ADIALOG6.OBJ, AEARTHW6.OBJ,  *
*                  AHELLOW6.MAP, AHELLOW6.HLP, AHELLOW6.ERR, AHELLOWE.RES,*
*                  AHELLOWE.DLL, AHELLOWP.DLL, ATIMEHDR.OBJ              *
***************************************************************************

***************************************************************************
*                                                                         *
* File Relationship Diagram (Files in Caps, Programs in lower case)       *
*                                                                         *
*                              ADIALOGE.RES                               *
*                                   ³                                     *
*                 AHELLOW6.H     dlgedit         iconedit                 *
*                    ³  ³           ³               ³                     *
* AHELLOW6.HPP       ³  ÃÄÄÄÄÄ>ADIALOGE.DLG    AHELLOW6.ICO BRAZIL.ICO    *
*  ADIALOG6.HPP      ³  ÃÄÄÄÄÄÄ>ADIALOGP.DLG        ³         ³           *
*   AEARTHW6.HPP     ³  ³           ³               ³         ³           *
*    ATIMEHDR.HPP    ³  ³           ³               ³         ³           *
*     ACOLORW6.HPP   ³  ³           ³               ³ ÚÄÄÄÄÄÄÄÙ           *
*      ASPEEDW6.HPP  ³  ³           ³               ³ ³                   *
*      v             ³  ³           ³               ³ ³                   *
* AHELLOW6.CPP <ÄÄÄÄÄ´  ÀÄÄÄÄÄÄÄÄÄÄÄÁ> AHELLOWE.RC<ÄÙ.³. AHELLOW6.IPF     *
*  ADIALOG6.CPP <ÄÄÄÄÙ                  AHELLOWP.RC <ÄÙ       ³           *
*   AEARTHW6.CPP                           ³                  ³           *
*    ATIMEHDR.CPP                          ³                  ³           *
*     ACOLORW6.CPP                         ³                  ³           *
*      ASPEEDW6.CPP                        ³                  v           *
*      º                                  rc -r             ipfc /x       *
*      º                                   ³                  |           *
*      v    AHELLOW6.OBJ               AHELLOWE.RES       AHELLOW6.HLP    *
*  icc -c ÍÍ>ADIALOG6.OBJ               AHELLOWP.RES          .           *
*             AEARTHW6.OBJ                 ³                  .           *
*              ATIMEHDR.OBJ                ³                  .           *
*               ACOLORW6.OBJ               v                  .           *
*                     º    AHELLODE.DEF->link386Ä>AHELLOD6.MAP.           *
*                     º     AHELLODP.DEF   ³                  .           *
*                     v                    ³                  .           *
* AHELLOW6.DEF ÄÄ>icc /TdpÄ>AHELLOW6.MAP   ³                  .           *
*                     ³                    v                  .           *
*                     ³                AHELLOWE.DLL . . . . . .           *
*                     ³                 AHELLOWP.DLL          v           *
*                     ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ>AHELLOW6.EXE    *
*                                                                         *
***************************************************************************

***************************************************************************
*                                                       ÉÍÍÍÍÍÍÍÍÍÍÍ»     *
* Key Window Parent Relationship Diagram:      Diagram  ºClass Name º     *
*                                                  Key: ºÄÄÄÄÄÄÄÄÄÄĺ     *
*                   IApplication::current().run()       ºObject Nameº     *
*                                 ³                     ÈÍÍÍÍÍÍÍÍÍÍͼ     *
*                                 ³                                       *
*                           ÉÍÍÍÍÍÍÍÍÍÍÍÍ»              ÉÍÍÍÍÍÍÍÍÍÍÍ»     *
*   AColorWindow ---+-------ºAHelloWindowºÄÄÄÄÄÄÄÄÄÄÄÄÄĺATextDialogº     *
*                   |       ºÄÄÄÄÄÄÄÄÄÄÄĺ              ºÄÄÄÄÄÄÄÄÄÄĺ     *
*   ASpeedWindow ---+       º mainWindow º              ºtextDialog º     *
*                           ÈÍÍÍÍÍÍÍÍÍÍÍͼ              ÈÍÍÍÍÍÍÍÍÍÍͼ     *
*                ÉÍÍÍÍÍÍÍÍ»       ³       ÉÍÍÍÍÍÍ»           ³            *
*                ºIMenuBarºÄÄÄÄÄÄÄÅÄÄÄÄÄÄĺITitleº      ÉÍÍÍÍÍÍÍÍÍÍÍ»     *
*                ºÄÄÄÄÄÄÄĺ       ³       ÈÍÍÍÍÍͼ      ºIEntryFieldº     *
*                ºmenuBar º       ³                     ºÄÄÄÄÄÄÄÄÄÄĺ     *
*                ÈÍÍÍÍÍÍÍͼ       ³                     º textField º     *
*            ÉÍÍÍÍÍÍÍÍÍÍÍÍ»       ³       ÉÍÍÍÍÍÍÍÍÍÍÍ» ÈÍÍÍÍÍÍÍÍÍÍͼ     *
*            ºIAcceleratorºÄÄÄÄÄÄÄÅÄÄÄÄÄÄĺIHelpWindowº                   *
*            ÈÍÍÍÍÍÍÍÍÍÍÍͼ       ³       ºÄÄÄÄÄÄÄÄÄÄĺ                   *
*                                 ³       º    help   º                   *
*                                 ³       ÈÍÍÍÍÍÍÍÍÍÍͼ                   *
*        ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿        *
* ÉÍÍÍÍÍÍÍÍÍÍÍÍ»   ÉÍÍÍÍÍÍÍÍÍÍÍÍ»        ÉÍÍÍÍÍÍÍÍÍÍ»        ÉÍÍÍÍÍÍÍÍÍ»  *
* ºISplitWindowº   ºISplitWindowº        ºISetCanvasº        ºIInfoAreaº  *
* ºÄÄÄÄÄÄÄÄÄÄÄĺ   ºÄÄÄÄÄÄÄÄÄÄÄ º        ºÄÄÄÄÄÄÄÄÄĺ        ºÄÄÄÄÄÄÄÄĺ  *
* ºstatusCanvasº   ºclientWindowº        º  buttons º        ºinfoArea º  *
* ÈÍÍÍÍÍÍÍÍÍÍÍͼ   ÈÍÍÍÍÍÍÍÍÍÍÍͼ        ÈÍÍÍÍÍÍÍÍÍͼ        ÈÍÍÍÍÍÍÍÍͼ  *
*             ³          ÃÄÄÄÄÄÄÄÄÄÄÄÄ¿         ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿       *
*ÉÍÍÍÍÍÍÍÍÍÍÍ»³    ÉÍÍÍÍÍÍÍÍÍÍÍÍ» ÉÍÍÍÍÍÍÍÍ» ÉÍÍÍÍÍÍÍÍÍÍÍ»  ÉÍÍÍÍÍÍÍÍÍÍÍÍ»*
*ºIStaticTextº´    ºISplitWindowº ºIListBoxº ºIPushButtonº  ºIPushButton º*
*ºÄÄÄÄÄÄÄÄÄÄĺ³    ºÄÄÄÄÄÄÄÄÄÄÄĺ ºÄÄÄÄÄÄÄĺ ºÄÄÄÄÄÄÄÄÄÄĺ..ºÄÄÄÄÄÄÄÄÄÄÄĺ*
*º statusLineº³    ºhellowCanvasº ºlistBox º º leftButtonº  º helpButton º*
*ÈÍÍÍÍÍÍÍÍÍÍͼ³    ÈÍÍÍÍÍÍÍÍÍÍÍͼ ÈÍÍÍÍÍÍÍͼ ÈÍÍÍÍÍÍÍÍÍÍͼ  ÈÍÍÍÍÍÍÍÍÍÍÍͼ*
*             ³          ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿                                *      *
*ÉÍÍÍÍÍÍÍÍÍÍÍ»³    ÉÍÍÍÍÍÍÍÍÍÍÍ»   ÉÍÍÍÍÍÍÍÍÍÍÍÍ»                         *         *
*ºIStaticTextº´    ºIStaticTextº   ºAEarthWindowº                         *         *
*ºÄÄÄÄÄÄÄÄÄÄĺ³    ºÄÄÄÄÄÄÄÄÄÄĺ   ºÄÄÄÄÄÄÄÄÄÄÄĺ                         *         *
*º   date    º³    º   hello   º   ºearthWindow º                         *         *
*ÈÍÍÍÍÍÍÍÍÍÍͼ³    ÈÍÍÍÍÍÍÍÍÍÍͼ   ÈÍÍÍÍÍÍÍÍÍÍÍͼ                         *         *
*             ³          ³                                                *
*ÉÍÍÍÍÍÍÍÍÍÍÍ»³     ÉÍÍÍÍÍÍÍÍÍ»                                           *
*ºIStaticTextºÙ     ºIPopMenu º                                           *
*ºÄÄÄÄÄÄÄÄÄÄĺ      ÈÍÍÍÍÍÍÍÍͼ                                           *
*º   time    º                                                            *
*ÈÍÍÍÍÍÍÍÍÍÍͼ                                                            *
***************************************************************************

***************************************************************************
* The HELLO6.EXE Sample Application call be build/run in three ways:      *
*                                                                         *
* Option 1: Run BUILD6.CMD                                                *
*                                                                         *
*   This option will compile, link, execute HELLO6.EXE.  It will then     *
*   cleanup all files created by BUILD6.CMD.                              *
*                                                                         *
* Option 2: Run AMAKE6.CMD                                                *
*           Run HELLO6.EXE or HELLO6 /p                                   *
*           Run CLEANUP6.CMD                                              *
*                                                                         *
*  AMAKE6.CMD will compile and link HELLO6.EXE.                           *
*  HELLO6 /p will run HELLO6 using the Portuguese Resource DLL            *
*  CLEANUP6.CMD will cleanup files build by MAKE6.CMD                     *
*                                                                         *
* Option 3: Run AMAKE6.CMD                                                *
*           Run HELLOWPS.CMD                                              *
*                                                                         *
*  AMAKE6.CMD will compile and link HELLO6.EXE.                           *
*  HELLOWPS.CMD will create a Work Place Shell Folder with Program Objects*
***************************************************************************