legacy/libisoburn/trunk/releng
2011-06-28 06:51:40 +00:00
..
README.releng
releng_build_isojigdo
releng_build_isojigdo.conf.template
releng_check_isocontent
releng_check_isocontent.conf.template
run_all_releng
template_new_releng
test_hardlinks Adjusted names of config variables in test_hardlinks 2011-06-28 06:51:40 +00:00
TODO

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

* DELIVERING A NEW TEST SCRIPT
 + start a new test over the top of template_new_releng
 + file name starts with releng_
 + any generated data to be stored in ./tmp/scriptname directory
 + test data generation options -rc [-keep]
 + test data removal options -cleanup
 + well documented configuration file test.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 (10, 20, ... 100)

* 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_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