diff options
author | Ingo Schwarze <schwarze@openbsd.org> | 2020-04-19 15:16:56 +0000 |
---|---|---|
committer | Ingo Schwarze <schwarze@openbsd.org> | 2020-04-19 15:16:56 +0000 |
commit | a7eb58f8be5552047bb2594077d548bec819a6d5 (patch) | |
tree | 286956bd2ac70f046fcef611c107c79336e270fa /mandoc_html.3 | |
parent | 5b933cc0ef58641ed3423aeb65ce14d99ebcc89e (diff) | |
download | mandoc-a7eb58f8be5552047bb2594077d548bec819a6d5.tar.gz |
Correctly handle non-unique tags even when NODE_ID and NODE_HREF fall
apart, NODE_ID occurring earlier than NODE_HREF.
Diffstat (limited to 'mandoc_html.3')
-rw-r--r-- | mandoc_html.3 | 29 |
1 files changed, 15 insertions, 14 deletions
diff --git a/mandoc_html.3 b/mandoc_html.3 index d638a107..46b4477b 100644 --- a/mandoc_html.3 +++ b/mandoc_html.3 @@ -366,6 +366,18 @@ If the .Fa unique argument is non-zero, deduplication is performed by appending an 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 The function .Fn print_otag_id @@ -400,9 +412,9 @@ This function is a wrapper around .Fn html_make_id and .Fn print_otag , -fixing the +automatically chosing the .Fa unique -argument to 1 and the +argument appropriately and setting the .Fa fmt arguments to .Qq chR @@ -457,20 +469,9 @@ returns a newly allocated string or if .Fa n lacks text data to create the attribute from. -If the -.Fa unique -argument is 0, the caller is responsible for +The caller is responsible for .Xr free 3 Ns ing 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 In case of .Xr malloc 3 |