-.TH REFILE %manext1% "January 18, 2001" "%nmhversion%"
+.TH REFILE %manext1% "March 18, 2013" "%nmhversion%"
.\"
.\" %nmhwarning%
.\"
.HP 5
.na
.B refile
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ msgs ]
.RB [ \-draft ]
.RB [ \-link " | " \-nolink ]
.RB [ \-preserve " | " \-nopreserve ]
+.RB [ \-retainsequences " | " \-noretainsequences ]
.RB [ \-unlink " | " \-nounlink ]
.RB [ \-src
.IR +folder ]
.RB [ \-normmproc ]
.I +folder1
\&...
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Refile
will use the next available message number
which is above the message number you wish to preserve.
.PP
+As message sequences are folder-specific,
+moving the message from the source folder removes it from all its
+sequences in that folder.
+.B \-retainsequences
+adds it to those same sequences in the destination folder,
+creating any that don't exist.
+This adding does not apply for the \*(lqcur\*(rq sequence.
+.PP
If
.B \-link
is not specified (or
.SH FILES
.fc ^ ~
.nf
-.ta \w'%etcdir%/ExtraBigFileName 'u
+.ta \w'%nmhetcdir%/ExtraBigFileName 'u
^$HOME/\&.mh\(ruprofile~^The user profile
.fi
.SH "PROFILE COMPONENTS"
.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.