-.\" $Id: mdoctree.1,v 1.1 2009/02/21 21:00:06 kristaps Exp $
+.\" $Id: mdoctree.1,v 1.4 2009/02/23 13:05:06 kristaps Exp $
.\"
.\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@kth.se>
.\"
.\" TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: February 21 2009 $
+.Dd $Mdocdate: February 23 2009 $
.Dt mdoctree 1
.Os
.\" SECTION
.Nm
utility parses a BSD
.Dq mdoc
-manual pages and prints its syntax tree. The arguments are as follows:
+manual pages and prints its syntax tree. It's commonly used to see the
+syntax tree of a document when building new
+.Xr mdoc 3
+utilities. The arguments are as follows:
.Bl -tag -width "\-Werr... "
.\" ITEM
.It Fl v
for stdin.
.El
.\" PARAGRAPH
+.Pp
The
.Nm
utility is a formatting front-end for
.\" SECTION
.Sh SEE ALSO
.Xr mdocterm 1 ,
+.Xr mdoclint 1 ,
.Xr mdoc.samples 7 ,
.Xr mdoc 7 ,
.Xr mdoc 3