0cf138fa246bd60c978e79511166991096b2993f
[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 renaming
21 the message files with preceding commas.  Such files will then need to
22 be removed in some manner after a certain amount of time.  Many sites
23 arrange for
24 .B cron
25 to remove these files once a day, so check
26 with your system administrator.
27 .PP
28 Alternately, if you wish for
29 .B rmm
30 to really remove the files
31 representing these messages, you can use the
32 .B \-unlink
33 switch.  But
34 messages removed by this method cannot be later recovered.
35 .PP
36 If you prefer a more sophisticated method of `removing' messages, you
37 can define the
38 .I rmmproc
39 profile component.  For example, you can
40 add a profile component such as
41 .PP
42 .RS 5
43 rmmproc:        /home/foouser/bin/rmm_msgs
44 .RE
45 .PP
46 then instead of simply renaming the message file,
47 .B rmm
48 will call
49 the named program or script to handle the files that represent the
50 messages to be deleted.
51 .PP
52 Some users of
53 .B csh
54 prefer the following:
55 .PP
56 .RS 5
57 alias rmm 'refile +d'
58 .RE
59 .PP
60 where folder `+d' is a folder for deleted messages, and
61 .PP
62 .RS 5
63 alias mexp 'rm `mhpath +d all`'
64 .RE
65 .PP
66 is used to \*(lqexpunge\*(rq deleted messages.
67 .PP
68 The current message is not changed by
69 .BR rmm ,
70 so a
71 .B next
72  will
73 advance to the next message in the folder as expected.
74
75 .SH FILES
76 .fc ^ ~
77 .nf
78 .ta \w'%etcdir%/ExtraBigFileName  'u
79 ^$HOME/.mmh/profile~^The user profile
80 .fi
81
82 .SH "PROFILE COMPONENTS"
83 .fc ^ ~
84 .nf
85 .ta 2.4i
86 .ta \w'ExtraBigProfileName  'u
87 ^Path:~^To determine the user's mail storage
88 ^Current\-Folder:~^To find the default current folder
89 ^rmmproc:~^Program to delete the message
90 .fi
91
92 .SH "SEE ALSO"
93 refile(1), rmf(1)
94
95 .SH DEFAULTS
96 .nf
97 .RB ` +folder "' defaults to the current folder"
98 .RB ` msgs "' defaults to cur"
99 .RB ` -nounlink '
100 .fi
101
102 .SH CONTEXT
103 If a folder is given, it will become the current folder.
104
105 .SH BUGS
106 Since
107 .B refile
108 uses your
109 .I rmmproc
110 to delete the message,
111 the
112 .I rmmproc
113 must
114 .B NOT
115 call
116 .B refile
117 without specifying
118 .BR \-normmproc ,
119 or you will create an infinte loop.