]> diplodocus.org Git - nmh/blobdiff - man/dp.man
Added support for "-" to indicate stdout to output_message().
[nmh] / man / dp.man
index ce237b05fdc839bc6b610f93830eb447f717ea88..7998c2d0b9447129f68201feb2861fd9fda59ff9 100644 (file)
@@ -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,38 @@ 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
-^$HOME/\&.mh\(ruprofile~^The user profile
-
+.TP 20
+$HOME/.mh\-profile
+The user's profile.
 .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"
-.nf
-.RB ` \-format "' default as described above"
-.RB ` \-width "' default to the width of the terminal"
-
+.SH DEFAULTS
+.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.