| Emeric Vigier | 2f62582 | 2012-08-06 11:09:52 -0400 | [diff] [blame] | 1 | This directory contains the initial testing release of GNU Common C++ |
| 2 | "2" 1.1. This release is provided for testing and development and in |
| 3 | many ways represents a significient refinement of the prior GNU Common |
| 4 | C++ "2" (1.0.x) releases. |
| 5 | |
| 6 | Few functional class changes in behavior exist in 1.1 vs 1.0. However, |
| 7 | many classes have been cleaned up to use const correctly, and this may |
| 8 | impact other people's code not written with this consideration. |
| 9 | |
| 10 | Many bugs were found and fixed between 1.0.13 and 1.1, and this alone |
| 11 | represents a worthwhile change for testing. It is believed 1.1 is |
| 12 | actually cleaner and more stable than 1.0 at this time. |
| 13 | |
| 14 | One important change in 1.1 is the new ost "String" class. This is |
| 15 | meant to be a smart and thread-aware string class that is capable of |
| 16 | re-allocating existing memory where possible rather than always |
| 17 | allocating through the heap. The idea here was to improve performance |
| 18 | as well as address other threading issues overlooked in std::string. |
| 19 | |
| 20 | All classes in 1.1 are implimented for both w32 and posix targets and |
| 21 | behavior should be more consistent for porting code. In the 1.0 |
| 22 | releases there were a number of classes which were never implimented for |
| 23 | w32 native builds, such as MappedFiles, etc. |
| 24 | |
| 25 | Many classes have been expanded. This is especially true of the Dir and |
| 26 | File classes, which now have many more member functions and greater |
| 27 | usability, as well as the Process class. |
| 28 | |
| 29 | An overview document formatted in texinfo is provided which provides a |
| 30 | good overview and summary of GNU Common C++ usage, features, and |
| 31 | functions. Extensive class-by-class functional documentation is also |
| 32 | provided in browsable form in the "doc" directory. This documentation |
| 33 | will be automatically generated for you during "make" if you have |
| 34 | doxygen already installed. |
| 35 | |
| 36 | GNU Common C++ is normally built and installed as a set of shared object |
| 37 | libraries and header files. These libraries and headers are installed |
| 38 | using directories selected through a "configure" script that has been |
| 39 | prepared with automake and autoconf. As such, they should build and |
| 40 | install similarly to and in a manner compatible and consistent with most |
| 41 | other GNU software. |
| 42 | |
| 43 | GNU Common C++ is free software licensed under the terms of the GNU Public |
| 44 | License. See the file COPYING.TXT for copying conditions. Please also |
| 45 | note that additional priviledges currenly apply to the use of Common C++ |
| 46 | as noted in each and every source file. These privileges are similar to |
| 47 | the terms Guile is licensed under and constitute priviliges similar to the |
| 48 | LGPL. |
| 49 | |
| 50 | Any comments, questions, patches, and/or bug reports should be sent to |
| 51 | "bug-commoncpp@gnu.org". |
| 52 | |
| 53 | |