REFILE(1MH)             COMMAND REFERENCE             REFILE(1MH)



NAME
     refile - file message(s) in (an)other folder(s)

SYNOPSIS
     refile [ -ask ] [ -noask ] [ [-file file] | [msgs] ] [ -help
     ] [ -link ] [ -nolink ]
     [ -preserve ] [ -nopreserve ] [ -src +folder ] +folder ...

DESCRIPTION
     Refile moves or links mail messages from one mail folder
     into one or more other mail folders (see mv(1) and ln(1)).
     The folder that the messages come from is called the source
     folder, while the other folders are called destination
     folders.  When a message is filed, it is linked into the
     destination folder(s) if possible, and is copied otherwise.

     If the destination folders are all on the same file system,
     multiple filing causes little storage overhead.  This is a
     good way to cross-file or multiply-index messages.

     If a destination folder doesn't exist, refile asks if you
     want to create one.  If you respond with no the refile is
     aborted.

     Your .mh_profile can contain the following entries:

          Path:        To determine the user's MH directory

          Current-Folder:
                       To find the default current folder

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

     Refile has the following defaults:

          -ask
          -nolink
          -nopreserve
          msgs           defaults to the current message
          -src +folder   defaults to the current folder

     You can use the keyword all as the msgs argument to refile
     all the mail messages in a mail folder. See the EXAMPLES
     section.

OPTIONS
     -ask    If the destination folder doesn't exist, refile asks
             you if you want to create the folder.

     -noask  If the destination folder doesn't exist, refile
             creates it without asking for confirmation.



Printed 4/6/89                                                  1

REFILE(1MH)             COMMAND REFERENCE             REFILE(1MH)



     -file file
             Move or link file into the destination folder. Note
             that file doesn't have to be in a mail folder; it
             can be in any directory.

     -help   Print a message showing how to use refile.

     -link   Preserve the mail message in the source folder.  (it
             does a link, ln(1), rather than a move, mv(1)).  If
             neither -link nor the keyword all are specified, the
             last message specified becomes the current message.
             Otherwise, the current message is left unchanged.

     -nolink Delete the filed messages from the source folder
             after copying them to the destination folder.

     -preserve
             Overrides the message renaming conventions.
             Normally, when a message is filed, it is assigned
             the next highest number available in each of the
             destination folders.  With this option naming
             conflicts may occur, so use this switch cautiously.
             (See pick(1) for more details on message numbering.)

     -src +folder
             Take the specified mail messages from folder.
             Folder becomes the current folder for future MH
             commands.

EXAMPLES
     If a message is received from Jones about the ARPA Map
     Project, the following instruction allows the message to be
     found in either of the two folders jones or Map:

          refile cur +jones +Map

     The following example moves all the mail messages from the
     folder inbox to the folder savebox:

          refile all -nolink -src +inbox +savebox

FILES
     $HOME/.mh_profile
                    The user profile

SEE ALSO
     comp(1mh), folder(1mh), forw(1mh), inc(1mh), mail(1mh),
     next(1mh), pick(1mh), prev(1mh), prompter(1mh), refile(1mh),
     repl(1mh), rmf(1mh), rmm(1mh), scan(1mh), send(1mh), and
     show(1mh).





Printed 4/6/89                                                  2

%%index%%
na:336,99;
sy:435,909;
de:1344,2166;
op:3510,534;4452,1820;
ex:6272,500;
fi:6772,145;
se:6917,520;
%%index%%000000000132