X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fmh-draft.man;h=bd841660f2081fb8d043688c9cdbe79df04fcf5b;hp=63b7b0df4d747096896ddbe21d5902b9bec3a56d;hb=337338b404931f06f0db2119c9e145e8ca5a9860;hpb=dc6c45394a06750eab463a2523406eed6c77e2e1

diff --git a/man/mh-draft.man b/man/mh-draft.man
index 63b7b0d..bd84166 100644
--- a/man/mh-draft.man
+++ b/man/mh-draft.man
@@ -19,109 +19,33 @@ The
 .BR forw ,
 and
 .B repl
-commands have two additional switches,
-.B \-draftfolder
-.I +folder
-and
-.B \-draftmessage
-.I msg
-which allow you to manipulate the various draft messages you are composing.
+commands allow you to manipulate various draft messages simultanely
 .PP
-If
-.B \-draftfolder
-.I +folder
-is used, these commands are
-directed to construct a draft message in the indicated folder.
+Draft messages are created in the draft 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 ,
-and
-.BR repl ).
+profile entry may be used to change the default draft folder.
 .PP
-If the swith
-.B \-draftmessage
-.I msg
-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
+New drafts are created unless the user invokes
 .B comp
 with
 .BR \-use ,
-in which case the default is `cur'.
+in which case the current draft is used.
 .PP
-Hence, the user may have several message compositions in progress
-simultaneously.  Now, all of the
-.B nmh
-tools are available on each of the user's message drafts (e.g.
-.BR show ,
-.BR scan ,
-.BR pick ,
-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 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
+The user can send off whatever drafts desired from the shell 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
-.B \-nodraftfolder
-switch, which undoes the last occurrence of
-.B \-draftfolder
-.I folder
-(useful if the latter occurs in the user's
-.B nmh
-profile).
-.PP
-If the user does not give the
-.B \-draftfolder
-.I +folder
-switch, then all these commands act \*(lqnormally\*(rq.  Note that the
-.B \-draft
-switch to
+`msgs' convention to the
 .B send
-and
-.B show
-still refers to the file called `draft' in the user's
-.B nmh
-directory.  In the interests of economy of expression, when using
-.B comp
-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
-.B \-draftfolder
-.I +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
-.RS
-.nf
-send -draftfolder +drafts first
-.fi
-.RE
-.PP
-is the same as
+command..
+If no `msgs' are given, it defaults to `cur'.
 .PP
 .RS
 .nf
-send -draftfolder +drafts -draftmessage first
+send first
 .fi
 .RE
 .PP
@@ -133,17 +57,10 @@ profile:
 .RS 5
 .nf
 Draft\-Folder: +drafts
-sendf: \-draftfolder +drafts
 .fi
 .RE
 .PP
-Furthermore, let's assume that the program
-.B sendf
-is a (symbolic) link in the user's
-.I $HOME/bin/
-directory to
-.BR send .
-Then, any of the commands
+Any of the commands
 .PP
 .RS 5
 .nf
@@ -154,7 +71,7 @@ repl
 .fi
 .RE
 .PP
-constructs the message draft in the `draft' folder using the `new'
+constructs 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
@@ -163,7 +80,7 @@ was done, the draft could be sent with simply
 .PP
 .RS 5
 .nf
-sendf
+send
 .fi
 .RE
 .PP
@@ -195,7 +112,7 @@ or
 .PP
 .RS 5
 .nf
-sendf `pick +drafts -to nmh-workers`
+send `pick +drafts -to nmh-workers`
 .fi
 .RE
 .PP
@@ -212,123 +129,15 @@ example, as many message drafts as desired can appear, since
 .B send
 doesn't mind sending more than one draft at a time.
 .PP
-Note that the argument
-.B \-draftfolder
-.I +folder
-is not included in the profile entry for
-.BR send ,
-since when
-.BR comp ,
-et. al., invoke
-.B send
-directly, they supply
-.B send
-with the UNIX pathname of the message draft, and
-.B not
-a
-.B \-draftmessage
-.I msg
-argument. As far as
-.B send
-is concerned, a draft folder is not being used.
-.PP
 It is important to realize that
 .B nmh
 treats the draft folder like a standard
 .B nmh
-folder in nearly all respects.  There are two exceptions:
-.PP
-First, under no circumstancs 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
-.B nmh
-program, as in
-.PP
-.RS 5
-.nf
-scan +drafts
-.fi
-.RE
-.PP
-it might become the current folder, depending on the context changes of the
-.B nmh
-program in question.
-.PP
-Second, although conceptually
+folder in nearly all respects.  There is one exception:
+Although conceptually
 .B send
 deletes the `msgs' named in the draft folder, it does not call
 .I delete\-prog
 to perform the deletion.
-
-.SS "What Happens if the Draft Exists"
-When the
-.BR comp ,
-.BR dist ,
-.BR forw ,
-and
-.B repl
-commands
-are invoked and the draft you indicated already exists, these programs
-will prompt the user for a reponse directing the program's action.
-The prompt is
-.PP
-.RS 5
-.nf
-Draft ``/home/foobar/nmhbox/draft'' exists (xx bytes).
-Disposition?
-.fi
-.RE
-.PP
-The appropriate responses and their meanings are:
-.PP
-.RS 5
-.fc ^ ~
-.nf
-.ta \w'replace 'u
-.BR ^replace~^ "- deletes the draft and starts afresh"
-.BR ^list~^ "- lists the draft"
-.BR ^refile~^ "- files the draft into a folder and starts afresh"
-.BR ^quit~^ "- leaves the draft intact and exits"
-.fi
-.RE
-.PP
-In addition, if you specified
-.B \-draftfolder
-.I folder
-to the command, then one other response will be accepted:
-.PP
-.RS 5
-.fc ^ ~
-.nf
-.ta \w'replace 'u
-.BR ^new~^ "- finds a new draft"
-.fi
-.RE
-.PP
-just as if
-.B \-draftmessage
-.I new
-had been given.
-Finally, the
-.B comp
-command will accept one more response:
-.PP
-.RS 5
-.fc ^ ~
-.nf
-.ta \w'replace 'u
-.BR ^use~^ "- re-uses the draft"
-.fi
-.RE
-.PP
-just as if
-.B \-use
-had been given.
-
 .SH CONTEXT
 None