X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/55c80a0ae8453ef6c3e0fcd0fac30644945d0ef2..94187a80bd60baab4b9c4b949ad820d730578123:/man/dp.man diff --git a/man/dp.man b/man/dp.man index 15522dea..af16d229 100644 --- a/man/dp.man +++ b/man/dp.man @@ -1,29 +1,30 @@ -.\" +.TH DP %manext8% 1999-04-30 "%nmhversion%" +. .\" %nmhwarning% -.\" $Id$ -.\" -.TH DP %manext8% "%nmhdate%" MH.6.8 [%nmhversion%] +. .SH NAME -dp \- parse dates 822-style +dp \- nmh parser of RFC 822-style dates .SH SYNOPSIS .HP 5 -.B %libdir%/dp +.na +.B %nmhlibexecdir%/dp +.RB [ \-help ] +.RB [ \-version ] .RB [ \-form .IR formatfile ] .RB [ \-format .IR string ] .RB [ \-width .IR columns ] -.RB [ \-version ] -.RB [ \-help ] .I dates \&... +.ad .SH DESCRIPTION -.B Dp +.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 also understands many non-standard formats, +such as those produced by TOPS\-20 sites and some Unix sites using +.IR ctime (3). It is useful for seeing how .B nmh will interpret a date. @@ -31,8 +32,8 @@ will interpret a date. 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 +and prints the date out in the official RFC 822 format. +Hence, it is usually best to enclose each argument in quotes for the shell. .PP To override the output format used by @@ -47,7 +48,7 @@ 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) +.IR mh\-format (5) for the details. .PP Here is the default format string used by @@ -59,35 +60,27 @@ Here is the default format string used by .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. - +Otherwise, output the RFC 822\-proper format of the date. .SH FILES -.fc ^ ~ -.nf -.ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u -^$HOME/\&.mh\(ruprofile~^The user profile -.fi - +.TP 20 +$HOME/.mh_profile +The user's profile. .SH "PROFILE COMPONENTS" None - .SH "SEE ALSO" -ap(8), +.IR fmttest (1), +.IR ap (8) +.PP .I "Standard for the Format of ARPA Internet Text Messages" -(RFC\-822) - +(RFC 822) .SH DEFAULTS -.nf -.RB ` \-format "' default as described above" -.RB ` \-width "' default to the width of the terminal" -.fi - +.PD 0 +.TP 20 +\-format +As described above. +.TP +\-width +The width of the terminal. +.PD .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.