]> diplodocus.org Git - nmh/blobdiff - man/dp.man
Use C's `++', `+=', etc., not the longhand.
[nmh] / man / dp.man
index ce237b05fdc839bc6b610f93830eb447f717ea88..dc1ad703f0026e7843c108dd778d30c19dc6af5e 100644 (file)
@@ -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 \- parse dates RFC 822-style
 .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,47 +48,39 @@ 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.
-
+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
-
+.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)
-
-.SH "DEFAULTS"
-.nf
-.RB ` \-format "' default as described above"
-.RB ` \-width "' default to the width of the terminal"
-
+(RFC 822)
+.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.