Reformate view event mailer and add more detail for SentMessageEvent event

Author: mdoutreluingne

mailer.rst

@@ -1410,91 +1410,89 @@ Mailer Events
 MessageEvent
 ~~~~~~~~~~~~
 
+**Event Class**: :class:`Symfony\\Component\\Mailer\\Event\\MessageEvent`
+
 ``MessageEvent`` allows to change the Message and the Envelope before the email
 is sent::
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\Mailer\Event\MessageEvent;
     use Symfony\Component\Mime\Email;
 
-    class MailerSubscriber implements EventSubscriberInterface
+    public function onMessage(MessageEvent $event): void
     {
-        public static function getSubscribedEvents(): array
-        {
-            return [
-                MessageEvent::class => 'onMessage',
-            ];
+        $message = $event->getMessage();
+        if (!$message instanceof Email) {
+            return;
         }
+        // do something with the message
+    }
 
-        public function onMessage(MessageEvent $event): void
-        {
-            $message = $event->getMessage();
-            if (!$message instanceof Email) {
-                return;
-            }
+Execute this command to find out which listeners are registered for this event and
+their priorities:
 
-            // do something with the message
-        }
-    }
+.. code-block:: terminal
+
+    $ php bin/console debug:event-dispatcher "Symfony\Component\Mailer\Event\MessageEvent"
 
 SentMessageEvent
 ~~~~~~~~~~~~
 
-``SentMessageEvent`` it allows acting on the :class:`Symfony\\Component\\Mailer\\SentMessage`::
+**Event Class**: :class:`Symfony\\Component\\Mailer\\Event\\SentMessageEvent`
+
+``SentMessageEvent`` it allows you to act on the :class:`Symfony\\Component\\\Mailer\\\SentMessage` to access the original 
+message (getOriginalMessage()) and some debugging information (getDebug()) such as 
+the HTTP calls made by the HTTP transports, which is useful for debugging errors::
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\Mailer\Event\SentMessageEvent;
     use Symfony\Component\Mailer\SentMessage;
 
-    class MailerSubscriber implements EventSubscriberInterface
+    public function onMessage(SentMessageEvent $event): void
     {
-        public static function getSubscribedEvents(): array
-        {
-            return [
-                SentMessageEvent::class => 'onMessage',
-            ];
+        $message = $event->getMessage();
+        if (!$message instanceof SentMessage) {
+            return;
         }
 
-        public function onMessage(SentMessageEvent $event): void
-        {
-            $message = $event->getMessage();
-            if (!$message instanceof SentMessage) {
-                return;
-            }
-
-            // do something with the message
-        }
+        // do something with the message
     }
 
+Execute this command to find out which listeners are registered for this event and
+their priorities:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:event-dispatcher "Symfony\Component\Mailer\Event\SentMessageEvent"
+
 FailedMessageEvent
 ~~~~~~~~~~~~
 
+**Event Class**: :class:`Symfony\\Component\\Mailer\\Event\\FailedMessageEvent`
+
 ``FailedMessageEvent`` it allows acting on the the initial message in case of a failure::
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\Mailer\Event\FailedMessageEvent;
 
-    class MailerSubscriber implements EventSubscriberInterface
+    public function onMessage(FailedMessageEvent $event): void
     {
-        public static function getSubscribedEvents(): array
-        {
-            return [
-                FailedMessageEvent::class => 'onMessage',
-            ];
-        }
+        // e.g you can get more information on this error when sending an email.
+        $event->getError();
+        
+        // do something with the message
+    }
 
-        public function onMessage(FailedMessageEvent $event): void
-        {
-            // e.g you can get more information on this error when sending an email.
-            $event->getError();
+Execute this command to find out which listeners are registered for this event and
+their priorities:
 
-            // do something with the message
-        }
-    }
+.. code-block:: terminal
+
+    $ php bin/console debug:event-dispatcher "Symfony\Component\Mailer\Event\FailedMessageEvent"
 
 .. versionadded:: 6.2
 
-    ``SentMessageEvent`` and ``FailedMessageEvent`` was introduced in Symfony 6.2.
+    ``SentMessageEvent`` and ``FailedMessageEvent`` were introduced in Symfony 6.2.
 
 Development & Debugging
 -----------------------