|
|
1.1 root 1: .\" This file is automatically generated. Do not edit!
2: .SC SORTM 1
3: .NA
4: sortm \- sort messages
5: .SY
6: sortm
7: \%[+folder] \%[msgs]
8: \%[\-datefield\ field]
9: \%[\-verbose] \%[\-noverbose]
10: \%[\-help]
11: .DE
12: \fISortm\fR sorts the specified messages in the named folder according
13: to the chronological order of the \*(lqDate:\*(rq field of each message.
14: Messages which are in the folder, but not specified by `msgs',
15: are moved to the end of the folder.
16: If a message does not exist (the folder has a gap),
17: \fIsortm\fR may fill the gap if convenient.
18:
19: The `\-verbose' switch directs \fIsortm\fR to tell the user the general
20: actions that it is taking to place the folder in sorted order.
21:
22: The `\-datefield\ field' switch tells \fIsortm\fR the name of the field
23: to use when making the date comparison.
24: If the user has a special field in each message,
25: such as \*(lqBB\-Posted:\*(rq or \*(lqDelivery\-Date:\*(rq,
26: then the `\-datefield' switch can be used to direct \fIsortm\fR which
27: field to examine.
28: .Fi
29: ^$HOME/\&.mh\(ruprofile~^The user profile
30: .Pr
31: ^Path:~^To determine the user's MH directory
32: .Ps
33: ^Current\-Folder:~^To find the default current folder
34: .Sa
35: folder (1)
36: .De
37: `+folder' defaults to the current folder
38: .Ds
39: `msgs' defaults to all
40: .Ds
41: `\-datefield date'
42: .Ds
43: `\-noverbose'
44: .Co
45: If a folder is given, it will become the current folder.
46: If the current message is moved, \fIsortm\fR will preserve its status
47: as current.
48: .Hi
49: Timezones used to be ignored when comparing dates:
50: they aren't any more.
51: .Bu
52: If \fIsortm\fR encounters a message without a date\-field,
53: or if the message has a date\-field that \fIsortm\fR cannot parse,
54: then \fIsortm\fR attempts to keep the message in the same relative
55: position.
56: This does not always work.
57: For instance, if the first message encountered lacks a date which can be
58: parsed,
59: then it will usually be placed at the end of the messages being sorted.
60:
61: When \fIsortm\fR complains about a message which it can't temporarlly order,
62: it complains about the message number \fIprior\fR to sorting.
63: It should indicate what the message number will be \fIafter\fR sorting.
64: .En
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.