Removed `-format string' switches but made -form accept `=formatstring'.
[mmh] / man / dp.man8
index 2742806..d07fa6b 100644 (file)
@@ -10,8 +10,6 @@ dp \- parse dates 822-style
 .B %libdir%/dp
 .RB [ \-form
 .IR formatfile ]
-.RB [ \-format
-.IR string ]
 .RB [ \-width
 .IR columns ]
 .RB [ \-version ]
@@ -39,14 +37,14 @@ shell.
 To override the output format used by
 .BR dp ,
 the
-.B \-format
-.I string
-or
-.B \-format
+.B \-form
 .I file
-switches are used.
+switch is 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.
+The
+.I file
+is either the name of a format file or
+a format string directly, if prepended with an equal sign `='.
 See
 .BR mh\-format (5)
 for the details.
@@ -55,7 +53,9 @@ 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 `:',
@@ -79,7 +79,7 @@ ap(8),
 
 .SH DEFAULTS
 .nf
-.RB ` \-format "' default as described above"
+.RB ` \-form "' default as described above"
 .RB ` \-width "' default to the width of the terminal"
 .fi
 
@@ -88,7 +88,7 @@ None
 
 .SH BUGS
 The argument to the
-.B \-format
+.B \-form
 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.