id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
23307	max_num limits total number of forms, not empty forms	velle	Aziz Alsaffar	"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. "	Cleanup/optimization	closed	Documentation	dev	Normal	fixed	afraid-to-commit	cmawebsite@…	Accepted	1	0	0	0	0	0