Author: russellm
Date: 2008-09-22 06:07:35 -0500 (Mon, 22 Sep 2008)
New Revision: 9083
Modified:
django/trunk/docs/ref/models/fields.txt
django/trunk/docs/topics/db/models.txt
Log:
Fixed #8967: Added documentation for the 'through' option on a many-to-many
field in the fields reference documentation.
Modified: django/trunk/docs/ref/models/fields.txt
===================================================================
--- django/trunk/docs/ref/models/fields.txt 2008-09-22 06:03:24 UTC (rev
9082)
+++ django/trunk/docs/ref/models/fields.txt 2008-09-22 11:07:35 UTC (rev
9083)
@@ -887,6 +887,17 @@
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
Modified: django/trunk/docs/topics/db/models.txt
===================================================================
--- django/trunk/docs/topics/db/models.txt 2008-09-22 06:03:24 UTC (rev
9082)
+++ django/trunk/docs/topics/db/models.txt 2008-09-22 11:07:35 UTC (rev
9083)
@@ -357,6 +357,8 @@
<manytomany-arguments>`. These options help define how the relationship should
work; all are optional.
+.. _intermediary-manytomany:
+
Extra fields on many-to-many relationships
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at
http://groups.google.com/group/django-updates?hl=en
-~----------~----~----~----~------~----~------~--~---
