Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Browse files

[1.0.X] Fixed #11138 -- Corrected the description of behavior related…

… to the max_num parameter for model formsets.

r10819 from trunk.

git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
1 parent efbe48c commit ad2efbdd61f890a2e17d3d1391dbd90ea91626d1 @kmtracey kmtracey committed
Showing with 5 additions and 4 deletions.
  1. +5 −4 docs/topics/forms/modelforms.txt
9 docs/topics/forms/modelforms.txt
@@ -520,7 +520,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')
@@ -531,10 +531,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 ad2efbd

Please sign in to comment.
Something went wrong with that request. Please try again.