aboutsummaryrefslogtreecommitdiffstats
path: root/docs/api-guide/relations.md
diff options
context:
space:
mode:
authorMarkus Törnqvist2013-05-18 18:13:31 +0300
committerMarkus Törnqvist2013-05-18 18:13:31 +0300
commit48c1b2233bbfb242b68d495f51f0f177b40aa7c4 (patch)
tree86a1630fe959518b53fcd21ccacabb43cb41ff04 /docs/api-guide/relations.md
parent2795e842d60c4f1759129ab46bad6ba3e62195aa (diff)
parent3f47eb7a77fcc735782dd1bf8e8e053e26417ea1 (diff)
downloaddjango-rest-framework-48c1b2233bbfb242b68d495f51f0f177b40aa7c4.tar.bz2
Merge branch 'master' into mjtorn-master
Conflicts: rest_framework/serializers.py rest_framework/tests/serializer.py Fixed conflicts
Diffstat (limited to 'docs/api-guide/relations.md')
-rw-r--r--docs/api-guide/relations.md9
1 files changed, 9 insertions, 0 deletions
diff --git a/docs/api-guide/relations.md b/docs/api-guide/relations.md
index 155c89de..99fe1083 100644
--- a/docs/api-guide/relations.md
+++ b/docs/api-guide/relations.md
@@ -381,6 +381,15 @@ Note that reverse generic keys, expressed using the `GenericRelation` field, can
For more information see [the Django documentation on generic relations][generic-relations].
+## ManyToManyFields with a Through Model
+
+By default, relational fields that target a ``ManyToManyField`` with a
+``through`` model specified are set to read-only.
+
+If you exlicitly specify a relational field pointing to a
+``ManyToManyField`` with a through model, be sure to set ``read_only``
+to ``True``.
+
## Advanced Hyperlinked fields
If you have very specific requirements for the style of your hyperlinked relationships you can override `HyperlinkedRelatedField`.