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

This commit is contained in:
Floris den Hengst 2015-03-07 18:45:57 +01:00 committed by Tim Graham
parent 756cee46d2
commit b9b8411129
1 changed files with 13 additions and 1 deletions

View File

@ -1377,7 +1377,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
@ -1385,6 +1388,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.