Return to dp.rf CVS log

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

Annotation of 43BSD/contrib/mh/conf/doc/dp.rf, revision 1.1

1.1     ! root        1: .\"    @(MHWARNING)
        !             2: .TH DP 8 "April 22, 1986" MH [mh.6]
        !             3: .UC 6
        !             4: .SH NAME
        !             5: dp \- parse dates 822\-style
        !             6: .SH SYNOPSIS
        !             7: .in +.5i
        !             8: .ti -.5i
        !             9: @(MHETCPATH)/dp
        !            10: \%[\-form\ formatfile]
        !            11: \%[\-format\ string]
        !            12: \%[\-width\ columns]
        !            13: dates\ ...
        !            14: \%[\-help]
        !            15: .in -.5i
        !            16: .SH DESCRIPTION
        !            17: \fIDp\fR is a program that parses dates according to the ARPA Internet
        !            18: standard.
        !            19: It also understands many non\-standard formats,
        !            20: such as those produced by TOPS\-20 sites and some UNIX sites using
        !            21: \fIctime\fR\0(3).
        !            22: It is useful for seeing how \fIMH\fR will interpret a date.
        !            23: 
        !            24: The \fIdp\fR program treats each argument as a single date,
        !            25: and prints the date out in the official 822\-format.
        !            26: Hence, it is usually best to enclose each argument in double\-quotes for the
        !            27: shell.
        !            28: 
        !            29: To override the output format used by \fIdp\fR,
        !            30: the `\-format\ string' or `\-format\ file' switches are used.
        !            31: This permits individual fields of the address to be extracted with ease.
        !            32: The string is simply a format stringand thefile is simply a format file.
        !            33: See \fImh\-format\fR\0(5) for the details.
        !            34: 
        !            35: Here is the default format string used by \fIdp\fR:
        !            36: 
        !            37: .ti +.5i
        !            38: %<(nodate{text})error: %{text}%|%(putstr(pretty{text}))%>
        !            39: 
        !            40: which says that if an error was detected, print the error, a `:',
        !            41: and the date in error.
        !            42: Otherwise, output the 822\-proper format of the date.
        !            43: .Fi
        !            44: ^$HOME/\&.mh\(ruprofile~^The user profile
        !            45: .Pr
        !            46: None
        !            47: .Sa
        !            48: ap(8)
        !            49: .br
        !            50: \fIStandard for the Format of ARPA Internet Text Messages\fR (aka RFC\-822)
        !            51: .De
        !            52: `\-format' default as described above
        !            53: .Ds
        !            54: `\-width' default to the width of the terminal
        !            55: .Co
        !            56: None
        !            57: .Bu
        !            58: The argument to the `\-format' switch must be interpreted as a single token
        !            59: by the shell that invokes \fIdp\fR.
        !            60: Therefore,
        !            61: one must usually place the argument to this switch inside double\-quotes.
        !            62: .En

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