Factor trim format function out
[mmh] / man / whatnow2.man1
1 .\"
2 .\" %nmhwarning%
3 .\"
4 .TH WHATNOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
5 .SH NAME
6 whatnow2 \- front-end for handling drafts
7 .SH SYNOPSIS
8 .HP 5
9 .na
10 .B whatnow
11 .RI [ command
12 .RB | \-Version ]
13 .RB | \-help ]
14 .ad
15 .SH DESCRIPTION
16 .B Whatnow
17 is the default program that queries the user about
18 the disposition of a composed draft.  It is normally automatically
19 invoked by one of the
20 .B mmh
21 commands
22 .BR comp ,
23 .BR dist ,
24 .BR forw ,
25 or
26 .B repl
27 after the initial edit.
28 .PP
29 When started, the editor is started on the draft. Then,
30 .B whatnow
31 can called with one of the commands.
32 .PP
33 .RS 5
34 .TP \w'refilezzzzfolderz'u
35 .B edit
36 re\-edit using the same editor that was used on the
37 preceding round unless a profile entry
38 `<lasteditor>\-next: <editor>' names an alternate editor
39 .TP \w'refilezzzzfolderz'u
40 .B edit <editor>
41 invoke <editor> for further editing
42 .TP \w'refilezzzzfolderz'u
43 .B list
44 list the draft on the terminal
45 .TP \w'refilezzzzfolderz'u
46 .B display
47 list the message being distributed/replied\-to on the terminal
48 .TP \w'refilezzzzfolderz'u
49 .B whom
50 list the recipients of the message
51 .TP \w'refilezzzzfolderz'u
52 .B send
53 send the message
54 .TP \w'refilezzzzfolderz'u
55 .B refile +folder
56 refile the draft into the given folder
57 .TP \w'refilezzzzfolderz'u
58 .B delete
59 delete the draft and exit
60 .TP \w'refilezzzzfolderz'u
61 .B attach files
62 add the named files to the draft as MIME attachments
63 .TP \w'refilezzzzfolderz'u
64 .B alist
65 list the MIME attachments
66 .TP \w'refilezzzzfolderz'u
67 .B detach numbers
68 remove MIME attachments by number
69 .RE
70 .PP
71 When entering your response, you need only type enough characters
72 to uniquely identify the response.
73 .PP
74 For the
75 .B edit
76 response, any valid switch to the editor is valid.
77 .PP
78 For the
79 .B send
80 response, any valid switch to
81 .BR send (1)
82 is valid.
83 .PP
84 For the
85 .B refile
86 response, any valid switch to
87 .B refile
88 is valid.
89 .PP
90 See
91 .BR mh\-profile (5)
92 for further information about how editors
93 are used by
94 .BR mmh .
95 It also discusses how environment variables can be
96 used to direct
97 .BR whatnow 's
98 actions in complex ways.
99 .PP
100 If the initial edit fails, no new draft is created, but any
101 existing re-used draft is preserved.
102 Failures of later edits are ignored and another prompt is printed.
103 .PP
104 Consult the
105 .BR mh-draft (7)
106 man page for more
107 information.
108
109 .SH FILES
110 .fc ^ ~
111 .nf
112 .ta \w'%etcdir%/ExtraBigFileName  'u
113 ^$HOME/.mmh/profile~^The user profile
114 ^+drafts~^The draft folder
115 .fi
116
117 .SH "PROFILE COMPONENTS"
118 .fc ^ ~
119 .nf
120 .ta 2.4i
121 .ta \w'ExtraBigProfileName  'u
122 ^Path:~^To determine the user's mail storage
123 ^Draft\-Folder:~^To set the default draft\-folder
124 ^Editor:~^To override the default editor
125 ^<lasteditor>\-next:~^To name an editor to be used after exit
126 ^~^from <lasteditor>
127 ^listproc:~^Program to list the contents of a message
128 .fi
129
130 .SH "SEE ALSO"
131 send(1)
132
133 .SH CONTEXT
134 None