Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

[1.4.X] Fixed #15932 - Documented how to supress multiple reverse rel…

…ations to the same model.

Thanks Claude Paroz for the patch.

Backport of b496be3 from master
  • Loading branch information...
commit 1d280026c3797a23075739f28bb238972afad317 1 parent c8e681f
@timgraham timgraham authored
Showing with 11 additions and 3 deletions.
  1. +11 −3 docs/ref/models/fields.txt
View
14 docs/ref/models/fields.txt
@@ -1002,9 +1002,10 @@ define the details of how the relation works.
<abstract-base-classes>`; and when you do so
:ref:`some special syntax <abstract-related-name>` is available.
- If you'd prefer Django didn't create a backwards relation, set ``related_name``
- to ``'+'``. For example, this will ensure that the ``User`` model won't get a
- backwards relation to this model::
+ If you'd prefer Django not to create a backwards relation, set
+ ``related_name`` to ``'+'`` or end it with ``'+'``. For example, this will
+ ensure that the ``User`` model won't have a backwards relation to this
+ model::
user = models.ForeignKey(User, related_name='+')
@@ -1096,6 +1097,13 @@ that control how the relationship functions.
Same as :attr:`ForeignKey.related_name`.
+ If you have more than one ``ManyToManyField`` pointing to the same model
+ and want to suppress the backwards relations, set each ``related_name``
+ to a unique value ending with ``'+'``::
+
+ users = models.ManyToManyField(User, related_name='u+')
+ referents = models.ManyToManyField(User, related_name='ref+')
+
.. attribute:: ManyToManyField.limit_choices_to
Same as :attr:`ForeignKey.limit_choices_to`.
Please sign in to comment.
Something went wrong with that request. Please try again.