Fixed #21343 -- Noted many-to-many restrictions with intermediate model.

timgraham · timgraham · commit a6e3fb80b0e0 · 2014-01-16T08:38:40.000-05:00
Thanks EvilDMP for the report.
diff --git a/docs/ref/models/relations.txt b/docs/ref/models/relations.txt
@@ -138,10 +138,14 @@ Related objects reference
     .. note::
 
        Note that ``add()``, ``create()``, ``remove()``, and ``clear()`` all
-       apply database changes immediately for all types of related fields. In other
-       words, there is no need to call ``save()`` on either end of the
+       apply database changes immediately for all types of related fields. In
+       other words, there is no need to call ``save()`` on either end of the
        relationship.
 
+       Also, if you are using :ref:`an intermediate model
+       <intermediary-manytomany>` for a many-to-many relationship, some of the
+       related manager's methods are disabled.
+
 .. _direct-assignment:
 
 Direct Assignment
diff --git a/docs/topics/db/examples/many_to_many.txt b/docs/topics/db/examples/many_to_many.txt
@@ -35,7 +35,10 @@ objects, and a ``Publication`` has multiple ``Article`` objects:
             ordering = ('headline',)
 
 What follows are examples of operations that can be performed using the Python
-API facilities.
+API facilities. Note that if you are using :ref:`an intermediate model
+<intermediary-manytomany>` for a many-to-many relationship, some of the related
+manager's methods are disabled, so some of these examples won't work with such
+models.
 
 Create a couple of ``Publications``::
 
