Ticket #5469: docs_newforms_txt.diff

docs/newforms.txt

@@ -981 +981 @@
     >>> f.errors
     {'url': [u'This field is required.'], 'name': [u'This field is required.']}
 
+
 ``widget``
 ~~~~~~~~~~
 
@@ -1052 +1053 @@
 displayed for unbound forms, and they're not used as fallback values if a
 particular value isn't provided.
 
+Note that ``initial`` values are *not* cleaned. It is supposed that values are right, unlike ``data`` values::
+
+    >>> class NewsForm(forms.Form):
+    ...     date = forms.DateField()
+    ...     title = forms.CharField()
+    >>> f = NewsForm(initial={'date': 'not_a_date'})
+    >>> f.as_table()
+    <tr><th><label for="id_date">Date:</label></th><td><input type="text" name="date" value="not_a_date" id="id_date" /></td></tr>
+    <tr><th><label for="id_title">Title:</label></th><td><input type="text" name="title" id="id_title" /></td></tr>
+
+This also means that for a ``MultiValueField``, you need to pass in the data as one value, not as the individual subfields.
+
 Finally, note that if a ``Field`` defines ``initial`` *and* you include
 ``initial`` when instantiating the ``Form``, then the latter ``initial`` will
 have precedence. In this example, ``initial`` is provided both at the field