refile(1mh)refile(1mh)Namerefile - file message in other folders
Syntaxrefile [ msgs ] [ +folder ] [ options ]
Description
Use the 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 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, will also define
those sequences for the destination folders. See for information con‐
cerning the previous sequence.
Options-draft Refiles the draft message, or the current message in your
folder, if you have one set up. You cannot give a msgs argu‐
ment 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 min‐
imum 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,
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. Nor‐
mally, when a message is refiled in to another folder, it is
set to the next available number in that folder. The -pre‐
serve 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 alter‐
native source folder.
Examples
The following example refiles messages 3 and 5 in the folder
% 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 folder. The message remains in the current folder as well as
appearing in the folder.
% refile-link 13 +test
The next example takes a message from the folder when it is not the
current folder, and places it in the folder
% refile 3 -src +test +outbox
Profile Components
Path: To determine your Mail directory
Folder-Protect: To set protections when creating a new folder
rmmproc: Program to delete the message
Files
The user profile.
See Alsofolder(1mh), mark(1mh), mh_profile(5mh)refile(1mh)