===================================================================
RCS file: /cvs/mandoc/Attic/mdocml.1,v
retrieving revision 1.2
retrieving revision 1.6
diff -u -p -r1.2 -r1.6
--- mandoc/Attic/mdocml.1	2008/11/22 18:34:06	1.2
+++ mandoc/Attic/mdocml.1	2008/11/27 17:27:50	1.6
@@ -1,36 +1,43 @@
-.\"	$OpenBSD: mdocml.1,v 1.2 2008/11/22 18:34:06 kristaps Exp $
+.\"	$OpenBSD: mdocml.1,v 1.6 2008/11/27 17:27:50 kristaps Exp $
 .\"
 .\" The following requests are required for all man pages.
 .\"
 .\" Remove `\&' from the line below.
-.Dd $Mdocdate: November 22 2008 $
+.Dd $Mdocdate: November 27 2008 $
 .Dt mdocml 1
 .Os
+.\"
+.Op foo
 .Sh NAME
 .Nm mdocml
 .Nd compile manpage source into mark-up language
+.\"
 .Sh SYNOPSIS
 .Nm mdocml
+.Op Fl W
 .Op Fl o Ar outfile
 .Op Ar infile
+.\"
 .Sh DESCRIPTION
 The
 .Nm
 utility compiles manpage source into a mark-up language.  Its arguments
 are as follows:
-.Bl -tag -width "-o outfile"
+.Bl -tag -width "\-o outfile"
 .It Fl o Ar outfile
 Place output in 
 .Ar outfile ,
 which may be
-.Qq -
+.Qq \-
 for standard output.  The default is standard output.
 .It Ar infile
 Read input from
 .Ar infile ,
 which may be 
-.Qq -
+.Qq \-
 for standard input.  The default is standard input.
+.It Fl W
+Print warnings.
 .El
 .\" The following requests should be uncommented and used where appropriate.
 .\" This next request is for sections 2, 3, and 9 function return values only.
@@ -43,10 +50,27 @@ for standard input.  The default is standard input.
 .\" .Sh DIAGNOSTICS
 .\" The next request is for sections 2, 3, and 9 error and signal handling only.
 .\" .Sh ERRORS
-.\" .Sh SEE ALSO
-.\" .Xr foobar 1
+.Sh SEE ALSO
+.Xr groff 1 ,
+.Xr mdoc.samples 7 ,
+.Xr mdoc 7
 .\" .Sh STANDARDS
 .\" .Sh HISTORY
-.\" .Sh AUTHORS
-.\" .Sh CAVEATS
+.Sh AUTHORS
+The
+.Nm
+utility was written by 
+.An Kristaps Dzonsons Aq kristaps@kth.se .
+.\"
+.Sh CAVEATS
+The
+.Nm
+engine doesn't understand
+.Sq \&Xo
+and
+.Sq \&Xc
+troff macros.
+.Pp
+.Em All
+macro arguments may be quoted, instead of only some.
 .\" .Sh BUGS