Ticket #16965: 16965.diff

docs/topics/forms/formsets.txt

@@ -413 +413 @@
 
 Default: ``False``
 
-Lets you create a formset with the ability to delete::
+Lets you create a formset with the ability to select forms for deletion::
 
     >>> from django.forms.formsets import formset_factory
     >>> from myapp.forms import ArticleForm
@@ -461 +461 @@
     >>> [form.cleaned_data for form in formset.deleted_forms]
     [{'DELETE': True, 'pub_date': datetime.date(2008, 5, 10), 'title': u'Article #1'}]
 
+If you are using a :class:`ModelFormSet<django.forms.models.BaseModelFormSet>`,
+instances for deleted forms will be deleted when you call ``formset.save()``.
+On the other hand, if you are using a plain ``FormSet``, it's up to you to
+handle ``formset.deleted_forms``, perhaps in your ``FormSet``'s ``save()``
+method, as there's no general way of deleting a form.
+
 Adding additional fields to a formset
 -------------------------------------
 
@@ -559 +565 @@
     </form>
 
 
-Similarly, if the formset has the ability to order (``can_order=True``), it is possible to render it
-with ``{{ form.ORDER }}``.
+Similarly, if the formset has the ability to order (``can_order=True``), it is
+possible to render it with ``{{ form.ORDER }}``.
 
 Using more than one formset in a view
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~