X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/2667af48dccbcb9e25709dea50451dd58d40aeae..872ef4dde72a88ceb1358849a462f791135b842d:/man/sortm.man

diff --git a/man/sortm.man b/man/sortm.man
index d31b89e6..9c556417 100644
--- a/man/sortm.man
+++ b/man/sortm.man
@@ -1,13 +1,15 @@
-.TH SORTM %manext1% "October 11, 2012" "%nmhversion%"
-.\"
+.TH SORTM %manext1% 2014-03-23 "%nmhversion%"
+.
 .\" %nmhwarning%
-.\"
+.
 .SH NAME
-sortm \- sort messages
+sortm \- sort nmh messages
 .SH SYNOPSIS
 .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,
@@ -72,7 +72,7 @@ switch causes
 .B sortm
 to sort messages by the specified text field.  All characters except
 letters and numbers are stripped and the resulting strings are sorted
-datefield\-major, textfield\-minor, using a case insensitive
+datefield-major, textfield-minor, using a case insensitive
 comparison.  If this field is \*(lqsubject\*(rq, any leading "re:" is
 stripped off.
 .PP
@@ -90,7 +90,7 @@ makes the limit infinity.
 With
 .B \-limit
 .IR 0 ,
-the sort is instead simply textfield\-major.
+the sort is instead simply textfield-major.
 .PP
 For example, to order a folder by date-major, grouping messages with
 the same subject on the same date together, use:
@@ -112,11 +112,14 @@ 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
-^$HOME/\&.mh\(ruprofile~^The user profile
+.ta \w'%nmhetcdir%/ExtraBigFileName  'u
+^$HOME/.mh_profile~^The user profile
 .fi
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
@@ -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
@@ -162,7 +165,7 @@ When
 .B sortm
 complains about a message which it can't temporally
 order, it complains about the message number
-.B prior
+.I prior
 to sorting.
 It should indicate what the message number will be
 .B after