--- /dev/null
+.\"
+.\" %nmhwarning%
+.\"
+.TH SORTM %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.SH NAME
+sortm \- sort messages
+.SH SYNOPSIS
+.HP 5
+.na
+.B sortm
+.RI [ +folder ]
+.RI [ msgs ]
+.RB [ \-datefield
+.IR field ]
+.RB [ \-textfield
+.IR field ]
+.RB [ \-notextfield ]
+.RB [ \-limit
+.IR days ]
+.RB [ \-nolimit ]
+.RB [ \-verbose " | " \-noverbose ]
+.RB [ \-version ]
+.RB [ \-help ]
+.ad
+.SH DESCRIPTION
+.B Sortm
+sorts the specified messages in the named folder according
+to the chronological order of the \*(lqDate:\*(rq field of each message.
+.PP
+The
+.B \-verbose
+switch directs
+.B sortm
+to tell the user the general
+actions that it is taking to place the folder in sorted order.
+.PP
+The
+.B \-datefield
+.I field
+switch tells
+.B sortm
+the name of the field to
+use when making the date comparison. If the user has a special field in
+each message, such as \*(lqBB\-Posted:\*(rq or \*(lqDelivery\-Date:\*(rq,
+then the
+.B \-datefield
+switch can be used to direct
+.B sortm
+which field to examine.
+.PP
+The
+.B \-textfield
+.I field
+switch causes
+.B sortm
+to sort messages
+by the specified text field. If this field is \*(lqsubject\*(rq, any
+leading "re:" is stripped off. In any case, all characters except
+letters and numbers are stripped and the resulting strings are sorted
+datefield\-major, textfield\-minor, using a case insensitive comparison.
+.PP
+With
+.B \-textfield
+.IR field ,
+if
+.B \-limit
+.I days
+is specified, messages
+with similar textfields that are dated within `days' of each other
+appear together. Specifying
+.B \-nolimit
+makes the limit infinity.
+With
+.B \-limit
+.IR 0 ,
+the sort is instead made textfield\-major, date\-minor.
+.PP
+For example, to order a folder by date-major, subject-minor, use:
+.PP
+.RS 5
+sortm -textfield subject +folder
+.RE
+
+.SH FILES
+.fc ^ ~
+.nf
+.ta \w'%etcdir%/ExtraBigFileName 'u
+^$HOME/.mmh/profile~^The user profile
+.fi
+
+.SH "PROFILE COMPONENTS"
+.fc ^ ~
+.nf
+.ta 2.4i
+.ta \w'ExtraBigProfileName 'u
+^Path:~^To determine the user's mail storage
+^Current\-Folder:~^To find the default current folder
+.fi
+
+.SH "SEE ALSO"
+folder(1)
+
+.SH DEFAULTS
+.nf
+.RB ` +folder "' defaults to the current folder"
+.RB ` msgs"' defaults to all"
+.RB ` \-datefield "' defaults to date"
+.RB ` \-notextfield '
+.RB ` \-noverbose '
+.RB ` \-nolimit '
+.fi
+
+.SH CONTEXT
+If a folder is given, it will become the current folder. If the current
+message is moved,
+.B sortm
+ will preserve its status as current.
+
+.SH HISTORY
+Timezones used to be ignored when comparing dates: they aren't any more.
+.PP
+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
+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
+numbering in a folder, use
+.RB \*(lq "folder\ \-pack" \*(rq
+as always.
+
+.SH BUGS
+If
+.B sortm
+encounters a message without a date\-field, or if the
+message has a date\-field that
+.B sortm
+cannot parse, then
+.B sortm
+attempts to keep the message in the same relative position. This does
+not always work. For instance, if the first message encountered lacks
+a date which can be parsed, then it will usually be placed at the end
+of the messages being sorted.
+.PP
+When
+.B sortm
+complains about a message which it can't temporally
+order, it complains about the message number
+.B prior
+to sorting.
+It should indicate what the message number will be
+.B after
+sorting.
projects / mmh / blobdiff