Added all of the MH sources, including RCS files, in
[mmh] / docs / historical / mh-6.8.5 / conf / doc / RCS / rmf.rf,v
1 head    1.7;
2 access;
3 symbols;
4 locks; strict;
5
6
7 1.7
8 date    92.05.12.22.24.59;      author jromine; state Exp;
9 branches;
10 next    1.6;
11
12 1.6
13 date    92.02.04.00.05.10;      author jromine; state Exp;
14 branches;
15 next    1.5;
16
17 1.5
18 date    90.04.05.15.15.06;      author sources; state Exp;
19 branches;
20 next    1.4;
21
22 1.4
23 date    90.03.22.11.31.48;      author sources; state Exp;
24 branches;
25 next    1.3;
26
27 1.3
28 date    90.03.20.19.42.30;      author sources; state Exp;
29 branches;
30 next    1.2;
31
32 1.2
33 date    90.03.20.17.36.44;      author sources; state Exp;
34 branches;
35 next    1.1;
36
37 1.1
38 date    90.03.20.17.21.27;      author sources; state Exp;
39 branches;
40 next    ;
41
42
43 desc
44 @@
45
46
47 1.7
48 log
49 @put "MH" in title
50 @
51 text
52 @.\"    @@(MHWARNING)
53 .\" @@(#)$Id: rmf.rf,v 1.6 1992/02/04 00:05:10 jromine Exp jromine $
54 .SC RMF 1
55 .NA
56 rmf \- remove an MH folder
57 .SY
58 rmf 
59 \%[+folder]
60 \%[\-interactive] \%[\-nointeractive]
61 \%[\-help]
62 .DE
63 \fIRmf\fR removes all of the messages (files) within the specified
64 (or default) folder,
65 and then removes the folder (directory) itself.
66 If there are any files within the folder which are not a part of \fIMH\fR,
67 they will \fInot\fR be removed, and an error will be produced.
68 If the folder is given explicitly or the `\-nointeractive' option is given,
69 then the folder will be removed without confirmation.
70 Otherwise, the user will be asked for confirmation.
71 If \fIrmf\fR can't find the current folder, for some reason,
72 the folder to be removed defaults to `+inbox' (unless overridden by
73 user's profile entry \*(lqInbox\*(rq) with confirmation.
74
75 \fIRmf\fR irreversibly deletes messages that don't have other links,
76 so use it with caution.
77
78 If the folder being removed is a subfolder, the parent
79 folder will become the new current folder, and \fIrmf\fR will
80 produce a message telling the user this has happened.
81 This provides an easy mechanism for selecting a set of messages,
82 operating on the list, then removing the list and returning to
83 the current folder from which the list was extracted.
84
85 \fIRmf\fR of a read\-only folder will delete the private sequence
86 and cur information
87 (i.e., \*(lqatr\-\fIseq\fR\-\fIfolder\fR\*(rq entries)
88 from the profile without affecting the folder itself.
89 .Fi
90 ^$HOME/\&.mh\(ruprofile~^The user profile
91 .Pr
92 ^Path:~^To determine the user's MH directory
93 .Ps
94 ^Current\-Folder:~^To find the default current folder
95 .Ps
96 ^Inbox:~^To find the default inbox
97 .Sa
98 rmm(1)
99 .De
100 `+folder' defaults to the current folder, usually with confirmation
101 .Ds
102 `\-interactive' if +folder' not given, `\-nointeractive' otherwise
103 .Co
104 \fIRmf\fR will set the current folder to the parent folder if a
105 subfolder is removed; or if the current folder is removed,
106 it will make \*(lqinbox\*(rq current.
107 Otherwise, it doesn't change the
108 current folder or message.
109 .Bu
110 Although intuitively one would suspect that \fIrmf\fR works recursively,
111 it does not.
112 Hence if you have a sub\-folder within a folder,
113 in order to \fIrmf\fR the parent,
114 you must first \fIrmf\fR each of the children.
115 .En
116 @
117
118
119 1.6
120 log
121 @contributed patch
122 @
123 text
124 @d2 1
125 a2 1
126 .\" @@(#)$Id: rmf.rf,v 1.5 1990/04/05 15:15:06 sources Exp jromine $
127 d5 1
128 a5 1
129 rmf \- remove folder
130 @
131
132
133 1.5
134 log
135 @add ID
136 @
137 text
138 @d2 1
139 a2 1
140 .\" @@(#)$Id:$
141 d21 2
142 a22 1
143 the folder to be removed defaults to `+inbox' with confirmation.
144 d44 2
145 @
146
147
148 1.4
149 log
150 @put things back, do .NA stuff another way
151 @
152 text
153 @d2 1
154 @
155
156
157 1.3
158 log
159 @typo
160 @
161 text
162 @d2 2
163 a3 2
164 .TH RMF 1 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
165 .SH .NA
166 d5 1
167 a5 1
168 .SH .SY
169 @
170
171
172 1.2
173 log
174 @fixup for makewhatis
175 @
176 text
177 @d2 1
178 a2 1
179 .TH RMF 1 [mh.6] MH
180 @
181
182
183 1.1
184 log
185 @Initial revision
186 @
187 text
188 @d2 2
189 a3 2
190 .SC RMF 1
191 .NA
192 d5 1
193 a5 1
194 .SY
195 @