NAME

       rmf - remove an nmh folder

SYNOPSIS

       rmf [+folder] [-interactive | -nointeractive] [-version] [-help]

DESCRIPTION

       Rmf  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 nmh, they will not 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
       rmf can't find the current folder, for some reason, the folder to be removed defaults to `+inbox' (unless
       overridden by user's profile entry “Inbox”) with confirmation.

       If the folder being removed is a subfolder, the parent folder will become the new current folder, and rmf
       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.

       If rmf is used on a read-only folder, it will delete all the private  sequences  (i.e.,  “atr-seq-folder”
       entries) for this folder from your context without affecting the folder itself.

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

FILES

       $HOME/.mh_profile          The user profile

PROFILE COMPONENTS

       Path:                To determine the user's nmh directory
       Current-Folder:      To find the default current folder
       Inbox:               To find the default inbox

SEE ALSO

       rmm(1), folder(1)

DEFAULTS

       `+folder' defaults to the current folder, usually with confirmation
       `-interactive' if +folder' not given, `-nointeractive' otherwise

CONTEXT

       Rmf  will set the current folder to the parent folder if a subfolder is removed; or if the current folder
       is removed, it will make “inbox” current.  Otherwise, it doesn't change the current folder or message.

BUGS

       Although intuitively one would suspect that rmf works recursively, it does not.   Hence  if  you  have  a
       sub-folder within a folder, in order to rmf the parent, you must first rmf each of the children.

nmh-1.6                                         January 18, 2001                                        RMF(1mh)