===================================================================
RCS file: /cvs/mandoc/Attic/mdoctree.1,v
retrieving revision 1.1
retrieving revision 1.4
diff -u -p -r1.1 -r1.4
--- mandoc/Attic/mdoctree.1	2009/02/21 21:00:06	1.1
+++ mandoc/Attic/mdoctree.1	2009/02/23 13:05:06	1.4
@@ -1,4 +1,4 @@
-.\" $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>
 .\"
@@ -16,7 +16,7 @@
 .\" 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
@@ -35,7 +35,10 @@ The
 .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
@@ -64,6 +67,7 @@ which may be 
 for stdin.
 .El
 .\" PARAGRAPH
+.Pp
 The
 .Nm
 utility is a formatting front-end for
@@ -97,6 +101,7 @@ To validate this manual page:
 .\" SECTION
 .Sh SEE ALSO
 .Xr mdocterm 1 ,
+.Xr mdoclint 1 ,
 .Xr mdoc.samples 7 ,
 .Xr mdoc 7 ,
 .Xr mdoc 3