p31829507
/
django
mirror of https://github.com/django/django.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

[1.8.x] Fixed #24432 -- Added docs for ManyToManyFields that reside in and refer to the same model. 

Backport of b9b8411129 from master
This commit is contained in:
Floris den Hengst 2015-03-07 18:45:57 +01:00 committed by Tim Graham
parent ffa4ff5e8c
commit 9853844ed3
1 changed files with 13 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
docs/ref/models/fields.txt
View File

@ -1422,7 +1422,10 @@ that control how the relationship functions.
If you don't specify an explicit ``through`` model, there is still an If you don't specify an explicit ``through`` model, there is still an
implicit ``through`` model class you can use to directly access the table implicit ``through`` model class you can use to directly access the table
created to hold the association. It has three fields: created to hold the association. It has three fields to link the models.
If the source and target models differ, the following fields are
generated:
* ``id``: the primary key of the relation. * ``id``: the primary key of the relation.
* ``<containing_model>_id``: the ``id`` of the model that declares the * ``<containing_model>_id``: the ``id`` of the model that declares the
@ -1430,6 +1433,15 @@ that control how the relationship functions.
* ``<other_model>_id``: the ``id`` of the model that the * ``<other_model>_id``: the ``id`` of the model that the
``ManyToManyField`` points to. ``ManyToManyField`` points to.
If the ``ManyToManyField`` points from and to the same model, the following
fields are generated:
* ``id``: the primary key of the relation.
* ``from_<model>_id``: the ``id`` of the instance which points at the
model (i.e. the source instance).
* ``to_<model>_id``: the ``id`` of the instance to which the relationship
points (i.e. the target model instance).
This class can be used to query associated records for a given model This class can be used to query associated records for a given model
instance like a normal model. instance like a normal model.