mandoc/mdoc.3 - diff

Return to mdoc.3 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/Attic/mdoc.3 between version 1.23 and 1.25

version 1.23, 2009/03/23 09:42:43

version 1.25, 2009/03/27 14:56:15

Line 56 library parses lines of

.Xr mdoc 7

input (and

.Em only

mdoc) into an abstract syntax tree that generalises the semantic

mdoc) into an abstract syntax tree (AST).

annotation of its input. Common front-ends for

.Nm

are

.Xr mdocterm 1 ,

.Xr mdoclint 1

and

.Xr mdoctree 1 .

.\" PARAGRAPH

.Pp

In general, applications initiate a parsing sequence with

Line 227 fields), its position in the tree (the

Line 220 fields), its position in the tree (the

.Va next

and

.Va prev

fields) and type-specific data (the

fields) and some type-specific data.

.Va data

field).

.\" PARAGRAPH

.Pp

The tree itself is arranged according to the following normal form,

Line 281 size_t len;

Line 272 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';

Line 314 utility was written by

Line 305 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

.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

.Sq \&.Bl

should be the width of

.Qq <string> ;

instead, a value of

Line 339 is provided.

Line 330 is provided.

.\" LIST-ITEM

.It

Columns widths in

.Sq \&Bl \-column

.Sq \&.Bl \-column

should default to width

.Qq <stringx>

if not included.

CVSweb