README
1#
2# @(#)README 1.3 17/11/21 Copyright 2016-2017 J. Schilling
3#
4
5 This is the test suite for the Schily Bourne Shell
6 in compatibility mode for the OpenSolaris AT&T Bourne Shell
7
8The directory "common" contains the linkage to the test suite, that calls the
9test framework in "$SRCROOT/tests", the directory "shelltests" contains the
10shell test suite itself.
11
12To run the tests, simply call "make" to test the just compiled Schily Bourne
13Shell at "$SRCROOT/sh/OBJ/<arch-dir>/sh". If a single test fails and is not
14expected to fail, all further tests are stopped.
15
16Failed tests leave debugging files in the subdirectory where the test did
17take place, e.g. "$SRCROOT/sh/tests/shelltests/exit". If the output of the
18test suite contains the word "FAIL", an unexpected failure was seen. If the
19output of the test suite contains the word "XFAIL", an expected failure was
20seen.
21
22To run all tests even in case of a single unexpected failure, call
23"EXPECT_FAIL=true make".
24
25To run the tests with other shells, you need to specify the absolute path
26to the shell in question. Call e.g.: "shell=/usr/bin/ksh93 make" or
27"EXPECT_FAIL=true shell=/usr/bin/ksh93 make".
28