OSDN Git Service

* examples: New directory.
[pf3gnuchains/gcc-fork.git] / contrib / reghunt / examples / README
1 This directory contains files from examples of regression hunts, cut
2 down to smaller ranges to save space and time.  Try these out before
3 using the tools on your own tests.  First, update gcc-svn-env and
4 common.config for your own environment.
5
6 Each of the examples has multiple files:
7
8   *.list files were created using gcc-svn-patchlist
9
10   *.config files were written by hand based on earlier config files;
11   the commented-out pieces are left as templates in case they're needed
12
13   *.c, *.c++ are source files for the test, usually taken directly from
14   the PR
15
16   *.test files are tests specific to a bug when an existing gcc-test-*
17   script can't be used
18
19   *.log files are output from various scripts
20
21 Examples, where the identifier is the PR number:
22
23   28970   wrong-code
24   29106   special test, 4.1 branch
25   29578   bogus-warning
26   29906a  ice-on-valid-code, break
27   29906b  ice-on-valid-code, fix
28   30643   special test, cross compiler
29
30 Cut down the range even further by setting LOW_PATCH and HIGH_PATCH
31 within the config file to ids where the log file shows the test
32 passed or failed.
33
34 To run one, do
35
36   reg-hunt 28970.config > 28970.log 2>&1
37
38 Check on its progress using
39
40   ./reg-watch 28970.log
41
42 To run them all, do
43
44   echo "hunt 28970" > queue
45   echo "hunt 29106" >> queue
46   echo "hunt 29578" >> queue
47   echo "hunt 29906a" >> queue
48   echo "hunt 29906b" >> queue
49   echo "hunt 30643" >> queue
50   ./testall queue
51
52 This allows you to add more to the queue if you're setting up lots of
53 hunts.