8 date 92.05.12.22.23.34; author jromine; state Exp;
13 date 90.04.05.15.08.58; author sources; state Exp;
18 date 90.03.22.11.31.05; author sources; state Exp;
23 date 90.03.20.19.41.41; author sources; state Exp;
28 date 90.03.20.17.35.59; author sources; state Exp;
33 date 90.03.16.15.58.04; author sources; state Exp;
38 date 90.03.16.15.57.51; author sources; state Exp;
49 @fixup for nroff problems
53 .\" @@(#)$Id: dp.rf,v 1.6 1990/04/05 15:08:58 sources Exp jromine $
56 dp \- parse dates 822-style
59 \%[\-form\ formatfile]
65 \fIDp\fR is a program that parses dates according to the ARPA Internet
67 It also understands many non\-standard formats,
68 such as those produced by TOPS\-20 sites and some UNIX sites using
70 It is useful for seeing how \fIMH\fR will interpret a date.
72 The \fIdp\fR program treats each argument as a single date,
73 and prints the date out in the official 822\-format.
74 Hence, it is usually best to enclose each argument in double\-quotes for the
77 To override the output format used by \fIdp\fR,
78 the `\-format\ string' or `\-format\ file' switches are used.
79 This permits individual fields of the address to be extracted with ease.
80 The string is simply a format stringand thefile is simply a format file.
81 See \fImh\-format\fR\0(5) for the details.
83 Here is the default format string used by \fIdp\fR:
87 %<(nodate{text})error: %{text}%|%(putstr(pretty{text}))%>
90 which says that if an error was detected, print the error, a `:',
91 and the date in error.
92 Otherwise, output the 822\-proper format of the date.
94 ^$HOME/\&.mh\(ruprofile~^The user profile
100 \fIStandard for the Format of ARPA Internet Text Messages\fR (aka RFC\-822)
102 `\-format' default as described above
104 `\-width' default to the width of the terminal
108 The argument to the `\-format' switch must be interpreted as a single token
109 by the shell that invokes \fIdp\fR.
111 one must usually place the argument to this switch inside double\-quotes.
126 dp \- parse dates 822\-style
132 @put things back, do .NA stuff another way
146 .TH DP 8 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
156 @fixup for makewhatis