[Form] Fix #9325

snoob · snoob · commit d945ba2baf53 · 2014-04-09T16:24:58.000+02:00
diff --git a/reference/forms/types/password.rst b/reference/forms/types/password.rst
@@ -9,7 +9,8 @@ The ``password`` field renders an input password text box.
 +-------------+------------------------------------------------------------------------+
 | Rendered as | ``input`` ``password`` field                                           |
 +-------------+------------------------------------------------------------------------+
-| Options     | - `always_empty`_                                                      |
+| Options     | - `always_empty`_ (deprecated as of 2.6)                               |
+|             | - `reset_on_submit`_                                                   |
 +-------------+------------------------------------------------------------------------+
 | Inherited   | - `max_length`_ (deprecated as of 2.5)                                 |
 | options     | - `empty_data`_                                                        |
@@ -34,6 +35,14 @@ Field Options
 always_empty
 ~~~~~~~~~~~~
 
+.. caution::
+
+    The ``_always_empty`` option has been deprecated and will be removed in 3.0.
+    Instead, use the ``reset_on_submit`` option.
+
+reset_on_submit
+~~~~~~~~~~~~
+
 **type**: ``Boolean`` **default**: ``true``
 
 If set to true, the field will *always* render blank, even if the corresponding
