version 1.21, 2020/04/18 20:44:09 |
version 1.23, 2020/04/24 13:13:06 |
Line 228 This format letter requires two |
|
Line 228 This format letter requires two |
|
arguments, the attribute name and the value. |
arguments, the attribute name and the value. |
The name must not be |
The name must not be |
.Dv NULL . |
.Dv NULL . |
|
.It Cm s |
|
Print a |
|
.Cm style |
|
attribute. |
|
If present, it must be the last format letter. |
|
It requires two |
|
.Va char * |
|
arguments. |
|
The first is the name of the style property, the second its value. |
|
The name must not be |
|
.Dv NULL . |
|
The |
|
.Cm s |
|
.Ar fmt |
|
letter can be repeated, each repetition requiring an additional pair of |
|
.Va char * |
|
arguments. |
.El |
.El |
.Pp |
.Pp |
.Fn print_otag |
.Fn print_otag |
|
|
.Fa unique |
.Fa unique |
argument is non-zero, deduplication is performed by appending an |
argument is non-zero, deduplication is performed by appending an |
underscore and a decimal integer, if necessary. |
underscore and a decimal integer, if necessary. |
|
If the |
|
.Fa unique |
|
argument is 1, this is assumed to be the first call for this tag |
|
at this location, typically for use by |
|
.Dv NODE_ID , |
|
so the integer is incremented before use. |
|
If the |
|
.Fa unique |
|
argument is 2, this is ssumed to be the second call for this tag |
|
at this location, typically for use by |
|
.Dv NODE_HREF , |
|
so the existing integer, if any, is used without incrementing it. |
.Pp |
.Pp |
The function |
The function |
.Fn print_otag_id |
.Fn print_otag_id |
Line 400 This function is a wrapper around |
|
Line 429 This function is a wrapper around |
|
.Fn html_make_id |
.Fn html_make_id |
and |
and |
.Fn print_otag , |
.Fn print_otag , |
fixing the |
automatically chosing the |
.Fa unique |
.Fa unique |
argument to 1 and the |
argument appropriately and setting the |
.Fa fmt |
.Fa fmt |
arguments to |
arguments to |
.Qq chR |
.Qq chR |
Line 457 returns a newly allocated string or |
|
Line 486 returns a newly allocated string or |
|
if |
if |
.Fa n |
.Fa n |
lacks text data to create the attribute from. |
lacks text data to create the attribute from. |
If the |
The caller is responsible for |
.Fa unique |
|
argument is 0, the caller is responsible for |
|
.Xr free 3 Ns ing |
.Xr free 3 Ns ing |
the returned string after using it. |
the returned string after using it. |
If the |
|
.Fa unique |
|
argument is non-zero, the |
|
.Va id_unique |
|
ohash table is used for de-duplication and owns the returned string. |
|
In this case, it will be freed automatically by |
|
.Fn html_reset |
|
or |
|
.Fn html_free . |
|
.Pp |
.Pp |
In case of |
In case of |
.Xr malloc 3 |
.Xr malloc 3 |