Added note that suffixes were removed from filenames of temporary files.

[nmh] / man / whatnow.man

diff --git a/man/whatnow.man b/man/whatnow.man
index f7d7b37a756256e0af28ddd3eb85b997f32d3780..c1f735b9fec144d31cdeb2b310e87c2b3752515b 100644 (file)
--- a/man/whatnow.man
+++ b/man/whatnow.man
@@ -1,12 +1,12 @@
+.TH WHATNOW %manext1% "January 17, 2014" "%nmhversion%"

 .\"
 .\" %nmhwarning%
 .\"
 .\" %nmhwarning%

-.\" $Id$

 .\"
 .\"

-.TH WHATNOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]

 .SH NAME
 whatnow \- prompting front-end for sending messages
 .SH SYNOPSIS
 .HP 5
 .SH NAME
 whatnow \- prompting front-end for sending messages
 .SH SYNOPSIS
 .HP 5

+.na

 .B whatnow
 .RB [ \-draftfolder
 .IR +folder ]
 .B whatnow
 .RB [ \-draftfolder
 .IR +folder ]


@@ -21,6 +21,7 @@ whatnow \- prompting front-end for sending messages
 .RI [ file ]
 .RB [ \-version ]
 .RB [ \-help ]
 .RI [ file ]
 .RB [ \-version ]
 .RB [ \-help ]

+.ad

 .SH DESCRIPTION
 .B Whatnow
 is the default program that queries the user about
 .SH DESCRIPTION
 .B Whatnow
 is the default program that queries the user about


@@ -43,18 +44,18 @@ repetitively prompts the user with \*(lqWhat now?\*(rq
 and awaits a response.  The valid responses are:
 .PP
 .RS 5
 and awaits a response.  The valid responses are:
 .PP
 .RS 5

-.TP \w'refilezzfolderz'u
+.TP \w'refilezzzzfolderz'u

 .B edit
 re\-edit using the same editor that was used on the
 preceding round unless a profile entry
 \*(lq<lasteditor>\-next: <editor>\*(rq names an alternate editor
 .B edit
 re\-edit using the same editor that was used on the
 preceding round unless a profile entry
 \*(lq<lasteditor>\-next: <editor>\*(rq names an alternate editor

-.TP \w'refilezzfolderz'u
+.TP \w'refilezzzzfolderz'u

 .B edit <editor>
 invoke <editor> for further editing
 .B edit <editor>
 invoke <editor> for further editing

-.TP \w'refilezzfolderz'u
+.TP \w'refilezzzzfolderz'u

 .B refile +folder
 refile the draft into the given folder
 .B refile +folder
 refile the draft into the given folder

-.TP \w'refilezzfolderz'u
+.TP \w'refilezzzzfolderz'u

 .B mime
 process the draft as MIME composition file using
 the
 .B mime
 process the draft as MIME composition file using
 the


@@ -62,38 +63,59 @@ the
 command
 .RB ( mhbuild
 by default)
 command
 .RB ( mhbuild
 by default)

-.TP \w'refilezzfolderz'u
+.TP \w'refilezzzzfolderz'u

 .B display
 list the message being distributed/replied\-to
 on the terminal
 .B display
 list the message being distributed/replied\-to
 on the terminal

-.TP \w'refilezzfolderz'u
+.TP \w'refilezzzzfolderz'u

 .B list
 list the draft on the terminal
 .B list
 list the draft on the terminal

-.TP \w'refilezzfolderz'u
+.TP \w'refilezzzzfolderz'u

 .B send
 send the message
 .B send
 send the message

-.TP \w'refilezzfolderz'u
+.TP \w'refilezzzzfolderz'u

 .B send \-watch
 send the message and monitor the delivery process
 .B send \-watch
 send the message and monitor the delivery process

-.TP \w'refilezzfolderz'u
+.TP \w'refilezzzzfolderz'u

 .B push
 send the message in the background
 .B push
 send the message in the background

-.TP \w'refilezzfolderz'u
+.TP \w'refilezzzzfolderz'u

 .B whom
 list the addresses that the message will go to
 .B whom
 list the addresses that the message will go to

-.TP \w'refilezzfolderz'u
+.TP \w'refilezzzzfolderz'u

 .B whom \-check
 list the addresses and verify that they are
 acceptable to the transport service
 .B whom \-check
 list the addresses and verify that they are
 acceptable to the transport service

-.TP \w'refilezzfolderz'u
+.TP \w'refilezzzzfolderz'u

 .B quit
 preserve the draft and exit
 .B quit
 preserve the draft and exit

-.TP \w'refilezzfolderz'u
+.TP \w'refilezzzzfolderz'u

 .B quit \-delete
 delete the draft and exit
 .B quit \-delete
 delete the draft and exit

-.TP \w'refilezzfolderz'u
+.TP \w'refilezzzzfolderz'u

 .B delete
 delete the draft and exit
 .B delete
 delete the draft and exit

+.TP \w'refilezzzzfolderz'u
+.B cd directory
+use the directory when interpreting attachment file names
+.TP \w'refilezzzzfolderz'u
+.B pwd
+print the working directory for attachment files
+.TP \w'refilezzzzfolderz'u
+.B ls [ls-options]
+list files in the attachment working directory using the ls command
+.TP \w'refilezzzzfolderz'u
+.B attach [-v] files
+add the named files to the message as MIME attachments; -v displays
+the mhbuild directive that
+.IR send (1)
+will use
+.TP \w'refilezzzzfolderz'u
+.B alist [-ln]
+list the MIME attachments, either short, long [-l] or numbered [-n]
+.TP \w'refilezzzzfolderz'u
+.B detach [-n] files-or-numbers
+remove MIME attachments, either by file name or by number with -n

 .RE
 .PP
 When entering your response, you need only type enough characters
 .RE
 .PP
 When entering your response, you need only type enough characters


@@ -108,7 +130,7 @@ For the
 and
 .B push
 responses, any valid switch to
 and
 .B push
 responses, any valid switch to

-.BR send (1)
+.IR send (1)

 is valid (as
 .B push
 merely invokes
 is valid (as
 .B push
 merely invokes


@@ -120,7 +142,7 @@ option).
 For the
 .B whom
 response, any valid switch to
 For the
 .B whom
 response, any valid switch to

-.BR whom (1)
+.IR whom (1)

 is valid.
 .PP
 For the
 is valid.
 .PP
 For the


@@ -145,7 +167,7 @@ to the
 message).
 .PP
 See
 message).
 .PP
 See

-.BR mh\-profile (5)
+.IR mh\-profile (5)

 for further information about how editors
 are used by
 .BR nmh .
 for further information about how editors
 are used by
 .BR nmh .


@@ -171,18 +193,28 @@ the
 .B nmh
 draft folder facility.  This is an advanced (and highly
 useful) feature.  Consult the
 .B nmh
 draft folder facility.  This is an advanced (and highly
 useful) feature.  Consult the

-.BR mh-draft (5)
+.IR mh-draft (5)

 man page for more
 information.
 man page for more
 information.

-
+.PP
+If your
+.B nmh
+was configured with readline enabled, you'll be able to use filename
+completion and other readline features at the prompt.  These are
+particularly useful with the
+.BR cd ,
+.BR ls ,
+.BR attach ,
+and
+.B detach
+commands for managing MIME attachments.

 .SH FILES
 .fc ^ ~
 .nf
 .SH FILES
 .fc ^ ~
 .nf

-.ta \w'/usr/local/nmh/etc/ExtraBigFileName  'u
+.ta \w'%etcdir%/ExtraBigFileName  'u

 ^$HOME/\&.mh\(ruprofile~^The user profile
 ^<mh\-dir>/draft~^The draft file
 .fi
 ^$HOME/\&.mh\(ruprofile~^The user profile
 ^<mh\-dir>/draft~^The draft file
 .fi

-

 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf


@@ -193,40 +225,25 @@ information.
 ^Editor:~^To override the default editor
 ^<lasteditor>\-next:~^To name an editor to be used after exit
 ^~^from <lasteditor>
 ^Editor:~^To override the default editor
 ^<lasteditor>\-next:~^To name an editor to be used after exit
 ^~^from <lasteditor>

-^automimeproc:~^If value is 1, and the draft is a MIME
-^~^composition file, then automatically call
-^~^buildmimeproc prior to sending.

 ^buildmimeproc:~^Program to translate MIME composition files
 ^fileproc:~^Program to refile the message
 ^lproc:~^Program to list the contents of a message
 ^sendproc:~^Program to use to send the message
 ^whomproc:~^Program to determine who a message would go to
 .fi
 ^buildmimeproc:~^Program to translate MIME composition files
 ^fileproc:~^Program to refile the message
 ^lproc:~^Program to list the contents of a message
 ^sendproc:~^Program to use to send the message
 ^whomproc:~^Program to determine who a message would go to
 .fi

-

 .SH "SEE ALSO"
 .SH "SEE ALSO"

-send(1), whom(1)
-
+.IR send (1),
+.IR whom (1)

 .SH DEFAULTS
 .nf
 .RB ` \-prompt "' defaults to \*(lqWhat\ Now?\ \*(rq"
 .fi
 .SH DEFAULTS
 .nf
 .RB ` \-prompt "' defaults to \*(lqWhat\ Now?\ \*(rq"
 .fi

-
-.SH CONTEXT
-None
-

 .SH BUGS
 .SH BUGS

-The argument to the
-.B \-prompt
-switch must be interpreted as a single
-token by the shell that invokes
-.BR whatnow .
-Therefore, one must
-usually place the argument to this switch inside double\-quotes.
-.PP

 If the initial edit fails,
 .B whatnow
 deletes your draft (by renaming
 If the initial edit fails,
 .B whatnow
 deletes your draft (by renaming

-it with a leading comma); failure of a later edit preserves the draft.
+it with a site-dependent prefix (usually a comma);
+failure of a later edit preserves the draft.

 .PP
 If the
 .I buildmimeproc
 .PP
 If the
 .I buildmimeproc