From: David Levine <levinedl@acm.org>
Date: Wed, 20 Jun 2012 01:15:18 +0000 (-0500)
Subject: Added a few clarifications and more DEFAULTS to mhmail(1) man page.
X-Git-Url: http://git.marmaro.de/?a=commitdiff_plain;h=d4850ff231bec8513dcd106bdb93bc61d179d8f6;p=mmh

Added a few clarifications and more DEFAULTS to mhmail(1) man page.
---

diff --git a/docs/pending-release-notes b/docs/pending-release-notes
index f153a77..33730ba 100644
--- a/docs/pending-release-notes
+++ b/docs/pending-release-notes
@@ -4,12 +4,13 @@ Things to add to the release notes for the next full release:
 NEW FEATURES
 ------------
 
-- All nmh programs will now warn about multiple profile entries for the
-  same component.  In previous versions, all but the first were
-  silently ignored.
+- All nmh programs will now warn about multiple profile entries for
+  the same non-null, non-comment component.  In previous versions, all
+  but the first were silently ignored.
 - mhmail now supports all post(8) options, and optionally can use
   send(1) with all of its options.  Its formerly undocumented -resent
-  switch has been documented.  And it has new -send/-nosend switches.
+  switch has been documented.  And it has new -attach, -header-field,
+  and -send/-nosend switches.
 
 ----------------------------
 OBSOLETE/DEPRECATED FEATURES
diff --git a/man/mhmail.man b/man/mhmail.man
index 3b382af..4f1635a 100644
--- a/man/mhmail.man
+++ b/man/mhmail.man
@@ -105,7 +105,8 @@ will not send the message and return with status 1.  You can use the switch
 \*(lq\*(rq to force an empty message.
 .PP
 Normally, addresses appearing as arguments are put in the \*(lqTo:\*(rq
-field.  If the
+field.  At least one such address is required when sending a message,
+i.e., if any other switches are supplied. If the
 .B \-cc
 switch is used, all addresses following it, even if there are
 intervening switches, are placed in the \*(lqcc:\*(rq field.
@@ -118,7 +119,11 @@ the draft.  If no
 .B \-from
 switch is used when sending,
 .B mhmail
-will supply a \*(lqFrom:\*(rq header field using the sender's local mailbox.
+will supply a \*(lqFrom:\*(rq header field using the sender's local mailbox,
+see
+.I localmbox
+in
+.BR mh-format (5).
 Naturally,
 .B post
 will fill\-in the \*(lqSender:\*(rq
@@ -209,15 +214,14 @@ is used.
 .fi
 
 .SH "SEE ALSO"
-dist(1), inc(1), post(8), send(1)
+dist(1), inc(1), mh-format(5), post(8), send(1)
 
 .SH DEFAULTS
 .nf
+.RB ` \-from "' defaults to sender's local mailbox (localmbox)"
+.RB ` \-profile "' is enabled by default only with " \-attach
 .RB ` \-send '
 .fi
-.RB ` \-profile' ,
-enabled by default only with
-.B \-attach
 
 .SH CONTEXT
 If