X-Git-Url: https://git.librecmc.org/?a=blobdiff_plain;f=testsuite%2FREADME;h=b943a1295d16c7ba944f38153e8c7bcd318c34ca;hb=6842c6062a201cc34a262b4c450cf8e1374e9e3a;hp=b02dfa49cdbfad18cec96500ac675a73f76d119a;hpb=01d2ea908b88a80b2f5d36c23229032dd76d621c;p=oweals%2Fbusybox.git

diff --git a/testsuite/README b/testsuite/README
index b02dfa49c..b943a1295 100644
--- a/testsuite/README
+++ b/testsuite/README
@@ -1,22 +1,41 @@
-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.
-
-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 is known to fail, it should be marked
-as such by including the string "XFAIL" in a comment.  If a
-certain feature must be enabled for it to pass, it should indicate
-that by including the string "UNSUPPORTED: " followed by the
-feature name in a comment.
+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:
+
+./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:
+
+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 Matt Kraai
+Copyright (C) 2001, 2002  Matt Kraai
 
 This program is free software; you can redistribute it and/or
 modify it under the terms of the GNU General Public License