Opened 15 years ago
Closed 15 years ago
#12515 closed (duplicate)
confusing wording - formset Extra parameter
Reported by: | smalldocerror | Owned by: | nobody |
---|---|---|---|
Component: | Documentation | Version: | 1.1 |
Severity: | Keywords: | formset extra= param | |
Cc: | Triage Stage: | Unreviewed | |
Has patch: | no | Needs documentation: | no |
Needs tests: | no | Patch needs improvement: | no |
Easy pickings: | no | UI/UX: | no |
Description
On page http://docs.djangoproject.com/en/dev/topics/forms/formsets/
You say
"As you can see it only displayed one form. This is because by default the formset_factory defines one extra form. This can be controlled with the extra parameter:"
I find this confusing. I think the first instance of the word "extra" is wrong.
It should be...
"As you can see it only displayed one form. This is because by default the formset_factory defines one [delete the word "extra" here] form. This can be controlled with the extra parameter:"
That is, ONE form is created by default. Not one EXTRA form.
The text for the next example confirms my belief.
"There are now a total of three forms showing above. One for the initial data that was passed in and two extra forms."
So, by default ONE form, not one extra. And if you say extra=1 (over-riding the default of extra=0?) then you get one EXTRA form.
But what do I know?
(wow, you make it hard to report a small bug! frickin spammers...)
#12505 describes the confusion in a slightly different way.