= NAME =
pre_deploy

= SYNOPSIS =
pre_deploy performs steps needed before executing the test_deploy function.

= DESCRIPTION =
This internal function checks to see if the software has been built.  If
it can't find the build directory, or if a previous build failed (detected
by the presend of a "build_failed" file in the build directory, then
pre_deploy tries to build the software again.

= EXAMPLES =

= ENVIRONMENT and ARGUMENTS =
pre_deploy uses the following environment variables:
 * $WORKSPACE
 * $TRIPLET

= RETURN =
returns non-zero for error.

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

= SEE ALSO =
 * [[function deploy|deploy]], [[function test_deploy|test_deploy]], [[function_post_deploy|post_deploy]]