Mercurial > bitten > bitten-test
comparison doc/recipes.txt @ 754:545be0c8f405
Adding the ability to modify the default ''onerror'' property in the ''<build>'' element. If not specified, the behavior is unchanged; by default any step failure will result in the build failing and stopping.
Added a new ''continue'' onerror specification-- it's similar to ''ignore''
except the results of ''continue'' steps are counted in the overall build
status (in ''ignore'' they're ignored.)
You'll need to upgrade both your master and slaves if you wish to use
the ''<build>'' element override or the new ''continue'' value.
Will update http://bitten.edgewall.org/wiki/Documentation/recipes.html .
Thanks to jerith for comments.
Closes #409.
Refs #210.
| author | wbell |
|---|---|
| date | Sat, 24 Apr 2010 13:37:26 +0000 |
| parents | 94a4be5a1f0f |
| children | 025b3e889321 |
comparison
equal
deleted
inserted
replaced
| 752:673ec182679d | 754:545be0c8f405 |
|---|---|
| 34 | 34 |
| 35 A ``<step>`` element will consist of any number of commands and reports. Most of | 35 A ``<step>`` element will consist of any number of commands and reports. Most of |
| 36 these elements are declared in XML namespaces, where the namespace URI defines | 36 these elements are declared in XML namespaces, where the namespace URI defines |
| 37 a collection of related commands. | 37 a collection of related commands. |
| 38 | 38 |
| 39 A ``<step>`` element can additionally have an ``onerror`` attribute with | 39 |
| 40 value of ``fail`` (terminate after step, default behaviour) or ``ignore`` | 40 The ``<build>`` element can optionally have an ``onerror`` attribute that |
| 41 (fail, but run next step). | 41 dictates how a build should proceed after the failure of a step. Allowable |
| 42 values are: | |
| 43 ``fail``: failure of a step causes the build to terminate. (default) | |
| 44 ``continue``: builds continue after step failures. Failing steps | |
| 45 contribute to the overall build status. | |
| 46 ``ignore``: builds continue after step failures. Builds are marked | |
| 47 as successful even in the presence of failed steps with | |
| 48 onerror='ignore' | |
| 49 | |
| 50 ``<step>`` elements can override the ``<build>`` ``onerror`` attribute with | |
| 51 their own ``onerror`` attributes. | |
| 42 | 52 |
| 43 Commonly, the first step of any build recipe will perform the checkout from the | 53 Commonly, the first step of any build recipe will perform the checkout from the |
| 44 repository. | 54 repository. |
| 45 | 55 |
| 46 .. code-block:: xml | 56 .. code-block:: xml |