[BACK]Return to mandoc.3 CVS log [TXT][DIR] Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/mandoc.3 between version 1.27 and 1.29

version 1.27, 2014/10/28 17:36:19 version 1.29, 2014/11/26 23:42:14
Line 81 
Line 81 
 .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
Line 111 
Line 110 
 .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 398  open with
Line 396  open 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
Line 420  implemented in
Line 416  implemented in
 Parse a file or file descriptor.  Parse a file or file descriptor.
 If  If
 .Va fd  .Va fd
 is -1,  is -1, open
 .Va fname  .Va fname
 is opened for reading.  with
   .Fn mparse_open .
 Otherwise,  Otherwise,
 .Va fname  .Va fname
 is assumed to be the name associated with  is assumed to be the name associated with
 .Va fd .  .Va fd .
 This may be called multiple times with different parameters; however,  Calls
   .Fn mparse_wait
   before returning.
   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.
 Declared in  Declared in
Line 471  implemented in
Line 471  implemented 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

Legend:
Removed from v.1.27  
changed lines
  Added in v.1.29

CVSweb