[1.2.X] Fixed #5537 -- document trailing '+' on related_name for supressing backward relation.

Thanks to dcramer for the report, and Russ for pointing out the workaround.

Backport of r14049 from trunk.


git-svn-id: http://code.djangoproject.com/svn/django/branches/releases/1.2.X@14050 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Simon Meers 2010-10-09 02:57:11 +00:00
parent 5ff085d65e
commit 52e7812901
1 changed files with 9 additions and 0 deletions

View File

@ -925,6 +925,15 @@ 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 wish to supress the provision of a backwards relation, you may
simply provide a ``related_name`` which ends with a '+' character.
For example::
user = models.ForeignKey(User, related_name='+')
will ensure that no backwards relation to this model is provided on the
``User`` model.
.. attribute:: ForeignKey.to_field
The field on the related object that the relation is to. By default, Django