mandoc/mandoc.3 - diff

Return to mandoc.3 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/mandoc.3 between version 1.3 and 1.5

-version 1.3, 2011/04/09 15:53:48
+version 1.5, 2011/04/30 10:18:24
 Line 97
 Line 97
 Line 97
  .Vt extern const char * const * man_macronames;
  .Vt extern const char * const * mdoc_argnames;
  .Vt extern const char * const * mdoc_macronames;
+ .Fd "#define ASCII_NBRSP"
+ .Fd "#define ASCII_HYPH"
  .Sh DESCRIPTION
  The
  .Nm mandoc
-Line 154  via
+Line 156  via
 Line 154  via
 Line 156  via
  .Ss Functions
  .Bl -ohang
  .It Fn mandoc_escape
+ Scan an escape sequence, i.e., a character string beginning with
+ .Sq \e .
+ Pass a pointer to this string as
+ .Va end ;
+ it will be set to the supremum of the parsed escape sequence unless
+ returning ESCAPE_ERROR, in which case the string is bogus and should be
+ thrown away.
+ If not ESCAPE_ERROR or ESCAPE_IGNORE,
+ .Va start
+ is set to the first relevant character of the substring (font, glyph,
+ whatever) of length
+ .Va sz .
+ Both
+ .Va start
+ and
+ .Va sz
+ may be NULL.
  .It Fn man_meta
+ Obtain the meta-data of a successful parse.
+ This may only be used on a pointer returned by
+ .Fn mparse_result .
  .It Fn man_node
+ Obtain the root node of a successful parse.
+ This may only be used on a pointer returned by
+ .Fn mparse_result .
  .It Fn mdoc_meta
+ Obtain the meta-data of a successful parse.
+ This may only be used on a pointer returned by
+ .Fn mparse_result .
  .It Fn mdoc_node
+ Obtain the root node of a successful parse.
+ This may only be used on a pointer returned by
+ .Fn mparse_result .
  .It Fn mparse_alloc
+ Allocate a parser.
+ The same parser may be used for multiple files so long as
+ .Fn mparse_reset
+ is called between parses.
+ .Fn mparse_free
+ must be called to free the memory allocated by this function.
  .It Fn mparse_free
+ Free all memory allocated by
+ .Fn mparse_alloc .
  .It Fn mparse_readfd
+ Parse a file or file descriptor.
+ If
+ .Va fd
+ is -1,
+ .Va fname
+ is opened for reading.
+ Otherwise,
+ .Va fname
+ is assumed to be the name associated with
+ .Va fd .
+ This may be called multiple times with different parameters; however,
+ .Fn mparse_reset
+ should be invoked between parses.
  .It Fn mparse_reset
+ Reset a parser so that
+ .Fn mparse_readfd
+ may be used again.
  .It Fn mparse_result
+ Obtain the result of a parse.
+ Only successful parses
+ .Po
+ i.e., those where
+ .Fn mparse_readfd
+ returned less than MANDOCLEVEL_FATAL
+ .Pc
+ should invoke this function, in which case one of the two pointers will
+ be filled in.
  .It Fn mparse_strerror
+ Return a statically-allocated string representation of an error code.
  .It Fn mparse_strlevel
+ Return a statically-allocated string representation of a level code.
  .El
  .Ss Variables
  .Bl -ohang
  .It Va man_macronames
+ The string representation of a man macro as indexed by
+ .Vt "enum mant" .
  .It Va mdoc_argnames
+ The string representation of a mdoc macro argument as indexed by
+ .Vt "enum mdocargt" .
  .It Va mdoc_macronames
+ The string representation of a mdoc macro as indexed by
+ .Vt "enum mdoct" .
  .El
  .Sh IMPLEMENTATION NOTES
  This section consists of structural documentation for
-Line 292  where a new body introduces a new phrase.
+Line 364  where a new body introduces a new phrase.
 Line 292  where a new body introduces a new phrase.
 Line 364  where a new body introduces a new phrase.
  .Pp
  The
  .Xr mdoc 7
- syntax tree accomodates for broken block structures as well.
+ syntax tree accommodates for broken block structures as well.
  The ENDBODY node is available to end the formatting associated
  with a given block before the physical end of that block.
  It has a non-null

CVSweb