version 1.27, 2014/10/28 17:36:19 |
version 1.30, 2015/01/15 02:29:26 |
|
|
.Fa "struct mparse *parse" |
.Fa "struct mparse *parse" |
.Fa "int *fd" |
.Fa "int *fd" |
.Fa "const char *fname" |
.Fa "const char *fname" |
.Fa "pid_t *child_pid" |
|
.Fc |
.Fc |
.Ft "enum mandoclevel" |
.Ft "enum mandoclevel" |
.Fo mparse_readfd |
.Fo mparse_readfd |
|
|
.Ft "enum mandoclevel" |
.Ft "enum mandoclevel" |
.Fo mparse_wait |
.Fo mparse_wait |
.Fa "struct mparse *parse" |
.Fa "struct mparse *parse" |
.Fa "pid_t child_pid" |
|
.Fc |
.Fc |
.In sys/types.h |
.In sys/types.h |
.In mandoc.h |
.In mandoc.h |
Line 178 initiate a parsing sequence with |
|
Line 176 initiate a parsing sequence with |
|
and |
and |
.Fn mparse_alloc ; |
.Fn mparse_alloc ; |
.It |
.It |
parse files or file descriptors with |
parse files with |
|
.Fn mparse_open |
|
and |
.Fn mparse_readfd ; |
.Fn mparse_readfd ; |
.It |
.It |
retrieve a parsed syntax tree, if the parse was successful, with |
retrieve a parsed syntax tree, if the parse was successful, with |
|
|
.Xr gunzip 1 ; |
.Xr gunzip 1 ; |
otherwise, with |
otherwise, with |
.Xr open 2 . |
.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. |
It can be passed to |
It can be passed to |
.Fn mparse_readfd |
.Fn mparse_readfd |
or used directly. |
or used directly. |
If applicable, return the |
|
.Xr gunzip 1 |
|
child process ID in |
|
.Fa child_pid , |
|
or otherwise 0. |
|
If non-zero, it should be passed to |
|
.Fn mparse_wait |
|
after completing the parse sequence. |
|
Declared in |
Declared in |
.In mandoc.h , |
.In mandoc.h , |
implemented in |
implemented in |
.Pa read.c . |
.Pa read.c . |
.It Fn mparse_readfd |
.It Fn mparse_readfd |
Parse a file or file descriptor. |
Parse a file descriptor opened with |
If |
.Xr open 2 |
.Va fd |
or |
is -1, |
.Fn mparse_open . |
.Va fname |
Pass the associated filename in |
is opened for reading. |
.Va fname . |
Otherwise, |
Calls |
.Va fname |
.Fn mparse_wait |
is assumed to be the name associated with |
before returning. |
.Va fd . |
This function may be called multiple times with different parameters; however, |
This 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. |
Declared in |
Declared in |
|
|
.It Fn mparse_wait |
.It Fn mparse_wait |
Bury a |
Bury a |
.Xr gunzip 1 |
.Xr gunzip 1 |
child process |
child process that was spawned with |
.Fa child_pid |
|
that was spawned with |
|
.Fn mparse_open . |
.Fn mparse_open . |
To be called after the parse sequence is complete. |
To be called after the parse sequence is complete. |
|
Not needed after |
|
.Fn mparse_readfd , |
|
but does no harm in that case, either. |
Returns |
Returns |
.Dv MANDOCLEVEL_OK |
.Dv MANDOCLEVEL_OK |
on success and |
on success and |