Merge 1b02ff79a7 into afe009e6c9

docs/plugins.rst

@@ -57,6 +57,12 @@ which you map the signals to your plugin logic. Let's take a simple example::
     def register():
         signals.initialized.connect(test)
 
+.. note::
+
+    Signal receivers are weakly-referenced, thus, they must not be defined
+    within your ``register`` callable or they will be garbage-collected before
+    the signal is emitted.
+
 List of signals
 ===============