NAME

       refile - file messages in other folders

SYNOPSIS

       refile [msgs] [-link | -nolink] [-src +folder] [-file file] +folder1 ...  [-Version]
            [-help]

DESCRIPTION

       Refile moves (see mv(1)) or links (see ln(1)) messages from a source folder  into  one  or
       more destination folders.

       If  you  think  of  a message as a sheet of paper, this operation is not unlike filing the
       sheet of paper (or copies) in file cabinet folders.  When a message is filed, it is linked
       into  the  destination  folder(s)  if  possible,  and is copied otherwise.  As long as the
       destination folders are all on the same file system, multiple filing causes little storage
       overhead.   This  facility  provides  a good way to cross-file or multiply-index messages.
       For example, if a message is received from Jones about the ARPA Map Project, the command

            refile c +jones +Map

       would allow the message to be found in either of the two folders `jones' or `Map'.

       You may specify the source folder using -src +folder.  If this is not given,  the  current
       folder  is  used by default.  If no message is specified, then the current message is used
       by default.

       The option -file file directs refile to use the specified file as the source message to be
       filed,  rather  than  a  message  from  a  folder.  Note that the file should be a validly
       formatted message, just like any other mh message.  It should NOT be in mail  drop  format
       (to convert a file in mail drop format to a folder of mh messages, see inc(1)).

       If  a  destination  folder  doesn't  exist,  refile  will ask if you want to create it.  A
       negative response will abort the file operation.  If the standard input for refile is  not
       a  tty,  then  refile  will not ask any questions and will proceed as if the user answered
       `yes' to all questions.

       The option -link preserves the source folder copy of the message (i.e., it  does  a  ln(1)
       rather  than  a mv(1)), whereas, -nolink (the default) deletes the filed messages from the
       source folder.  No backups are kept, because the contents don't  vanish.   They  are  only
       moved to a new location.  To restore: refile the other way.

FILES

       $HOME/.mmh/profile         The user profile

PROFILE COMPONENTS

       Path:                To determine the user's mail storage
       Current-Folder:      To find the default current folder
       Folder-Protect:      To set mode when creating a new folder

SEE ALSO

       folder(1), rmf(1), rmm(1)

DEFAULTS

       `-src +folder' defaults to the current folder
       `msgs' defaults to the current message
       `-nolink'

CONTEXT

       If  -link  is  specified, the current message in the source folder will be set to the last
       message specified; otherwise, the current message won't be changed.

       If the `Previous-Sequence' profile entry  is  set,  in  addition  to  defining  the  named
       sequences  from  the  source  folder,  refile  will  also  define  those sequences for the
       destination  folders.   See  mh-sequence  (7)  for  information  concerning  the  previous
       sequence.

HISTORY

       Since  mmh-0.3,  refile  does never change the current folder.  (It used to change it when
       -src +folder was given, but this behavior had usability disadvantages.)