Browse Source

Reduce duplication in docs and fix typos.

Mark Story 12 years ago
parent
commit
443f6cb1d9
1 changed files with 19 additions and 31 deletions
  1. 19 31
      src/View/Helper/FormHelper.php

+ 19 - 31
src/View/Helper/FormHelper.php

@@ -1742,7 +1742,7 @@ class FormHelper extends Helper {
  * ### Options:
  *
  * - `monthNames` - If false, 2 digit numbers will be used instead of text.
- *   If a array, the given array will be used.
+ *   If an array, the given array will be used.
  * - `empty` - If true, the empty select option is shown. If a string,
  *   that string is displayed as the empty element.
  * - `value` The selected value of the input.
@@ -1854,24 +1854,28 @@ class FormHelper extends Helper {
 /**
  * Returns a set of SELECT elements for a full datetime setup: day, month and year, and then time.
  *
- * ### Options:
+ * ### Date Options:
  *
  * - `empty` - If true, the empty select option is shown. If a string,
  *   that string is displayed as the empty element.
+ * - `value` | `default` The default value to be used by the input. A value in `$this->data`
+ *   matching the field name will override this value. If no default is provided `time()` will be used.
  * - `monthNames` If false, 2 digit numbers will be used instead of text.
- *   If a array, the given array will be used.
- * - `minYear` - The lowest year to use in the year select
- * - `maxYear` - The maximum year to use in the year select
+ *   If an array, the given array will be used.
+ * - `minYear` The lowest year to use in the year select
+ * - `maxYear` The maximum year to use in the year select
  * - `orderYear` - Order of year values in select options.
  *   Possible values 'asc', 'desc'. Default 'desc'.
- * - `interval` - The interval for the minutes select. Defaults to 1
- * - `round` - Set to `up` or `down` if you want to force rounding in either
- *   direction. Defaults to null.
- * - `value` | `default` - The default value to be used by the input.
- *   A value in `$this->data` matching the field name will override this value.
- *   If no default is provided `time()` will be used.
- * - `timeFormat` - The time format to use, either 12 or 24.
- * - `second` - Set to true to enable seconds drop down.
+ *
+ * ### Time options:
+ *
+ * - `empty` - If true, the empty select option is shown. If a string,
+ * - `value` | `default` The default value to be used by the input. A value in `$this->data`
+ *   matching the field name will override this value. If no default is provided `time()` will be used.
+ * - `timeFormat` The time format to use, either 12 or 24.
+ * - `interval` The interval for the minutes select. Defaults to 1
+ * - `round` - Set to `up` or `down` if you want to force rounding in either direction. Defaults to null.
+ * - `second` Set to true to enable seconds drop down.
  *
  * To control the order of inputs, and any elements/content between the inputs you
  * can override the `dateWidget` template. By default the `dateWidget` template is:
@@ -1975,14 +1979,7 @@ class FormHelper extends Helper {
  *
  * ### Options:
  *
- * - `interval` The interval for the minutes select. Defaults to 1
- * - `empty` - If true, the empty select option is shown. If a string,
- *   that string is displayed as the empty element.
- * - `round` - Set to `up` or `down` if you want to force rounding in either direction. Defaults to null.
- * - `value` | `default` The default value to be used by the input. A value in `$this->data`
- *   matching the field name will override this value. If no default is provided `time()` will be used.
- * - `timeFormat` The time format to use, either 12 or 24.
- * - `second` Set to true to enable seconds drop down.
+ * See dateTime() for time options.
  *
  * @param string $fieldName Prefix name for the SELECT element
  * @param array $options Array of Options
@@ -2010,16 +2007,7 @@ class FormHelper extends Helper {
  *
  * ### Options:
  *
- * ### Options:
- *
- * - `monthNames` If false, 2 digit numbers will be used instead of text.
- *   If a array, the given array will be used.
- * - `minYear` The lowest year to use in the year select
- * - `maxYear` The maximum year to use in the year select
- * - `empty` - If true, the empty select option is shown. If a string,
- *   that string is displayed as the empty element.
- * - `value` | `default` The default value to be used by the input. A value in `$this->data`
- *   matching the field name will override this value. If no default is provided `time()` will be used.
+ * See dateTime() for date options.
  *
  * @param string $fieldName Prefix name for the SELECT element
  * @param array $options Array of Options