summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorTim Graham <timograham@gmail.com>2016-01-26 19:06:39 -0500
committerTim Graham <timograham@gmail.com>2016-01-26 19:12:01 -0500
commit8e6a08e937272f088902cdbec65a9f2e919783bf (patch)
treea73224237b9878f7d9233bac51127ceea2fa43eb /docs
parentbdbe50a491ca41e7d4ebace47bfe8abe50a58211 (diff)
Refs #26142 -- Documented that Formset's extra=0 doesn't prevent creating objects.
Diffstat (limited to 'docs')
-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 f3ad3cc1b1..978e9df83b 100644
--- a/docs/topics/forms/modelforms.txt
+++ b/docs/topics/forms/modelforms.txt
@@ -921,6 +921,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``::