Factor trim format function out

[mmh] / man / spost.man8

diff --git a/man/spost.man8 b/man/spost.man8
index 98c08fa..1e96286 100644 (file)
--- a/man/spost.man8
+++ b/man/spost.man8
@@ -39,10 +39,22 @@ and finally feeds the message to the MTA.
 will not normally be called directly by the user.
 .PP
 .B Spost
-searches the `To:', `Cc:', `Bcc:',
+searches the `To:', `Cc:', `Bcc:', `Dcc:',
 `Fcc:', and `Resent\-xxx:' header lines of the specified
 message for destination addresses,
 .PP
+.B Spost
+invokes
+.B sendmail
+with all recipients, except the blind ones (`Bcc:'),
+as command line arguments:
+.RS
+.B sendmail
+.B \-i
+.RB [ \-v ]
+.I recipients ...
+.RE
+.PP
 If a `Bcc:' field is encountered, its addresses will be used for
 delivery, and the `Bcc:' field will be removed from the message
 sent to sighted recipients.  The blind recipients will receive a newly
@@ -53,10 +65,30 @@ invokes
 .B send
 to send the Bcc message.)
 .PP
+If a `Dcc:' field is encountered, the field will be removed
+before sending the message. The Dcc recipient will receive the
+message as well, but without being mentioned in the recipient
+headers.
+.PP
+In contrast to Bcc, the Dcc recipient receives the
+same original message as all the sighted reciepients, whereas
+the Bcc recipient receives a special, newly constructed message,
+which contains the original message as an attachment.
+.PP
+Bcc is probably a good choice for a message with both sighted
+and invisible reciepients (e.g. inform someone privately about
+the message being sent). Dcc is probably a good choice for
+a message to a group of only invisible recipients (e.g. invite
+to a party).
+.PP
 The `Aliasfile' profile entry
 can be used to specify one or more files that spost
 should take aliases from.
 .PP
+Aliasing is done on any address field. Those are:
+`From:', `To:', `Cc:', `Bcc:' and `Dcc:',
+or the `Resent\-xxx:' versions of these fields.
+.PP
 The
 .B \-verbose
 switch enables informational messages.
@@ -64,10 +96,17 @@ For example, the `\-v' switch will be added to the
 .B sendmail
 invocation.
 .PP
-.B Spost
-constructs the `From:' line of the
-message from the user's login name and the full name from the GECOS field
-of the passwd file.
+If you specify a `From:' line manually in the message draft,
+it will be used as provided.
+If there is no `From:' line in the draft,
+.B spost
+uses the
+.RI ` Default-From '
+profile entry, if set.
+Otherwise
+.B spost
+constructs the `From:' line from the user's login name
+and the full name from the GECOS field of the passwd file.
 An example is `From: Dan Harkless <dan>'.
 .PP
 If you set the
@@ -75,19 +114,24 @@ If you set the
 environment variable.
 Its value overrides the full name from the GECOS field.
 .PP
-If you specify a `From:'
-line manually in the message draft.
-It will be used as provided.
-However, a `Sender:' header with the user's
-.B real
-address will be added.
+A `Sender:' header will be added in two cases.
+First, if the `From:' line given in the draft contains one or
+more addresses, of which none is the user's own one, as defined by
+.RI ` Alternate-Mailboxes '.
+(The sender address will then be determined equally as described
+above for the absent `From:' header.)
+Second, if the `From:' line contains multiple addresses, of
+which at least one is the user's own address. The first own
+address will be used as the sender address.
 .PP
 Note that this applies equally to `Resent\-From:' lines
 in messages sent with
 .BR dist .
 .PP
-Your MTA is supposed to care to fully qualitfy the addresses
-with the correct domain name.
+.B Spost
+tries to fully qualify the addresses in every address field.
+Your MTA is supposed to add the correct domain,
+if there is none after aliasing.
 .PP
 The draft is filed to the folders in the Fcc headers by
 .BR refile .
@@ -100,10 +144,15 @@ None
 .fi
 
 .SH "PROFILE COMPONENTS"
-.B spost
-does
-.B NOT
-consult the user's profile.
+.fc ^ ~
+.nf
+.ta 3.5i
+.ta \w'ExtraBigProfileName  'u
+^Aliasfile:~^For default alias files
+^Default\-From:~^The default From header
+^Alternate\-Mailboxes:~^The user's addresses
+^Sendmail:~^The path name to the sendmail program.
+.fi
 
 .SH "SEE ALSO"
 send(1), mh\-mail(5), mh\-alias(5), mh\-tailor(5), refile(1),
@@ -119,6 +168,16 @@ send(1), mh\-mail(5), mh\-alias(5), mh\-tailor(5), refile(1),
 None
 
 .SH BUGS
-Spost does not qualify addresses.
-.PP
-Spost does only basic processing and checking, yet.
+None
+
+.SH HISTORY
+The
+.B spost
+in mmh-0.1 used
+.BR sendmail 's
+.I -t
+flag to have
+.B sendmail
+extract the recipients from the message headers. Now, it
+passes the recipients as command line arguments. This provides
+better compatibility to other sendmail implementations.