#23307: max_num limits total number of forms, not empty forms
--------------------------------------+--------------------
Reporter: velle | Owner: nobody
Type: Cleanup/optimization | Status: new
Component: Documentation | Version: 1.4
Severity: Normal | Keywords:
Triage Stage: Unreviewed | Has patch: 0
Easy pickings: 0 | UI/UX: 0
--------------------------------------+--------------------
On: https://docs.djangoproject.com/en/1.6/topics/forms/formsets/
The documentation says: "The max_num parameter to formset_factory() gives
you the ability to limit the maximum number of empty forms the formset
will display".
I believe max_num limits the total number of forms, not the empty forms,
or else the rest of the documentation on the page and the example do not
make sense.
Also, right after the example they write: "If the value of max_num is
greater than the number of existing objects, 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."
They mention "objects". But if a newcomer to Django is reading the
documentation on forms from one end to the other, he will not know what is
meant by objects, when he hasnt yet read about ModelForms. I don't know
how to deal with this. Maybe the ModelForm section could come before
FormSet, but I have not thought that through.
--
Ticket URL: <https://code.djangoproject.com/ticket/23307>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/048.66dcd4735dbfe5e800365a4975d491d5%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.
