home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / dho_10b.zip / README.TXT < prev   
Text File  |  1995-08-07  |  7KB  |  157 lines
  1.      Information about Developer Helper, release 1.0Beta
  2.  
  3.      The Developer Helper Application Framewien is a framework
  4. written in C++ for use in developing high quality graphical 
  5. applications for the 32 bit OS/2 (versions 2.0 and higher).  Included 
  6. in this framework are objects to assist in developing all types of 
  7. applications (both character based and Presentation Manager), including 
  8. object classes to handle threads, processes, abstract data types and 
  9. user interface.  The overriding design goal behind Developer Helper 
  10. is to provide the most functionality possible, exposing the great 
  11. primitives and API's provided by IBM to the application developer, and 
  12. encapsulating much of the trivial and error prone of setting up the 
  13. base of applications.
  14.      
  15.      To develop with Developer Helper, all a developer has to do is 
  16. concentrate on their application, and not concentrate on wrestling with
  17.  many arcane API calls.   DHO currently supports IBM C-Set++, GCC/2, and
  18. EMX  binaries, with source code available for adaption to other C++
  19. compilers which are available for OS/2.  Included in this package are C++
  20. source and header files, library files, a tutorial, this document and some 
  21. samples.
  22.  
  23.  
  24. ===========================================================================
  25. Installation:
  26.  
  27.    The DHO package is contained in a single zip file.  Unzip the file 
  28. passing the decompression software the option to retain directory 
  29. structure.  Assuming the package was decompressed in the root directory
  30. of a disk, all one has to do is to include the dho\include directory 
  31. in your compiler's search path, and link to an approriate library
  32. found in \dho\lib.  Source code is provided for debugging purposes
  33. in \dho\source.  Examples of makefiles for the C-Set, GCC/2 and EMX-
  34. gcc compilers are included in this distribution.
  35.  
  36.  
  37. Using DHO in a DLL
  38.      The DHO library can be used in a DLL, but the following two precautions 
  39. should be taken into account.     First, the utility function 
  40. void setModule(char *modName)  must be called in some sort of DLL 
  41. initialization function is the DLL is to access resources which are bound
  42.  to the DLL (use of Dialogs bound to the DLL are one example).  Pass 
  43. setModule the name of the DLL, and all additional resources will 
  44. be loaded from the DLL.  If for some reason the DLL code must use resources 
  45. bound to the executable, pass a NULL string to this function, and DHO will
  46. then load all it's resources from the executable.
  47.  
  48.      Secondly, if classes are exposed or are passed into funtions located 
  49. in a DLL, care must be taken to ensure that the version of DHO which is 
  50. statically linked into the DLL and the version which is linked 
  51. into the executable are the same.  Again, use of the utility functions 
  52. const char *DHOgetBaseVersion() and const char *DHOgetRev() can be used 
  53. to ensure proper linkage.  An example of this follows.
  54.  
  55. ---------------------------------------------------------
  56. INT main(void)
  57. {
  58.    initDLL(DHOgetBaseVersion(), DHOgetRev());
  59.    return 0;
  60. }
  61.  
  62. APIRET EXPENTRY initDLL(const char *base, const char *rev)
  63. {
  64.    if ((!strcmp(base, DHOgetBaseVersion())) || 
  65.        (!strcmp(rev, DHOgetRev())))
  66.    {
  67.          // -- handle error condition gracefully
  68.          exit(1);
  69.    }
  70. }
  71.  
  72. ---------------------------------------------------------
  73.  
  74.      In most cases, if the base version of the DLL matches the base version
  75. of the executable, the program will run properly.  The base version of the 
  76. library changes only when there are interface changes to the libraries.  
  77. The revision number is increased only when there are internal bug fixes and 
  78. enhancements which do not modify any interfaces.   In the future, a DLL 
  79. version of DHO will eliminate this need for version checking since it will be 
  80. possible for the executable and the dll to dynamically link to the DHO 
  81. library at runtime.
  82.  
  83.  
  84.  
  85. ===========================================================================
  86. Licensing Information and Disclaimer
  87.  
  88.    This library is released as is, and carries no warranty.  The author 
  89. assumes no liability for dmamages which may vbe caused by this library,
  90. nor for does the author guarantee that this API will remain contant
  91.  
  92.    This release (1.0Beta) is provided free to any non-commercial developer
  93. provided that the developer sends comments and criticisms about this class 
  94. library along with a brief description of the product developed with DHO to 
  95. the author.  Commercial Developers may contact the author for terms regarding
  96. DHO's commercial use.  In any circumstance, the notice "portions (c) 1994-95
  97. Tom Bednarz" must appear in the product information dialog box.
  98.  
  99.  
  100. ===========================================================================
  101. Package Contents:
  102.    This development kit includes binaries for 3 major OS/2 compilers,
  103. header files for use with the library, full source for the library,
  104. a tutorial and a samples.   There are 6 binary libraries included;
  105. they are:
  106.  
  107.    dhoiccd.lib            --  Debug library for use with IBM C-Set++
  108.    dhoicc.lib             --  Optimized library for use with IBM C-Set++
  109.    dhogccd.lib            --  Debug library for use with GCC/2
  110.    dhogcc.lib             --  Optimized library for use with GCC/2
  111.    dhoemxd.lib            --  Debug library for use with GCC andEMX
  112.    dhoemx.lib             --  Optimized library for use with GCC and EMX
  113.  
  114.  
  115. ===========================================================================
  116. New in version 1.0B
  117.  
  118.    *  improved windowing model -- now includes a basic starting point
  119.       for creating new window types, and also includes various
  120.       other pre0fabricated window classes (such as frame windows).
  121.  
  122.    *  support for DLL's
  123.  
  124.    *  a thread class
  125.  
  126.    *  full CUA '91 control support.
  127.  
  128.    *  improved examples, and a full tutorial
  129.  
  130.  
  131. ===========================================================================
  132. Known Limitations:
  133.  
  134.    The method void removeItem(USHORT item) in the class TContainerWindow
  135.    currently does not work properly.  A fix is in the works, and will be available
  136.    in the next release of Developer Helper.
  137.  
  138.    Please remember that this is a Beta version, and that I will attempt to fix bugs
  139.    and problems which are submitted to me.  It is my goal to create a premier freeware
  140.    application framework which can be used and adapted by developers to create
  141.    high quality OS/2 software.
  142.  
  143.  
  144. ===========================================================================
  145. Please send any comments, bug reports, or questions to:
  146.  
  147.            Tom Bednarz
  148.            766 Elm Street
  149.            Somerset, MA 02726
  150.  
  151.            e-mail: ab150@osfn.rhilinet.gov
  152.  
  153.  
  154. this package is  (c) 1994-95 Tom Bednarz, Jr.
  155. C-Set++ and OS/2 are copyrighted trademarks of IBM Corporatrion
  156.  
  157.