Commit ae95edf9 authored by Karen Tracey's avatar Karen Tracey
Browse files

Fixed #11138 -- Corrected the description of behavior related to the max_num...

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
parent 5a5842cc
Loading
Loading
Loading
Loading
+5 −4
Original line number Diff line number Diff line
@@ -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()