return -1 if fork(2) fails in execprog
[mmh] / man / rmm.man1
1 .\"
2 .\" %nmhwarning%
3 .\"
4 .TH RMM %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
5 .SH NAME
6 rmm \- remove messages
7 .SH SYNOPSIS
8 .HP 5
9 .na
10 .B rmm
11 .RI [ +folder ]
12 .RI [ msgs ]
13 .RB [ \-unlink " | " \-nounlink ]
14 .RB [ \-Version ]
15 .RB [ \-help ]
16 .ad
17 .SH DESCRIPTION
18 By default,
19 .B rmm
20 will remove the specified messages by refiling them to the trash folder
21 `+trash'. The contents of this folder will then need to
22 be removed after a certain amount of time.
23 .PP
24 Alternately, if you wish for
25 .B rmm
26 to really remove the files
27 representing these messages, you can use the
28 .B \-unlink
29 switch.  But
30 messages removed by this method cannot be later recovered.
31 .PP
32 .RS 5
33 rmm \-unlink +trash a
34 .RE
35 .PP
36 can be used to expunge deleted messages.
37 .PP
38 The current message is not changed by
39 .BR rmm ,
40 so a
41 .B next
42  will
43 advance to the next message in the folder as expected.
44
45 .SH FILES
46 .fc ^ ~
47 .nf
48 .ta \w'%etcdir%/ExtraBigFileName  'u
49 ^$HOME/.mmh/profile~^The user profile
50 .fi
51
52 .SH "PROFILE COMPONENTS"
53 .fc ^ ~
54 .nf
55 .ta 2.4i
56 .ta \w'ExtraBigProfileName  'u
57 ^Path:~^To determine the user's mail storage
58 ^Current\-Folder:~^To find the default current folder
59 .fi
60
61 .SH "SEE ALSO"
62 refile(1), rmf(1)
63
64 .SH DEFAULTS
65 .nf
66 .RB ` +folder "' defaults to the current folder"
67 .RB ` msgs "' defaults to the current message"
68 .RB ` \-nounlink '
69 .fi
70
71 .SH CONTEXT
72 If a folder is given, it will become the current folder.