2015-05-05 Yvan Roux <yvan.roux@linaro.org>
[official-gcc.git] / gcc / testsuite / gcc.test-framework / README
blob558342eb3cc3acd4b256542a5228b4de694a5eee
1 Check the test directives used in GCC's testsuite by generating and
2 running tests that use combinations of those commands or that stress
3 the selector expressions that can be used in those directives.  Also
4 run a few tests of specific functionality from the source directory.
5                                                                                 
6 Each generated test has two parts: a file ending in "-1.c" whose
7 expected result is encoded in the filename after "-exp-", and a file
8 ending in "-2.c" which is always expected to pass.
9                                                                                 
10 This test directory is normally skipped and is not meant to be run at
11 the same time as other parts of the testsuite; it's only of interest to
12 people who are modifying the test directives or their support in GCC's
13 .exp files.
15 To run these tests:
16                                                                                 
17     CHECK_TEST_FRAMEWORK=1 make -k check RUNTESTFLAGS="test-framework.exp"
18                                                                                 
19 To check the results:
20                                                                                 
21     TF=${SRC}/gcc/testsuite/gcc.test-framework
22     awk -f ${TF}/test-framework.awk gcc/testsuite/gcc/gcc.sum
23                                                                                 
24 The awk script prints unexpected results followed by the number of tests
25 that passed and failed.
28 Copyright (C) 2005-2015 Free Software Foundation, Inc.
30 Copying and distribution of this file, with or without modification,
31 are permitted in any medium without royalty provided the copyright
32 notice and this notice are preserved.