summaryrefslogtreecommitdiff
path: root/docs/ref/models/fields.txt
diff options
context:
space:
mode:
Diffstat (limited to 'docs/ref/models/fields.txt')
-rw-r--r--docs/ref/models/fields.txt11
1 files changed, 10 insertions, 1 deletions
diff --git a/docs/ref/models/fields.txt b/docs/ref/models/fields.txt
index 2fad2d64b7..4acf47c188 100644
--- a/docs/ref/models/fields.txt
+++ b/docs/ref/models/fields.txt
@@ -1715,6 +1715,13 @@ that control how the relationship functions.
.. note::
+ If you don't want multiple associations between the same instances, add
+ a :class:`~django.db.models.UniqueConstraint` including the from and to
+ fields. Django's automatically generated many-to-many tables include
+ such a constraint.
+
+ .. note::
+
Recursive relationships using an intermediary model and defined as
symmetrical (that is, with :attr:`symmetrical=True
<ManyToManyField.symmetrical>`, which is the default) can't determine
@@ -1746,7 +1753,9 @@ that control how the relationship functions.
points (i.e. the target model instance).
This class can be used to query associated records for a given model
- instance like a normal model.
+ instance like a normal model::
+
+ Model.m2mfield.through.objects.all()
.. attribute:: ManyToManyField.through_fields