.\" %nmhwarning%
.\" $Id$
.\"
-.\" include the -mh macro file
-.so %etcdir%/tmac.h
-.\"
-.if '\*(ZZ'-man' \{\
.TH MH-CHART %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
mh-chart \- Chart of nmh Commands
.SH SYNOPSIS
-.in +.5i
-.ti -.5i
-.\}
-.in 1i
-.na
-.ti .5i
-.ne 7
-ali
-\%[\-alias\ aliasfile]
-\%[\-list] \%[\-nolist]
-\%[\-normalize] \%[\-nonormalize]
-\%[\-user] \%[\-nouser]
-aliases\ ...
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 6
-anno
-\%[+folder] \%[msgs]
-\%[\-component\ field]
-\%[\-inplace] \%[\-noinplace]
-\%[\-date] \%[\-nodate]
-\%[\-text\ body]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 6
-burst
-\%[+folder] \%[msgs]
-\%[\-inplace] \%[\-noinplace]
-\%[\-quiet] \%[\-noquiet]
-\%[\-verbose] \%[\-noverbose]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 9
-comp
-\%[+folder] \%[msg]
-\%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
-\%[\-editor\ editor] \%[\-noedit]
-\%[\-file\ file]
-\%[\-form\ formfile]
-\%[\-use] \%[\-nouse]
-\%[\-whatnowproc\ program] \%[\-nowhatnowproc]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 9
-dist
-\%[+folder] \%[msg]
-\%[\-annotate] \%[\-noannotate]
-\%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
-\%[\-editor\ editor] \%[\-noedit]
-\%[\-form\ formfile]
-\%[\-inplace] \%[\-noinplace]
-\%[\-whatnowproc\ program] \%[\-nowhatnowproc]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 9
-flist
-\%[+folder1 [+folder2 ...]]
-\%[\-sequence\ name1 [\-sequence\ name2 ...]]
-\%[\-all] \%[\-noall]
-\%[\-showzero] \%[\-noshowzero]
-\%[\-alpha] \%[\-noalpha]
-\%[\-recurse] \%[\-norecurse]
-\%[\-fast] \%[\-nofast]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 4
-%libdir%/fmtdump
-\%[\-form\ formatfile]
-\%[\-format\ string]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 12
-folder
-\%[+folder] \%[msg]
-\%[\-all] \%[\-noall]
-\%[\-fast] \%[\-nofast]
-\%[\-header] \%[\-noheader]
-\%[\-pack] \%[\-nopack]
-\%[\-recurse] \%[\-norecurse]
-\%[\-total] \%[\-nototal]
-\%[\-print] \%[\-noprint]
-\%[\-list] \%[\-nolist]
-\%[\-push] \%[\-pop]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-folders
-
-.ti .5i
-.ne 11
-forw
-\%[+folder] \%[msgs]
-\%[\-annotate] \%[\-noannotate]
-\%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
-\%[\-editor\ editor] \%[\-noedit]
-\%[\-filter\ filterfile]
-\%[\-form\ formfile]
-\%[\-format] \%[\-noformat]
-\%[\-inplace] \%[\-noinplace]
-\%[\-mime] \%[\-nomime]
-\%[\-whatnowproc\ program] \%[\-nowhatnowproc]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 5
-forw
-\%[+folder] \%[msgs]
-\%[\-digest\ list] \%[\-issue\ number] \%[\-volume\ number]
-\%[other\ switches\ for\ \fIforw\fR]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 11
-inc
-\%[+folder]
-\%[\-audit\ audit\-file] \%[\-noaudit]
-\%[\-changecur] \%[\-nochangecur]
-\%[\-file\ name]
-\%[\-form\ formatfile]
-\%[\-format\ string]
-\%[\-silent] \%[\-nosilent]
-\%[\-truncate] \%[\-notruncate]
-\%[\-width\ columns]
-%nmhbeginpop%
-\%[\-host\ hostname]
-\%[\-user\ username]
-\%[\-pack\ file]
-\%[\-nopack]
-%nmhendpop%
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 7
-mark
-\%[+folder] \%[msgs]
-\%[\-sequence\ name\ ...]
-\%[\-add] \%[\-delete] \%[\-list]
-\%[\-public] \%[\-nopublic]
-\%[\-zero] \%[\-nozero]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 9
-mhbuild
-file
-\%[\-list] \%[-nolist]
-\%[\-realsize] \%[\-norealsize]
-\%[\-headers] \%[\-noheaders]
-\%[\-ebcdicsafe] \%[\-noebcdicsafe]
-\%[\-rfc934mode] \%[\-norfc934mode]
-\%[\-verbose] \%[\-noverbose]
-\%[\-check] \%[\-nocheck]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 9
-%libdir%/mhl
-\%[\-bell] \%[\-nobell]
-\%[\-clear] \%[\-noclear]
-\%[\-folder\ +folder]
-\%[\-form\ formfile]
-\%[\-length\ lines] \%[\-width\ columns]
-\%[\-moreproc\ program] \%[\-nomoreproc]
-\%[files\ ...]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 8
-mhmail
-\%[
-addrs\ ...
-\%[\-body\ text]
-\%[\-cc\ addrs\ ...]
-\%[\-from\ addr]
-\%[\-subject subject]]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 16
-mhn
-\%[+folder] \%[msgs] \%[\-file file]
-\%[\-part number]... \%[\-type content]...
-\%[\-show] \%[\-noshow]
-\%[\-list] \%[-nolist]
-\%[\-store] \%[\-nostore]
-\%[\-cache] \%[\-nocache]
-\%[\-headers] \%[\-noheaders]
-\%[\-realsize] \%[\-norealsize]
-\%[\-serialonly] \%[\-noserialonly]
-\%[\-form formfile]
-\%[\-pause] \%[\-nopause]
-\%[\-auto] \%[\-noauto]
-\%[\-rcache policy] \%[\-wcache policy]
-\%[\-check] \%[\-nocheck]
-\%[\-verbose] \%[\-noverbose]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 5
-mhparam
-\%[profile-components]
-\%[\-components] \%[\-nocomponents]
-\%[\-all]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 3
-mhpath
-\%[+folder] \%[msgs]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 5
-msgchk
-\%[\-date] \%[\-nodate]
-\%[\-notify\ all/mail/nomail] \%[\-nonotify\ all/mail/nomail]
-%nmhbeginpop%
-\%[\-host\ hostname]
-\%[\-user\ username]
-%nmhendpop%
-\%[users\ ...]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 5
-msh
-\%[\-prompt\ string]
-\%[\-scan] \%[\-noscan]
-\%[\-topcur] \%[\-notopcur]
-\%[file]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 6
-next
-\%[+folder]
-\%[\-showproc\ program]
-\%[\-showmimeproc\ program]
-.br
-\%[\-header] \%[\-noheader]
-\%[\-checkmime] \%[\-nocheckmime]
-.br
-\%[switches\ for\ \fIshowproc\fR or\ \fIshowmimeproc\fR]
-.br
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 5
-packf
-\%[+folder] \%[msgs]
-\%[-file\ name]
-\%[-mbox] \%[-mmdf]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 10
-pick
-\%[+folder] \%[msgs]
-\%[\-and\ ...] \%[\-or\ ...] \%[\-not\ ...] \%[\-lbrace\ ...\ \-rbrace]
-\%[\-\|\-component\ pattern]
-\%[\-after\ date] \%[\-before\ date] \%[\-datefield\ field]
-\%[\-sequence\ name\ ...]
-\%[\-public] \%[\-nopublic]
-\%[\-zero] \%[\-nozero]
-\%[\-list] \%[\-nolist]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 6
-prev
-\%[+folder]
-\%[\-showproc\ program]
-\%[\-showmimeproc\ program]
-.br
-\%[\-header] \%[\-noheader]
-\%[\-checkmime] \%[\-nocheckmime]
-.br
-\%[\-switches\ for\ \fIshowproc\fR or\ \fIshowmimeproc\fR]
-.br
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 7
-prompter
-\%[\-erase\ chr]
-\%[\-kill\ chr]
-\%[\-prepend] \%[\-noprepend]
-\%[\-rapid] \%[\-norapid]
-\%[\-doteof] \%[\-nodoteof]
-file
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 5
-%libdir%/rcvdist
-\%[\-form\ formfile]
-\%[switches\ for\ \fIpostproc\fR]
-address1\ ...
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 4
-%libdir%/rcvpack
-file
-\%[-mbox] \%[-mmdf]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 7
-%libdir%/rcvstore
-\%[+folder]
-\%[\-create] \%[\-nocreate]
-\%[\-unseen] \%[\-nounseen]
-\%[\-sequence\ name\ ...]
-\%[\-public] \%[\-nopublic]
-\%[\-zero] \%[\-nozero]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 10
-%libdir%/rcvtty
-\%[command]
-\%[\-form\ formatfile]
-\%[\-format\ string]
-\%[\-width\ columns]
-\%[\-bell] \%[\-nobell]
-\%[\-newline]
-\%[\-nonewline]
-\%[\-biff]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 9
-refile
-\%[msgs]
-\%[\-draft]
-\%[\-link] \%[\-nolink]
-\%[\-preserve] \%[\-nopreserve]
-\%[\-unlink] \%[\-nounlink]
-\%[\-src\ +folder]
-\%[\-file\ file]
-+folder ...
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 15
-repl
-\%[+folder] \%[msg]
-\%[\-group] \%[\-nogroup]
-\%[\-annotate] \%[\-noannotate]
-\%[\-cc\ all/to/cc/me] \%[\-nocc\ all/to/cc/me]
-\%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
-\%[\-editor\ editor] \%[\-noedit]
-\%[\-fcc\ +folder]
-\%[\-filter\ filterfile]
-\%[\-form\ formfile]
-\%[\-format] \%[\-noformat]
-\%[\-inplace] \%[\-noinplace]
-\%[\-query] \%[\-noquery]
-\%[\-whatnowproc\ program] \%[\-nowhatnowproc]
-\%[\-width\ columns]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 4
-rmf
-\%[+folder]
-\%[\-interactive] \%[\-nointeractive]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 3
-rmm
-\%[+folder] \%[msgs]
-\%[\-unlink] \%[\-nounlink]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 8
-scan
-\%[+folder] \%[msgs]
-\%[\-clear] \%[\-noclear]
-\%[\-form\ formatfile]
-\%[\-format\ string]
-\%[\-header] \%[\-noheader]
-\%[\-width\ columns]
-\%[\-reverse] \%[\-noreverse]
-\%[\-file filename]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 15
-send
-\%[\-alias\ aliasfile]
-\%[\-draft]
-\%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
-\%[\-filter\ filterfile] \%[\-nofilter]
-\%[\-format] \%[\-noformat]
-\%[\-forward] \%[\-noforward]
-\%[\-mime] \%[\-nomime]
-\%[\-msgid] \%[\-nomsgid]
-\%[\-push] \%[\-nopush]
-\%[\-split\ seconds]
-\%[\-verbose] \%[\-noverbose]
-\%[\-watch] \%[\-nowatch]
-\%[\-width\ columns]
-\%[file\ ...]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 7
-show
-\%[+folder] \%[msgs]
-\%[\-showproc\ program]
-.br
-\%[\-showmimeproc\ program]
-\%[\-header] \%[\-noheader]
-.br
-\%[\-draft]
-\%[\-checkmime] \%[\-nocheckmime]
-.br
-\%[switches\ for\ \fIshowproc\fR or \fIshowmimeproc\fR]
-.br
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 5
-sortm
-\%[+folder] \%[msgs]
-\%[\-datefield\ field]
-\%[\-textfield\ field] \%[\-notextfield]
-\%[\-limit days] \%[\-nolimit]
-\%[\-verbose] \%[\-noverbose]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 6
-whatnow
-\%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
-\%[\-editor\ editor] \%[\-noedit]
-\%[\-prompt\ string]
-\%[file]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 7
-whom
-\%[\-alias\ aliasfile]
-\%[\-check] \%[\-nocheck]
-\%[\-draft]
-\%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
-\%[file]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 7
-%libdir%/ap
-\%[\-form\ formatfile]
-\%[\-format\ string]
-\%[\-normalize] \%[\-nonormalize]
-\%[\-width\ columns]
-addrs\ ...
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 5
-%libdir%/conflict
-\%[\-mail\ name]
-\%[\-search\ directory]
-\%[aliasfiles\ ...]
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 5
-%libdir%/dp
-\%[\-form\ formatfile]
-\%[\-format\ string]
-\%[\-width\ columns]
-dates\ ...
-\%[\-version]
-\%[\-help]
-
-.ti .5i
-.ne 3
-%libdir%/install\-mh
-\%[\-auto]
-
-.ti .5i
-.ne 11
-%libdir%/post
-\%[\-alias\ aliasfile]
-\%[\-filter\ filterfile] \%[\-nofilter]
-\%[\-format] \%[\-noformat]
-\%[\-mime] \%[\-nomime]
-\%[\-msgid] \%[\-nomsgid]
-\%[\-verbose] \%[\-noverbose]
-\%[\-watch] \%[\-nowatch]
-\%[\-width\ columns]
-file
-\%[\-version]
-\%[\-help]
-.ti .5i
-.ne 10
-%libdir%/slocal \%[address\ info\ sender]
-.br
-\%[\-addr\ address]
-\%[\-info\ data]
-\%[\-sender\ sender]
-.br
-\%[\-user\ username]
-\%[\-mailbox\ mbox]
-\%[\-file\ file]
-.br
-\%[\-maildelivery\ deliveryfile]
-\%[\-suppressdup]
-.br
-\%[\-nosuppressdup]
-\%[\-verbose] \%[\-noverbose]
-\%[\-debug]
-.br
-\%[\-version]
-\%[\-help]
-.ad
-.in 0
+This man page will contain the SYNOPSIS section of all nmh commands
.\" %nmhwarning%
.\" $Id$
.\"
-.\" include the -mh macro file
-.so %etcdir%/tmac.h
-.\"
.TH MH-DRAFT %manext5% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
mh-draft \- draft folder facility for nmh message system
.SH SYNOPSIS
-.in +.5i
-.ti -.5i
-any \fInmh\fR command
-.in -.5i
+any
+.B nmh
+command
.SH DESCRIPTION
-
There are a number of interesting advanced facilities for the composition of
outgoing mail.
-
-.Uh "The Draft Folder"
-The \fIcomp\fR, \fIdist\fR, \fIforw\fR, and \fIrepl\fR commands have
-two additional switches, `\-draftfolder\ +folder' and `\-draftmessage\ msg'
+.PP
+.SS "The Draft Folder"
+The
+.BR comp ,
+.BR dist ,
+.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.
-
-If `\-draftfolder\ +folder' is used, these commands are
+.PP
+If
+.B \-draftfolder
+.I +folder
+is used, these commands are
directed to construct a draft message in the indicated folder.
-(The \*(lqDraft\-Folder:\*(rq profile entry may be used to declare a
-default draft folder for use with \fIcomp\fR, \fIdist\fR, \fIforw\fR,
-and \fIrepl\fR).
-
-If the swith `\-draftmessage\ msg' is given, the specified draft is used
-to compose the message. If `\-draftmessage\ msg' is not used, then the
+(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 ).
+.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
-\fIcomp\fR with `\-use', in which case the default is `cur'.
-
+.B comp
+with
+.BR \-use ,
+in which case the default is `cur'.
+.PP
Hence, the user may have several message compositions in progress
-simultaneously. Now, all of the \fInmh\fR tools are available on each of
-the user's message drafts (e.g., \fIshow\fR, \fIscan\fR, \fIpick\fR, and
-so on). If the folder does not exist, the user is asked if it should be
-created (just like with \fIrefile\fR). Also, the last draft message
+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 user was composing is known as `cur' in the draft folder.
-
-Furthermore, the \fIsend\fR command has these switches as well. Hence,
+.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 \fInmh\fR `msgs' convention with `\-draftmessage msgs'. If no
-`msgs' are given, it defaults to `cur'.
-
-In addition, all five programs have a `\-nodraftfolder' switch, which
-undoes the last occurrence of `\-draftfolder\ folder' (useful if the
-latter occurs in the user's \fInmh\fR profile).
-
-If the user does not give the `\-draftfolder\ +folder' switch, then
-all these commands act ``normally''. Note that the `\-draft' switch
-to \fIsend\fR and \fIshow\fR still refers to the file called `draft'
-in the user's \fInmh\fR directory. In the interests of economy of
-expression, when using \fIcomp\fR or \fIsend\fR, the user needn't
-prefix the draft `msg' or `msgs' with `\-draftmessage'. Both of these
+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
+.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
-`\-draftfolder\ +folder' treat these arguments as `msg' or `msgs'.
-(This may appear to be inconsistent, at first, but it saves a lot of
-typing) Hence,
-
-.ti +.5i
-send -draftf +drafts first
-
+.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
-
-.ti +.5i
-send -draftf +drafts -draftm first
-
+.PP
+.RS
+.nf
+send -draftfolder +drafts -draftmessage first
+.fi
+.RE
+.PP
To make all this a bit more clear, here are some examples. Let's assume
-that the following entries are in the \fInmh\fR profile:
-
-.in +.5i
+that the following entries are in the
+.B nmh
+profile:
+.PP
+.RS 5
.nf
Draft\-Folder: +drafts
-sendf: -draftfolder +drafts
+sendf: \-draftfolder +drafts
.fi
-.in -.5i
-
-Furthermore, let's assume that the program \fIsendf\fR is a (symbolic)
-link in the user's \fB$HOME/bin/\fR directory to \fIsend\fR. Then, any
-of the commands
-
-.in +.5i
+.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
+.PP
+.RS 5
.nf
comp
dist
forw
repl
.fi
-.in -.5i
-
+.RE
+.PP
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 \fIquit\fR option
-at `What now?' level, then later on, if no other draft composition was
-done, the draft could be sent with simply
-
-.ti +.5i
+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
+was done, the draft could be sent with simply
+.PP
+.RS 5
+.nf
sendf
-
+.fi
+.RE
+.PP
Or, if more editing was required, the draft could be edited with
-
-.ti +.5i
+.PP
+.RS 5
+.nf
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
-the user could \fIscan\fR the folder to see which message draft in the
+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 back-quoted \fIpick\fR to do the work:
-
-.ti +.5i
+employ a back-quoted
+.B pick
+to do the work:
+.PP
+.RS 5
+.nf
comp -use `pick +drafts -to nmh-workers`
-
+.fi
+.RE
+.PP
or
-
-.ti +.5i
+.PP
+.RS 5
+.nf
sendf `pick +drafts -to nmh-workers`
-
-Note that in the \fIcomp\fR example, the output from \fIpick\fR must
-resolve to a single message draft (it makes no sense to talk about
-composing two or more drafts with one invocation of \fIcomp\fR).
-In contrast, in the \fIsend\fR example, as many message drafts as desired
-can appear, since \fIsend\fR doesn't mind sending more than one draft
-at a time.
-
-Note that the argument `\-draftfolder\ +folder' is not included in the
-profile entry for \fIsend\fR, since when \fIcomp\fR, et. al., invoke
-\fIsend\fR directly, they supply \fIsend\fR with the UNIX pathname
-of the message draft, and \fBnot\fR a `draftmessage\ msg' argument.
-As far as \fIsend\fR is concerned, a \fIdraft folder\fR is not being used.
-
-It is important to realize that \fInmh\fR treats the draft folder
-like a standard \fInmh\fR folder in nearly all respects. There are
-two exceptions:
-
-First, under no circumstancs will the `\-draftfolder\ folder' switch cause the
-named folder to become the current folder.
-
-Obviously, if the folder appeared in the context of a standard `+folder'
-argument to an \fInmh\fR program, as in
-
-.ti +.5i
+.fi
+.RE
+.PP
+Note that in the
+.B comp
+example, the output from
+.B pick
+must resolve to a single message draft (it makes no sense to talk about
+composing two or more drafts with one invocation of
+.BR comp ).
+In contrast, in the
+.B send
+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
-
-it might become the current folder, depending on the context changes of
-the \fInmh\fR program in question.
-
-Second, although conceptually \fIsend\fR deletes the `msgs' named in
-the draft folder, it does not call `delete-prog' to perform the deletion.
-
-.Uh "What Happens if the Draft Exists"
-When the \fIcomp\fR, \fIdist\fR, \fIforw\fR, and \fIrepl\fR commands
+.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
+.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
-
-.ti +.5i
+.PP
+.RS 5
+.nf
Draft ``/home/foobar/nmhbox/draft'' exists (xx bytes).
-.ti +.5i
Disposition?
-
+.fi
+.RE
+.PP
The appropriate responses and their meanings are:
-
+.PP
+.RS 5
+.fc ^ ~
.nf
-^replace - deletes the draft and starts afresh
-^list - lists the draft
-^refile - files the draft into a folder and starts afresh
-^quit - leaves the draft intact and exits
+.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
-
-In addition, if you specified `\-draftfolder\ folder' to the command,
-then one other response will be accepted:
-
+.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
-^new - finds a new draft,
+.ta \w'replace 'u
+.BR ^new~^ "- finds a new draft"
.fi
-
-just as if `\-draftmessage\ new' had been given.
-Finally, the \fIcomp\fR command will accept one more response:
-
+.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
-^use - re-uses the draft
+.ta \w'replace 'u
+.BR ^use~^ "- re-uses the draft"
.fi
+.RE
+.PP
+just as if
+.B \-use
+had been given.
-just as if `\-use' had been given.
-.Co
+.SH CONTEXT
None
-.En
projects / mmh / commitdiff