* testsuite/README: Document -v option.
[oweals/busybox.git] / testsuite / README
1 To run the test suite, change to this directory and run
2 "./runtest".  It will run all of the test cases, and list those
3 with unexpected outcomes.  Adding the -v option will cause it to
4 show expected outcomes as well.  To only run the test cases for
5 particular applets, specify them as parameters to runtest.
6
7 The test cases for an applet reside in the subdirectory of the
8 applet name.  The name of the test case should be the assertion
9 that is tested.  The test case should be a shell fragment that
10 returns successfully if the test case passes, and unsuccessfully
11 otherwise.  If the test case is known to fail, it should be marked
12 as such by including the string "XFAIL" in a comment.  If a
13 certain feature must be enabled for it to pass, it should indicate
14 that by including the string "UNSUPPORTED: " followed by the
15 feature name in a comment.
16
17 For the entire testsuite, the copyright is as follows:
18
19 Copyright (C) 2001 Matt Kraai
20
21 This program is free software; you can redistribute it and/or
22 modify it under the terms of the GNU General Public License
23 as published by the Free Software Foundation; either version 2
24 of the License, or (at your option) any later version.
25
26 This program is distributed in the hope that it will be useful,
27 but WITHOUT ANY WARRANTY; without even the implied warranty of
28 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
29 GNU General Public License for more details.
30
31 You should have received a copy of the GNU General Public License
32 along with this program; if not, write to the Free Software
33 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.