aboutsummaryrefslogtreecommitdiff
path: root/binutils/testsuite/binutils-all/windres/README
blob: 91ccb7b05cc071c5e9392fe6cd17b1f9ee886962 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
Instructions for adding tests:

The files *.rc are hand-edited or copied from elsewhere.

The script msupdate is used to generate the *.rsd files, which are
dumps of the RES formatted output of MSVC's RC utility.

Within the *.rc file, the first N lines beginning with a special
comment can control the test.  Comments are // /* or # (// is
recommended, as both rc and windres support those).  Each line
contains one command:

	// parse-only
	// xfail *-*-*
	// cpparg <preprocessor options passed via --preprocessor-arg>

parse-only must preceed any xfail commands, and indicates that a
comparison with the *.rsd file will not happen.  xfail indicates when
a failure is expected.  This should only be used for when you are
adding a new test that is known to fail because of a bug in windres,
and it should be removed when the bug is fixed.

You can use pfail or cfail instead of xfail to indicate that only the
parsing or comparing should be xfailed.

The windres tests only run for ix86 targets, because the
MSVC-generated *.rsd files are generated for that.

Copyright (C) 2012-2019 Free Software Foundation, Inc.

Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.