0
@@ -408,6 +408,31 @@
0
 
0
     >>> formset = AuthorFormSet(queryset=Author.objects.filter(name__startswith='O'))
0
 
0
+Saving objects in the formset
0
+-----------------------------
0
+
0
+Similar to a ``ModelForm`` you can save the data into the model. This is done
0
+with the ``save()`` method on the formset::
0
+
0
+    # create a formset instance with POST data.
0
+    >>> formset = AuthorFormSet(request.POST)
0
+    
0
+    # assuming all is valid, save the data
0
+    >>> instances = formset.save()
0
+
0
+The ``save()`` method will return the instances that have been saved to the
0
+database. If an instance did not change in the bound data it will not be
0
+saved to the database and not found in ``instances`` in the above example.
0
+
0
+You can optionally pass in ``commit=False`` to ``save()`` to only return the
0
+model instances without any database interaction::
0
+
0
+    # don't save to the database
0
+    >>> unsaved_instances = formset.save(commit=False)
0
+
0
+This gives you the ability to attach data to the instances before saving them
0
+to the database.
0
+
0
 Using ``inlineformset_factory``
0
 -------------------------------
0