[reference][forms] Quickly adding missing empty_value date option

weaverryan · weaverryan · commit d150185dadd4 · 2011-07-23T22:00:59.000-05:00
diff --git a/reference/forms/types/date.rst b/reference/forms/types/date.rst
@@ -21,6 +21,7 @@ day, and year) or three select boxes (see the `widget_` option).
 +----------------------+-----------------------------------------------------------------------------+
 | Options              | - `widget`_                                                                 |
 |                      | - `input`_                                                                  |
+|                      | - `empty_value`_                                                            |
 |                      | - `years`_                                                                  |
 |                      | - `months`_                                                                 |
 |                      | - `days`_                                                                   |
@@ -74,6 +75,25 @@ Field Options
 
 .. include:: /reference/forms/types/options/date_input.rst.inc
 
+empty_value
+~~~~~~~~~~~
+
+**type**: ``string``|``array``
+
+If your widget option is set to ``choice``, then this field will be represented
+as a series of ``select`` boxes. The ``empty_value`` option can be used to
+add a "blank" entry to the top of each select box::
+
+    $builder->add('dueDate', 'date', array(
+        'empty_value' => '',
+    ));
+
+Alternatively, you can specify a string to be displayed for the "blank" value::
+
+    $builder->add('dueDate', 'date', array(
+        'empty_value' => array('year' => 'Year', 'month' => 'Month', 'day' => 'Day')
+    ));
+
 .. include:: /reference/forms/types/options/years.rst.inc
 
 .. include:: /reference/forms/types/options/months.rst.inc
