]> diplodocus.org Git - nmh/blobdiff - man/refile.man
Added test case for commit 4318012376e06229307c0ed4f62a00faae9edc63.
[nmh] / man / refile.man
index 484188650515473f0bf0fff41d5599957db5b2d3..b6b1fb39ac0dc3cf3e54b768be12a88edabdc527 100644 (file)
@@ -1,4 +1,4 @@
-.TH REFILE %manext1% "January 18, 2001" "%nmhversion%"
+.TH REFILE %manext1% "March 18, 2013" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
 .\"
 .\" %nmhwarning%
 .\"
@@ -8,6 +8,8 @@ refile \- file message in other folders
 .HP 5
 .na
 .B refile
 .HP 5
 .na
 .B refile
+.RB [ \-help ]
+.RB [ \-version ]
 .RI [ msgs ]
 .RB [ \-draft ]
 .RB [ \-link " | " \-nolink ]
 .RI [ msgs ]
 .RB [ \-draft ]
 .RB [ \-link " | " \-nolink ]
@@ -23,11 +25,9 @@ refile \- file message in other folders
 .RB [ \-normmproc ]
 .I +folder1
 \&...
 .RB [ \-normmproc ]
 .I +folder1
 \&...
-.RB [ \-version ]
-.RB [ \-help ]
 .ad
 .SH DESCRIPTION
 .ad
 .SH DESCRIPTION
-.B Refile
+.B refile
 moves (see
 .IR mv (1))
 or links (see
 moves (see
 .IR mv (1))
 or links (see
@@ -114,10 +114,13 @@ switch, then
 will use the next available message number
 which is above the message number you wish to preserve.
 .PP
 will use the next available message number
 which is above the message number you wish to preserve.
 .PP
-The
+As message sequences are folder-specific,
+moving the message from the source folder removes it from all its
+sequences in that folder.
 .B \-retainsequences
 .B \-retainsequences
-switch causes the memberships in sequences, except \*(lqcur\*(rq, of
-the refiled messages to be carried over to each destination folder.
+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
 .PP
 If
 .B \-link
@@ -175,7 +178,7 @@ to file the <mh\-dir>/draft.
 .SH FILES
 .fc ^ ~
 .nf
 .SH FILES
 .fc ^ ~
 .nf
-.ta \w'%etcdir%/ExtraBigFileName  'u
+.ta \w'%nmhetcdir%/ExtraBigFileName  'u
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
 .SH "PROFILE COMPONENTS"
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
 .SH "PROFILE COMPONENTS"
@@ -223,7 +226,9 @@ for information concerning the previous sequence.
 .SH BUGS
 Since
 .B refile
 .SH BUGS
 Since
 .B refile
-uses your
+and
+.B rmm
+use your
 .I rmmproc
 to delete the message,
 the
 .I rmmproc
 to delete the message,
 the
@@ -232,6 +237,8 @@ must
 .B NOT
 call
 .B refile
 .B NOT
 call
 .B refile
+or
+.B rmm
 without specifying
 .BR \-normmproc ,
 or you will create an infinite loop.
 without specifying
 .BR \-normmproc ,
 or you will create an infinite loop.