===================================================================
RCS file: /cvs/mandoc/Attic/mdoc.3,v
retrieving revision 1.22
retrieving revision 1.25
diff -u -p -r1.22 -r1.25
--- mandoc/Attic/mdoc.3	2009/03/22 08:52:27	1.22
+++ mandoc/Attic/mdoc.3	2009/03/27 14:56:15	1.25
@@ -1,4 +1,4 @@
-.\" $Id: mdoc.3,v 1.22 2009/03/22 08:52:27 kristaps Exp $
+.\" $Id: mdoc.3,v 1.25 2009/03/27 14:56:15 kristaps Exp $
 .\"
 .\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@openbsd.org>
 .\"
@@ -16,7 +16,7 @@
 .\" TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
 .\" PERFORMANCE OF THIS SOFTWARE.
 .\" 
-.Dd $Mdocdate: March 22 2009 $
+.Dd $Mdocdate: March 27 2009 $
 .Dt mdoc 3
 .Os
 .\" SECTION
@@ -56,14 +56,7 @@ library parses lines of 
 .Xr mdoc 7
 input (and
 .Em only
-mdoc) into an abstract syntax tree that generalises the semantic
-annotation of its input.  Common front-ends for 
-.Nm
-are
-.Xr mdocterm 1 ,
-.Xr mdoclint 1 
-and
-.Xr mdoctree 1 .
+mdoc) into an abstract syntax tree (AST).
 .\" PARAGRAPH
 .Pp
 In general, applications initiate a parsing sequence with
@@ -227,9 +220,7 @@ fields), its position in the tree (the
 .Va next 
 and
 .Va prev 
-fields) and type-specific data (the
-.Va data
-field).
+fields) and some type-specific data.
 .\" PARAGRAPH
 .Pp
 The tree itself is arranged according to the following normal form,
@@ -281,7 +272,7 @@ size_t len;
 int line;
 
 line = 1;
-mdoc = mdoc_alloc(NULL, NULL);
+mdoc = mdoc_alloc(NULL, 0, NULL);
 
 while ((buf = fgetln(fp, &len))) {
 	buf[len - 1] = '\\0';
@@ -314,29 +305,32 @@ utility was written by 
 .\" LIST-ITEM
 .It
 The 
-.Sq \&Xc
+.Sq \&.Xc
 and
-.Sq \&Xo
+.Sq \&.Xo
 macros aren't handled when used to span lines for the
-.Sq \&It
+.Sq \&.It
 macro. 
 .\" LIST-ITEM
 .It
 The 
-.Sq \&Bsx
-macro doesn't yet understand version arguments.
+.Sq \&.Bsx
+macro family doesn't yet understand version arguments.
 .\" LIST-ITEM
 .It
 If not given a value, the \-offset argument to
-.Sq \&Bd
+.Sq \&.Bd
 and
-.Sq \&Bl
-should by the width of 
-.Qq <string> .
+.Sq \&.Bl
+should be the width of 
+.Qq <string> ;
+instead, a value of 
+.Li 10n
+is provided.
 .\" LIST-ITEM
 .It
 Columns widths in
-.Sq \&Bl -column
+.Sq \&.Bl \-column
 should default to width
 .Qq <stringx>
 if not included.