From: Jelmer Vernooij <jelmer@samba.org>
Date: Sun, 6 Jan 2008 01:33:05 +0000 (-0600)
Subject: r26673: selftest: Document the purpose and output format of samba4_tests.sh.
X-Git-Tag: samba-4.0.0alpha3~560
X-Git-Url: http://git.samba.org/samba.git/?p=ira%2Fwip.git;a=commitdiff_plain;h=93b80f1ceb1efffd16a489bebd63ec10dd947989

r26673: selftest: Document the purpose and output format of samba4_tests.sh.
---

diff --git a/source/selftest/samba4_tests.sh b/source/selftest/samba4_tests.sh
index 66717c03aef..290c06fa6af 100755
--- a/source/selftest/samba4_tests.sh
+++ b/source/selftest/samba4_tests.sh
@@ -1,4 +1,23 @@
 #!/bin/sh
+# This script generates a list of testsuites that should be run as part of 
+# the Samba 4 test suite.
+
+# The output of this script is parsed by selftest.pl, which then decides 
+# which of the tests to actually run. It will, for example, skip all tests 
+# listed in samba4-skip or only run a subset during "make quicktest".
+
+# The idea is that this script outputs all of the tests of Samba 4, not 
+# just those that are known to pass, and list those that should be skipped 
+# or are known to file in samba4-skip/samba4-knownfail. This makes it 
+# very easy to see what functionality is still missing in Samba 4 and makes 
+# it possible to run the testsuite against other servers, such as Samba 3 or 
+# Windows that have a different set of features.
+
+# The syntax for a testsuite is "-- TEST --" on a single line, followed 
+# by the name of the test, the environment it needs and the command to run, all 
+# three separated by newlines. All other lines in the output are considered 
+# comments.
+
 if [ ! -n "$PERL" ]
 then
 	PERL=perl