mandoc/man.3 - diff

Return to man.3 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/Attic/man.3 between version 1.11 and 1.12

version 1.11, 2010/01/07 19:10:09

version 1.12, 2010/02/17 19:22:01

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 Both functions (see

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 for details.

.\" 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 return 0, the data will be incomplete.

.\" 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 fields) and some type-specific data.

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 next-lint scope as documented in

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 int line;

Line 252 int line;

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] = '\e0';

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 man_free(man);

Line 282 man_free(man);

The

.Nm

utility was written by

.An Kristaps Dzonsons Aq kristaps@kth.se .

.An Kristaps Dzonsons Aq kristaps@bsd.lv .

CVSweb