Added description of @folder format to nmh.man.

[mmh] / man / mh-mail.man

diff --git a/man/mh-mail.man b/man/mh-mail.man
index 1874d9b..c6ebffa 100644 (file)
--- a/man/mh-mail.man
+++ b/man/mh-mail.man
@@ -1,8 +1,7 @@
+.TH MH-MAIL %manext5% "July 9, 2012" "%nmhversion%"
 .\"
 .\" %nmhwarning%
-.\" $Id$
 .\"
-.TH MH-MAIL %manext5% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 mh-mail \- message format for nmh message system
 .SH SYNOPSIS
@@ -45,7 +44,11 @@ the header and body may be separated by a line consisting of dashes:
 .PP
 .RS 5
 .nf
-%components%
+From: Local Mailbox <user@example.com>
+To:
+cc:
+Fcc: +outbox
+Subject:
 .fi
 .RE
 .PP
@@ -89,15 +92,21 @@ into the mail transport system.
 .PP
 .BR From :
 .RS 5
-Added by
-.BR post ,
+This header is filled in by default with the system's idea of the user's local
+mailbox.  This can be changed with the
+.B Local\-Mailbox
+profile entry.  It
 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 ,
+.BR repl ),
 the reply address is constructed by
 checking the following headers (in this order): \*(lqMail-Reply\-To:\*(rq,
 \*(lqReply\-To:\*(rq, \*(lqFrom:\*(rq, \*(lqSender:\*(rq.
+A \*(lqFrom:\*(rq
+header MUST exist when the message is sent to
+.BR post,
+otherwise the message will be rejected.
 .RE
 .PP
 .BR Mail\-Reply\-To :
@@ -135,10 +144,11 @@ constructed by checking the following headers (in this order):
 .PP
 .BR Sender :
 .RS 5
-Added by
+Required by
 .B post
-in the event that the message already has a
-\*(lqFrom:\*(rq line.  This line contains the address of the actual
+in the event that the message has multiple addresses on the
+\*(lqFrom:\*(rq line.  It is otherwise optional.  This line should
+contain the address of the actual
 sender.
 .RE
 .PP
@@ -152,14 +162,28 @@ Contains addresses of primary recipients.
 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
 uses an encapsulation method for blind copies, see
-.BR send .
+.IR send (1).
+.RE
+.PP
+.BR Dcc :
+.RS 5
+Still more recipients.  However, the \*(lqDcc:\*(rq line is not
+copied onto the messages as delivered.  Recipients on the \*(lqDcc:\*(rq
+line receive the same messsage as recipients on the \*(lqTo:\*(rq and
+\*(lqcc:\*(rq lines.  See
+.IR send (1)
+for more details.
+.B Dcc
+is not supported with the
+.B sendmail/pipe
+mail transport method.
 .RE
 .PP
 .BR Fcc :
@@ -262,17 +286,15 @@ under the
 .B \-annotate
 option.
 .RE
-
 .SH FILES
 .fc ^ ~
 .nf
 .ta \w'%etcdir%/ExtraBigFileName  'u
 ^%mailspool%/$USER~^Location of mail drop
 .fi
-
 .SH "SEE ALSO"
-.I "Standard for the Format of ARPA Internet Text Messages
+.I
+Standard for the Format of ARPA Internet Text Messages
 (RFC\-822)
-
 .SH CONTEXT
 None