1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
|
.\"
.\" %nmhwarning%
.\" $Id: dp.man,v 1.5 2001/01/25 21:15:53 ssen Exp $
.\"
.TH DP %manext8% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
dp \- parse dates 822-style
.SH SYNOPSIS
.HP 5
.na
.B %libdir%/dp
.RB [ \-form
.IR formatfile ]
.RB [ \-format
.IR string ]
.RB [ \-width
.IR columns ]
.RB [ \-version ]
.RB [ \-help ]
.I dates
\&...
.ad
.SH DESCRIPTION
.B Dp
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
.BR ctime (3).
It is useful for seeing how
.B nmh
will interpret a date.
.PP
The
.B dp
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.
.PP
To override the output format used by
.BR dp ,
the
.B \-format
.I string
or
.B \-format
.I file
switches are used.
This permits individual fields of the address to be extracted with ease.
The string is simply a format string and the file is simply a format file.
See
.BR mh\-format (5)
for the details.
.PP
Here is the default format string used by
.BR dp :
.PP
.RS 5
%<(nodate{text})error: %{text}%|%(putstr(pretty{text}))%>
.RE
.PP
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.
.SH FILES
.fc ^ ~
.nf
.ta \w'%etcdir%/ExtraBigFileName 'u
^$HOME/\&.mh\(ruprofile~^The user profile
.fi
.SH "PROFILE COMPONENTS"
None
.SH "SEE ALSO"
ap(8),
.I "Standard for the Format of ARPA Internet Text Messages"
(RFC\-822)
.SH DEFAULTS
.nf
.RB ` \-format "' default as described above"
.RB ` \-width "' default to the width of the terminal"
.fi
.SH CONTEXT
None
.SH BUGS
The argument to the
.B \-format
switch must be interpreted as a single token by the shell that invokes
.BR dp .
Therefore, one must usually place the argument to this switch inside double\-quotes.
|
