Ticket #10284: modelformset_doc.diff

docs/topics/forms/modelforms.txt

@@ -654 +654 @@
 need to call ``formset.save_m2m()`` to ensure the many-to-many relationships
 are saved properly.
 
+If you pass ``can_delete=True`` to the ``modelformset_factory``, and you save
+with ``commit=False``, you need to call delete on each of the
+``formset.deleted_objects`` to actually delete them::
+
+    # really delete instances
+    >>> instances = formset.save(commit=False)
+    >>> for obj in formset.deleted_objects:
+    ...     obj.delete()
+
 .. _model-formsets-max-num:
 
 Limiting the number of editable objects