Changeset 5267:1416714ec4d1

Timestamp:

2007-11-04 08:01:12 (14 months ago)

Author:

Rocco Rutte <pdmef@…>

Branch:

HEAD

Message:

Improve DSN docs (require sendmail-compatible MTA, add SMTP notes). Closes #2979

Files:

• doc/manual.xml.head (modified) (1 diff)
• init.h (modified) (3 diffs)

doc/manual.xml.head

@@ -4616 +4616 @@
 RFC1894 defines a set of MIME content types for relaying information
 about the status of electronic mail messages.  These can be thought of as
-``return receipts.'' Berkeley sendmail 8.8.x currently has some command
-line options in which the mail client can make requests as to what type
-of status messages should be returned.
-</para>
-
-<para>
-To support this, there are two variables. <link linkend="dsn-notify">&dollar;dsn&lowbar;notify</link> is used to request receipts for
+``return receipts.''
+</para>
+
+<para>
+To support DSN, there are two variables. <link linkend="dsn-notify">&dollar;dsn&lowbar;notify</link> is used to request receipts for
 different results (such as failed message, message delivered, etc.).
 <link linkend="dsn-return">&dollar;dsn&lowbar;return</link> requests how much
 of your message should be returned with the receipt (headers or full
-message).  Refer to the man page on sendmail for more details on DSN.
+message).
+</para>
+
+<para>
+When using <link linkend="sendmail">&dollar;sendmail</link> for mail
+delivery, you need to use either Berkeley sendmail 8.8.x (or greater) a MTA
+supporting DSN command line options compatible to Sendmail: The -N and -R
+options can be used by the mail client to make requests as to what type of
+status messages should be returned. Please consider your MTA documentation
+whether DSN is supported.
+</para>
+
+<para>
+For SMTP delivery using <link
+  linkend="smtp-url">&dollar;smtp&lowbar;url</link>, it depends on the
+capabilities announced by the server whether mutt will attempt to
+request DSN or not.
 </para>
 

init.h

@@ -498 +498 @@
   /*
   ** .pp
-  ** \fBNote:\fP you should not enable this unless you are using Sendmail
-  ** 8.8.x or greater.
-  ** .pp
   ** This variable sets the request for when notification is returned.  The
   ** string consists of a comma separated list (no spaces!) of one or more
@@ -509 +506 @@
   ** .pp
   ** Example: set dsn_notify="failure,delay"
+  ** .pp
+  ** \fBNote:\fP when using $$sendmail for delivery, you should not enable
+  ** this unless you are either using Sendmail 8.8.x or greater or a MTA
+  ** providing a sendmail(1)-compatible interface supporting the -N option
+  ** for DSN. For SMTP delivery, it depends on the server whether DSN is
+  ** supported or not.
   */
   { "dsn_return",       DT_STR,  R_NONE, UL &DsnReturn, UL "" },
   /*
-  ** .pp
-  ** \fBNote:\fP you should not enable this unless you are using Sendmail
-  ** 8.8.x or greater.
   ** .pp
   ** This variable controls how much of your message is returned in DSN
@@ -521 +521 @@
   ** .pp
   ** Example: set dsn_return=hdrs
+  ** .pp
+  ** \fBNote:\fP when using $$sendmail for delivery, you should not enable
+  ** this unless you are either using Sendmail 8.8.x or greater or a MTA
+  ** providing a sendmail(1)-compatible interface supporting the -R option
+  ** for DSN. For SMTP delivery, it depends on the server whether DSN is
+  ** supported or not.
   */
   { "duplicate_threads",        DT_BOOL, R_RESORT|R_RESORT_INIT|R_INDEX, OPTDUPTHREADS, 1 },