home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / yeah09.zip / README.TXT < prev    next >
Text File  |  1996-05-25  |  3KB  |  77 lines
  1. Welcome to version 0.9 of Your Extended Attribute Helper, YEAH.
  2. ===============================================================
  3.  
  4.  
  5. This version, 0.9, of YEAH, is a pre release. It, and the coming
  6. 1.0 release, is freeware, (see the file LICENCE.TXT for details.)
  7. The main difference between 0.9 and the coming 1.0 is the
  8. documentation. The documentation available in 0.9 is more or less
  9. a strict reference manual for the classes included. There is little
  10. to no indication over "how to get started", both with respect to
  11. plain usage, and to extending YEAH. For some information about that,
  12. plus a discussion on "how was it done, and why" see the article
  13. "Encapsulating Extended Attributes, Part 2" in the June issue of
  14. EDM/2 (http://www.iqpac.com.)
  15.  
  16.  
  17.  
  18. Version 1.0 of YEAH is expected to be released before the end of
  19. June.
  20.  
  21.  
  22. 1. What is YEAH?
  23. ----------------
  24.  
  25. YEAH is a C++ framework for extended attributes. For this collection
  26. of C++ classes, I prefer the term "frame work" over the term
  27. "library", since its main purpose is to allow you to write your own
  28. extensions to the existing classes, as opposed to just using what is
  29. given. Given is a base, something that does most of the dirty work,
  30. and allows you to focus on the interesting parts, the extended
  31. attributes themselves. Given is also a small collection of concrete
  32. extended attribute classes. By no means are those classes the only
  33. right implementations for the kind of extended attribute they
  34. represent. What is the right implementation depends on how you want
  35. to organise your software, what your software does, and what
  36. extended attributes you use.
  37.  
  38.  
  39.  
  40. 2. Restrictions.
  41. ----------------
  42.  
  43. YEAH can only be used with IBM Visual Age C++, or other C++
  44. compilers that can 1) read IBM Visual Age C++ .LIB files, and 2) can
  45. make use of IBM Open Class Library. The reason for this is that, out
  46. of necessity, YEAH needs, as a bare minimum, collection classes and
  47. a string class. The reason IBM Open Class Library is the one chosen
  48. to provide collections and strings, is not a bias towards IBM, but
  49. simply that it is the one I have available. Once compilers begin
  50. supporting the new template syntax proposed by the ISO and ANSI
  51. standards of C++, and the STL (Standard Template Library) is shipped
  52. with those compiler's (which it will, as a natural part of the
  53. library and header files of the proposed ISO and ANSI standard C++,)
  54. YEAH will be rewritten to make use of it. I have chosen not to base
  55. YEAH on any of the many implementations of STL that are available
  56. today, for the reason that they are not close enough to the proposed
  57. standard, simply because compilers do not support many of the
  58. necessary template constructs.
  59.  
  60.  
  61.  
  62. 3. Trademarks.
  63. --------------
  64.  
  65. IBM, Visual Age C++ and Open Class Library are registered trade
  66. marks of International Business Machines Inc.
  67.  
  68. C++ is (I think) a registered trademark of Unix Systems Laboratories.
  69.  
  70.  
  71. 4. Copyright.
  72. -------------
  73.  
  74. YEAH, the compiler library, the source code and help files, is
  75. the copyrighted material of Björn Fahller.
  76.  
  77.