summaryrefslogtreecommitdiffstats
path: root/binutils-2.25/binutils/testsuite/binutils-all/windres/README
diff options
context:
space:
mode:
Diffstat (limited to 'binutils-2.25/binutils/testsuite/binutils-all/windres/README')
-rw-r--r--binutils-2.25/binutils/testsuite/binutils-all/windres/README33
1 files changed, 33 insertions, 0 deletions
diff --git a/binutils-2.25/binutils/testsuite/binutils-all/windres/README b/binutils-2.25/binutils/testsuite/binutils-all/windres/README
new file mode 100644
index 00000000..67114461
--- /dev/null
+++ b/binutils-2.25/binutils/testsuite/binutils-all/windres/README
@@ -0,0 +1,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 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.