Permalink
Browse files

Fixed #8967: Added documentation for the 'through' option on a many-t…

…o-many field in the fields reference documentation.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@9083 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
1 parent 5563362 commit 54f962c0bf3cf4802ee2c94194bcdb4bd4728106 @freakboy3742 freakboy3742 committed Sep 22, 2008
Showing with 13 additions and 0 deletions.
  1. +11 −0 docs/ref/models/fields.txt
  2. +2 −0 docs/topics/db/models.txt
View
@@ -887,6 +887,17 @@ that control how the relationship functions.
add the descriptor for the reverse relationship, allowing
:class:`ManyToManyField` relationships to be non-symmetrical.
+.. attribute:: ManyToManyFields.through
+
+ Django will automatically generate a table to manage many-to-many
+ relationships. However, if you want to manually specify the intermediary
+ table, you can use the :attr:`~ManyToManyField.through` option to specify
+ the Django model that represents the intermediate table that you want to
+ use.
+
+ The most common use for this option is when you want to associate
+ :ref:`extra data with a many-to-many relationship <intermediary-manytomany>`.
+
.. attribute:: ManyToManyField.db_table
The name of the table to create for storing the many-to-many data. If this
@@ -357,6 +357,8 @@ arguments which are explained in :ref:`the model field reference
<manytomany-arguments>`. These options help define how the relationship should
work; all are optional.
+.. _intermediary-manytomany:
+
Extra fields on many-to-many relationships
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

0 comments on commit 54f962c

Please sign in to comment.