Import ezmlm-idx 0.40

[ezmlm] / ezmlm-return.1

diff --git a/ezmlm-return.1 b/ezmlm-return.1
index 3f84989..e3a8e89 100644 (file)
--- a/ezmlm-return.1
+++ b/ezmlm-return.1
@@ -3,12 +3,16 @@
 ezmlm-return \- handle mailing list bounces
 .SH SYNOPSIS
 .B ezmlm-return
+[
+.B \-dD
+]
 .I dir
 .SH DESCRIPTION
 .B ezmlm-return
 handles bounces for the mailing list
 stored in
-.IR dir .
+.I dir
+and, if it exists, the associated digest list.
 
 .B ezmlm-return
 is normally invoked from a
@@ -21,6 +25,30 @@ and a mail envelope from the
 and
 .BR HOST
 environment variables.
+
+.B ezmlm-return
+exits 99, not 0, upon success.
+.SH OPTIONS
+.TP
+.B \-d
+.B ezmlm-return
+will assume the bounce is for a digest list.
+Normally,
+.B ezmlm-return
+will autodetect this from the bounce address. Autodetection makes
+.B ezmlm-return
+less flexible and will be removed in future versions.
+.TP
+.B \-D
+.B ezmlm-return
+will assume that the bounce is for a normal (non-digest) list.
+Normally,
+.B ezmlm-return
+will autodetect this from the bounce address. Autodetection makes
+.B ezmlm-return
+less flexible and will be removed in future versions.
+.B \-D
+will become the default.
 .SH ADDRESSES
 .B ezmlm-return
 handles mail sent to any of the following addresses:
@@ -59,6 +87,21 @@ bounced.
 will remove
 .I box\fB@\fIdomain
 from the mailing list.
+.TP
+.I local\fB\-return\-receipt\-\fIcookie\-fImsg\-
+A receipt from the list. This is logged. For SQL supporting lists,
+.I cookie
+is verified and receipt logged only if the cookie is correct. The arrival
+of the receipt shows that qmail at the sending host is running.
+
+For all the above addresses if,
+.I local
+is followed by
+.IR \-digest ,
+bounces are assumed to be from the digest list, and are stored in
+.I dir\fB/digest/bounce
+rather than in
+.I dir \fB/bounce .
 .SH "SEE ALSO"
 ezmlm-manage(1),
 ezmlm-make(1),