From ba82c49879c9fda961ad77ef1922dee09f4c5488 Mon Sep 17 00:00:00 2001 From: Shantonu Sen Date: Tue, 2 Jan 2001 06:43:07 +0000 Subject: [PATCH] mh_chart-mh_draft --- man/mh-chart.man | 577 +----------------------------------------------------- man/mh-draft.man | 417 ++++++++++++++++++++++++++------------- 2 files changed, 281 insertions(+), 713 deletions(-) diff --git a/man/mh-chart.man b/man/mh-chart.man index 3049933..9815d87 100644 --- a/man/mh-chart.man +++ b/man/mh-chart.man @@ -2,584 +2,9 @@ .\" %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 diff --git a/man/mh-draft.man b/man/mh-draft.man index 6dc3125..7f86635 100644 --- a/man/mh-draft.man +++ b/man/mh-draft.man @@ -2,191 +2,334 @@ .\" %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 -- 1.7.10.4