Release Engineering Che[at|ck] List
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* SOFTWARE TO TEST
 Use latest libraries code base from svn and bzr
 (see README for aditional and autodetected library dependencies)
 Alternatively, use latest all-in-one development tarball from:
 http://www.gnu.org/software/xorriso/

* SETUP THE TEST ENVIRONMENT
 + Not all TESTs are scripts (e.g. cppcheck, valgrind)
 + Copy all FILE.conf.template to $HOME/.libburnia-releng/FILE.conf
 + Read the configuration files and set up accordingly to your needs

* DELIVERING A NEW TEST SCRIPT
 + start a new test script over the top of template_new_releng
 + all filenames start with releng_ prefix
 + self generated data are to be stored in
   ./releng_generated_data/scriptname/ directory
 + test data generation options -rc [-keep]
 + test data removal options -cleanup
 + well documented configuration file $script.conf.template
 + throw FAIL string to stdout if any failure is detected
 + exit code 0 on success, non-zero on failure
 + use different exit codes for any failure (range 1-31)

* RUNNING TESTS
 + All tests have to be run from the releng/ directory, within
   libisoburn source tree.

* TESTS LIST

 TEST: releng_build_os
 FILE: libburn/releng/releng_build_os
 WHO:  george, thomas

 TEST: releng_build_isojigdo
 FILE: libisoburn/releng/releng_build_isojigdo
 WHO:  george, thomas

 TEST: releng_check_hardlinks
 FILE: libisoburn/releng/releng_check_hardlinks
 WHO:  george, thomas

 TEST: releng_check_isocontent
 FILE: libisoburn/releng/releng_check_isocontent
 WHO:  george, thomas

 TEST: valgrind
 FILE:
 WHO:  george, thomas

 TEST: cppcheck
 FILE: http://people.debian.org/~danchev/xorriso/sclogs/
 WHO:  george, thomas

 TEST: buildd_logs
 FILE: http://buildd.debian.org (others are also welcome)
 FILE: (err/warn from prev. builds for several h/w architectures and kernels: linux, kfreebsd, hurd)
 WHO:  george, thomas

 TEST: medistimator (dialog mode, size estimation, processing large trees)
       requires some specific knowledge of how the tool works, to interpret
       the results and compare them previous runs (see comments in the source).
 FILE: http://anonscm.debian.org/gitweb/?p=users/danchev/medistimator.git;a=summary
 FILE: http://people.debian.org/~danchev/medistimator/log/
 WHO:  george, thomas

 TEST: gprof
 FILE: CFLAGS=-pg ./configure && make
 FILE: run resulting executable; gmon.out to be created in current cirectory
 FILE: gprof path/to/xorriso gmon.out  > gprof.out
 WHO:  george, thomas