1 This file contains a list of notes for those writing testcases and those
2 writing expect scripts. At present, they're in random order.
6 - each level adds verbosity so level 2 prints all level 1 and level 2 stuff.
8 1) Print a one-liner indicating the testcase being run (and maybe special
11 2) Print compiler and program invocation including arguments and their output.
12 Proc's gcc_load and gcc_start handle the latter two.
14 3) Print detailed testcase analysis like "Looking for pattern ...", etc.
16 4) Maximum verbosity. Print anything else of interest.
20 Various messages are stored in gcc.log by the testing framework and we
21 try to augment them with some of our own. The format of the framework
33 EXEC: program being executed (so compiler path and args are recorded)
34 STAT: intermediate pass/fail statistics
36 DO NOT PUT NON-PORTABLE TESTCASES IN gcc.c-torture.
38 ANY TARGET SPECIFIC TESTCASE MUST HAVE APPROPRIATE CODE TO PREVENT IT FROM
39 CAUSING A `FAILURE' ON UNSUPPORTED PLATFORMS.
41 Test scripts must ignore the compiler messages "path prefix never used"
42 and "linker input file unused". Don't let their appearance cause a testcase
43 to fail. See lib/dg.exp for the exact regsub to use.
45 If you're unclear about which directory a testcase should be installed in,
48 Always use abort() for runtime failures, and exit(0) for success.
49 The testing harness is set up to watch for these and do something appropriate
50 (when necessary) for target boards.
52 Have the text of a fail message be the same as that for pass.
68 This lets test-tool (which drives the nightly tests) do a better job
69 at tracking which tests have digressed or been fixed.