-.TH REFILE %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH REFILE %manext1% "March 18, 2013" "%nmhversion%"
.\"
.\" %nmhwarning%
.\"
.SH SYNOPSIS
.HP 5
.na
-.B refile
+.B refile
.RI [ msgs ]
.RB [ \-draft ]
.RB [ \-link " | " \-nolink ]
.RB [ \-preserve " | " \-nopreserve ]
+.RB [ \-retainsequences " | " \-noretainsequences ]
.RB [ \-unlink " | " \-nounlink ]
.RB [ \-src
.IR +folder ]
.SH DESCRIPTION
.B Refile
moves (see
-.BR mv (1))
+.IR mv (1))
or links (see
-.BR ln (1))
+.IR ln (1))
messages
from a source folder into one or more destination folders.
.PP
.B nmh
messages,
see
-.BR inc (1)).
+.IR inc (1)).
.PP
If a destination folder doesn't exist,
.B refile
.B \-link
preserves the source folder copy of the message (i.e.,
it does a
-.BR ln (1)
+.IR ln (1)
rather than a
-.BR mv (1)),
+.IR mv (1)),
whereas,
.B \-nolink
(the default) deletes the filed messages from the source folder.
Normally when a message is refiled, for each destination folder it
is assigned the number which is one above the current highest message
number in that folder. Use of the
-.B \-preserv
+.B \-preserve
switch will override
this message renaming, and try to preserve the number of the message.
If a conflict for a particular folder occurs when using the
will use the next available message number
which is above the message number you wish to preserve.
.PP
+The
+.B \-retainsequences
+switch causes the memberships in sequences, except \*(lqcur\*(rq, of
+the refiled messages to be carried over to each destination folder.
+.PP
If
.B \-link
is not specified (or
.fi
.SH "SEE ALSO"
.IR folder (1),
+.IR mh-sequence (5),
.IR rmf (1),
.IR rmm (1)
.SH DEFAULTS
.RB ` \-nolink '
.RB ` \-nounlink '
.RB ` \-nopreserve '
+.RB ` \-noretainsequences '
.fi
.SH CONTEXT
If
.SH BUGS
Since
.B refile
-uses your
+and
+.B rmm
+use your
.I rmmproc
to delete the message,
the
.B NOT
call
.B refile
+or
+.B rmm
without specifying
.BR \-normmproc ,
or you will create an infinite loop.