Merge branch 'tmpfiles'

[nmh] / man / refile.man

diff --git a/man/refile.man b/man/refile.man
index d6799f01fb4b51a9df169f297ef3e38c9932d2e5..213f5747aaa88699f8c53cbf6ad97b4727648822 100644 (file)
--- 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,12 @@ refile \- file message in other folders
 .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 ]
@@ -28,9 +29,9 @@ refile \- file message in other folders
 .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
@@ -74,7 +75,7 @@ be in mail drop format
 .B nmh
 messages,
 see
-.BR inc (1)).
+.IR inc (1)).
 .PP
 If a destination folder doesn't exist,
 .B refile
@@ -93,9 +94,9 @@ The option
 .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.
@@ -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,11 @@ switch, then
 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
@@ -184,6 +190,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 +200,7 @@ to file the <mh\-dir>/draft.
 .RB ` \-nolink '
 .RB ` \-nounlink '
 .RB ` \-nopreserve '
+.RB ` \-noretainsequences '
 .fi
 .SH CONTEXT
 If
@@ -215,7 +223,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 +234,8 @@ must
 .B NOT
 call
 .B refile
+or
+.B rmm
 without specifying
 .BR \-normmproc ,
 or you will create an infinite loop.