Added context_find_prefix().

[nmh] / man / refile.man

diff --git a/man/refile.man b/man/refile.man
index 6d104c4208a753a9b640d8ded2b603fe57daa46a..d4dfbacc44100649cd4aaaba992babe37dda4c34 100644 (file)
--- a/man/refile.man
+++ b/man/refile.man
@@ -1,18 +1,18 @@
+.TH REFILE %manext1% "March 18, 2013" "%nmhversion%"
 .\"
 .\" %nmhwarning%
-.\" $Id$
 .\"
-.TH REFILE %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 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 ]
@@ -29,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
@@ -75,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
@@ -94,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.
@@ -104,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
@@ -114,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
@@ -167,14 +175,12 @@ The
 switch tells
 .B refile
 to file the <mh\-dir>/draft.
-
 .SH FILES
 .fc ^ ~
 .nf
-.ta \w'/usr/local/nmh/etc/ExtraBigFileName  'u
+.ta \w'%nmhetcdir%/ExtraBigFileName  'u
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
-
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
@@ -185,10 +191,11 @@ to file the <mh\-dir>/draft.
 ^Folder\-Protect:~^To set mode when creating a new folder
 ^rmmproc:~^Program to delete the message
 .fi
-
 .SH "SEE ALSO"
-folder(1), rmf(1), rmm(1)
-
+.IR folder (1),
+.IR mh-sequence (5),
+.IR rmf (1),
+.IR rmm (1)
 .SH DEFAULTS
 .nf
 .RB ` "\-src\ +folder" "' defaults to the current folder"
@@ -196,8 +203,8 @@ folder(1), rmf(1), rmm(1)
 .RB ` \-nolink '
 .RB ` \-nounlink '
 .RB ` \-nopreserve '
+.RB ` \-noretainsequences '
 .fi
-
 .SH CONTEXT
 If
 .B \-src
@@ -216,11 +223,12 @@ will also define
 those sequences for the destination folders.  See
 .B mh\-sequence (5)
 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
@@ -229,6 +237,8 @@ must
 .B NOT
 call
 .B refile
+or
+.B rmm
 without specifying
 .BR \-normmproc ,
 or you will create an infinite loop.