Ticket #5469: newforms_docs.diff

docs/newforms.txt

@@ -1052 +1052 @@
 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>
+
 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