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