Fixed #13949 - Note that readonly fields can't be modified via custom clean methods. thanks alk for the suggestion and elbarto and Gabriel Hurley whose language I used in the final patch.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@15060 bcc190cf-cafb-0310-a4f2-bffc1f526a37

1 files changed, 6 insertions, 2 deletions

diff --git a/docs/topics/forms/index.txt b/docs/topics/forms/index.txt
index cfcfcf3701..ab35cc9d8b 100644
--- a/docs/topics/forms/index.txt
+++ b/docs/topics/forms/index.txt
@@ -139,7 +139,11 @@ While you could access ``request.POST`` directly at this point, it is better to
 access ``form.cleaned_data``. This data has not only been validated but will
 also be converted in to the relevant Python types for you. In the above example,
 ``cc_myself`` will be a boolean value. Likewise, fields such as ``IntegerField``
-and ``FloatField`` convert values to a Python int and float respectively.
+and ``FloatField`` convert values to a Python int and float respectively. Note
+that read-only fields are not available in ``form.cleaned_data`` (and setting
+a value in a custom ``clean()`` method won't have any effect) because these
+fields are displayed as text rather than as input elements, and thus are not
+posted back to the server.
 
 Extending the above example, here's how the form data could be processed:
 
@@ -390,5 +394,5 @@ This covers the basics, but forms can do a whole lot more:
 .. seealso::
 
     :doc:`The Forms Reference </ref/forms/index>`
-        Covers the full API reference, including form fields, form widgets, 
+        Covers the full API reference, including form fields, form widgets,
         and form and field validation.