Renamed -version switch to -Version to remove the conflict with -verbose.

[mmh] / man / mh-mail.man5

diff --git a/man/mh-mail.man5 b/man/mh-mail.man5
index 2f29640..05e825b 100644 (file)
--- a/man/mh-mail.man5
+++ b/man/mh-mail.man5
@@ -18,18 +18,16 @@ prefers,
 .B nmh
 can read message files in that antiquated format.
 .PP
-Each user possesses a mail drop box which initially receives all messages
-processed by
-.BR post .
+Each user possesses a system maildrop box which initially receives all
+messages delivered by the MTA.
 .B Inc
-will read from that drop
-box and incorporate the new messages found there into the user's own
+will read from that maildrop
+and incorporate the new messages found there into the user's own
 mail folders (typically
 .RI \*(lq +inbox \*(rq).
-The mail drop box consists of one or more messages.
 .PP
 Messages are expected to consist of lines of text.  Graphics and binary
-data are not handled.  No data compression is accepted.  All text is
+data are not directly handled.  No data compression is accepted.  All text is
 clear ASCII 7-bit data.
 .PP
 The general \*(lqmemo\*(rq framework of RFC\-822 is used.  A message
@@ -62,10 +60,10 @@ in their text portions.
 .PP
 The text for most formatted components (e.g., \*(lqDate:\*(rq and
 \*(lqMessage\-Id:\*(rq) is produced automatically.  The only ones entered
-by the user are address fields such as \*(lqTo:\*(rq, \*(lqcc:\*(rq,
+by the user are address fields such as \*(lqTo:\*(rq, \*(lqCc:\*(rq,
 etc.  Internet addresses are assigned mailbox names and host computer
 specifications.  The rough format is \*(lqlocal@domain\*(rq, such as
-\*(lqMH@UCI\*(rq, or \*(lqMH@UCI\-ICSA.ARPA\*(rq.  Multiple addresses
+\*(lqbob@example.org\*(rq.  Multiple addresses
 are separated by commas.  A missing host/domain is assumed to be the
 local host/domain.
 .PP
@@ -75,22 +73,22 @@ expected or enforced within the body.
 .PP
 Following is a list of header components that are considered
 meaningful to various
-.B nmh
+.B mmh
 programs.
 .PP
 .BR Date :
 .RS 5
 Added by
-.BR post ,
-contains date and time of the message's entry
+.BR spost .
+Contains date and time of the message's entry
 into the mail transport system.
 .RE
 .PP
 .BR From :
 .RS 5
 Added by
-.BR post ,
-contains the address of the author or authors
+.BR spost .
+Contains the address of the author or authors
 (may be more than one if a \*(lqSender:\*(rq field is present).  For a
 standard reply (using
 .BR repl ,
@@ -118,7 +116,7 @@ any addresses in this field will take precedence, and no other reply address
 will be added to the draft.  If this header is not available, then the
 return addresses will be constructed from the \*(lqMail-Reply\-To:\*(rq,
 or \*(lqReply\-To:\*(rq, or \*(lqFrom:\*(rq, along with adding the
-addresses from the headers \*(lqTo:\*(rq, \*(lqcc:\*(rq, as well as
+addresses from the headers \*(lqTo:\*(rq, \*(lqCc:\*(rq, as well as
 adding your personal address.
 .RE
 .PP
@@ -135,7 +133,7 @@ constructed by checking the following headers (in this order):
 .BR Sender :
 .RS 5
 Added by
-.B post
+.B spost
 in the event that the message already has a
 \*(lqFrom:\*(rq line.  This line contains the address of the actual
 sender.
@@ -146,36 +144,34 @@ sender.
 Contains addresses of primary recipients.
 .RE
 .PP
-.BR cc :
+.BR Cc :
 .RS 5
 Contains addresses of secondary recipients.
 .RE
 .PP
-Bcc:
+.BR Bcc :
 .RS 5
 Still more recipients.  However, the \*(lqBcc:\*(rq line is not
 copied onto the message as delivered, so these recipients are not
 listed.
-.B nmh
+.B mmh
 uses an encapsulation method for blind copies, see
-.BR send .
+.BR send (1)
+or
+.BR spost (8).
 .RE
 .PP
 .BR Fcc :
 .RS 5
 Causes
-.B post
+.B spost
 to copy the message into the specified folder for the sender,
 if the message was successfully given to the transport system.
 .RE
 .PP
 .BR Message\-ID :
 .RS 5
-A unique message identifier added by
-.B post
-if the
-.B \-msgid
-flag is set.
+A unique message identifier added by the MTA.
 .RE
 .PP
 .BR Subject :
@@ -194,13 +190,13 @@ when replying to a message.
 .BR Resent\-Date :
 .RS 5
 Added when redistributing a message by
-.BR post .
+.BR spost .
 .RE
 .PP
 .BR Resent\-From :
 .RS 5
 Added when redistributing a message by
-.BR post .
+.BR spost .
 .RE
 .PP
 .BR Resent\-To:
@@ -209,9 +205,9 @@ New recipients for a message resent by
 .BR dist .
 .RE
 .PP
-.BR Resent\-cc :
+.BR Resent\-Cc :
 .RS 5
-Still more recipients. See \*(lqcc:\*(rq and \*(lqResent\-To:\*(rq.
+Still more recipients. See \*(lqCc:\*(rq and \*(lqResent\-To:\*(rq.
 .RE
 .PP
 .BR Resent\-Bcc :
@@ -227,18 +223,25 @@ See \*(lqFcc:\*(rq and \*(lqResent\-To:\*(rq.
 .PP
 .BR Resent\-Message\-Id :
 .RS 5
-A unique identifier glued on by
-.B post
-if the
-.B \-msgid
-flag is set.
+A unique identifier glued on by the MTA.
 See \*(lqMessage\-Id:\*(rq and \*(lqResent\-To:\*(rq.
 .RE
 .PP
-.BR Resent :
+The following non-standard header components are also meaningful to
+.B mmh
+tools:
+.PP
+.BR Attach :
 .RS 5
 Annotation for
-.B dist
+.B send
+to attach the given file to the message being sent.
+.RE
+.PP
+.BR Replied :
+.RS 5
+Annotation for
+.B repl
 under the
 .B \-annotate
 option.
@@ -253,10 +256,10 @@ under the
 option.
 .RE
 .PP
-.BR Replied :
+.BR Resent :
 .RS 5
 Annotation for
-.B repl
+.B dist
 under the
 .B \-annotate
 option.