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

Thanks EvilDMP for the report.

2 files changed, 10 insertions, 3 deletions

diff --git a/docs/ref/models/relations.txt b/docs/ref/models/relations.txt
index 0c47bc4047..7f5eb18ea6 100644
--- 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
index 42fa9cc1a1..5b06cde6f6 100644
--- 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``::