Ticket #7968: modelforms-doc-imagefields.diff

docs/modelforms.txt

@@ -55 +55 @@
     ``FilePathField``                ``CharField``
     ``FloatField``                   ``FloatField``
     ``ForeignKey``                   ``ModelChoiceField`` (see below)
-    ``ImageField``                   ``ImageField``
+    ``ImageField``                   ``ImageField`` (see below)
     ``IntegerField``                 ``IntegerField``
     ``IPAddressField``               ``IPAddressField``
     ``ManyToManyField``              ``ModelMultipleChoiceField`` (see
@@ -112 +112 @@
       field has ``blank=False`` and an explicit ``default`` value (the
       ``default`` value will be initially selected instead).
 
+When ``ImageField`` or ``FileField`` fields are left blank by the user, they 
+will be skipped during a ``save()``. Any existing image or file will remain.
+We suggest you use a BooleanField to allow the user to remove an existing
+image or file.
+
 Finally, note that you can override the form field used for a given model
 field. See `Overriding the default field types`_ below.