Browse files

Clarify the m2m intermediary docs a bit.

git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
1 parent c1f5da9 commit 74927cd87eaf9bd2fe8fd8d23180f46a3c5d9fa7 @ubernostrum ubernostrum committed Aug 1, 2008
Showing with 11 additions and 3 deletions.
  1. +11 −3 docs/model-api.txt
@@ -1000,9 +1000,17 @@ There are a few restrictions on the intermediate model:
* Your intermediate model must contain one - and *only* one - foreign key
on the source model (this would be ``Group`` in our example). If you
have more than one foreign key, a validation error will be raised.
- * If the many-to-many relation is a relation on itself, the relationship
- must be non-symmetric.
+ * The only exception to this is a model which has a many-to-many
+ relationship to itself, through an intermediary model. In this
+ case, two foreign keys to the same model are permitted, but they
+ will be treated as the two (different) sides of the many-to-many
+ relation.
+ * When defining a many-to-many relationship from a model to
+ itself, using an intermediary model, you *must* use
+ ``symmetrical=False`` (see the documentation for
+ ``ManyToManyField`` above).
Now that you have set up your ``ManyToManyField`` to use your intermediary
model (Membership, in this case), you're ready to start creating some

0 comments on commit 74927cd

Please sign in to comment.