Changeset 5267:1416714ec4d1 for doc/manual.xml.head

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)

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>