Return to dp.me CVS log

Up to [CSRG BSD Unix] / 43BSDReno / share / doc / usd / 08.mh

Annotation of 43BSDReno/share/doc/usd/08.mh/dp.me, revision 1.1.1.1

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

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