File: README

package info (click to toggle)
palp 2.21-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 1,300 kB
  • sloc: ansic: 17,456; sh: 1,452; makefile: 52
file content (38 lines) | stat: -rw-r--r-- 1,498 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
This directory contains a collection of test scripts that are executed
by "make check" and/or "make checklong". The basic setup and execution
of an individual tests looks like,

  COMMAND="the command to run"
  DESCRIPTION="a description of the test"
  EXPECTED="the expected output from $COMMAND"
  run_test

The run_test() function will then run the given $COMMAND, and report
the result; that is, whether or not the actual output matches the
$EXPECTED output. There are a few more variables you can use: the
run_test() function is defined and documented in lib/run-test.sh.

Variables
=========

A few environment variables are passed from the GNUmakefile to the
test scripts:

 * DIM: the value of POLY_Dmax to use. The "all-dims" target produces
   multiple executables, each compiled with a different value for
   POLY_Dmax. For example, poly-4d.x, poly-5d.x, ..., poly-11d.x. The
   value of $DIM tells the test script which of those executables to
   test. The GNUmakefile loops through all possible values of DIM, to
   ensure that all executables get tested. As a result, the test
   scripts themselves do not need to repeat any tests.

 * LONG: if set to a non-null value, indicates that the script
   is allowed to run tests that take a long time to run. The
   "make checklong" command sets this automatically; a plain
   "make check" does not.

Return value
============

Each script succeeds (exits with code zero) if all of its tests pass,
and fails with a non-zero code otherwise.