hook_variable_info() 'required' property is not documented

The code example has:

> 'required' => TRUE,

but this is not in the @return docs.