src/usr.bin/mandoc/man.3 - diff

Return to man.3 CVS log

Up to [local] / src / usr.bin / mandoc

Diff for /src/usr.bin/mandoc/Attic/man.3 between version 1.6 and 1.7

version 1.6, 2009/10/20 10:15:04

version 1.7, 2010/02/18 02:11:26

Line 1

.\" $Id$

.\"

.\" Permission to use, copy, modify, and distribute this software for any

.\" purpose with or without fee is hereby granted, provided that the above

Line 91

and variables (see

.Sx Variables )

may use the following types:

.Bl -ohang -offset "XXXX"

.Bl -ohang

.\" LIST-ITEM

.It Vt struct man

An opaque type defined in

Line 112

.\" SUBSECTION

.Ss Functions

Function descriptions follow:

.Bl -ohang -offset "XXXX"

.Bl -ohang

.\" LIST-ITEM

.It Fn man_alloc

Allocates a parsing structure. The

Line 166

.\" SUBSECTION

.Ss Variables

The following variables are also defined:

.Bl -ohang -offset "XXXX"

.Bl -ohang

.\" LIST-ITEM

.It Va man_macronames

An array of string-ified token names.

Line 215

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

where capitalised non-terminals represent nodes.

.Pp

.Bl -tag -width "ELEMENTXX" -compact -offset "XXXX"

.Bl -tag -width "ELEMENTXX" -compact

.\" LIST-ITEM

.It ROOT

\(<- mnode+

Line 242

The following example reads lines from stdin and parses them, operating

on the finished parse tree with

.Fn parsed .

Note that, if the last line of the file isn't newline-terminated, this

This example does not error-check nor free memory upon failure.

will truncate the file's last character (see

.Bd -literal -offset indent

.Xr fgetln 3 ) .

Further, this example does not error-check nor free memory upon failure.

.Bd -literal -offset "XXXX"

struct man *man;

struct man_node *node;

char *buf;

Line 255

Line 252

line = 1;

man = man_alloc(NULL, 0, NULL);

buf = NULL;

alloc_len = 0;

while ((buf = fgetln(fp, &len))) {

while ((len = getline(&buf, &alloc_len, stdin)) >= 0) {

buf[len - 1] = '\\0';

if (len && buflen[len - 1] = '\en')

if ( ! man_parseln(man, line, buf))

buf[len - 1] = '\e0';

errx(1, "man_parseln");

if ( ! man_parseln(man, line, buf))

line++;

errx(1, "man_parseln");

line++;

}

free(buf);

if ( ! man_endparse(man))

errx(1, "man_endparse");

if (NULL == (node = man_node(man)))

errx(1, "man_node");

parsed(man, node);

man_free(man);

Line 280

Line 282

The

.Nm

utility was written by

.An Kristaps Dzonsons Aq kristaps@kth.se .

.An Kristaps Dzonsons Aq kristaps@bsd.lv .