diff --git a/core/includes/form.inc b/core/includes/form.inc index 144e3a2..d7a7300 100644 --- a/core/includes/form.inc +++ b/core/includes/form.inc @@ -81,8 +81,14 @@ function template_preprocess_select(&$variables) { * @return array * A structured array of options and optgroups for use in a select form * element. - * - * @todo Document the format of this array. + * - label: A translated string whose value is the text of a single HTML + * option element, or the label attribute for an optgroup. + * - options: Optional, array of options for an optgroup. + * - selected: A boolean that indicates whether the option is selected when + * rendered. + * - type: A string that defines the element type. The value can be 'option' + * or 'optgroup'. + * - value: A string that contains the value attribute for the option. */ function form_select_options($element, $choices = NULL) { if (!isset($choices)) {