8 date 92.05.12.22.24.59; author jromine; state Exp;
13 date 92.02.04.00.05.10; author jromine; state Exp;
18 date 90.04.05.15.15.06; author sources; state Exp;
23 date 90.03.22.11.31.48; author sources; state Exp;
28 date 90.03.20.19.42.30; author sources; state Exp;
33 date 90.03.20.17.36.44; author sources; state Exp;
38 date 90.03.20.17.21.27; author sources; state Exp;
53 .\" @@(#)$Id: rmf.rf,v 1.6 1992/02/04 00:05:10 jromine Exp jromine $
56 rmf \- remove an MH folder
60 \%[\-interactive] \%[\-nointeractive]
63 \fIRmf\fR removes all of the messages (files) within the specified
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.
75 \fIRmf\fR irreversibly deletes messages that don't have other links,
76 so use it with caution.
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.
85 \fIRmf\fR of a read\-only folder will delete the private sequence
87 (i.e., \*(lqatr\-\fIseq\fR\-\fIfolder\fR\*(rq entries)
88 from the profile without affecting the folder itself.
90 ^$HOME/\&.mh\(ruprofile~^The user profile
92 ^Path:~^To determine the user's MH directory
94 ^Current\-Folder:~^To find the default current folder
96 ^Inbox:~^To find the default inbox
100 `+folder' defaults to the current folder, usually with confirmation
102 `\-interactive' if +folder' not given, `\-nointeractive' otherwise
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.
110 Although intuitively one would suspect that \fIrmf\fR works recursively,
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.
126 .\" @@(#)$Id: rmf.rf,v 1.5 1990/04/05 15:15:06 sources Exp jromine $
143 the folder to be removed defaults to `+inbox' with confirmation.
150 @put things back, do .NA stuff another way
164 .TH RMF 1 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
174 @fixup for makewhatis