Commit | Line | Data |
---|---|---|
64e08727 DD |
1 | Instructions for adding tests: |
2 | ||
3 | The files *.rc are hand-edited or copied from elsewhere. | |
4 | ||
5 | The script msupdate is used to generate the *.rsd files, which are | |
6 | dumps of the RES formatted output of MSVC's RC utility. | |
7 | ||
8 | Within the *.rc file, the first N lines beginning with a special | |
9 | comment can control the test. Comments are // /* or # (// is | |
10 | recommended, as both rc and windres support those). Each line | |
11 | contains one command: | |
12 | ||
13 | // parse-only | |
14 | // xfail *-*-* | |
ec25acb3 | 15 | // cpparg <preprocessor options passed via --preprocessor-arg> |
64e08727 DD |
16 | |
17 | parse-only must preceed any xfail commands, and indicates that a | |
18 | comparison with the *.rsd file will not happen. xfail indicates when | |
19 | a failure is expected. This should only be used for when you are | |
20 | adding a new test that is known to fail because of a bug in windres, | |
21 | and it should be removed when the bug is fixed. | |
22 | ||
23 | You can use pfail or cfail instead of xfail to indicate that only the | |
24 | parsing or comparing should be xfailed. | |
25 | ||
26 | The windres tests only run for ix86 targets, because the | |
27 | MSVC-generated *.rsd files are generated for that. | |
5bf135a7 NC |
28 | \f |
29 | Copyright (C) 2012 Free Software Foundation, Inc. | |
30 | ||
31 | Copying and distribution of this file, with or without modification, | |
32 | are permitted in any medium without royalty provided the copyright | |
33 | notice and this notice are preserved. |