.IR deliveryfile ]
.RB [ \-verbose " | " \-noverbose ]
.RB [ \-debug ]
-.RB [ \-version ]
+.RB [ \-Version ]
.RB [ \-help ]
.ad
.SH DESCRIPTION
The message selection criteria used by
.B slocal is specified
in the file
-.RI \*(lq \&.maildelivery \*(rq
+.RI ` \&.maildelivery '
in the user's home directory.
You can specify an alternate file with the
.B \-maildelivery
Under
.BR sendmail ,
the sender will obtained from the mbox
-\*(lqFrom \*(rq line, if present. The user may override these
+`From ' line, if present. The user may override these
values with command line arguments, or arguments to the
.B \-addr
and
.B \-file
switch sets the name of the file from which the message should be
read, instead of reading stdin. This is useful when debugging a
-.RI \*(lq \&.maildelivery \*(rq
+.RI ` \&.maildelivery '
file.
.PP
The
switch produces more
verbose debugging output on stderr. These flags are useful when
creating and debugging your
-.RI \*(lq \&.maildelivery \*(rq
+.RI ` \&.maildelivery '
file, as they
allow you to see the decisions and actions that
.B slocal
is taking, as well as check for syntax errors in your
-.RI \*(lq \&.maildelivery \*(rq
+.RI ` \&.maildelivery '
file.
.SS "Message Transfer Agents"
You should include the line
.PP
.RS 5
-\*(lq|\ %bindir%/slocal\ \-user\ username\*(rq
+`|\ %bindir%/slocal\ \-user\ username'
.RE
.PP
in your \&.forward file in your home directory. This will cause
.SS "The Maildelivery File"
The
-.RI \*(lq \&.maildelivery \*(rq
+.RI ` \&.maildelivery '
file controls how
.B slocal
filters and delivers
with a backslash. Lines beginning with `#' and blank lines are ignored.
.PP
The format of each line in the
-.RI \*(lq \&.maildelivery \*(rq
+.RI ` \&.maildelivery '
file is:
.PP
.RS 5
-.B header pattern action result string
+.B "header pattern action result string
.RE
.PP
.BR header :
.BR action :
.RS 5
The action to take to deliver the message. When a message is delivered,
-a \*(lqDelivery\-Date:\ date\*(rq header is added which indicates the date
+a `Delivery\-Date:\ date' header is added which indicates the date
and time that message was delivered.
.TP 4
.I destroy
Append the message to the mbox file named by
.IR string .
This is handled by piping the message to the
-.B nmh
+.B mmh
program
.BR rcvpack .
If
the size of the message in bytes
.TP \w'zzreplyztozaaa'u
$(reply\-to)
-either the \*(lqReply\-To:\*(rq or \*(lqFrom:\*(rq field of the message
+either the `Reply\-To:' or `From:' field of the message
.TP \w'zzreplyztozaaa'u
$(info)
the out-of-band information specified
.TP 4
.IR folder " or " +
Store the message in the
-.B nmh
+.B mh
folder named by
.IR string .
This is handled by piping the message to the
-.B nmh
+.B mmh
program
.BR rcvstore .
If
.SS "Security of Delivery Files"
In order to prevent security problems, the
-.RI \*(lq \&.maildelivery \*(rq
+.RI ` \&.maildelivery '
file must be owned either by the user or by root, and must be
writable only by the owner. If this is not the case, the file is
not read.
.PP
If the
-.RI \*(lq \&.maildelivery \*(rq
+.RI ` \&.maildelivery '
file cannot be found, or does not
perform an action which delivers the message, then
.B slocal
.nf
.ta \w'default 'u +\w'mh-workersxx 'uC +\w'destroy 'uC +\w'result 'u
#
-# .maildelivery file for nmh's slocal
+# .maildelivery file for mmh's slocal
#
# Blank lines and lines beginning with a '#' are ignored
#
# FIELD PATTERN ACTION RESULT STRING
#
-# File mail with foobar in the \*(lqTo:\*(rq line into file foobar.log
+# File mail with foobar in the `To:' line into file foobar.log
To foobar file A foobar.log
# Pipe messages from coleman to the program message-archive
From coleman pipe A /bin/message-archive
-# Anything to the \*(lqnmh-workers\*(rq mailing list is put in
+# Anything to the `nmh-workers' mailing list is put in
# its own folder, if not filed already
To nmh-workers folder ? nmh-workers
.BR $USER ,
.BR $HOME ,
.B $SHELL
-are set appropriately, and no other environment variables exist.
+are set appropriately,
+.B $PATH
+is preserved, but no other environment variables exist.
.PP
The process is given a certain amount of time to execute. If the process
does not exit within this limit, the process will be terminated with
.fi
.SH CONTEXT
-None
+.B slocal
+does neither read nor change the context.
+Nor does it read the user profile.
.SH HISTORY
.B Slocal
facility provided by
.BR MMDF-II .
Thus, the
-.RI \*(lq \&.maildelivery \*(rq
+.RI ` \&.maildelivery '
file syntax is somewhat limited. But
.B slocal
has been modified and extended, so that is it no longer compatible with
value
.B RP_MECH
(200), which means
-\*(lquse an alternate route\*(rq (deliver the message to the maildrop).
+`use an alternate route' (deliver the message to the maildrop).
.PP
The `suppress duplicates' function had been removed from slocal for
simplicity reasons.