Commit b9b84111 authored by Floris den Hengst's avatar Floris den Hengst Committed by Tim Graham
Browse files

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

parent 756cee46
Loading
Loading
Loading
Loading
+13 −1
Original line number Diff line number Diff line
@@ -1377,7 +1377,10 @@ that control how the relationship functions.

    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
    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.
    * ``<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
      ``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
    instance like a normal model.