From 6b52e1793c682d4f9c8f030dcbe6908ddddf875e Mon Sep 17 00:00:00 2001
From: "Jorge C. Leitão" <jorgecarleitao@gmail.com>
Date: Mon, 16 Jun 2014 21:30:26 +0200
Subject: [1.6.x] Fixed #14481 -- Documented implicit "through" class created
 by ManyToManyField.

Thanks to jonathanmorgan for the report and initial patch.

Backport of de90129070 from master
---
 docs/ref/models/fields.txt | 13 +++++++++++++
 1 file changed, 13 insertions(+)

(limited to 'docs')

diff --git a/docs/ref/models/fields.txt b/docs/ref/models/fields.txt
index d70f6c7e8f..bda884697c 100644
--- a/docs/ref/models/fields.txt
+++ b/docs/ref/models/fields.txt
@@ -1280,6 +1280,19 @@ that control how the relationship functions.
     :ref:`extra data with a many-to-many relationship
     <intermediary-manytomany>`.
 
+    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:
+
+    * ``id``: the primary key of the relation.
+    * ``<containing_model>_id``: the ``id`` of the model that declares the
+      ``ManyToManyField``.
+    * ``<other_model>_id``: the ``id`` of the model that the
+      ``ManyToManyField`` points to.
+
+    This class can be used to query associated records for a given model
+    instance like a normal model.
+
 .. attribute:: ManyToManyField.db_table
 
     The name of the table to create for storing the many-to-many data. If this
-- 
cgit v1.3