.\" This file is automatically generated. Do not edit!
.\" @(#)$Id: dp.rf,v 1.7 1992/05/12 22:23:34 jromine Exp $
dp \- parse dates 822-style
/usr/contrib/mh-6.8/lib/dp
\fIDp\fR is a program that parses dates according to the ARPA Internet
It also understands many non\-standard formats,
such as those produced by TOPS\-20 sites and some UNIX sites using
It is useful for seeing how \fIMH\fR will interpret a date.
The \fIdp\fR program treats each argument as a single date,
and prints the date out in the official 822\-format.
Hence, it is usually best to enclose each argument in double\-quotes for the
To override the output format used by \fIdp\fR,
the `\-format\ string' or `\-format\ file' switches are used.
This permits individual fields of the address to be extracted with ease.
The string is simply a format stringand thefile is simply a format file.
See \fImh\-format\fR\0(5) for the details.
Here is the default format string used by \fIdp\fR:
%<(nodate{text})error: %{text}%|%(putstr(pretty{text}))%>
which says that if an error was detected, print the error, a `:',
Otherwise, output the 822\-proper format of the date.
^$HOME/\&.mh\(ruprofile~^The user profile
\fIStandard for the Format of ARPA Internet Text Messages\fR (aka RFC\-822)
`\-format' default as described above
`\-width' default to the width of the terminal
The argument to the `\-format' switch must be interpreted as a single token
by the shell that invokes \fIdp\fR.
one must usually place the argument to this switch inside double\-quotes.