1This directory contains test related to regression tracking that require
2a specific setup and a complete test.  Each regression test must be
3contained in a test directory whose name is "its<number>", where <number>
4is the ITS number, and it must be entirely executed by a script, contained
5in that directory and with the same name of the directory.  It can exploit
6all the helpers provided for common tests (variables in scripts/defines.sh,
7data files in data/, ...), but it should simultaneously be as self contained
8and as general as possible.  Warning: occasionally, data files and
9shell variables may change, so limit their use to real needs.
10
11For example, if an issue only appears with a certain database type, the
12test itself should only run when invoked for that database type;
13otherwise, if the issue appears whatever backend is used, the test should
14be parametric, so that it is run with the backend selected at run-time
15via the "-b" switch of the "run" script.
16
17Regression tests are prepared on a voluntary basis, so don't expect all
18bugs to have a test any soon.  When the issue reporter provides a simple,
19yet complete means to reproduce the bug she's reporting, this may speed up
20the process.  In case, only put neutral data in bug exploitation reports.
21