version 1.31, 2015/01/15 04:26:40 |
version 1.32, 2015/07/19 06:05:16 |
|
|
.Nm mparse_result , |
.Nm mparse_result , |
.Nm mparse_strerror , |
.Nm mparse_strerror , |
.Nm mparse_strlevel |
.Nm mparse_strlevel |
.Nm mparse_wait , |
|
.Nd mandoc macro compiler library |
.Nd mandoc macro compiler library |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.In sys/types.h |
.In sys/types.h |
|
|
.Fo mparse_strlevel |
.Fo mparse_strlevel |
.Fa "enum mandoclevel" |
.Fa "enum mandoclevel" |
.Fc |
.Fc |
.Ft "enum mandoclevel" |
|
.Fo mparse_wait |
|
.Fa "struct mparse *parse" |
|
.Fc |
|
.In sys/types.h |
.In sys/types.h |
.In mandoc.h |
.In mandoc.h |
.In mdoc.h |
.In mdoc.h |
|
|
implemented in |
implemented in |
.Pa read.c . |
.Pa read.c . |
.It Fn mparse_open |
.It Fn mparse_open |
If the |
Open the file for reading. |
|
If that fails and |
.Fa fname |
.Fa fname |
ends in |
does not already end in |
.Pa .gz , |
.Ql .gz , |
open with |
try again after appending |
.Xr gunzip 1 ; |
.Ql .gz . |
otherwise, with |
Save the information whether the file is zipped or not. |
.Xr open 2 . |
|
If |
|
.Xr open 2 |
|
fails, append |
|
.Pa .gz |
|
and try with |
|
.Xr gunzip 1 . |
|
Return a file descriptor open for reading in |
Return a file descriptor open for reading in |
.Fa fd , |
.Fa fd , |
or -1 on failure. |
or -1 on failure. |
|
|
.Fn mparse_open . |
.Fn mparse_open . |
Pass the associated filename in |
Pass the associated filename in |
.Va fname . |
.Va fname . |
Calls |
|
.Fn mparse_wait |
|
before returning. |
|
This function may be called multiple times with different parameters; however, |
This function may be called multiple times with different parameters; however, |
.Fn mparse_reset |
.Fn mparse_reset |
should be invoked between parses. |
should be invoked between parses. |
|
|
.Pa read.c . |
.Pa read.c . |
.It Fn mparse_strlevel |
.It Fn mparse_strlevel |
Return a statically-allocated string representation of a level code. |
Return a statically-allocated string representation of a level code. |
Declared in |
|
.In mandoc.h , |
|
implemented in |
|
.Pa read.c . |
|
.It Fn mparse_wait |
|
Bury a |
|
.Xr gunzip 1 |
|
child process that was spawned with |
|
.Fn mparse_open . |
|
To be called after the parse sequence is complete. |
|
Not needed after |
|
.Fn mparse_readfd , |
|
but does no harm in that case, either. |
|
Returns |
|
.Dv MANDOCLEVEL_OK |
|
on success and |
|
.Dv MANDOCLEVEL_SYSERR |
|
on failure, that is, when |
|
.Xr wait 2 |
|
fails, or when |
|
.Xr gunzip 1 |
|
died from a signal or exited with non-zero status. |
|
Declared in |
Declared in |
.In mandoc.h , |
.In mandoc.h , |
implemented in |
implemented in |