Browse files

Fixed #11138 -- Corrected the description of behavior related to the …

…max_num parameter for model formsets.

git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
kmtracey committed May 18, 2009
1 parent 5a5842c commit ae95edf91df4eb47c25f262a77749538b37d357e
Showing with 5 additions and 4 deletions.
  1. +5 −4 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()

0 comments on commit ae95edf

Please sign in to comment.