Mark --bsmtp - unsuitable for delivery and subject to removal.

2 files changed, 13 insertions, 6 deletions

diff --git a/NEWS b/NEWS
index 44a07363..a8984127 100644
--- a/NEWS
+++ b/NEWS
@@ -44,6 +44,7 @@ removed from a 6.4.0 or newer release.)
 * The maintainer may migrate fetchmail to C++ with STL or C#, and impose further
   requirements (dependencies), such as Boost or other class libraries.
 * The softbounce option default will change to "false" in the next release.
+* The --bsmtp - mode of operation may be removed in a future release.
 
 --------------------------------------------------------------------------------
 
diff --git a/fetchmail.man b/fetchmail.man
index 245d40b5..d9d2b1ed 100644
--- a/fetchmail.man
+++ b/fetchmail.man
@@ -694,12 +694,18 @@ port 25 will (in accordance with RFC 2033) not be accepted.
 .br
 Append fetched mail to a BSMTP file.  This simply contains the SMTP
 commands that would normally be generated by fetchmail when passing
-mail to an SMTP listener daemon.  An argument of '\-' causes the mail
-to be written to standard output.  Note that fetchmail's
-reconstruction of MAIL FROM and RCPT TO lines is not guaranteed
-correct; the caveats discussed under THE USE AND ABUSE OF MULTIDROP
-MAILBOXES below apply.  This mode has precedence before \-\-mda and
-SMTP/LMTP.
+mail to an SMTP listener daemon.
+
+An argument of '\-' causes the SMTP batch to be written to standard
+output, which is of limited use: this only makes sense for debugging,
+because fetchmail's regular output is interspersed on the same channel,
+so this isn't suitable for mail delivery. This special mode may be
+removed in a later release.
+
+Note that fetchmail's reconstruction of MAIL FROM and RCPT TO lines is
+not guaranteed correct; the caveats discussed under THE USE AND ABUSE OF
+MULTIDROP MAILBOXES below apply.  This mode has precedence before
+\-\-mda and SMTP/LMTP.
 .TP
 .B \-\-bad\-header {reject|accept}
 (Keyword: bad\-header; since v6.3.15)