2009-10-14 Sebastian Pop <sebastian.pop@amd.com>

[pf3gnuchains/gcc-fork.git] / gcc / testsuite / README.compat

diff --git a/gcc/testsuite/README.compat b/gcc/testsuite/README.compat
index da2340a..7eee66d 100644 (file)
--- a/gcc/testsuite/README.compat
+++ b/gcc/testsuite/README.compat
@@ -24,7 +24,24 @@ sets of compiler options.
   with the compiler under test using the first of each pair of compiler
   options from COMPAT_OPTIONS.  When ALT_CXX_UNDER_TEST is "same", each
   test is built using the compiler under test but with combinations of
-  the options from COMPAT_OPTIONS.
+  the options from COMPAT_OPTIONS.  If the alternate compiler needs a
+  different setting for LD_LIBRARY_PATH, specify it in the environment
+  varible ALT_LD_LIBRARY_PATH.  If it needs different options to build
+  a shared object, define those in ALT_SHOBJ_OPTIONS.
+
+  Normally, only a small amount of compatibility tests is run.
+  Setting RUN_ALL_COMPAT_TESTS=1 in the environment before running the
+  testsuite enables running all compatibility tests, but might take
+  significantly longer than it takes without this variable.
+
+To run only the C++ compatibility tests, optionally specifying an
+alternate compiler and/or sets of options, do from $objdir/gcc:
+
+  rm site.exp
+  make -k ALT_CXX_UNDER_TEST=<prefix>/bin/g++ \
+    ALT_LD_LIBRARY_PATH=<prefix>/lib \
+    COMPAT_OPTIONS="list as shown above" check-c++ \
+    RUNTESTFLAGS="compat.exp"
 
 A test that fails when the pieces are compiled with different compilers
 but passes when the pieces are compiled with the same compiler
@@ -53,10 +70,6 @@ There's a lot more that can be done with these tests.
       LD_LIBRARY_PATH for the alternate compiler in the support for each
       language
 
-   -  build pieces of the test into shared libraries; this requires
-      support for LD_LIBRARY_PATH for the alternate compiler, and
-      knowledge about how to build a shared library for each target
-
    -  build pieces of the test into static libraries; this requires
       knowledge about how to build a static library for each target
 
@@ -70,3 +83,10 @@ There's a lot more that can be done with these tests.
 
 Janis Johnson, <janis187@us.ibm.com>
 October 2002
+
+\f
+Copyright (C) 2002, 2003, 2004 Free Software Foundation, Inc.
+
+Copying and distribution of this file, with or without modification,
+are permitted in any medium without royalty provided the copyright
+notice and this notice are preserved.