summaryrefslogtreecommitdiff
path: root/docs/ref/models
diff options
context:
space:
mode:
authorTim Graham <timograham@gmail.com>2015-07-24 07:51:40 -0400
committerTim Graham <timograham@gmail.com>2015-08-10 08:51:32 -0400
commit5980b05c1fad69eef907e0076aa2dc837edab529 (patch)
tree559858b70445d26700fcf6ef09c655d2fa050557 /docs/ref/models
parent12f91f6ebdd2470197fff4e053b50f3e54294028 (diff)
Fixed #25160 -- Moved unsaved model instance data loss check to Model.save()
This mostly reverts 5643a3b51be338196d0b292d5626ad43648448d3 and 81e1a35c364e5353d2bf99368ad30a4184fbb653. Thanks Carl Meyer for review.
Diffstat (limited to 'docs/ref/models')
-rw-r--r--docs/ref/models/fields.txt30
1 files changed, 0 insertions, 30 deletions
diff --git a/docs/ref/models/fields.txt b/docs/ref/models/fields.txt
index f68223a82c..df3df016a2 100644
--- a/docs/ref/models/fields.txt
+++ b/docs/ref/models/fields.txt
@@ -1383,30 +1383,6 @@ The possible values for :attr:`~ForeignKey.on_delete` are found in
If in doubt, leave it to its default of ``True``.
-.. attribute:: ForeignKey.allow_unsaved_instance_assignment
-
- .. versionadded:: 1.8
-
- This flag was added for backwards compatibility as older versions of
- Django always allowed assigning unsaved model instances.
-
- Django prevents unsaved model instances from being assigned to a
- ``ForeignKey`` field to prevent accidental data loss (unsaved foreign keys
- are silently ignored when saving a model instance).
-
- If you require allowing the assignment of unsaved instances and aren't
- concerned about the data loss possibility (e.g. you never save the objects
- to the database), you can disable this check by creating a subclass of the
- field class and setting its ``allow_unsaved_instance_assignment`` attribute
- to ``True``. For example::
-
- class UnsavedForeignKey(models.ForeignKey):
- # A ForeignKey which can point to an unsaved object
- allow_unsaved_instance_assignment = True
-
- class Book(models.Model):
- author = UnsavedForeignKey(Author, on_delete=models.CASCADE)
-
.. _ref-manytomany:
``ManyToManyField``
@@ -1607,12 +1583,6 @@ that control how the relationship functions.
If in doubt, leave it to its default of ``True``.
-.. attribute:: ManyToManyField.allow_unsaved_instance_assignment
-
- .. versionadded:: 1.8
-
- Works analogously to :attr:`ForeignKey.allow_unsaved_instance_assignment`.
-
:class:`ManyToManyField` does not support :attr:`~Field.validators`.
:attr:`~Field.null` has no effect since there is no way to require a