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
 -------------------------------------
 
