summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTim Graham <timograham@gmail.com>2016-01-26 19:06:39 -0500
committerTim Graham <timograham@gmail.com>2016-01-27 08:57:17 -0500
commit204d31cd6033bfcd7ede1a6eedcc5f351d2cfa11 (patch)
treea31c33f2a59446ea350eeb4ff962b04c10ed860d
parentdee5896b55385d2c66d8c1b8386604868f7fc6b4 (diff)
[1.9.x] Refs #26142 -- Documented that Formset's extra=0 doesn't prevent creating objects.
Backport of 8e6a08e937272f088902cdbec65a9f2e919783bf from master
-rw-r--r--docs/topics/forms/modelforms.txt6
1 files changed, 6 insertions, 0 deletions
diff --git a/docs/topics/forms/modelforms.txt b/docs/topics/forms/modelforms.txt
index 1106980bac..95ef3334fc 100644
--- a/docs/topics/forms/modelforms.txt
+++ b/docs/topics/forms/modelforms.txt
@@ -931,6 +931,12 @@ extra forms displayed.
>>> [x.name for x in formset.get_queryset()]
['Charles Baudelaire', 'Paul Verlaine', 'Walt Whitman']
+Also, ``extra=0`` doesn't prevent creation of new model instances as you can
+:ref:`add additional forms with JavaScript <understanding-the-managementform>`
+or just send additional POST data. Formsets `don't yet provide functionality
+<https://code.djangoproject.com/ticket/26142>`_ for an "edit only" view that
+prevents creation of new instances.
+
If the value of ``max_num`` is greater than the number of existing related
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``::