dc: fix '?'
[oweals/busybox.git] / testsuite / README
index 377f20ef8ecf7eb2e9c626c96f1b3a01ef5ebdf9..b943a1295d16c7ba944f38153e8c7bcd318c34ca 100644 (file)
@@ -1,20 +1,38 @@
-Update: doesn't work as described. Try "make check" from parent dir...
-* * *
-
 To run the test suite, change to this directory and run "./runtest".  It will
 run all of the test cases, and list those with unexpected outcomes.  Adding the
 -v option will cause it to show expected outcomes as well.  To only run the test
-cases for particular applets, specify them as parameters to runtest.
+cases for particular applets:
+
+./runtest <applet1> <applet2>...
+
+Set SKIP_KNOWN_BUGS environment variable to any non-empty value
+to exclude tests which are known to fail.
+
+Set SKIP_INTERNET_TESTS to exclude tests which require working
+internet connection.
+
+
+Common causes of false positives:
 
-The test cases for an applet reside in the subdirectory of the applet name.  The
-name of the test case should be the assertion that is tested.  The test case
-should be a shell fragment that returns successfully if the test case passes,
-and unsuccessfully otherwise.
+For busybox built against uclibc, /etc/TZ does not exist or does not match
+host system timezone setting. For glibc based host systems, timezone settings
+are in /etc/localtime.
+
+LANG and LC_xxx environment variables set to non-C locale.
+
+
+Developer's notes:
+
+The test cases for an applet reside in the subdirectory of the applet name.
+The name of the test case should be the assertion that is tested.
+The test case should be a shell fragment that returns successfully
+if the test case passes, and unsuccessfully otherwise.
 
 If the test case relies on a certain feature, it should include the string
 "FEATURE: " followed by the name of the feature in a comment.  If it is always
 expected to fail, it should include the string "XFAIL" in a comment.
 
+
 For the entire testsuite, the copyright is as follows:
 
 Copyright (C) 2001, 2002  Matt Kraai