Function: mh-refile-msg

mh-refile-msg is an autoloaded, interactive and byte-compiled function defined in mh-folder.el.gz.

Signature

(mh-refile-msg RANGE FOLDER &optional DONT-UPDATE-LAST-DESTINATION-FLAG)

Documentation

Refile (output) RANGE into FOLDER.

You are prompted for the folder name. Note that this command can also be used to create folders. If you specify a folder that does not exist, you will be prompted to create it.

The hook mh-refile-msg-hook is called after a message is marked to be refiled.

Check the documentation of mh-interactive-range to see how RANGE is read in interactive use.

In a program, the variables mh-last-destination and mh-last-destination-folder are not updated if DONT-UPDATE-LAST-DESTINATION-FLAG is non-nil.

Key Bindings

Aliases

mh-alt-refile-msg

Source Code

;; Defined in /usr/src/emacs/lisp/mh-e/mh-folder.el.gz
;;;###mh-autoload
(defun mh-refile-msg (range folder &optional dont-update-last-destination-flag)
  "Refile (output) RANGE into FOLDER.

You are prompted for the folder name. Note that this command can also
be used to create folders. If you specify a folder that does not
exist, you will be prompted to create it.

The hook `mh-refile-msg-hook' is called after a message is marked to
be refiled.

Check the documentation of `mh-interactive-range' to see how RANGE is
read in interactive use.

In a program, the variables `mh-last-destination' and
`mh-last-destination-folder' are not updated if
DONT-UPDATE-LAST-DESTINATION-FLAG is non-nil."
  (interactive (list (mh-interactive-range "Refile")
                     (intern (mh-prompt-for-refile-folder))))
  (unless dont-update-last-destination-flag
    (setq mh-last-destination (cons 'refile folder)
          mh-last-destination-folder mh-last-destination))
  (mh-iterate-on-range () range
    (mh-refile-a-msg nil folder))
  (when (looking-at mh-scan-refiled-msg-regexp) (mh-next-msg)))