Migrated man page post(8) to spost(8).

[mmh] / man / spost.man8

diff --git a/man/spost.man8 b/man/spost.man8
new file mode 100644 (file)
index 0000000..00f1d7b
--- /dev/null
+++ b/man/spost.man8
@@ -0,0 +1,143 @@
+.\"
+.\" %nmhwarning%
+.\"
+.TH SPOST %manext8% "%nmhdate%" MH.6.8 [%nmhversion%]
+.SH NAME
+spost \- feed a message to sendmail
+.SH SYNOPSIS
+.HP 5
+.na
+.HP 5
+.B spost
+.RB [ \-alias
+.IR aliasfile
+.RB " | " \-noalias ]
+.RB [ \-dist ]
+.RB [ \-push " | " \-nopush ]
+.RB [ \-verbose " | " \-noverbose ]
+.RB [ \-watch " | " \-nowatch ]
+.I file
+.RB [ \-version ]
+.RB [ \-help ]
+.ad
+.SH DESCRIPTION
+.B Spost
+is the program called by
+.B send
+to feed the message in
+.I file
+to
+.B sendmail
+for delivery.  In fact, many of
+the features attributed to
+.B send
+in its manual page are performed by
+.BR spost ,
+with
+.B send
+acting as a preprocessor.
+Thus, it is
+.B spost
+which parses the various header fields, appends
+\*(lqFrom:\*(rq and \*(lqDate:\*(rq lines,
+and finally feeds the message to the MTA.
+.B Spost
+will not normally be called directly by the user.
+.PP
+.B Spost
+searches the \*(lqTo:\*(rq, \*(lqCc:\*(rq, \*(lqBcc:\*(rq,
+\*(lqFcc:\*(rq, and \*(lqResent\-xxx:\*(rq header lines of the specified
+message for destination addresses,
+.PP
+If a \*(lqBcc:\*(rq field is encountered, its addresses will be used for
+delivery, and the \*(lqBcc:\*(rq field will be removed from the message
+sent to sighted recipients.  The blind recipients will receive a newly
+constructed message with a copy of the original message attached.
+MIME rules are used for encapsulation.
+.RB ( spost
+invokes
+.B send
+to send the Bcc message.)
+.PP
+The
+.B \-alias
+.I aliasfile
+switch can be used to specify a file that spost
+should take aliases from.  More than one file can be specified, each
+being preceded with
+.BR \-alias .
+In any event, the alias file, set with the `Aliasfile' profile entry, is
+read first.
+.PP
+The
+.B \-verbose
+enables the output of informational messages.
+This option sets \-watch, too.
+.PP
+The
+.B \-watch
+switch adds the `\-v' switch to the
+.B sendmail
+invocation.
+.PP
+.B Spost
+constructs the \*(lqFrom:\*(rq line of the
+message from the user's login name and the full name from the GECOS field
+of the passwd file.
+An example is \*(lqFrom: Dan Harkless <dan>\*(rq.
+.PP
+If you set the
+.B $SIGNATURE
+environment variable.
+Its value overrides the full name from the GECOS field.
+.PP
+If you specify a \*(lqFrom:\*(rq
+line manually in the message draft.
+It will be used as provided.
+However, a \*(lqSender:\*(rq header with the user's
+.B real
+address will be added.
+.PP
+Note that this applies equally to \*(lqResent\-From:\*(rq lines
+in messages sent with
+.BR dist .
+.PP
+Your MTA is supposed to care to fully qualitfy the addresses
+with the correct domain name.
+.PP
+The draft is filed to the folders in the Fcc headers by
+.BR refile .
+
+.SH FILES
+.fc ^ ~
+.nf
+.ta \w'ExtraBigFileName  'u
+None
+.fi
+
+.SH "PROFILE COMPONENTS"
+.B spost
+does
+.B NOT
+consult the user's profile.
+
+.SH "SEE ALSO"
+mhmail(1), send(1), mh\-mail(5), mh\-alias(5), mh\-tailor(5),
+refile(1),
+.I "Standard for the Format of ARPA Internet Text Messages"
+(RFC\-822)
+
+.SH DEFAULTS
+.nf
+.RB ` \-noverbose '
+.RB ` \-nowatch '
+.RB ` \-nopush '
+.fi
+
+.SH CONTEXT
+None
+
+.SH BUGS
+Spost does not qualify addresses.
+.PP
+Spost does only basic processing and checking, yet.