function check capability in split format
	
|  | 
= 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. | 
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. | 
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''
 | 
| assert_define, test_run | 
= SEE ALSO =
 * [[function_assert_define|assert_define]], [[function_test_run|test_run]]
 |