| 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 *-*-* |
| 15 |
// cpparg <preprocessor options passed via --preprocessor-arg> |
| 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. |
| 28 |
|
| 29 |
Copyright (C) 2012-2020 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. |