diff --git a/docs/ref/models/fields.txt b/docs/ref/models/fields.txt index 87029876303..192b8f8f4e7 100644 --- a/docs/ref/models/fields.txt +++ b/docs/ref/models/fields.txt @@ -1422,7 +1422,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. * ``_id``: the ``id`` of the model that declares the @@ -1430,6 +1433,15 @@ that control how the relationship functions. * ``_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__id``: the ``id`` of the instance which points at the + model (i.e. the source instance). + * ``to__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.