refile(1)refile(1)NAMErefile - file message in other folders (only available within the mes‐
sage handling system, mh)
SYNOPSISrefile [msgs] [+folder] [options]
OPTIONS
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. 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 mes‐
sage. 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. Prints a list of the valid options to this command. 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. 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. 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 num‐
ber 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 speci‐
fied; 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 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
The following example refiles messages 3 and 5 in the folder +records:
% refile 3 5 +records The next example files the current message into
two folders: % refile +jones +map 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 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
The user profile.
SEE ALSOfolder(1), mark(1), mh_profile(4)refile(1)