5 .\" include the -mh macro file
8 .TH RMF %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
10 rmf \- remove an nmh folder
16 \%[\-interactive] \%[\-nointeractive]
22 \fIRmf\fR removes all of the messages (files) within the specified
23 (or default) folder, and then removes the folder (directory) itself.
25 If there are any files within the folder which are not a part of
26 \fInmh\fR, they will \fInot\fR be removed, and an error will be produced.
27 If the folder is given explicitly or the `\-nointeractive' option is
28 given, then the folder will be removed without confirmation. Otherwise,
29 the user will be asked for confirmation. If \fIrmf\fR can't find the
30 current folder, for some reason, the folder to be removed defaults to
31 `+inbox' (unless overridden by user's profile entry \*(lqInbox\*(rq)
34 If the folder being removed is a subfolder, the parent folder will become
35 the new current folder, and \fIrmf\fR will produce a message telling the
36 user this has happened. This provides an easy mechanism for selecting
37 a set of messages, operating on the list, then removing the list and
38 returning to the current folder from which the list was extracted.
40 If \fIrmf\fR is used on a read\-only folder, it will delete all the
42 (i.e., \*(lqatr\-\fIseq\fR\-\fIfolder\fR\*(rq entries) for this folder
43 from your context without affecting the folder itself.
45 \fIRmf\fR irreversibly deletes messages that don't have other links, so
48 ^$HOME/\&.mh\(ruprofile~^The user profile
50 ^Path:~^To determine the user's nmh directory
52 ^Current\-Folder:~^To find the default current folder
54 ^Inbox:~^To find the default inbox
58 `+folder' defaults to the current folder, usually with confirmation
60 `\-interactive' if +folder' not given, `\-nointeractive' otherwise
62 \fIRmf\fR will set the current folder to the parent folder if a
63 subfolder is removed; or if the current folder is removed, it will make
64 \*(lqinbox\*(rq current. Otherwise, it doesn't change the current folder
67 Although intuitively one would suspect that \fIrmf\fR works recursively,
68 it does not. Hence if you have a sub\-folder within a folder, in order
69 to \fIrmf\fR the parent, you must first \fIrmf\fR each of the children.