							October 27, 1993


  This is a collection of tests for g++, the FSF's C++ compiler. The
driver that runs the testcases is called DejaGnu.  If you do not have
DejaGnu yet, you will need to get it.  The tests were developed and/or
collected by Cygnus Support. These tests are included "as is". If any
of the tests fail, don't report a bug.  Bug reports for DejaGnu can go
to bug-dejagnu@prep.ai.mit.edu.  Discussion and comments about this
testsuite can be sent to me, at the address below.

  Since these are part of the development source tree at Cygnus, this
tar file is supposed to be untarred so that the testsuite directory is
in the gcc source tree. Most of the time DejaGnu is run by hand using
"runtest", but as we believe in solid testing, we've integrated it
into the Makefile as a target. We normally use the testsuite by doing
a "make all; make check-g++" at the top level and building and testing
our whole tree.  If you have both the gcc testsuite and the g++
testsuite, you can check both with the "make check" command.

  DejaGnu can be run either installed, or uninstalled. Usually it gets
installed so that anyone can just run the tests without having to
configure or build DejaGnu.

  This suite is still under development, and has some known problems.
The biggest problem is that not all test cases have their expectedness
set right yet.  When run on a SunOS 4.1.3 SPARC machine using a
prerelease version of gcc 2.5.0, I get:

                === g++ Summary ===

# of expected passes       733
# of expected failures     130
# of unexpected successes  1
# of unexpected failures   146

You should see numbers similar to this.  If not, then something is
wrong.  In the future, the number of unexpected failures will be much
closer to zero.

  To run the tests, first change to the gcc-2.5.0 directory, then type:

	runtest --all --tool g++ --srcdir ./testsuite

Here's a brief explanation.

runtest         - Is the name used to invoke DejaGnu.   If DejaGnu is not
		  install this will be the relative path name for runtest.

--all           - Print tests that pass and warnings. The default is
                  to only print tests that fail or internal errors in
                  DejaGnu. All the tests are recorded in the summary
                  file produced by running the tests.

--tool          - This tells DejaGnu which tool you are testing. It is
                  mainly used to find the testsuite directories for a
                  particular tool when several testsuites are in the
                  same directory. (like the gcc and g++ testsuites)

--srcdir        - This points to the top level of the directory
                  containing the sources of the testsuite. This is
                  ./testsuite if you are in the directory that has the
                  testsuite directory.


					Mike Stump
					mrs@cygnus.com
					FSF C++ developer
