= NAME =
check_capability

= SYNOPSIS =
 * check_capability <variable>

= DESCRIPTION =
This routine checks that a board and distribution have a certain "capability".
The capability is defined as a variable prefixed with "CAP_".

If the indicated capability variable is set, nothing happens.
If the variable is not set, then the job is aborted.

= EXAMPLES =
Here are some sample invocations:
{{{#!YellowBox
check_capability RENESAS
}}}

This would check for the presence of $CAP_RENESAS, and check that its
value is non-empty.

= ENVIRONMENT and ARGUMENTS =
This routine specifically checks whether $CAP_<variable> is non-zero.


= RETURN =
Returns non-zero and aborts the job if the CAP_<variable> is not defined.

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

= SEE ALSO =
 * [[function_assert_define|assert_define]], [[function_test_run|test_run]]