projects
/
mmh
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
Add some comments to the format compiler and engine.
[mmh]
/
man
/
dp.man8
diff --git
a/man/dp.man8
b/man/dp.man8
index
2742806
..
e0080cf
100644
(file)
--- a/
man/dp.man8
+++ b/
man/dp.man8
@@
-10,10
+10,6
@@
dp \- parse dates 822-style
.B %libdir%/dp
.RB [ \-form
.IR formatfile ]
.B %libdir%/dp
.RB [ \-form
.IR formatfile ]
-.RB [ \-format
-.IR string ]
-.RB [ \-width
-.IR columns ]
.RB [ \-version ]
.RB [ \-help ]
.I dates
.RB [ \-version ]
.RB [ \-help ]
.I dates
@@
-39,14
+35,14
@@
shell.
To override the output format used by
.BR dp ,
the
To override the output format used by
.BR dp ,
the
-.B \-format
-.I string
-or
-.B \-format
+.B \-form
.I file
.I file
-switches are used.
+switch is used.
This permits individual fields of the address to be extracted with ease.
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.
See
.BR mh\-format (5)
for the details.
@@
-55,7
+51,9
@@
Here is the default format string used by
.BR dp :
.PP
.RS 5
.BR dp :
.PP
.RS 5
+.nf
%<(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 `:',
.RE
.PP
which says that if an error was detected, print the error, a `:',
@@
-79,16
+77,8
@@
ap(8),
.SH DEFAULTS
.nf
.SH DEFAULTS
.nf
-.RB ` \-format "' default as described above"
-.RB ` \-width "' default to the width of the terminal"
+.RB ` \-form "' default as described above"
.fi
.SH CONTEXT
None
.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.