1To run the test suite, change to this directory and run "./runtest". It will 2run all of the test cases, and list those with unexpected outcomes. Adding the 3-v option will cause it to show expected outcomes as well. To only run the test 4cases for particular applets: 5 6./runtest <applet1> <applet2>... 7 8Set SKIP_KNOWN_BUGS environment variable to any non-empty value 9to exclude tests which are known to fail. 10 11Set SKIP_INTERNET_TESTS to exclude tests which require working 12internet connection. 13 14 15Common causes of false positives: 16 17For busybox built against uclibc, /etc/TZ does not exist or does not match 18host system timezone setting. For glibc based host systems, timezone settings 19are in /etc/localtime. 20 21LANG and LC_xxx environment variables set to non-C locale. 22 23 24Developer's notes: 25 26The test cases for an applet reside in the subdirectory of the applet name. 27The name of the test case should be the assertion that is tested. 28The test case should be a shell fragment that returns successfully 29if the test case passes, and unsuccessfully otherwise. 30 31If the test case relies on a certain feature, it should include the string 32"FEATURE: " followed by the name of the feature in a comment. If it is always 33expected to fail, it should include the string "XFAIL" in a comment. 34 35 36For the entire testsuite, the copyright is as follows: 37 38Copyright (C) 2001, 2002 Matt Kraai 39 40This program is free software; you can redistribute it and/or 41modify it under the terms of the GNU General Public License 42as published by the Free Software Foundation; either version 2 43of the License, or (at your option) any later version. 44 45This program is distributed in the hope that it will be useful, 46but WITHOUT ANY WARRANTY; without even the implied warranty of 47MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 48GNU General Public License for more details. 49 50You should have received a copy of the GNU General Public License 51along with this program; if not, write to the Free Software 52Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. 53