diff options
| author | Karen Tracey <kmtracey@gmail.com> | 2009-05-18 16:02:43 +0000 |
|---|---|---|
| committer | Karen Tracey <kmtracey@gmail.com> | 2009-05-18 16:02:43 +0000 |
| commit | ad2efbdd61f890a2e17d3d1391dbd90ea91626d1 (patch) | |
| tree | 71c8c3f95be0aeeef8f0a8c23d738ee95941bdeb /docs | |
| parent | efbe48cfcb98c7e0c15d47f40ad48058f3121198 (diff) | |
[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: http://code.djangoproject.com/svn/django/branches/releases/1.0.X@10820 bcc190cf-cafb-0310-a4f2-bffc1f526a37
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/topics/forms/modelforms.txt | 9 |
1 files changed, 5 insertions, 4 deletions
diff --git a/docs/topics/forms/modelforms.txt b/docs/topics/forms/modelforms.txt index 7cd95a2bc8..7e86f16611 100644 --- a/docs/topics/forms/modelforms.txt +++ b/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() |