]> diplodocus.org Git - nmh/blobdiff - man/refile.man
mhstore(1) now obeys its -noverbose switch.
[nmh] / man / refile.man
index 6d104c4208a753a9b640d8ded2b603fe57daa46a..213f5747aaa88699f8c53cbf6ad97b4727648822 100644 (file)
@@ -1,18 +1,18 @@
+.TH REFILE %manext1% "March 18, 2013" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
 .\" %nmhwarning%
-.\" $Id$
 .\"
 .\"
-.TH REFILE %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 refile \- file message in other folders
 .SH SYNOPSIS
 .HP 5
 .na
 .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 ]
 .RI [ msgs ]
 .RB [ \-draft ]
 .RB [ \-link " | " \-nolink ]
 .RB [ \-preserve " | " \-nopreserve ]
+.RB [ \-retainsequences " | " \-noretainsequences ]
 .RB [ \-unlink " | " \-nounlink ]
 .RB [ \-src
 .IR +folder ]
 .RB [ \-unlink " | " \-nounlink ]
 .RB [ \-src
 .IR +folder ]
@@ -29,9 +29,9 @@ refile \- file message in other folders
 .SH DESCRIPTION
 .B Refile
 moves (see
 .SH DESCRIPTION
 .B Refile
 moves (see
-.BR mv (1))
+.IR mv (1))
 or links (see
 or links (see
-.BR ln (1))
+.IR ln (1))
 messages
 from a source folder into one or more destination folders.
 .PP
 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
 .B nmh
 messages,
 see
-.BR inc (1)).
+.IR inc (1)).
 .PP
 If a destination folder doesn't exist,
 .B refile
 .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
 .B \-link
 preserves the source folder copy of the message (i.e.,
 it does a
-.BR ln (1)
+.IR ln (1)
 rather than a
 rather than a
-.BR mv (1)),
+.IR mv (1)),
 whereas,
 .B \-nolink
 (the default) deletes the filed messages from the source folder.
 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
 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
 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,11 @@ 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
+.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
 If
 .B \-link
 is not specified (or
@@ -167,14 +172,12 @@ The
 switch tells
 .B refile
 to file the <mh\-dir>/draft.
 switch tells
 .B refile
 to file the <mh\-dir>/draft.
-
 .SH FILES
 .fc ^ ~
 .nf
 .SH FILES
 .fc ^ ~
 .nf
-.ta \w'/usr/local/nmh/etc/ExtraBigFileName  'u
+.ta \w'%etcdir%/ExtraBigFileName  'u
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
-
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
@@ -185,10 +188,11 @@ to file the <mh\-dir>/draft.
 ^Folder\-Protect:~^To set mode when creating a new folder
 ^rmmproc:~^Program to delete the message
 .fi
 ^Folder\-Protect:~^To set mode when creating a new folder
 ^rmmproc:~^Program to delete the message
 .fi
-
 .SH "SEE ALSO"
 .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"
 .SH DEFAULTS
 .nf
 .RB ` "\-src\ +folder" "' defaults to the current folder"
@@ -196,8 +200,8 @@ folder(1), rmf(1), rmm(1)
 .RB ` \-nolink '
 .RB ` \-nounlink '
 .RB ` \-nopreserve '
 .RB ` \-nolink '
 .RB ` \-nounlink '
 .RB ` \-nopreserve '
+.RB ` \-noretainsequences '
 .fi
 .fi
-
 .SH CONTEXT
 If
 .B \-src
 .SH CONTEXT
 If
 .B \-src
@@ -216,11 +220,12 @@ will also define
 those sequences for the destination folders.  See
 .B mh\-sequence (5)
 for information concerning the previous sequence.
 those sequences for the destination folders.  See
 .B mh\-sequence (5)
 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
@@ -229,6 +234,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.