X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/cbce5e434f84af560946e16709d3c2ad10eb8942..07661005b9a36338ab158bcbe7762788a1df4030:/man/refile.man?ds=sidebyside diff --git a/man/refile.man b/man/refile.man index 7fdaca8c..213f5747 100644 --- 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 @@ -183,7 +189,10 @@ to file the /draft. ^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" @@ -191,6 +200,7 @@ folder(1), rmf(1), rmm(1) .RB ` \-nolink ' .RB ` \-nounlink ' .RB ` \-nopreserve ' +.RB ` \-noretainsequences ' .fi .SH CONTEXT If @@ -213,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 @@ -222,6 +234,8 @@ must .B NOT call .B refile +or +.B rmm without specifying .BR \-normmproc , or you will create an infinite loop.