=================================================================== RCS file: /cvs/mandoc/mandoc_html.3,v retrieving revision 1.21 retrieving revision 1.23 diff -u -p -r1.21 -r1.23 --- mandoc/mandoc_html.3 2020/04/18 20:44:09 1.21 +++ mandoc/mandoc_html.3 2020/04/24 13:13:06 1.23 @@ -1,4 +1,4 @@ -.\" $Id: mandoc_html.3,v 1.21 2020/04/18 20:44:09 schwarze Exp $ +.\" $Id: mandoc_html.3,v 1.23 2020/04/24 13:13:06 schwarze Exp $ .\" .\" Copyright (c) 2014, 2017, 2018 Ingo Schwarze .\" @@ -14,7 +14,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: April 18 2020 $ +.Dd $Mdocdate: April 24 2020 $ .Dt MANDOC_HTML 3 .Os .Sh NAME @@ -228,6 +228,23 @@ This format letter requires two arguments, the attribute name and the value. The name must not be .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 .Pp .Fn print_otag @@ -366,6 +383,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 +429,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 +486,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