Merge branch '3.4' into 4.3

javiereguiluz · javiereguiluz · commit 9f57f196154f · 2019-12-11T16:41:40.000+01:00
* 3.4:
  Tweak the explanation about event priorities
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
@@ -145,10 +145,12 @@ that defines one or more methods that listen to one or various events. The main
 difference with the event listeners is that subscribers always know which events
 they are listening to.
 
-In a given subscriber, different methods can listen to the same event. The order
-in which methods are executed is defined by the ``priority`` parameter of each
-method (the higher the number the earlier the method is called). To learn more
-about event subscribers, read :doc:`/components/event_dispatcher`.
+If different event subscriber methods listen to the same event, their order is
+defined by the ``priority`` parameter. This value is a positive or negative
+integer which defaults to ``0``. The higher the number, the earlier the method
+is called. **Priority is aggregated for all listeners and subscribers**, so your
+methods could be executed before or after the methods defined in other listeners
+and subscribers. To learn more about event subscribers, read :doc:`/components/event_dispatcher`.
 
 The following example shows an event subscriber that defines several methods which
 listen to the same ``kernel.exception`` event::
