===================================================================
RCS file: /cvs/mandoc/Attic/mdocml.1,v
retrieving revision 1.23
retrieving revision 1.25
diff -u -p -r1.23 -r1.25
--- mandoc/Attic/mdocml.1	2008/12/08 16:29:57	1.23
+++ mandoc/Attic/mdocml.1	2008/12/10 12:05:33	1.25
@@ -1,6 +1,6 @@
 .\"
-.Dd $Mdocdate: December 8 2008 $
-.Dt mdocml 1 alpha
+.Dd $Mdocdate: December 10 2008 $
+.Dt mdocml 1
 .Os
 .\"
 .Sh NAME
@@ -9,7 +9,8 @@
 .\"
 .Sh SYNOPSIS
 .Nm mdocml
-.Op Fl vW
+.Op Fl v
+.Op Fl W Ns Ar err...
 .Op Fl f Ar filter
 .Op Fl o Ar outfile
 .Op Ar infile
@@ -25,15 +26,24 @@ and
 the default.  Arguments common to all filters follow:
 .Bl -tag -width "\-o outfile"
 .It Fl f Ar filter
-The output filter name.
+The output filter name.  This
+.Em must
+be declared before any other options.
 .It Fl o Ar outfile
 Write output to 
 .Ar outfile ,
 which may be
 .Dq \-
 for stdout.
-.It Fl W
-Print warnings to stderr.
+.It Fl W Ns Ar err...
+Print warning messages.  If set to 
+.Fl W Ns Ar all ,
+all warnings are printed; if
+.Fl W Ns Ar error ,
+warnings are considered errors and cause utility termination.  Multiple 
+.Fl W
+arguments may be comma-separated, such as
+.Fl W Ns Ar error,all .
 .It Fl v
 Make warning and error messages verbose.
 .It Ar infile