head	1.7;
access;
symbols;
locks; strict;


1.7
date	92.05.12.22.23.34;	author jromine;	state Exp;
branches;
next	1.6;

1.6
date	90.04.05.15.08.58;	author sources;	state Exp;
branches;
next	1.5;

1.5
date	90.03.22.11.31.05;	author sources;	state Exp;
branches;
next	1.4;

1.4
date	90.03.20.19.41.41;	author sources;	state Exp;
branches;
next	1.3;

1.3
date	90.03.20.17.35.59;	author sources;	state Exp;
branches;
next	1.2;

1.2
date	90.03.16.15.58.04;	author sources;	state Exp;
branches;
next	1.1;

1.1
date	90.03.16.15.57.51;	author sources;	state Exp;
branches;
next	;


desc
@@


1.7
log
@fixup for nroff problems
@
text
@.\"	@@(MHWARNING)
.\" @@(#)$Id: dp.rf,v 1.6 1990/04/05 15:08:58 sources Exp jromine $
.SC DP 8
.NA
dp \- parse dates 822-style
.SY
@@(MHETCPATH)/dp
\%[\-form\ formatfile]
\%[\-format\ string]
\%[\-width\ columns]
dates\ ...
\%[\-help]
.DE
\fIDp\fR is a program that parses dates according to the ARPA Internet
standard.
It also understands many non\-standard formats,
such as those produced by TOPS\-20 sites and some UNIX sites using
\fIctime\fR\0(3).
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
shell.

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:

.nf
.ti +.5i
%<(nodate{text})error: %{text}%|%(putstr(pretty{text}))%>
.fi

which says that if an error was detected, print the error, a `:',
and the date in error.
Otherwise, output the 822\-proper format of the date.
.Fi
^$HOME/\&.mh\(ruprofile~^The user profile
.Pr
None
.Sa
ap(8)
.br
\fIStandard for the Format of ARPA Internet Text Messages\fR (aka RFC\-822)
.De
`\-format' default as described above
.Ds
`\-width' default to the width of the terminal
.Co
None
.Bu
The argument to the `\-format' switch must be interpreted as a single token
by the shell that invokes \fIdp\fR.
Therefore,
one must usually place the argument to this switch inside double\-quotes.
.En
@


1.6
log
@add ID
@
text
@d2 1
a2 1
.\" @@(#)$Id:$
d5 1
a5 1
dp \- parse dates 822\-style
@


1.5
log
@put things back, do .NA stuff another way
@
text
@d2 1
@


1.4
log
@typo
@
text
@d2 2
a3 2
.TH DP 8 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
.SH .NA
d5 1
a5 1
.SH .SY
@


1.3
log
@fixup for makewhatis
@
text
@d2 1
a2 1
.TH DP 8 [mh.6] MH
@


1.2
log
@fixup
@
text
@d2 2
a3 2
.SC DP 8
.NA
d5 1
a5 1
.SY
@


1.1
log
@Initial revision
@
text
@d33 1
d36 1
@