c11da838510e87589a34a5c87fc1f2aeb5b62fc2
[mmh] / man / whatnow.man1
1 .\"
2 .\" %nmhwarning%
3 .\"
4 .TH WHATNOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
5 .SH NAME
6 whatnow \- prompting front-end for sending messages
7 .SH SYNOPSIS
8 .HP 5
9 .na
10 .B whatnow
11 .RB [ \-editor
12 .IR editor ]
13 .RB [ \-prompt
14 .IR string ]
15 .RI [ file ]
16 .RB [ \-Version ]
17 .RB [ \-help ]
18 .ad
19 .SH DESCRIPTION
20 .B Whatnow
21 is the default program that queries the user about
22 the disposition of a composed draft.  It is normally automatically
23 invoked by one of the
24 .B nmh
25 commands
26 .BR comp ,
27 .BR dist ,
28 .BR forw ,
29 or
30 .B repl
31 after the initial edit.
32 .PP
33 When started, the editor is started on the draft (unless the
34 .B \-editor
35 switch with an empty string argument is given,
36 in which case the initial edit is suppressed).  Then,
37 .B whatnow
38 repetitively prompts the user with \*(lqWhat now?\*(rq
39 and awaits a response.  The valid responses are:
40 .PP
41 .RS 5
42 .TP \w'refilezzzzfolderz'u
43 .B edit
44 re\-edit using the same editor that was used on the
45 preceding round unless a profile entry
46 \*(lq<lasteditor>\-next: <editor>\*(rq names an alternate editor
47 .TP \w'refilezzzzfolderz'u
48 .B edit <editor>
49 invoke <editor> for further editing
50 .TP \w'refilezzzzfolderz'u
51 .B refile +folder
52 refile the draft into the given folder
53 .TP \w'refilezzzzfolderz'u
54 .B display
55 list the message being distributed/replied\-to
56 on the terminal
57 .TP \w'refilezzzzfolderz'u
58 .B list
59 list the draft on the terminal
60 .TP \w'refilezzzzfolderz'u
61 .B send
62 send the message
63 .TP \w'refilezzzzfolderz'u
64 .B send \-watch
65 send the message and monitor the delivery process
66 .TP \w'refilezzzzfolderz'u
67 .B quit
68 preserve the draft and exit
69 .TP \w'refilezzzzfolderz'u
70 .B delete
71 delete the draft and exit
72 .TP \w'refilezzzzfolderz'u
73 .B cd directory
74 use the directory when interpreting attachment file names
75 .TP \w'refilezzzzfolderz'u
76 .B pwd
77 print the working directory for attachment files
78 .TP \w'refilezzzzfolderz'u
79 .B ls [ls-options]
80 list files in the attachment working directory using the ls command
81 .TP \w'refilezzzzfolderz'u
82 .B attach files
83 add the named files to the draft as MIME attachments
84 .TP \w'refilezzzzfolderz'u
85 .B alist
86 list the MIME attachments
87 .TP \w'refilezzzzfolderz'u
88 .B detach [-n] files-or-numbers
89 remove MIME attachments, either by file name or by number with -n
90 .RE
91 .PP
92 When entering your response, you need only type enough characters
93 to uniquely identify the response.
94 .PP
95 For the
96 .B edit
97 response, any valid switch to the editor is valid.
98 .PP
99 For the
100 .B send
101 response, any valid switch to
102 .BR send (1)
103 is valid.
104 .PP
105 For the
106 .B refile
107 response, any valid switch to
108 .B refile
109 is valid.
110 .PP
111 See
112 .BR mh\-profile (5)
113 for further information about how editors
114 are used by
115 .BR nmh .
116 It also discusses how environment variables can be
117 used to direct
118 .BR whatnow 's
119 actions in complex ways.
120 .PP
121 If the initial edit fails, no new draft is created, but any
122 existing re-used draft is preserved.
123 Failures of later edits are ignored and another prompt is printed.
124 .PP
125 The
126 .B \-prompt
127 .I string
128 switch sets the prompting string for
129 .BR whatnow .
130 .PP
131 Consult the
132 .BR mh-draft (7)
133 man page for more
134 information.
135
136 .SH FILES
137 .fc ^ ~
138 .nf
139 .ta \w'%etcdir%/ExtraBigFileName  'u
140 ^$HOME/.mmh/profile~^The user profile
141 ^+drafts~^The draft folder
142 .fi
143
144 .SH "PROFILE COMPONENTS"
145 .fc ^ ~
146 .nf
147 .ta 2.4i
148 .ta \w'ExtraBigProfileName  'u
149 ^Path:~^To determine the user's mail storage
150 ^Draft\-Folder:~^To set the default draft\-folder
151 ^Editor:~^To override the default editor
152 ^<lasteditor>\-next:~^To name an editor to be used after exit
153 ^~^from <lasteditor>
154 ^listproc:~^Program to list the contents of a message
155 .fi
156
157 .SH "SEE ALSO"
158 send(1)
159
160 .SH DEFAULTS
161 .nf
162 .RB ` \-prompt "' defaults to \*(lqWhat\ Now?\ \*(rq"
163 .fi
164
165 .SH CONTEXT
166 None