minor #18296 [Mailer] Improve the warning about signing messages in a listener (MatTheCat)

This PR was merged into the 5.4 branch.

Discussion
----------

[Mailer] Improve the warning about signing messages in a listener

Fixes symfony/symfony#50254

Following the code samples to sign/encrypt messages won’t work using `TemplatedEmail`, because these are rendered on `MessageEvent`. It seems more logical to warn about this in the `Signing and Encrypting Messages` section rather than `Mailer Events`.

(Failures unrelated.)

Commits
-------

e45f6e9 Improve the warning about signing messages in a listener

Author: javiereguiluz

mailer.rst

@@ -1044,6 +1044,15 @@ Before signing/encrypting messages, make sure to have:
     When using OpenSSL to generate certificates, make sure to add the
     ``-addtrust emailProtection`` command option.
 
+.. caution::
+
+    These features require messages to be rendered,
+    which is not always immediate.
+    For example, :ref:`templated emails <mailer-twig>` content is generated
+    by a :class:`Symfony\\Component\\Mailer\\EventListener\\MessageListener`.
+    If you need to sign and/or encrypt such a message, you need to do so in
+    a :ref:`MessageEvent <messageevent>` listener with a negative priority.
+
 Signing Messages
 ~~~~~~~~~~~~~~~~
 
@@ -1432,13 +1441,6 @@ is sent::
         }
     }
 
-.. tip::
-
-    When using a ``MessageEvent`` listener to
-    :doc:`sign the email contents <signing-and-encrypting-messages>`, run it as
-    late as possible (e.g. setting a negative priority for it) so the email
-    contents are not set or modified after signing them.
-
 Development & Debugging
 -----------------------