X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/2667af48dccbcb9e25709dea50451dd58d40aeae..b0aa8cdb1c264e42d4931ca24968689c73381278:/man/sortm.man diff --git a/man/sortm.man b/man/sortm.man index d31b89e6..a74ef785 100644 --- a/man/sortm.man +++ b/man/sortm.man @@ -1,4 +1,4 @@ -.TH SORTM %manext1% "October 11, 2012" "%nmhversion%" +.TH SORTM %manext1% "March 23, 2014" "%nmhversion%" .\" .\" %nmhwarning% .\" @@ -8,6 +8,8 @@ sortm \- sort messages .HP 5 .na .B sortm +.RB [ \-help ] +.RB [ \-version ] .RI [ +folder ] .RI [ msgs ] .RB [ \-all " | " \-noall ] @@ -21,11 +23,9 @@ sortm \- sort messages .RB [ \-nolimit ] .RB [ \-check " | " \-nocheck ] .RB [ \-verbose " | " \-noverbose ] -.RB [ \-version ] -.RB [ \-help ] .ad .SH DESCRIPTION -.B Sortm +.B sortm sorts the specified messages in the named folder according to the chronological order of the \*(lqDate:\*(rq field of each message. .PP @@ -36,7 +36,7 @@ switch is enabled, then .B sortm reports that as an error and exits with non-zero status. .B \-noall -is most useful in the user's profile, to avoid inadvertant sorting of +is most useful in the user's profile, to avoid inadvertent sorting of an entire folder. The .B \-all switch can then be used on the command line to disable it. Of course, @@ -112,10 +112,13 @@ messages, and exits with non-zero status. With the default of .B sortm sorts messages with a missing or invalid \*(lqDate:\*(rq field using their file modification times. +.PP +When ordering messages based on their dates, if they have the same +dates, their original message order is preserved. .SH FILES .fc ^ ~ .nf -.ta \w'%etcdir%/ExtraBigFileName 'u +.ta \w'%nmhetcdir%/ExtraBigFileName 'u ^$HOME/\&.mh\(ruprofile~^The user profile .fi .SH "PROFILE COMPONENTS" @@ -150,7 +153,7 @@ Timezones used to be ignored when comparing dates: they aren't any more. Messages which were in the folder, but not specified by `msgs', used to be moved to the end of the folder; now such messages are left untouched. .PP -.B Sortm +.B sortm sometimes did not preserve the message numbering in a folder (e.g., messages 1, 3, and 5, might have been renumbered to 1, 2, 3 after sorting). This was a bug, and has been fixed. To compress the message