version 1.38, 2017/01/09 01:37:03 |
version 1.40, 2017/06/24 14:38:32 |
|
|
.Ft struct mparse * |
.Ft struct mparse * |
.Fo mparse_alloc |
.Fo mparse_alloc |
.Fa "int options" |
.Fa "int options" |
.Fa "enum mandoclevel wlevel" |
.Fa "enum mandocerr mmin" |
.Fa "mandocmsg mmsg" |
.Fa "mandocmsg mmsg" |
.Fa "char *defos" |
.Fa "enum mandoc_os oe_e" |
|
.Fa "char *os_s" |
.Fc |
.Fc |
.Ft void |
.Ft void |
.Fo (*mandocmsg) |
.Fo (*mandocmsg) |
Line 304 This is for example useful in |
|
Line 305 This is for example useful in |
|
.Xr makewhatis 8 |
.Xr makewhatis 8 |
.Fl Q |
.Fl Q |
to quickly build minimal databases. |
to quickly build minimal databases. |
.It Ar wlevel |
.It Ar mmin |
Can be set to |
Can be set to |
.Dv MANDOCLEVEL_BADARG , |
.Dv MANDOCERR_BASE , |
.Dv MANDOCLEVEL_ERROR , |
.Dv MANDOCERR_STYLE , |
|
.Dv MANDOCERR_WARNING , |
|
.Dv MANDOCERR_ERROR , |
|
.Dv MANDOCERR_UNSUPP , |
or |
or |
.Dv MANDOCLEVEL_WARNING . |
.Dv MANDOCERR_MAX . |
Messages below the selected level will be suppressed. |
Messages below the selected level will be suppressed. |
.It Ar mmsg |
.It Ar mmsg |
A callback function to handle errors and warnings. |
A callback function to handle errors and warnings. |
|
|
If printing of error messages is not desired, |
If printing of error messages is not desired, |
.Dv NULL |
.Dv NULL |
may be passed. |
may be passed. |
.It Ar defos |
.It Ar os_e |
|
Operating system to check base system conventions for. |
|
If |
|
.Dv MANDOC_OS_OTHER , |
|
the system is automatically detected from |
|
.Ic \&Os , |
|
.Fl Ios , |
|
or |
|
.Xr uname 3 . |
|
.It Ar os_s |
A default string for the |
A default string for the |
.Xr mdoc 7 |
.Xr mdoc 7 |
.Sq \&Os |
.Ic \&Os |
macro, overriding the |
macro, overriding the |
.Dv OSNAME |
.Dv OSNAME |
preprocessor definition and the results of |
preprocessor definition and the results of |
|
|
.Ed |
.Ed |
.Pp |
.Pp |
Here, the formatting of the |
Here, the formatting of the |
.Sq \&Ao |
.Ic \&Ao |
block extends from TEXT ao to TEXT ac, |
block extends from TEXT ao to TEXT ac, |
while the formatting of the |
while the formatting of the |
.Sq \&Bo |
.Ic \&Bo |
block extends from TEXT bo to TEXT bc. |
block extends from TEXT bo to TEXT bc. |
It renders as follows in |
It renders as follows in |
.Fl T Ns Cm ascii |
.Fl T Ns Cm ascii |
Line 669 Using badly-nested blocks is |
|
Line 682 Using badly-nested blocks is |
|
.Em strongly discouraged ; |
.Em strongly discouraged ; |
for example, the |
for example, the |
.Fl T Ns Cm html |
.Fl T Ns Cm html |
and |
front-end to |
.Fl T Ns Cm xhtml |
|
front-ends to |
|
.Xr mandoc 1 |
.Xr mandoc 1 |
are unable to render them in any meaningful way. |
is unable to render them in any meaningful way. |
Furthermore, behaviour when encountering badly-nested blocks is not |
Furthermore, behaviour when encountering badly-nested blocks is not |
consistent across troff implementations, especially when using multiple |
consistent across troff implementations, especially when using multiple |
levels of badly-nested blocks. |
levels of badly-nested blocks. |