For the mhstore -clobber test, cd to the Mail subdirectory so that
[mmh] / man / sortm.man
index 64d6654..47dcee3 100644 (file)
@@ -1,12 +1,12 @@
 .\"
 .\" %nmhwarning%
 .\"
 .\" %nmhwarning%
-.\" $Id$
 .\"
 .TH SORTM %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 sortm \- sort messages
 .SH SYNOPSIS
 .HP 5
 .\"
 .TH SORTM %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 sortm \- sort messages
 .SH SYNOPSIS
 .HP 5
+.na
 .B sortm
 .RI [ +folder ]
 .RI [ msgs ]
 .B sortm
 .RI [ +folder ]
 .RI [ msgs ]
@@ -21,6 +21,7 @@ sortm \- sort messages
 .RB [ \-verbose " | " \-noverbose ]
 .RB [ \-version ]
 .RB [ \-help ]
 .RB [ \-verbose " | " \-noverbose ]
 .RB [ \-version ]
 .RB [ \-help ]
+.ad
 .SH DESCRIPTION
 .B Sortm
 sorts the specified messages in the named folder according
 .SH DESCRIPTION
 .B Sortm
 sorts the specified messages in the named folder according
@@ -52,11 +53,11 @@ The
 .I field
 switch causes
 .B sortm
 .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
+to sort messages by the specified text field.  All characters except
 letters and numbers are stripped and the resulting strings are sorted
 letters and numbers are stripped and the resulting strings are sorted
-datefield\-major, textfield\-minor, using a case insensitive comparison.
+datefield\-major, textfield\-minor, using a case insensitive
+comparison.  If this field is \*(lqsubject\*(rq, any leading "re:" is
+stripped off.
 .PP
 With
 .B \-textfield
 .PP
 With
 .B \-textfield
@@ -65,7 +66,7 @@ if
 .B \-limit
 .I days
 is specified, messages
 .B \-limit
 .I days
 is specified, messages
-with similar textfields that are dated within `days' of each other
+with the same textfields that are dated within `days' of each other
 appear together.  Specifying
 .B \-nolimit
 makes the limit infinity.
 appear together.  Specifying
 .B \-nolimit
 makes the limit infinity.
@@ -74,7 +75,8 @@ With
 .IR 0 ,
 the sort is instead made textfield\-major, date\-minor.
 .PP
 .IR 0 ,
 the sort is instead made textfield\-major, date\-minor.
 .PP
-For example, to order a folder by date-major, subject-minor, use:
+For example, to order a folder by date-major, grouping messages with
+the same subject on the same date together, use:
 .PP
 .RS 5
 sortm -textfield subject +folder
 .PP
 .RS 5
 sortm -textfield subject +folder
@@ -83,7 +85,7 @@ sortm -textfield subject +folder
 .SH FILES
 .fc ^ ~
 .nf
 .SH FILES
 .fc ^ ~
 .nf
-.ta \w'/usr/local/nmh/etc/ExtraBigFileName  'u
+.ta \w'%etcdir%/ExtraBigFileName  'u
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
 
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
 
@@ -113,7 +115,7 @@ folder(1)
 If a folder is given, it will become the current folder.  If the current
 message is moved,
 .B sortm
 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.
+will preserve its status as current.
 
 .SH HISTORY
 Timezones used to be ignored when comparing dates: they aren't any more.
 
 .SH HISTORY
 Timezones used to be ignored when comparing dates: they aren't any more.