===================================================================
RCS file: /cvs/mandoc/Attic/mdocml.1,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -p -r1.1 -r1.2
--- mandoc/Attic/mdocml.1	2008/11/22 14:53:29	1.1
+++ mandoc/Attic/mdocml.1	2008/11/22 18:34:06	1.2
@@ -1,25 +1,37 @@
-.\"	$OpenBSD: mdocml.1,v 1.1 2008/11/22 14:53:29 kristaps Exp $
+.\"	$OpenBSD: mdocml.1,v 1.2 2008/11/22 18:34:06 kristaps Exp $
 .\"
 .\" The following requests are required for all man pages.
 .\"
 .\" Remove `\&' from the line below.
-.Dd $\&Mdocdate$
-.Dt NAME SECTION#
+.Dd $Mdocdate: November 22 2008 $
+.Dt mdocml 1
 .Os
 .Sh NAME
-.Nm program
-.Nd one line about what it does
+.Nm mdocml
+.Nd compile manpage source into mark-up language
 .Sh SYNOPSIS
-.\" For a program:  program [-abc] file ...
-.Nm program
-.Op Fl abc
-.Ar
+.Nm mdocml
+.Op Fl o Ar outfile
+.Op Ar infile
 .Sh DESCRIPTION
 The
 .Nm
-utility processes files ...
-something
-something.
+utility compiles manpage source into a mark-up language.  Its arguments
+are as follows:
+.Bl -tag -width "-o outfile"
+.It Fl o Ar outfile
+Place output in 
+.Ar outfile ,
+which may be
+.Qq -
+for standard output.  The default is standard output.
+.It Ar infile
+Read input from
+.Ar infile ,
+which may be 
+.Qq -
+for standard input.  The default is standard input.
+.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.
 .\" .Sh RETURN VALUES