binutils/testsuite/binutils-all/windres/README

   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
  16 parse-only must preceed any xfail commands, and indicates that a
  17 comparison with the *.rsd file will not happen.  xfail indicates when
  18 a failure is expected.  This should only be used for when you are
  19 adding a new test that is known to fail because of a bug in windres,
  20 and it should be removed when the bug is fixed.
  21
  22 You can use pfail or cfail instead of xfail to indicate that only the
  23 parsing or comparing should be xfailed.
  24
  25 The windres tests only run for ix86 targets, because the
  26 MSVC-generated *.rsd files are generated for that.