= NAME =
build_error

= SYNOPSIS =
 * build_error ["<reason-string>"]

= DESCRIPTION =
This helper function touches the file "build_failed", then aborts the job
with the message: "Build failed: $@"

This function calls abort_job, and so does not return.

= EXAMPLES =
Here are some sample invocations:
{{{#!YellowBox
    build_error "missing patch file: $1"
}}}

= ENVIRONMENT and ARGUMENTS =
This function assumes that the current directory is the build directory.

= RETURN =
This function does not return.

= SOURCE =
Located in ''scripts/functions.sh''

= SEE ALSO =
 * [[function_abort_job|abort_job]]