Return to sortm.rf CVS log

Up to [CSRG BSD Unix] / 43BSDReno / contrib / mh / conf / doc

Annotation of 43BSDReno/contrib/mh/conf/doc/sortm.rf, revision 1.1.1.1

1.1       root        1: .\"    @(MHWARNING)
                      2: .TH SORTM 1 "June 5, 1989" MH [mh.6]
                      3: .UC 6
                      4: .SH NAME
                      5: sortm \- sort messages
                      6: .SH SYNOPSIS
                      7: .in +.5i
                      8: .ti -.5i
                      9: sortm
                     10: \%[+folder] \%[msgs]
                     11: \%[\-datefield\ field]
                     12: \%[\-verbose] \%[\-noverbose]
                     13: \%[\-subject]
                     14: \%[\-limit days]
                     15: \%[\-help]
                     16: .in -.5i
                     17: .SH DESCRIPTION
                     18: \fISortm\fR sorts the specified messages in the named folder according
                     19: to the chronological order of the \*(lqDate:\*(rq field of each message.
                     20: Messages which are in the folder, but not specified by `msgs',
                     21: are moved to the end of the folder.
                     22: 
                     23: The `\-verbose' switch directs \fIsortm\fR to tell the user the general
                     24: actions that it is taking to place the folder in sorted order.
                     25: 
                     26: The `\-datefield\ field' switch tells \fIsortm\fR the name of the field
                     27: to use when making the date comparison.
                     28: If the user has a special field in each message,
                     29: such as \*(lqBB\-Posted:\*(rq or \*(lqDelivery\-Date:\*(rq,
                     30: then the `\-datefield' switch can be used to direct \fIsortm\fR which
                     31: field to examine.
                     32: 
                     33: The `\-subject' causes \fIsortm\fR to sort messages by subject; the
                     34: leading "re:" and all characters except letters are stripped and the
                     35: resulting strings are sorted using a case insensitive comparison. If
                     36: `\-limit\ days' is specified, messages with similar subjects that are
                     37: dated within `days' of each other appear together.
                     38: .Fi
                     39: ^$HOME/\&.mh\(ruprofile~^The user profile
                     40: .Pr
                     41: ^Path:~^To determine the user's MH directory
                     42: .Ps
                     43: ^Current\-Folder:~^To find the default current folder
                     44: .Sa
                     45: folder (1)
                     46: .De
                     47: `+folder' defaults to the current folder
                     48: .Ds
                     49: `msgs' defaults to all
                     50: .Ds
                     51: `\-datefield date'
                     52: .Ds
                     53: `\-noverbose'
                     54: .Ds
                     55: `\-nosubject'
                     56: .Ds
                     57: `\-limit infinity'
                     58: .Co
                     59: If a folder is given, it will become the current folder.
                     60: If the current message is moved, \fIsortm\fR will preserve its status
                     61: as current.
                     62: .Hi
                     63: Timezones used to be ignored when comparing dates:
                     64: they aren't any more.
                     65: .Bu
                     66: If \fIsortm\fR encounters a message without a date\-field,
                     67: or if the message has a date\-field that \fIsortm\fR cannot parse,
                     68: then \fIsortm\fR attempts to keep the message in the same relative
                     69: position.
                     70: This does not always work.
                     71: For instance, if the first message encountered lacks a date which can be
                     72: parsed,
                     73: then it will usually be placed at the end of the messages being sorted.
                     74: 
                     75: When \fIsortm\fR complains about a message which it can't temporarily order,
                     76: it complains about the message number \fIprior\fR to sorting.
                     77: It should indicate what the message number will be \fIafter\fR sorting.
                     78: .En

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.