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