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         // 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 \f
  29 Copyright (C) 2012-2021 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.