<step> not documented

[Mark Potter <mpotter@…>]

The "<step ..." construct is not clearly documented anywhere. The best I could find searching here was Documentation/recipes.html, which is lacking.

Looking at all of the samples that I could find here, I believe the possible parameters are:

• id - required, must be unique within the recipe.
• onerror - Response if the contained commands fail. Default is the value as set in the parent <build>, which defaults to "fail".
  • "fail": Failure of step causes the build to terminate and the build to be considered failed.
  • "continue": Failure will cause the build to be considered failed but will not cause the build to terminate; build will continue with the next step.
  • ignore: Failure will not cause the build to be considered failed and will not cause the build to terminate; build will continue with the next step.
• description - Description of this step.
  I see a description field in my notes on the bitten_step table. I however do not see this value being used anywhere in the UI (didn't search the code).
• title
  Only found one example of this, on Project Build Recipes; one of the steps used both title and description. Is this a mistake and this parameter is being totally ignored?