drop completed items, polish core text

This commit is contained in:
George Danchev 2011-06-28 17:33:08 +00:00
parent 8befd096a7
commit 6e671c83e9
2 changed files with 20 additions and 30 deletions

View File

@ -1,28 +1,29 @@
Release Engineering
~~~~~~~~~~~~~~~~~~~
* SOFTWARE TO TEST
Use latest libraries code base from svn and bzr
Use latest libburnia 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
+ Copy all SCRIPT.conf.template to $HOME/.libburnia-releng/SCRIPT.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
+ 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)
+ 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
+ Return 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.
libisoburn source tree. Ther is a 'master' script called
run_all_releng, which runs all scripts prefixed with releng_*.

View File

@ -1,25 +1,14 @@
* write a 'master' script to run all tests
-> work in progress: run_all_releng
+ figure out how to store logs and search for interesting
* write common configuration facility
* run_all_releng (master script)
+ figure out how to efficiently search for interesting
err/warn keywords spewed up by the script or apps it calls.
+ write common configuration facility
* releng_build_isojigdo:
+ finish boot options
* releng_check_isocontent: compare input data against the ISO image content, might be tricky
-> work in progress
* Give up existing standard option -clean in favor of:
+ Option -keep which keeps the test data from being removed after
the test.
+ Option -clean_up which removes the test data without doing another test.
+ Rule: A test must not overwrite existing data on disk.
It rather shall refuse and offer option -clean_up to
solve the problem (after skilled examination by the user).
+ Rule: A test shall remove all files which it has created.
Only explicit user orders shall allow test files to persist.
These orders may be program arguments or configuration variables.
-> see releng/test_hardlinks for an implementation example
* releng_check_isocontent (WIP) - compare input data against
the ISO image content, might be tricky
* Interpreter to read options from config files and sets the variables