[1.4.X] Fixed #13586 - Added an example of how to connect a m2m_changed signal handler.

Backport of 1360bd4186 from master

1 files changed, 11 insertions, 2 deletions

diff --git a/docs/ref/signals.txt b/docs/ref/signals.txt
index 3917b52b96..486e53b679 100644
--- a/docs/ref/signals.txt
+++ b/docs/ref/signals.txt
@@ -277,13 +277,22 @@ like this::
         # ...
         toppings = models.ManyToManyField(Topping)
 
-If we would do something like this:
+If we connected a handler like this::
+
+    def toppings_changed(sender, **kwargs):
+        # Do something
+        pass
+
+    m2m_changed.connect(toppings_changed, sender=Pizza.toppings.through)
+
+and then did something like this::
 
     >>> p = Pizza.object.create(...)
     >>> t = Topping.objects.create(...)
     >>> p.toppings.add(t)
 
-the arguments sent to a :data:`m2m_changed` handler would be:
+the arguments sent to a :data:`m2m_changed` handler (``topppings_changed`` in
+the example above) would be:
 
 ==============  ============================================================
 Argument        Value