Factor trim format function out
[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 mmh
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 `What now?'
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 `<lasteditor>\-next: <editor>' 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 list
52 list the draft on the terminal
53 .TP \w'refilezzzzfolderz'u
54 .B display
55 list the message being distributed/replied\-to on the terminal
56 .TP \w'refilezzzzfolderz'u
57 .B whom
58 list the recipients of the message
59 .TP \w'refilezzzzfolderz'u
60 .B send
61 send the message
62 .TP \w'refilezzzzfolderz'u
63 .B refile +folder
64 refile the draft into the given folder
65 .TP \w'refilezzzzfolderz'u
66 .B delete
67 delete the draft and exit
68 .TP \w'refilezzzzfolderz'u
69 .B quit
70 preserve the draft and exit
71 .TP \w'refilezzzzfolderz'u
72 .B cd directory
73 use the directory when interpreting attachment file names
74 .TP \w'refilezzzzfolderz'u
75 .B pwd
76 print the working directory for attachment files
77 .TP \w'refilezzzzfolderz'u
78 .B ls [ls-options]
79 list files in the attachment working directory using the ls command
80 .TP \w'refilezzzzfolderz'u
81 .B attach files
82 add the named files to the draft as MIME attachments
83 .TP \w'refilezzzzfolderz'u
84 .B alist
85 list the MIME attachments
86 .TP \w'refilezzzzfolderz'u
87 .B detach numbers
88 remove MIME attachments by number
89 .RE
90 .PP
91 When entering your response, you need only type enough characters
92 to uniquely identify the response.
93 .PP
94 For the
95 .B edit
96 response, any valid switch to the editor is valid.
97 .PP
98 For the
99 .B send
100 response, any valid switch to
101 .BR send (1)
102 is valid.
103 .PP
104 For the
105 .B refile
106 response, any valid switch to
107 .B refile
108 is valid.
109 .PP
110 See
111 .BR mh\-profile (5)
112 for further information about how editors
113 are used by
114 .BR mmh .
115 It also discusses how environment variables can be
116 used to direct
117 .BR whatnow 's
118 actions in complex ways.
119 .PP
120 If the initial edit fails, no new draft is created, but any
121 existing re-used draft is preserved.
122 Failures of later edits are ignored and another prompt is printed.
123 .PP
124 The
125 .B \-prompt
126 .I string
127 switch sets the prompting string for
128 .BR whatnow .
129 .PP
130 Consult the
131 .BR mh-draft (7)
132 man page for more
133 information.
134
135 .SH FILES
136 .fc ^ ~
137 .nf
138 .ta \w'%etcdir%/ExtraBigFileName  'u
139 ^$HOME/.mmh/profile~^The user profile
140 ^+drafts~^The draft folder
141 .fi
142
143 .SH "PROFILE COMPONENTS"
144 .fc ^ ~
145 .nf
146 .ta 2.4i
147 .ta \w'ExtraBigProfileName  'u
148 ^Path:~^To determine the user's mail storage
149 ^Draft\-Folder:~^To set the default draft\-folder
150 ^Editor:~^To override the default editor
151 ^<lasteditor>\-next:~^To name an editor to be used after exit
152 ^~^from <lasteditor>
153 ^listproc:~^Program to list the contents of a message
154 .fi
155
156 .SH "SEE ALSO"
157 send(1)
158
159 .SH DEFAULTS
160 .nf
161 .RB ` \-prompt "' defaults to `What\ Now?\ '"
162 .fi
163
164 .SH CONTEXT
165 None