version 1.27, 2009/01/16 14:04:26 |
version 1.30, 2009/01/20 15:05:01 |
|
|
.Nm |
.Nm |
utility interfaces the |
utility interfaces the |
.Xr mdoc 3 |
.Xr mdoc 3 |
library to validate and parse mdoc-macro documents. Arguments follow: |
library to scan, parse and validate mdoc-macro documents. Arguments |
|
follow: |
.Bl -tag -width "\-Werr... " |
.Bl -tag -width "\-Werr... " |
.It Fl W Ns Ar err... |
.It Fl W Ns Ar err... |
Print warning messages. May be set to |
Print warning messages. May be set to |
Line 56 reads from stdin, writes messages to stdout, and write |
|
Line 57 reads from stdin, writes messages to stdout, and write |
|
warnings to stderr. |
warnings to stderr. |
.Pp |
.Pp |
.Ex -std mdocml |
.Ex -std mdocml |
|
.Pp |
|
.Nm |
|
is |
|
.Ud |
.\" |
.\" |
.Sh EXAMPLES |
.Sh EXAMPLES |
To validate this manual page: |
To validate this manual page: |
Line 76 utility was written by |
|
Line 81 utility was written by |
|
.An Kristaps Dzonsons Aq kristaps@kth.se . |
.An Kristaps Dzonsons Aq kristaps@kth.se . |
.\" |
.\" |
.Sh CAVEATS |
.Sh CAVEATS |
The most glaring short-coming of |
See |
.Nm |
.Xr mdoc 3 |
is that it doesn't yet support the |
for a list of bugs, caveats, and incomplete macros. |
.Sq \&Xc |
|
and |
|
.Sq \&Xo |
|
macros when used to extend the line arguments to |
|
.Sq \&It ; |
|
in effect, trampling the body section. We note that this is explicitly |
|
discouraged in |
|
.Xr mdoc.samples 7 , |
|
but in practice used quite often. |
|
.\" .Sh BUGS |
.\" .Sh BUGS |