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 + ` 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 +` 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``::