]> 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%
 .\"
@@ -8,6 +8,8 @@ refile \- file message in other folders
 .HP 5
 .na
 .B refile
+.RB [ \-help ]
+.RB [ \-version ]
 .RI [ msgs ]
 .RB [ \-draft ]
 .RB [ \-link " | " \-nolink ]
@@ -23,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
@@ -114,10 +114,13 @@ switch, then
 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
-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
@@ -175,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"
@@ -223,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
@@ -232,6 +237,8 @@ must
 .B NOT
 call
 .B refile
+or
+.B rmm
 without specifying
 .BR \-normmproc ,
 or you will create an infinite loop.