Enhance documentation of HandleTrait::handle

Fan2Shrek · Fan2Shrek · commit f1dfba27409c · 2025-04-02T17:11:01.000+02:00
diff --git a/messenger.rst b/messenger.rst
@@ -2512,11 +2512,16 @@ wherever you need a query bus behavior instead of the ``MessageBusInterface``::
         }
     }
 
-You also can also specify stamps when handling a message. For example, you can
+You also can also add stamps when handling a message. For example, you can
 add an ``DoctrineFlushStamp`` to flush the entity manager after handling the message::
 
     $this->handle(new SomeMessage($data), [new DoctrineFlushStamp()]);
 
+.. note::
+
+    If adding a stamp of the same type that already exists in the envelope,
+    both stamps will be kept (see `Envelopes & Stamps`_).
+
 .. versionadded:: 7.3
 
     The ``$stamps`` parameter on the handle method was introduced in Symfony 7.3.

Original file line number	Diff line number	Diff line change
@@ -2512,11 +2512,16 @@ wherever you need a query bus behavior instead of the ``MessageBusInterface``::
`2512`	`2512`	`}`
`2513`	`2513`	`}`
`2514`	`2514`
`2515`		`-You also can also specify stamps when handling a message. For example, you can`
	`2515`	`+You also can also add stamps when handling a message. For example, you can`
`2516`	`2516`	add an ``DoctrineFlushStamp`` to flush the entity manager after handling the message::
`2517`	`2517`
`2518`	`2518`	`$this->handle(new SomeMessage($data), [new DoctrineFlushStamp()]);`
`2519`	`2519`
	`2520`	`+.. note::`
	`2521`	`+`
	`2522`	`+ If adding a stamp of the same type that already exists in the envelope,`
	`2523`	+ both stamps will be kept (see `Envelopes & Stamps`_).
	`2524`	`+`
`2520`	`2525`	`.. versionadded:: 7.3`
`2521`	`2526`
`2522`	`2527`	The ``$stamps`` parameter on the handle method was introduced in Symfony 7.3.