added some comments

fabpot · fabpot · commit 0c4a417084d3 · 2019-03-30T08:58:08.000+01:00
diff --git a/src/Symfony/Component/Mailer/MailerInterface.php b/src/Symfony/Component/Mailer/MailerInterface.php
@@ -15,6 +15,10 @@
 use Symfony\Component\Mime\RawMessage;
 
 /**
+ * Interface for mailers able to send emails synchronous and/or asynchronous.
+ *
+ * Implementations must support synchronous and asynchronous sending.
+ *
  * @author Fabien Potencier <fabien@symfony.com>
  *
  * @experimental in 4.3
diff --git a/src/Symfony/Component/Mailer/Transport/TransportInterface.php b/src/Symfony/Component/Mailer/Transport/TransportInterface.php
@@ -17,6 +17,11 @@
 use Symfony\Component\Mime\RawMessage;
 
 /**
+ * Interface for all mailer transports.
+ *
+ * When sending emails, you should prefer MailerInterface implementations
+ * as they allow asynchronous sending.
+ *
  * @author Fabien Potencier <fabien@symfony.com>
  *
  * @experimental in 4.3
