Return to dp.rf CVS log

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

Annotation of 43BSDReno/contrib/mh/conf/doc/dp.rf, revision 1.1.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.