⟦2e40c0bbd⟧

TextFile

This is version 1.36.0 of libg++, the GNU C++ class library.

* Contents

    * g++ source files are in the ./src directory
    * Some simple tests and demo programs are in ./tests
    * Header files are in ./g++-include
    * documentation is in ./libg++.texinfo. You may convert this into
      an emacs Info file by editing the file and typing `texinfo-format-buffer'
    * Some miscellaneous files of possible interest are in ./etc
      (These files are not officially a part of the libg++ distribution,
      and are subject to arbitrary changes, deletions, etc. from release
      to release.)

* Installation (see libg++.texinfo more more details)

    * Check the declared indicated pathnames, etc. in the Makefile

        Be sure to use USG-oriented switches if you run SystemV unix.

        If you run into problems, check through system-dependent
        #defines in  g++-include/stdio.h,  g++-include/math.h
        and g++-include/values.h, especially.

    * type `make all', or, step-by-step:

       `make src/libg++.a' -- to compile libg++.a
       `make tests'        -- to make some tests/demos of libg++.
                              This will first compile tests, then run them,
                              then diff the results against expected
                              results. 
       `make install'      -- to install libg++.a and include directories    
       `make etc'          -- (optional) to compile various other things 
       `make gperf'        -- (optional) to compile Doug Schmidt's
                               perfect hash function generator.  This
                               program illustrates many of the new
                               C++ 2.0 features available in G++,
                               including multiple inheritance and static
                               member functions.

*NOTES on compiling and running libg++/tests

test0 and tCurses are not automatically run through `checktests'.
You must run them manually.

With the current g++-1.36.1, tests/test0, and incremental linking in
general should work on most machines. If it does not, you may even
have trouble compiling it.  You can do `touch tests/test0', and
continue if this happens to you.

It is a very good idea to also cd to the test directory and run tests
manually, to see what they do. 

Compiling and running the tests consumes a fair amount of time and
disk space!

Some reported diffs may be perfectly reasonable, owing to things like
floating point precision differences: The expected.out file was created
on a Sun4/110.

    Some tRational and tFix results depend on floating representations,
    and may generate slightly different output on different machines.

    tRandom seeds some random-numbers in a way that also relies on
    floating-point representations -- Your output should be numerically
    similar, but probably not identical.

* changes from libg++-1.36.0

    * Better support for USG, DGUX, HPUX

    * test0 and incremental linking should now work

    * Other very minor fixes as noted in the ChangeLog

* changes from libg++-1.35.0 & 1.35.1

    * various and sundry bug fixes, minor enhancements, and/or portability 
        improvements as described in the ChangeLog. 

    * Most everything should now work on most SystemV machines. Let me
        know if they don't.

    * genclass now allows an optional prefix to be used instead of type
        name concatenation in order to help minimize filename
        lengths for SYSV users. This is not a great solution, but
        is A solution to filename length problems for SYSV users.

    * Some, but not all classes now behave well with respect to 
      the new 2.0 const specifications. Some uncertainties about
      how g++ will interpret gcc-based const function qualifiers
      (to indicate lack of side effects) versus C++-2.0 const member
      functions has held up the conversion of some classes to use
      const in either or both of these ways.

    * A version of etags suitable for use with c++ is in etc/
        (courtesy of J. Clark)

    * `graph', a unix graph(1) work-alike is in libg++/etc, courtesy
        of Rich Murphey.

    * RAVLMap (Ranked AVLs) prototypes.

    * The GetOpt class & support has been moved from etc/ into libg++.a

    * Streams have been redone to be nearly 100% AT&T 1.2 compatible.
        One minor possible incompatibility exists (ostream<< char)
        that can be eliminated via #define NO_OUTPUT_CHAR at the
        top of stream.h. This is probably necessary in order to
        compile et++. See libg++.texinfo for more details.

        The new stream implementation is not particulary pretty.
        Its main virtue is that it avoids some of the worst things 
        about both AT&T streams and old libg++ streams. A much
        superior AT&T 2.0-iostream superset is in the works
        for future release.

* Lots of other information is in the libg++.texinfo file. It really is
  very important to actually read the documentation before using 
  library classes. Examination of the demo files in the test directory
  may also be useful. (Note however, that the demo files are merely
  designed to test examples of each class capability,
  and are not especially good examples of client functions that might
  use these classes.)

* There is now a gnu libg++ mailing list (bug-lib-g++@prep.ai.mit.edu) and
    associated usenet gnu news group.

* You will be performing a valuable service if you use libg++
   classes and report back any comments, and suggestions, or bugs,
   preferably to the bug-lib-g++ list. Your feedback is extremely 
   helpful in efforts to make libg++ as useful and reliable as possible.

* See file `etc/release.log' for changes from previous versions

* If you are a systems administrator installing libg++ for others,
    please make the documentation (libg++.texinfo) and test files
    available to users!

* I continue to solicit

  * bug reports.
  * suggestions.
  * comments.
  * questions about installing and using libg++
  * other contributions to be incorporated into libg++.
  * sample programs using libg++.

  Often, the best place to send such things is bug-lib-g++@prep.ai.mit.edu,
  although direct mail to me is also welcome.

* Good luck!

Doug Lea, Computer Science Dept., SUNY Oswego, Oswego, NY, 13126 (315)341-2367
email: dl@oswego.edu              or dl%oswego.edu@nisc.nyser.net
UUCP :...cornell!devvax!oswego!dl or ...rutgers!sunybcs!oswego!dl
DataMuseum.dk

DKUUG/EUUG Conference tapes

⟦2e40c0bbd⟧ TextFile

Derivation

TextFile
