X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/95e9c4e6befb17ca3e691c26f024fb55eeae5e31..c525020c77134b8832587755b7c05764a0516d80:/man/refile.man

diff --git a/man/refile.man b/man/refile.man
index 2cbec305..b6b1fb39 100644
--- a/man/refile.man
+++ b/man/refile.man
@@ -1,4 +1,4 @@
-.TH REFILE %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH REFILE %manext1% "March 18, 2013" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
@@ -7,11 +7,14 @@ refile \- file message in other folders
 .SH SYNOPSIS
 .HP 5
 .na
-.B refile 
+.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 ]
@@ -22,11 +25,9 @@ refile \- file message in other folders
 .RB [ \-normmproc ]
 .I +folder1
 \&...
-.RB [ \-version ]
-.RB [ \-help ]
 .ad
 .SH DESCRIPTION
-.B Refile
+.B refile
 moves (see
 .IR mv (1))
 or links (see
@@ -103,7 +104,7 @@ whereas,
 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
@@ -113,6 +114,14 @@ switch, then
 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
@@ -169,7 +178,7 @@ to file the <mh\-dir>/draft.
 .SH FILES
 .fc ^ ~
 .nf
-.ta \w'%etcdir%/ExtraBigFileName  'u
+.ta \w'%nmhetcdir%/ExtraBigFileName  'u
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
 .SH "PROFILE COMPONENTS"
@@ -184,6 +193,7 @@ to file the <mh\-dir>/draft.
 .fi
 .SH "SEE ALSO"
 .IR folder (1),
+.IR mh-sequence (5),
 .IR rmf (1),
 .IR rmm (1)
 .SH DEFAULTS
@@ -193,6 +203,7 @@ to file the <mh\-dir>/draft.
 .RB ` \-nolink '
 .RB ` \-nounlink '
 .RB ` \-nopreserve '
+.RB ` \-noretainsequences '
 .fi
 .SH CONTEXT
 If
@@ -215,7 +226,9 @@ for information concerning the previous sequence.
 .SH BUGS
 Since
 .B refile
-uses your
+and
+.B rmm
+use your
 .I rmmproc
 to delete the message,
 the
@@ -224,6 +237,8 @@ must
 .B NOT
 call
 .B refile
+or
+.B rmm
 without specifying
 .BR \-normmproc ,
 or you will create an infinite loop.