===================================================================
RCS file: /cvs/mandoc/Attic/mdocml.1,v
retrieving revision 1.28
retrieving revision 1.33
diff -u -p -r1.28 -r1.33
--- mandoc/Attic/mdocml.1	2009/01/16 15:58:50	1.28
+++ mandoc/Attic/mdocml.1	2009/02/21 15:34:46	1.33
@@ -1,25 +1,38 @@
 .\"
-.Dd $Mdocdate: January 16 2009 $
+.Dd $Mdocdate: February 21 2009 $
 .Dt mdocml 1
 .Os
-.\"
+.\" SECTION
 .Sh NAME
 .Nm mdocml
 .Nd mdoc macro compiler
-.\"
+.\" SECTION
 .Sh SYNOPSIS
 .Nm mdocml
+.Op Fl f Ns Ar filter
 .Op Fl v
 .Op Fl W Ns Ar err...
 .Op Ar infile
-.\"
+.\" SECTION
 .Sh DESCRIPTION
 The
 .Nm
 utility interfaces the
 .Xr mdoc 3
-library to validate and parse mdoc-macro documents.  Arguments follow:
+library to scan, parse, validate and output mdoc-macro documents.
+Arguments follow:
 .Bl -tag -width "\-Werr... "
+.\" ITEM
+.It Fl f Ns Ar filter
+Pipe the parsed syntax tree into an output filter.  May be either
+.Ar tree
+for the parse tree or
+.Ar term
+for a terminal-encoded, formatted manual page.
+.\" ITEM
+.It Fl v
+Print verbose parsing output.
+.\" ITEM
 .It Fl W Ns Ar err...
 Print warning messages.  May be set to 
 .Fl W Ns Ar all
@@ -34,8 +47,7 @@ termination.  Multiple 
 .Fl W
 arguments may be comma-separated, such as
 .Fl W Ns Ar error,all .
-.It Fl v
-Print verbose parsing output.
+.\" ITEM
 .It Ar infile
 Read input from
 .Ar infile ,
@@ -43,53 +55,46 @@ which may be 
 .Dq \-
 for stdin.
 .El
+.\" PARAGRAPH
 .Pp
 Parsing and validation rules are drawn entirely from the 
 .Xr mdoc 7
 and
 .Xr mdoc.samples 7 
 manuals.
+.\" PARAGRAPH
 .Pp
 By default,
 .Nm
-reads from stdin, writes messages to stdout, and writes errors and
-warnings to stderr.
+reads from stdin and only validates its input.
+.\" PARAGRAPH
 .Pp
 .Ex -std mdocml
+.\" PARAGRAPH
 .Pp
 .Nm
 is
 .Ud
-.\" 
+.\" SECTION
 .Sh EXAMPLES
 To validate this manual page:
+.\" PARAGRAPH
 .Pp
 .D1 % mdocml \-Wall,error mdocml.1 
-.\"
+.\" SECTION
 .Sh SEE ALSO
 .Xr groff 1 ,
 .Xr mdoc.samples 7 ,
 .Xr mdoc 7 ,
 .Xr mdoc 3
-.\" .Sh STANDARDS
-.\" .Sh HISTORY
+.\" 
 .Sh AUTHORS
 The
 .Nm
 utility was written by 
 .An Kristaps Dzonsons Aq kristaps@kth.se .
-.\"
+.\" SECTION
 .Sh CAVEATS
-The most glaring short-coming of 
-.Nm
-is that it doesn't yet support the 
-.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
+See
+.Xr mdoc 3
+for a list of bugs, caveats, and incomplete macros.