[PATCH 1/5] Update selftest README to point at upstream subunit repository for protocol description.

Jelmer Vernooij jelmer at samba.org
Tue Jan 20 18:58:45 MST 2015


Change-Id: I50c2a5e9847d269486cb5157357592004779704a
Signed-Off-By: Jelmer Vernooij <jelmer at samba.org>
---
 selftest/README | 33 +++++++++++++++++----------------
 1 file changed, 17 insertions(+), 16 deletions(-)

diff --git a/selftest/README b/selftest/README
index d9ad020..012a5cb 100644
--- a/selftest/README
+++ b/selftest/README
@@ -1,22 +1,22 @@
 # vim: ft=rst
 
 This directory contains test scripts that are useful for running a
-bunch of tests all at once. 
+bunch of tests all at once.
 
-There are two parts to this: 
+There are two parts to this:
 
  * The test runner (selftest/selftest.pl)
  * The test formatter
 
-selftest.pl simply outputs subunit, which can then be formatted or analyzed 
-by tools that understand the subunit protocol. One of these tools is 
+selftest.pl simply outputs subunit, which can then be formatted or analyzed
+by tools that understand the subunit protocol. One of these tools is
 format-subunit, which is used by default as part of "make test".
 
 Available testsuites
 ====================
-The available testsuites are obtained from a script, usually 
+The available testsuites are obtained from a script, usually
 source{3,4}/selftest/tests.py. This script should for each testsuite output
-the name of the test, the command to run and the environment that should be 
+the name of the test, the command to run and the environment that should be
 provided. Use the included "plantest" function to generate the required output.
 
 Testsuite behaviour
@@ -24,20 +24,21 @@ Testsuite behaviour
 
 Exit code
 ------------
-The testsuites should exit with a non-zero exit code if at least one 
+The testsuites should exit with a non-zero exit code if at least one
 test failed. Skipped tests should not influence the exit code.
 
 Output format
 -------------
-Testsuites can simply use the exit code to indicate whether all of their 
-tests have succeeded or one or more have failed. It is also possible to 
-provide more granular information using the Subunit protocol. 
+Testsuites can simply use the exit code to indicate whether all of their
+tests have succeeded or one or more have failed. It is also possible to
+provide more granular information using the Subunit protocol.
 
-This protocol works by writing simple messages to standard output. Any 
-messages that can not be interpreted by this protocol are considered comments 
+This protocol works by writing simple messages to standard output. Any
+messages that can not be interpreted by this protocol are considered comments
 for the last announced test.
 
-For a full description of the subunit protocol, see ../lib/subunit/README.
+For a full description of the subunit protocol, see the README file in the subunit
+repository at http://github.com/testing-cabal/subunit.
 
 The following commands are Samba extensions to Subunit:
 
@@ -73,8 +74,8 @@ Indicate that a testsuite has failed.
 
 Environments
 ============
-Tests often need to run against a server with particular things set up, 
-a "environment". This environment is provided by the test "target": Samba 3, 
+Tests often need to run against a server with particular things set up,
+a "environment". This environment is provided by the test "target": Samba 3,
 Samba 4 or Windows.
 
 The environments are currently available include
@@ -87,7 +88,7 @@ The environments are currently available include
      * PASSWORD: Administrator password
      * DOMAIN: Domain name
      * REALM: Realm name
-     * SERVER: DC host name 
+     * SERVER: DC host name
      * SERVER_IP: DC IPv4 address
      * SERVER_IPV6: DC IPv6 address
      * NETBIOSNAME: DC NetBIOS name
-- 
2.1.4



More information about the samba-technical mailing list