[Nmh-workers] Changes to mh-draft.man

[Larry Hynes]

I think I'm following convention with this change:

        -Draft\-Folder: +drafts
        +Draft\-Folder: drafts

Or, to put it another way, I have 'Draft-Folder: drafts' in my
.mh_profile, and mh-profile(5) says 'Draft-Folder: drafts'.

I'm guessing that this:

        -finds a new draft
        +creates a new draft

adequately covers the original intent, or does 'finds' have special
meaning here?

diff --git a/man/mh-draft.man b/man/mh-draft.man
index 3ef246d9..4044e97c 100644
--- a/man/mh-draft.man
+++ b/man/mh-draft.man
@@ -1,4 +1,4 @@
-.TH MH-DRAFT %manext5% "November 6, 2012" "%nmhversion%"
+.TH MH-DRAFT %manext5% "March 21, 2017" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
@@ -7,37 +7,29 @@ mh-draft \- draft folder facility for nmh message system
 .SH DESCRIPTION
 There are a number of interesting advanced facilities for the composition of
 outgoing mail.
-.PP
 .SS "The Draft Folder"
 The
 .BR comp ,
 .BR dist ,
 .BR forw ,
 .BR repl ,
+.BR send ,
 and
 .B whom
-commands have two additional switches,
+commands each take the switches
 .B \-draftfolder
 .I +folder
 and
 .B \-draftmessage
-.I msg
+.IR msg ,
 which allow you to manipulate the various draft messages you are composing.
 .PP
 If
 .B \-draftfolder
 .I +folder
-is used, these commands are
-directed to construct a draft message in the indicated folder.
-(The
+is used, draft messages will be constructed in the indicated folder.  The
 .RI \*(lq Draft\-Folder \*(rq
-profile entry may be used to declare a default draft folder for use with
-.BR comp ,
-.BR dist ,
-.BR forw ,
-.BR repl ,
-and
-.B whom ).
+profile entry may be used to specify a default draft folder.
 .PP
 If the switch
 .B \-draftmessage
@@ -45,8 +37,8 @@ If the switch
 is given, the specified draft is used to compose the message.  If
 .B \-draftmessage
 .I msg
-is not used, then the
-draft defaults to `new' (create a new draft) unless the user invokes
+is not used, then the draft defaults to `new' (create a new draft)
+unless the user invokes
 .B comp
 with
 .BR \-use ,
@@ -62,26 +54,24 @@ tools are available on each of the user's message drafts 
(e.g.
 and so on).  If the folder does not exist, the user is asked if it should be
 created (just like with
 .BR refile ).
-Also, the last draft message
-the user was composing is known as `cur' in the draft folder.
+The last draft message the user was composing is known as `cur'
+in the draft folder.
 .PP
-Furthermore, the
-.B send
-command has these switches as well.  Hence,
-from the shell, the user can send off whatever drafts desired using the
-standard
+Using
+.BR send ,
+the user can send drafts using the standard
 .B nmh
 `msgs' convention with
 .B \-draftmessage
 .IR msgs .
 If no `msgs' are given, it defaults to `cur'.
 .PP
-In addition, all five programs have a
+In addition, all of these programs have a
 .B \-nodraftfolder
 switch, which undoes the last occurrence of
 .B \-draftfolder
 .I folder
-(useful if the latter occurs in the user's
+(useful if a default is specified in the user's
 .B nmh
 profile).
 .PP
@@ -102,10 +92,10 @@ or
 .BR send ,
 the user needn't prefix the draft `msg' or `msgs' with
 .BR \-draftmessage .
-Both of these
-commands accept a `file' or `files' argument, and they will, if given
+Both of these commands accept a `file' or `files' argument and they will,
+if given
 .B \-draftfolder
-.I +folder
+.IR +folder ,
 treat these arguments as `msg' or `msgs'.  (This may appear to be
 inconsistent, at first, but it saves a lot of typing.)  Hence,
 .PP
@@ -130,7 +120,7 @@ profile:
 .PP
 .RS 5
 .nf
-Draft\-Folder: +drafts
+Draft\-Folder: drafts
 sendf: \-draftfolder +drafts
 .fi
 .RE
@@ -141,7 +131,7 @@ is a (symbolic) link in the user's
 .I $HOME/bin/
 directory to
 .BR send .
-Then, any of the commands
+Now,
 .PP
 .RS 5
 .nf
@@ -152,11 +142,11 @@ repl
 .fi
 .RE
 .PP
-constructs the message draft in the `draft' folder using the `new'
+will construct the message draft in the `draft' folder using the `new'
 message number.  Furthermore, they each define `cur' in this folder to
 be that message draft.  If the user were to use the
 .B quit
-option at `What now?' level, then later on, if no other draft composition
+option at the `What now?' prompt, then later on, if no other draft composition
 was done, the draft could be sent with simply
 .PP
 .RS 5
@@ -173,13 +163,12 @@ comp -use
 .fi
 .RE
 .PP
-Instead, if other drafts had been composed in the meantime, so that this
-message draft was no longer known as `cur' in the `draft' folder, then
+If other drafts had been composed in the meantime, so that this message
+draft was no longer known as `cur' in the `draft' folder, then
 the user could
 .B scan
-the folder to see which message draft in the
-folder should be used for editing or sending.  Clever users could even
-employ a backquoted
+the folder to see which message draft should be used for editing or sending.
+Clever users could even employ a backquoted
 .B pick
 to do the work:
 .PP
@@ -221,9 +210,7 @@ et al, invoke
 .B send
 directly, they supply
 .B send
-with the UNIX pathname of the message draft, and
-.B not
-a
+with the UNIX pathname of the message draft; NOT a
 .B \-draftmessage
 .I msg
 argument.  As far as
@@ -240,7 +227,6 @@ First, under no circumstances will the
 .B \-draftfolder
 .I folder
 switch cause the named folder to become the current folder.
-.PP
 Obviously, if the folder appeared in the context of a standard
 .I +folder
 argument to an
@@ -309,7 +295,7 @@ to the command, then one other response will be accepted:
 .PD 0
 .TP 10
 .B new
-finds a new draft
+creates a new draft
 .PD
 .RE
 .PP
@@ -332,5 +318,17 @@ re-uses the draft
 just as if
 .B \-use
 had been given.
+.SH FILES
+.PP
+.TP 20
+$HOME/.mh_profile
+The user's profile.
+.SH "PROFILE COMPONENTS"
+.PP
+.PD 0
+.TP 20
+Draft\-Folder:
+For a default draft folder
+.PD
 .SH CONTEXT
 None