8 date 93.08.27.20.21.19; author jromine; state Exp;
13 date 90.04.05.15.15.26; author sources; state Exp;
18 date 90.03.28.10.48.27; author sources; state Exp;
23 date 90.03.23.13.43.25; author sources; state Exp;
28 date 90.03.22.15.01.28; author sources; state Exp;
33 date 90.03.22.11.31.53; author sources; state Exp;
38 date 90.03.20.19.42.36; author sources; state Exp;
43 date 90.03.20.17.36.51; author sources; state Exp;
48 date 90.03.20.17.21.31; author sources; state Exp;
59 @change comments about the lack of "-pack"
63 .\" @@(#)$Id: sortm.rf,v 1.8 1990/04/05 15:15:26 sources Exp jromine $
66 sortm \- sort messages
70 \%[\-datefield\ field]
71 \%[\-textfield\ field] \%[\-notextfield]
72 \%[\-limit days] \%[\-nolimit]
73 \%[\-verbose] \%[\-noverbose]
76 \fISortm\fR sorts the specified messages in the named folder according
77 to the chronological order of the \*(lqDate:\*(rq field of each message.
79 The `\-verbose' switch directs \fIsortm\fR to tell the user the general
80 actions that it is taking to place the folder in sorted order.
82 The `\-datefield\ field' switch tells \fIsortm\fR the name of the field
83 to use when making the date comparison.
84 If the user has a special field in each message,
85 such as \*(lqBB\-Posted:\*(rq or \*(lqDelivery\-Date:\*(rq,
86 then the `\-datefield' switch can be used to direct \fIsortm\fR which
89 The `\-textfield\ field' switch causes \fIsortm\fR to sort messages by
90 the specified text field.
91 If this field is \*(lqsubject\*(rq,
92 any leading "re:" is stripped off.
93 In any case, all characters except letters and numbers are stripped
94 and the resulting strings are sorted
95 datefield\-major, textfield\-minor,
96 using a case insensitive comparison.
98 With `\-textfield\ field',
99 if `\-limit\ days' is specified, messages with similar textfields
100 that are dated within `days' of each other appear together.
101 Specifying `\-nolimit' makes the limit infinity.
102 With `\-limit 0', the sort is instead made textfield\-major, date\-minor.
105 For example, to order a folder by date-major, subject-minor, use:
108 sortm -textfield subject +folder
111 ^$HOME/\&.mh\(ruprofile~^The user profile
113 ^Path:~^To determine the user's MH directory
115 ^Current\-Folder:~^To find the default current folder
119 `+folder' defaults to the current folder
121 `msgs' defaults to all
131 If a folder is given, it will become the current folder.
132 If the current message is moved, \fIsortm\fR will preserve its status
135 Timezones used to be ignored when comparing dates:
136 they aren't any more.
138 Messages which were in the folder, but not specified by `msgs',
139 used to be moved to the end of the folder;
140 now such messages are left untouched.
142 \fISortm\fP sometimes did not preserve the message
143 numbering in a folder (e.g., messages
144 1, 3, and 5, might have been renumbered
145 to 1, 2, 3 after sorting).
146 This was a bug, and has been fixed.
147 To compress the message numbering in a folder, use
148 \*(lq\fIfolder\ \-pack\fR\|\*(rq as always.
150 If \fIsortm\fR encounters a message without a date\-field,
151 or if the message has a date\-field that \fIsortm\fR cannot parse,
152 then \fIsortm\fR attempts to keep the message in the same relative
154 This does not always work.
155 For instance, if the first message encountered lacks a date which can be
157 then it will usually be placed at the end of the messages being sorted.
159 When \fIsortm\fR complains about a message which it can't temporally order,
160 it complains about the message number \fIprior\fR to sorting.
161 It should indicate what the message number will be \fIafter\fR sorting.
177 \fIsortm\fR would try to fill any gaps in a folder within the
178 range of messages it sorted.
179 To improve performance,
180 \fIsortm\fR now minimizes the number of message moves.
181 To pack a folder, use
182 \*(lq\fIfolder\ \-pack\fR\|\*(rq instead.
201 Messages which are in the folder, but not specified by `msgs',
202 are moved to the end of the folder.
203 If a message does not exist (the folder has a gap),
204 \fIsortm\fR may fill the gap if convenient.
207 With `\-limit 0', the sort is made textfield\-major, date\-minor.
220 \%[\-limit days] \%[\-nolimit]
223 The `\-subject' switch causes \fIsortm\fR to sort messages by subject;
224 the leading "re:" and all characters except letters are stripped and the
225 resulting strings are sorted using a case insensitive comparison. If
226 `\-limit\ days' is specified, messages with similar subjects that are
227 dated within `days' of each other appear together.
237 @put things back, do .NA stuff another way
245 When \fIsortm\fR complains about a message which it can't temporarlly order,
256 .TH SORTM 1 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
266 @fixup for makewhatis
271 .TH SORTM 1 [mh.6] MH