Removed the -noeditor switches and made them replaceable by `-editor ""'.
[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 \-edit
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 The
122 .B \-prompt
123 .I string
124 switch sets the prompting string for
125 .BR whatnow .
126 .PP
127 Consult the
128 .BR mh-draft (7)
129 man page for more
130 information.
131
132 .SH FILES
133 .fc ^ ~
134 .nf
135 .ta \w'%etcdir%/ExtraBigFileName  'u
136 ^$HOME/.mmh/profile~^The user profile
137 ^+drafts~^The draft folder
138 .fi
139
140 .SH "PROFILE COMPONENTS"
141 .fc ^ ~
142 .nf
143 .ta 2.4i
144 .ta \w'ExtraBigProfileName  'u
145 ^Path:~^To determine the user's mail storage
146 ^Draft\-Folder:~^To set the default draft\-folder
147 ^Editor:~^To override the default editor
148 ^<lasteditor>\-next:~^To name an editor to be used after exit
149 ^~^from <lasteditor>
150 ^listproc:~^Program to list the contents of a message
151 .fi
152
153 .SH "SEE ALSO"
154 send(1)
155
156 .SH DEFAULTS
157 .nf
158 .RB ` \-prompt "' defaults to \*(lqWhat\ Now?\ \*(rq"
159 .fi
160
161 .SH CONTEXT
162 None
163
164 .SH BUGS
165 If the initial edit fails,
166 .B whatnow
167 deletes your draft (by renaming
168 it with a leading comma); failure of a later edit preserves the draft.