4.4BSD/usr/src/contrib/mh-6.8/conf/doc/rmf.rf

.\"	@(MHWARNING)
.\" @(#)$Id: rmf.rf,v 1.7 1992/05/12 22:24:59 jromine Exp $
.SC RMF 1
.NA
rmf \- remove an MH folder
.SY
rmf 
\%[+folder]
\%[\-interactive] \%[\-nointeractive]
\%[\-help]
.DE
\fIRmf\fR removes all of the messages (files) within the specified
(or default) folder,
and then removes the folder (directory) itself.
If there are any files within the folder which are not a part of \fIMH\fR,
they will \fInot\fR be removed, and an error will be produced.
If the folder is given explicitly or the `\-nointeractive' option is given,
then the folder will be removed without confirmation.
Otherwise, the user will be asked for confirmation.
If \fIrmf\fR can't find the current folder, for some reason,
the folder to be removed defaults to `+inbox' (unless overridden by
user's profile entry \*(lqInbox\*(rq) with confirmation.

\fIRmf\fR irreversibly deletes messages that don't have other links,
so use it with caution.

If the folder being removed is a subfolder, the parent
folder will become the new current folder, and \fIrmf\fR will
produce a message telling the user this has happened.
This provides an easy mechanism for selecting a set of messages,
operating on the list, then removing the list and returning to
the current folder from which the list was extracted.

\fIRmf\fR of a read\-only folder will delete the private sequence
and cur information
(i.e., \*(lqatr\-\fIseq\fR\-\fIfolder\fR\*(rq entries)
from the profile without affecting the folder itself.
.Fi
^$HOME/\&.mh\(ruprofile~^The user profile
.Pr
^Path:~^To determine the user's MH directory
.Ps
^Current\-Folder:~^To find the default current folder
.Ps
^Inbox:~^To find the default inbox
.Sa
rmm(1)
.De
`+folder' defaults to the current folder, usually with confirmation
.Ds
`\-interactive' if +folder' not given, `\-nointeractive' otherwise
.Co
\fIRmf\fR will set the current folder to the parent folder if a
subfolder is removed; or if the current folder is removed,
it will make \*(lqinbox\*(rq current.
Otherwise, it doesn't change the
current folder or message.
.Bu
Although intuitively one would suspect that \fIrmf\fR works recursively,
it does not.
Hence if you have a sub\-folder within a folder,
in order to \fIrmf\fR the parent,
you must first \fIrmf\fR each of the children.
.En