-.TH SORTM %manext1% "March 23, 2014" "%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 ]
.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
.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
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:
.fc ^ ~
.nf
.ta \w'%nmhetcdir%/ExtraBigFileName 'u
-^$HOME/\&.mh\(ruprofile~^The user profile
+^$HOME/.mh_profile~^The user profile
.fi
.SH "PROFILE COMPONENTS"
.fc ^ ~
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
.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