The buildbot was reporting "warning" on stdin, not stderr.

[nmh] / man / dp.man

diff --git a/man/dp.man b/man/dp.man
index f3fe6bfa4be3f20d42c97fee4a0bed270c5542cf..9a3bfb2a27016f8566d7622dcd2737942dd3ae28 100644 (file)
--- a/man/dp.man
+++ b/man/dp.man
@@ -1,72 +1,85 @@
+.TH DP %manext8% "November 6, 2012" "%nmhversion%"

 .\"
 .\" %nmhwarning%
 .\"
 .\" %nmhwarning%

-.\" $Id$

 .\"
 .\"

-.\" include the -mh macro file
-.so %etcdir%/tmac.h
-.\"
-.TH DP %manext8% MH.6.8 [%nmhversion%]

 .SH NAME
 .SH NAME

-dp \- parse dates 822-style
+dp \- parse dates RFC 822-style

 .SH SYNOPSIS
 .SH SYNOPSIS

-.in +.5i
-.ti -.5i
-%libdir%/dp
-\%[\-form\ formatfile]
-.br
-\%[\-format\ string]
-\%[\-width\ columns]
-dates\ ...
-.br
-\%[\-version]
-\%[\-help]
-.in -.5i
+.HP 5
+.na
+.B %libdir%/dp
+.RB [ \-form
+.IR formatfile ]
+.RB [ \-format
+.IR string ]
+.RB [ \-width
+.IR columns ]
+.RB [ \-version ]
+.RB [ \-help ] 
+.I dates
+\&...
+.ad

 .SH DESCRIPTION
 .SH DESCRIPTION

-\fIDp\fR is a program that parses dates according to the ARPA Internet
-standard.
+.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
 It also understands many non\-standard formats,
 such as those produced by TOPS\-20 sites and some UNIX sites using

-\fIctime\fR(3).
-It is useful for seeing how \fInmh\fR will interpret a date.
-
-The \fIdp\fR 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
+.IR ctime (3).
+It is useful for seeing how
+.B nmh
+will interpret a date.
+.PP
+The
+.B dp
+program treats each argument as a single date,
+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.
 shell.

-
-To override the output format used by \fIdp\fR,
-the `\-format\ string' or `\-format\ file' switches are used.
+.PP
+To override the output format used by
+.BR dp ,
+the
+.B \-format
+.I string
+or
+.B \-format
+.I file
+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.
 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 \fImh\-format\fR(5) for the details.
-
-Here is the default format string used by \fIdp\fR:
-
-.nf
-.ti +.5i
+See
+.IR mh\-format (5)
+for the details.
+.PP
+Here is the default format string used by
+.BR dp :
+.PP
+.RS 5

 %<(nodate{text})error: %{text}%|%(putstr(pretty{text}))%>
 %<(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.
 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.
-.Fi
-^$HOME/\&.mh\(ruprofile~^The user profile
-.Pr
+Otherwise, output the RFC 822\-proper format of the date.
+.SH FILES
+.TP 20
+$HOME/.mh\-profile
+The user's profile.
+.SH "PROFILE COMPONENTS"

 None
 None

-.Sa
-ap(8)
-.br
-\fIStandard for the Format of ARPA Internet Text Messages\fR (RFC\-822)
-.De
-`\-format' default as described above
-.Ds
-`\-width' default to the width of the terminal
-.Co
+.SH "SEE ALSO"
+.IR ap (8),
+.PP
+.I "Standard for the Format of ARPA Internet Text Messages"
+(RFC 822)
+.SH DEFAULTS
+.PD 0
+.TP 20
+\-format
+As described above.
+.TP
+\-width
+The width of the terminal.
+.PD
+.SH CONTEXT

 None
 None

-.Bu
-The argument to the `\-format' switch must be interpreted as a single token
-by the shell that invokes \fIdp\fR.
-Therefore,
-one must usually place the argument to this switch inside double\-quotes.
-.En