home *** CD-ROM | disk | FTP | other *** search
/ Power GUI Programming with VisualAge C++ / powergui.iso / trialva / ibmcppw / samples / ioc / acdfmake / readme.txt < prev   
Encoding:
Text File  |  1996-02-22  |  7.4 KB  |  100 lines
  1. ***************************************************************************
  2. * COMPOUND DOCUMENT FRAMEWORK OVERVIEW OF SAMPLES - Version 1: Readme File*
  3. *                                                                         *
  4. * COPYRIGHT: Copyright(C) International Business Machines Corp.,1992,1996.*
  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. * See the IBM User Interface Class Library User's Guide                   *
  16. *   for more information about this sample program.                       *
  17. *                                                                         *
  18. * CDF (Compound Document Framework) Samples - overview of all 6 samples   *
  19. *                                             =========================   *
  20. *  DESCRIPTION:                                                           *
  21. *   - aCDF1 Sample 1 is a "Hello World" basic CDF server with fixed       *
  22. *           data, model/view, streaming, full OLE server                  * 
  23. *   - aCDF2 Sample 2 is a more advanced CDF server with 2 entry fields,   *
  24. *           User Interface control handlers, notifications,               *
  25. *           flattening/resurrecting of objects.                           *
  26. *   - aCDF3 Sample 3 is a basic CDF container (and server)                *
  27. *   - aCDF4 Sample 4 is a more advanced CDF container with iteration      *
  28. *           through contained objects, resizing, etc.                     *
  29. *   - aCDF5 Sample 5 used a CDF server to show collection operations      *
  30. *           and collection streaming                                      *
  31. *   - aCDF6 Sample 6 is a CDF port of the ICLUI HELLO5 sample including   *
  32. *           graphics and help.                                            *
  33. *                                                                         *
  34. * TASK:                                                                   *
  35. *                                                                         *
  36. * CONCEPTS/FEATURES:                                                      *
  37. * - These samples illustrate how to create derived model and view classes *
  38. *   from the Compound Document Framework. Very few modifications are need *
  39. *   to be made as the inherited classes provided most of the requirements.*
  40. *   Thus it is easy to develop OLE based Compound Document Applications   *
  41. *                                                                         *
  42. * SPECIAL NOTES (BUILD OPTIONS):                                          *
  43. * =============  =============                                            *
  44. * - compile/link options used by all samples are in aCDFmake\aCDF.mak     *
  45. * - "set CDF_STATIC=1" prior to running nmake if you wish to build an EXE *
  46. *   which is statically linked to the ICLUI runtimes (otherwise the       *
  47. *   default is to to use the ICLUI system DLLs).                          *
  48. * - "set CDF_DEBUG=1" to build a debug version (/Ti+) with browser data   *
  49. *   (/Fb+) and performance analysis (/Gh+) and no optimization (/O-).     *
  50. *   This also creates a command-line output window (/pmtype:vio).         *
  51. *   NOTE: the prebuilt debug EXE does not have a command-line window.     *
  52. * - "set CDF_DEBUG=1" also enables ICLUI tracing in the samples since it  *
  53. *   defines /dIC_TRACE_DEVELOP during compilation.                        *
  54. * - "set ICLUI TRACETO=STDOUT" and "set ICLUI TRACE=ON" to view the trace.*
  55. ***************************************************************************
  56. * HOW TO RUN THE PROJECT FROM THE COMMAND LINE:                           *
  57. *                                                                         *
  58. * All the sample applications can be built by entering:                   *
  59. *     nmake                                                               *
  60. * with no options while in the aCDFmake directory containing the Compound *
  61. * Document Framework Makefile and aCDF.mak make flags.                    *
  62. * Makefile This will generate sever executable files called:              *
  63. *     aCDF1\aCDF1.exe                                                     *
  64. *     aCDF2\aCDF2.exe                                                     *
  65. *     aCDF3\aCDF3.exe                                                     *
  66. *     aCDF4\aCDF4.exe                                                     *
  67. *     aCDF5\aCDF5.exe                                                     *
  68. *     aCDF6\aCDF6.exe                                                     *
  69. * which can each be run from the command line.                            *
  70. * To clean up the files generated from running make, enter:               *
  71. *     nmake clean                                                         *
  72. *                                                                         *
  73. ***************************************************************************
  74. * HOW TO RUN THE PROJECT FROM WITHIN THE WORKFRAME ENVIRONMENT:           *
  75. *                                                                         *
  76. * WorkFrame needs to be run for each sample individually.  For example,   *
  77. * The sample 1 WorkFrame project can be opened moving into the aCDF1      *
  78. * sample directory and then entering:                                     *
  79. *     iwf aCDF1.iwp                                                       *
  80. * The sample can be rebuilt by selecting the WorkFrame menu items:        *
  81. *     "Project" and "Build All" (or press the "Build ALL" toolbar button) *
  82. * The sample can be run by selecting the WorkFrame menu items:            *
  83. *     "Project" and "Run" (or double click on the aCDF1.exe icon)         *
  84. ***************************************************************************
  85. * ADDITIONAL INFORMATION:                                                 *
  86. *                                                                         *
  87. * For additional information on this and other samples shipped            *
  88. * with the VisualAge for C++ product, please see the Guide to Samples     *
  89. * notebook.                                                               *
  90. *                                                                         *
  91. * To access the notebook from Program Manager, open the VisualAge for     *
  92. * C++ product object, then open the Guide to Samples notebook.            *
  93. ***************************************************************************
  94. * SHIPPED FILE LIST:                                                      *
  95. *                                                                         *
  96. *       Readme.txt      - Overview of all 6 samples and overall Make      *
  97. *       aCDF.mak        - Generic build flags used by each sample Makefile*
  98. *       Makefile        - Makefile which invokes all 6 sample Makefiles   *
  99. ***************************************************************************
  100.