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     ! 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.