1 files changed, 22 insertions, 5 deletions
diff --git a/mdocml.1 b/mdocml.1
index ad46bba4..a4fc8490 100644
--- a/mdocml.1
+++ b/mdocml.1
@@ -3,16 +3,19 @@
 .\" The following requests are required for all man pages.
 .\"
 .\" Remove `\&' from the line below.
-.Dd $Mdocdate: November 22 2008 $
+.Dd $Mdocdate: November 25 2008 $
 .Dt mdocml 1
 .Os
+.\"
 .Sh NAME
 .Nm mdocml
 .Nd compile manpage source into mark-up language
+.\"
 .Sh SYNOPSIS
 .Nm mdocml
 .Op Fl o Ar outfile
 .Op Ar infile
+.\"
 .Sh DESCRIPTION
 The
 .Nm
@@ -43,10 +46,24 @@ 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.
 .\" .Sh BUGS