Index for Section 1

Alphabetical listing for R

Bottom of page

refile(1)
NAME
  refile - file message in other folders (only available within the message
  handling system, mh)

SYNOPSIS
  refile [msgs] [+folder] [options]

OPTIONS
  -draft
      Refiles the draft message, or the current message in your +drafts
      folder, if you have one set up. You cannot give a msgs argument when
      you use this option.

  -file filename
      Moves a file into a folder. This option takes a file from its directory
      and places it in the named folder, as the next message in the folder.
      The file must be formatted as a legal mail message. This means that the
      message must have the minimum header fields separated from the body of
      the message by a blank line or a line of dashes.

  -help
      Prints a list of the valid options to this command.

  -link

  -nolink
      Keeps a copy of the message in the source folder. Normally, refile
      removes the messages from the original folder when it refiles them. The
      -link option keeps a copy in the original folder, as well as filing a
      copy in the new folder.

  -preserve

  -nopreserve
      Preserves the number of a message in the new folder. Normally, when a
      message is refiled in to another folder, it is set to the next
      available number in that folder. The -preserve option keeps the number
      of the message the same in the new folder as it had been in the old.

      You cannot have two messages with the same number in one folder, so you
      should use this option with care.

  -src +folder
      Specifies the source folder to take messages from. Normally, messages
      are refiled from the current folder into another folder. However, you
      can take messages from a different folder by using the -src +folder
      option to specify the alternative source folder.

DESCRIPTION
  Use the refile command to move the specified message from the current
  folder to another folder. You can refile messages in more than one folder
  by giving multiple folder names as arguments.

  If you do not specify a message, the current message is refiled. You can
  refile a message other than the current message by giving its number as a
  msgs argument. You can also refile more than one message at a time by
  specifying more than one message number, or a range of message numbers, or
  a message sequence. See mark(1) for more information on sequences.

  The current folder remains the same unless the -src option is specified; in
  that case, the source folder becomes current. Normally, the last message
  specified becomes the current message. However, if the -link option is
  used, the current message is not changed.

  If the Previous-Sequence: entry is set in the .mh_profile file, in addition
  to defining the named sequences from the source folder, refile will also
  define those sequences for the destination folders. See mh_profile(4) for
  information concerning the previous sequence.

PROFILE COMPONENTS
  Path: To determine your Mail directory

  Folder-Protect: To set protections when creating a new folder

  rmmproc: Program to delete the message

EXAMPLES
   1.  The following example refiles messages 3 and 5 in the folder +records:
	    % refile 3 5 +records

   2.  The next example files the current message into two folders:
	    % refile +jones +map

   3.  The next example takes message 13 in the current folder and refiles it
       in the +test folder. The message remains in the current folder as well
       as appearing in the +test folder.
	    % refile -link 13 +test

   4.  The next example takes a message from the folder +test when it is not
       the current folder, and places it in the folder +outbox:
	    % refile 3 -src +test +outbox

FILES
  $HOME/.mh_profile
      The user profile.

SEE ALSO
  folder(1), mark(1), mh_profile(4)

Index for Section 1

Alphabetical listing for R

Top of page