From ae95edf91df4eb47c25f262a77749538b37d357e Mon Sep 17 00:00:00 2001 From: Karen Tracey Date: Mon, 18 May 2009 16:00:29 +0000 Subject: [PATCH] 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 --- docs/topics/forms/modelforms.txt | 9 +++++---- 1 file 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()