X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/0f1f3f43ff17248c7de3da2494614bc7a880f478..9f8418e870a70c264eda1598f2d470e5428c216d:/man/refile.man diff --git a/man/refile.man b/man/refile.man index a111046d..c006c763 100644 --- a/man/refile.man +++ b/man/refile.man @@ -1,4 +1,4 @@ -.TH REFILE %manext1% "January 18, 2001" "%nmhversion%" +.TH REFILE %manext1% "March 18, 2013" "%nmhversion%" .\" .\" %nmhwarning% .\" @@ -8,10 +8,13 @@ refile \- file message in other folders .HP 5 .na .B refile +.RB [ \-help ] +.RB [ \-version ] .RI [ msgs ] .RB [ \-draft ] .RB [ \-link " | " \-nolink ] .RB [ \-preserve " | " \-nopreserve ] +.RB [ \-retainsequences " | " \-noretainsequences ] .RB [ \-unlink " | " \-nounlink ] .RB [ \-src .IR +folder ] @@ -22,8 +25,6 @@ refile \- file message in other folders .RB [ \-normmproc ] .I +folder1 \&... -.RB [ \-version ] -.RB [ \-help ] .ad .SH DESCRIPTION .B Refile @@ -113,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 @@ -169,7 +178,7 @@ to file the /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" @@ -184,6 +193,7 @@ to file the /draft. .fi .SH "SEE ALSO" .IR folder (1), +.IR mh-sequence (5), .IR rmf (1), .IR rmm (1) .SH DEFAULTS @@ -193,6 +203,7 @@ to file the /draft. .RB ` \-nolink ' .RB ` \-nounlink ' .RB ` \-nopreserve ' +.RB ` \-noretainsequences ' .fi .SH CONTEXT If @@ -215,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 @@ -224,6 +237,8 @@ must .B NOT call .B refile +or +.B rmm without specifying .BR \-normmproc , or you will create an infinite loop.