minor #44567 [Mailer] Update docs for sendmail -t (fabpot)

fabpot · fabpot · commit 3269f400f95b · 2021-12-11T15:09:52.000+01:00
This PR was merged into the 4.4 branch. Discussion ---------- [Mailer] Update docs for sendmail -t | Q | A | ------------- | --- | Branch? | 4.4 | Bug fix? | no | New feature? | no  | Deprecations? | no  | Tickets | Fix #40070 Replaces #39744 Based on the comments in the referenced issue and pull request, I think the best we can do is to document the issues when using `sendmail -t`. I think we should also make it very clear in our docs (not just in the code). Commits ------- d05e10a [Mailer] Update docs for sendmail -t
diff --git a/src/Symfony/Component/Mailer/Transport/SendmailTransport.php b/src/Symfony/Component/Mailer/Transport/SendmailTransport.php
@@ -23,10 +23,6 @@
 /**
  * SendmailTransport for sending mail through a Sendmail/Postfix (etc..) binary.
  *
- * Supported modes are -bs and -t, with any additional flags desired.
- * It is advised to use -bs mode since error reporting with -t mode is not
- * possible.
- *
  * @author Fabien Potencier <fabien@symfony.com>
  * @author Chris Corbyn
  */
@@ -39,11 +35,14 @@ class SendmailTransport extends AbstractTransport
     /**
      * Constructor.
      *
-     * If using -t mode you are strongly advised to include -oi or -i in the flags.
-     * For example: /usr/sbin/sendmail -oi -t
-     * -f<sender> flag will be appended automatically if one is not present.
+     * Supported modes are -bs and -t, with any additional flags desired.
      *
      * The recommended mode is "-bs" since it is interactive and failure notifications are hence possible.
+     * Note that the -t mode does not support error reporting and does not support Bcc properly (the Bcc headers are not removed).
+     *
+     * If using -t mode, you are strongly advised to include -oi or -i in the flags (like /usr/sbin/sendmail -oi -t)
+     *
+     * -f<sender> flag will be appended automatically if one is not present.
      */
     public function __construct(string $command = null, EventDispatcherInterface $dispatcher = null, LoggerInterface $logger = null)
     {
