Added all of the MH sources, including RCS files, in
[mmh] / docs / historical / mh-6.8.5 / conf / doc / RCS / rmm.rf,v
1 head     1.10;
2 branch   ;
3 access   ;
4 symbols  ;
5 locks    ; strict;
6 comment  @@;
7
8
9 1.10
10 date     91.01.25.15.22.28;  author mh;  state Exp;
11 branches ;
12 next     1.9;
13
14 1.9
15 date     91.01.14.16.42.57;  author mh;  state Exp;
16 branches ;
17 next     1.8;
18
19 1.8
20 date     90.12.18.15.46.24;  author mh;  state Exp;
21 branches ;
22 next     1.7;
23
24 1.7
25 date     90.12.18.15.38.47;  author mh;  state Exp;
26 branches ;
27 next     1.6;
28
29 1.6
30 date     90.12.18.15.27.24;  author mh;  state Exp;
31 branches ;
32 next     1.5;
33
34 1.5
35 date     90.04.05.15.15.12;  author sources;  state Exp;
36 branches ;
37 next     1.4;
38
39 1.4
40 date     90.03.22.11.31.49;  author sources;  state Exp;
41 branches ;
42 next     1.3;
43
44 1.3
45 date     90.03.20.19.42.31;  author sources;  state Exp;
46 branches ;
47 next     1.2;
48
49 1.2
50 date     90.03.20.17.36.46;  author sources;  state Exp;
51 branches ;
52 next     1.1;
53
54 1.1
55 date     90.03.20.17.21.28;  author sources;  state Exp;
56 branches ;
57 next     ;
58
59
60 desc
61 @@
62
63
64 1.10
65 log
66 @jlr
67 @
68 text
69 @.\"    @@(MHWARNING)
70 .\" @@(#)$Id: rmm.rf,v 1.9 91/01/14 16:42:57 mh Exp Locker: mh $
71 .SC RMM 1
72 .NA
73 rmm \- remove messages
74 .SY
75 rmm
76 \%[+folder] \%[msgs]
77 \%[\-help]
78 .DE
79 \fIRmm\fR removes the specified messages by renaming the message
80 files with preceding commas.  Many sites consider files that start with a 
81 comma to be a temporary backup, and arrange for \fIcron\fR\0(8)
82 to remove such files once a day.
83
84 If the user has a profile component such as
85
86         rmmproc:        /bin/rm
87
88 then instead of simply renaming the message file,
89 \fIrmm\fR
90 will call the named program to delete the file.
91 Note that at most installations, 
92 \fIcron\fR\0(8) is told to remove files that begin with a comma once a night.
93
94 Some users of csh prefer the following:
95
96         alias rmm 'refile +d'
97
98 where folder +d is a folder for deleted messages, and
99
100         alias mexp 'rm `mhpath +d all`'
101
102 is used to \*(lqexpunge\*(rq deleted messages.
103
104 The current message is not changed by \fIrmm\fR, so a \fInext\fR  will
105 advance to the next message in the folder as expected.
106 .Fi
107 ^$HOME/\&.mh\(ruprofile~^The user profile
108 .Pr
109 ^Path:~^To determine the user's MH directory
110 .Ps
111 ^Current\-Folder:~^To find the default current folder
112 .Ps
113 ^rmmproc:~^Program to delete the message
114 .Sa
115 rmf(1)
116 .De
117 `+folder' defaults to the current folder
118 .Ds
119 `msgs' defaults to cur
120 .Co
121 If a folder is given, it will become the current folder.
122 .Bu
123 Since \fIrefile\fR uses your \fIrmmproc\fP to delete the message,
124 the \fIrmmproc\fP must \fBNOT\fP call \fIrefile\fP without
125 specifying `\-normmproc',
126 or you will create an infinte loop.
127 .En
128 @
129
130
131 1.9
132 log
133 @document refile -[no]rmmproc
134 jlr
135 @
136 text
137 @d2 1
138 a2 1
139 .\" @@(#)$Id: rmm.rf,v 1.8 90/12/18 15:46:24 mh Exp Locker: mh $
140 a53 14
141 .Hh
142 If you're not a csh user, and you have an \fIrmmproc\fP script
143 which \fIrefile\fP\|s messages,
144 be sure you use something like:
145
146 .ti +.5i
147 mv `mhpath msgs` `mhpath new +folder`
148
149 Other work-arounds are possible, such as:
150
151 .ti +.5i
152 cd `mhpath +`
153 .ti +.5i
154 MH=/dev/null MHCONTEXT=/dev/null refile $* +folder
155 @
156
157
158 1.8
159 log
160 @jlr
161 @
162 text
163 @d2 1
164 a2 1
165 .\" @@(#)$Id: rmm.rf,v 1.7 90/12/18 15:38:47 mh Exp Locker: mh $
166 d70 2
167 a71 1
168 the \fIrmmproc\fP must \fBNOT\fP call \fIrefile\fP,
169 @
170
171
172 1.7
173 log
174 @give tricky example rmmproc
175 jlr
176 @
177 text
178 @d2 1
179 a2 1
180 .\" @@(#)$Id: rmm.rf,v 1.6 90/12/18 15:27:24 mh Exp Locker: mh $
181 d55 1
182 a55 1
183 If you're not a csh user, and you have an \*(lqrmmproc\*(rq script
184 d69 2
185 a70 2
186 Since \fIrefile\fR uses your \*(lqrmmproc\*(rq to delete the message,
187 the \*(lqrmmproc\*(rq must \fBNOT\fP call \fIrefile\fP,
188 @
189
190
191 1.6
192 log
193 @mention not calling refile as rmmproc.
194 jlr
195 @
196 text
197 @d2 1
198 a2 1
199 .\" @@(#)$Id: rmm.rf,v 1.5 90/04/05 15:15:12 sources Exp Locker: mh $
200 d61 7
201 @
202
203
204 1.5
205 log
206 @add ID
207 @
208 text
209 @d2 1
210 a2 1
211 .\" @@(#)$Id:$
212 d54 11
213 @
214
215
216 1.4
217 log
218 @put things back, do .NA stuff another way
219 @
220 text
221 @d2 1
222 @
223
224
225 1.3
226 log
227 @typo
228 @
229 text
230 @d2 2
231 a3 2
232 .TH RMM 1 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
233 .SH .NA
234 d5 1
235 a5 1
236 .SH .SY
237 @
238
239
240 1.2
241 log
242 @fixup for makewhatis
243 @
244 text
245 @d2 1
246 a2 1
247 .TH RMM 1 [mh.6] MH
248 @
249
250
251 1.1
252 log
253 @Initial revision
254 @
255 text
256 @d2 2
257 a3 2
258 .SC RMM 1
259 .NA
260 d5 1
261 a5 1
262 .SY
263 @