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