Fixed #11138 -- Corrected the description of behavior related to the max_num parameter for model formsets.

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

1 files changed, 5 insertions, 4 deletions

diff --git a/docs/topics/forms/modelforms.txt b/docs/topics/forms/modelforms.txt
index 0d0b4d407d..8730bc48ba 100644
--- a/docs/topics/forms/modelforms.txt
+++ b/docs/topics/forms/modelforms.txt
@@ -552,7 +552,7 @@ Limiting the number of editable objects
 
 As with regular formsets, you can use the ``max_num`` parameter to
 ``modelformset_factory`` to limit the number of forms displayed. With
-model formsets, this properly limits the query to select only the maximum
+model formsets, this property limits the query to select only the maximum
 number of objects needed::
 
     >>> Author.objects.order_by('name')
@@ -563,10 +563,11 @@ number of objects needed::
     >>> formset.initial
     [{'id': 1, 'name': u'Charles Baudelaire'}, {'id': 3, 'name': u'Paul Verlaine'}]
 
-If the value of ``max_num`` is less than the total objects returned, the
-formset will fill the rest with extra forms::
+If the value of ``max_num`` is higher than the number of objects returned, up to 
+``extra`` additional blank forms will be added to the formset, so long as the 
+total number of forms does not exceed ``max_num``::
 
-    >>> AuthorFormSet = modelformset_factory(Author, max_num=4, extra=1)
+    >>> AuthorFormSet = modelformset_factory(Author, max_num=4, extra=2)
     >>> formset = AuthorFormSet(queryset=Author.objects.order_by('name'))
     >>> for form in formset.forms:
     ...     print form.as_table()