tests/README.tests

   1 Description of Testcases for OMK
   2 ================================
   3
   4 Each test resides in a separate directory. The directories can be
   5 nested. There is no difference between the tests in diffrent levels of
   6 directory structure.
   7
   8 Structure of a Testcase
   9 -----------------------
  10
  11 A directory contain the testcase if it contains at least one of these
  12 files: Makefile.test, run_test.
  13
  14 Definition of a Testcase:
  15
  16 * Makefile.test: testcase commands in the form of makefile. The test is
  17   run by "make -f Makefile.test". If the exit status is zero, the
  18   testcase is considered as passed, otherwise as failed.
  19
  20 * run_test: executable file that runs the test(s). The exit status has
  21   the same meaning as in the case of Makefile.test.
  22
  23 * rules: Specifies the rules this testcase applies to. The syntax of
  24   this files is describes in section Rules description.
  25
  26 Output of testcase:
  27
  28 Besides exit status, the testcases can produce the folowing output.
  29
  30 * FIXME: chybove hlaseni - soubor error nebo stderr?
  31
  32 Rules Description
  33 -----------------
  34
  35 The rules file contains one or more lines. Each line represents a set
  36 of zero or more rules. The set of rules to be applied to this testcase
  37 is union of these sets.
  38
  39 Each line can contain:
  40
  41 * <rule name> - This selects rules of this name
  42
  43 * all: - this selects all rules
  44
  45 * snip:<snippet name> - this selects all the rules, which are composed
  46   of the given snippet.