More work on releng/README

releng/README

@@ -9,7 +9,7 @@ Copyright (C) 2011 George Danchev, Thomas Schmitt
 Provided under GPL version 2 or later.
 ------------------------------------------------------------------------------
 
-The impatient tester will build libisoburn and then do
+The impatient tester will build libisoburn according to ./README and then do
   cd ./releng
   ./run_all_auto -x ../xorriso/xorriso
 
@@ -73,6 +73,7 @@ or if you want to use an installed xorriso program:
 
 
 +++ General options -x , -k, -f, -c, -h, --
++++ + All scripts support -h
 
 There are several options which work with run_all_auto and any single test.
   -x  absolute or relative path to xorriso binary to be run.
@@ -87,7 +88,7 @@ particular manually executable test scripts.
 
                         Manually executable tests
                  
->>> list of manual tests
++++ list of manual tests
 
 Currently there are the following tests which should have the attention of
 the user or require sysadmin considerations before they are run:
@@ -120,14 +121,24 @@ the user or require sysadmin considerations before they are run:
   directory. MD5 mismatch causes a test failure. Differences to the directory
   state are reported but still regarded as success.
 
+
 >>> ./run_all_manual
 
 >>> + Any auto_* script can be run on its own, regardless.
 >>> List auto tests
 
->>> + All scripts support -h
 
->>> give hints what to do with FAIL results.
++++ give hints what to do with FAIL results.
+
+The text output of the automatic tests is recorded in file
+   releng_generated_data/log.run_all_auto
+
+Script ./run_all_auto will detect failure of perticular tests and report
+lines from the log file which contain problem indicating key words:
+  NEVER|ABORT|FATAL|FAILURE|MISHAP|SORRY|WARNING|HINT|FAIL|ERROR|WRONG
+
+If the program messages in log.run_all_auto do not explain the failure,
+please contact mailing list libburn-hackers@pykix.org .
 
 
 ----------------------------------------------------------------------------
@@ -151,8 +162,9 @@ not done as long as such a line remains.
 +++ + Each script' self-generated data are to be stored in
 +++   ./releng_generated_data/scriptname/ directory
 
-Your test must not start if no file ./inc/releng_getopts.inc exists,
-i.e. if the current working direcoty is not ./releng.
+Your test must not start if no file
+   ./inc/releng_getopts.inc
+exists, i.e. if the current working direcoty is not ./releng.
 If your test creates own files on disk, then it must do this underneath
 directory ./releng_generated_data/$test_name (resp. $GEN_DATA_DIR, see below).
 
@@ -161,7 +173,8 @@ directory ./releng_generated_data/$test_name (resp. $GEN_DATA_DIR, see below).
 +++ + Use different exit codes for any failure (range 0-31)
 
 In case of failure, issue a line to stdout that begins by the word "FAIL",
-and make sure that the test script finally returns a non-zero exit value.
+followed by " : " and the name of the test (e.g. $SELF, see below).
+Make sure that the test script finally returns a non-zero exit value.
 This value should be between 1 and 28. Each type of failure should have its
 own exit value.
 Predefined are:
@@ -180,14 +193,20 @@ The code piece inc/releng_getopts.inc should get executed inline at the
 start of a test script.
 It initializes the following variables and sets some of them according
 to the general options of the test suite:
+
   SELF              basename $0
+
   GEN_DATA_DIR      releng_generated_data/${SELF}
+
   RELENG_XORRISO    Path to xorriso binary. "" or "0" means no xorriso.
                     Default "0". Adjustable by option -x.
+
   SIMULATE_FAILURE  0=normal operation, 1=test script shall simulate a failure.
                     Default 0. Setable to 1 by option -f.
+
   CLEANUP           0=do not cleanup temporary data, 1=normal operation
                     Default 1. Setable to 0 by option -k.
+
   SPECIFIC_HELP     0=normal operation, 1=print help text of script and exit 0
                     Default 0. Setable to 1 by option -h
 

xorriso/xorriso_timestamp.h

@@ -1 +1 @@
-#define Xorriso_timestamP "2011.08.01.152915"
+#define Xorriso_timestamP "2011.08.07.110306"