Index: docs/db-api.txt =================================================================== --- docs/db-api.txt (revision 7028) +++ docs/db-api.txt (working copy) @@ -225,6 +225,19 @@ Django will complain if you try to assign or add an object of the wrong type. +When you update a ``ManyToManyField``, Django will emit a signal that +provides a notification of the changes. The raised signals are: + + * **``m2m_add_items``** gets fired after new objects are added to the + ``ManyToManyField``, and passes the list of newly added objects to + listeners + * **``m2m_remove_items``** gets fired after existing objects are removed + from the ``ManyToManyField``, and passes a list of removed objects + to listeners + * **``m2m_clear_items``** gets fired before all objects are cleared + from the ``ManyToManyField``, and passes a list of the objects to be + removed to listeners + How Django knows to UPDATE vs. INSERT -------------------------------------