X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Fdp.man;h=3f98913a87a78afd9d3ebd7428b499f8c7ccaecd;hb=5e5e8b753acc7ff1e16c7fca172a2151a6c01353;hp=ce237b05fdc839bc6b610f93830eb447f717ea88;hpb=b36e2ab7892cdf30a8b33d02e00af70398013b5d;p=mmh diff --git a/man/dp.man b/man/dp.man index ce237b0..3f98913 100644 --- a/man/dp.man +++ b/man/dp.man @@ -1,12 +1,12 @@ +.TH DP %manext8% "November 6, 2012" "%nmhversion%" .\" .\" %nmhwarning% -.\" $Id$ .\" -.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 ] @@ -18,12 +18,13 @@ dp \- parse dates 822-style .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). +.IR ctime (3). It is useful for seeing how .B nmh will interpret a date. @@ -32,7 +33,7 @@ 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 +Hence, it is usually best to enclose each argument in quotes for the shell. .PP To override the output format used by @@ -47,47 +48,36 @@ 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 .BR dp : .PP .RS 5 -.nf %<(nodate{text})error: %{text}%|%(putstr(pretty{text}))%> -.fi .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'/usr/local/nmh/etc/ExtraBigFileName 'u +.ta \w'%etcdir%/ExtraBigFileName 'u ^$HOME/\&.mh\(ruprofile~^The user profile - +.fi .SH "PROFILE COMPONENTS" None - .SH "SEE ALSO" -ap(8), +.IR ap (8), +.PP .I "Standard for the Format of ARPA Internet Text Messages" (RFC\-822) - -.SH "DEFAULTS" +.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.