diff options
author | Jonathan "Duke" Leto <jonathan@leto.net> | 2011-04-29 10:46:10 -0700 |
---|---|---|
committer | Jonathan "Duke" Leto <jonathan@leto.net> | 2011-04-29 10:46:10 -0700 |
commit | cbe1a65dc1da0e2dd9fb3b6369a6e39efe2fcfb4 (patch) | |
tree | efd72a83f44c73c821fe9c7852976d70ecf9672e | |
parent | Add the beginning of docs about configuring Jitterbug (diff) | |
download | jitterbug-cbe1a65dc1da0e2dd9fb3b6369a6e39efe2fcfb4.tar.gz |
Add more docs about the build_process config key
Diffstat (limited to '')
-rw-r--r-- | README.md | 23 |
1 files changed, 23 insertions, 0 deletions
diff --git a/README.md b/README.md index 388681d..4ea55af 100644 --- a/README.md +++ b/README.md @@ -66,3 +66,26 @@ Most of the configuration changes that you will make are in the "jitterbug" and This means that reports should be stored in /tmp/jitterbug and build directories will be stored in /tmp/build. +The "build_process" section has the most options, which may be overwhelming at first. Most of +them are related to how emails will be formatted. The first three config keys are the most +important: + + build_process: + builder: ./scripts/capsule.sh + builder_variables: "DEBUG=1" + reuse_repo: 1 + +The "builder" key is a path to a script that detects the language and type of +test suite and then builds and tests a repo. Unless Jitterbug doesn't know how +to autodetect and run the tests in your repo (please tell us!), you won't have +to change this config key. + +The "build_variables" keys is for setting environment variabels in the builder +process. Here, we set the environmanet variable DEBUG to a value of 1. + +The "reuse_repo" key tells Jitterbug whether it should reuse Git repos, i.e. +not clone them again and again. If you have large git repos, this config key +can be a life saver to minimize bandwidth and the time to build + test a +commit. If this is a true value, repos will be cached in the "build" directory +specified above. + |