=================================================================== RCS file: /cvs/mandoc/mandoc_html.3,v retrieving revision 1.9 retrieving revision 1.16 diff -u -p -r1.9 -r1.16 --- mandoc/mandoc_html.3 2017/07/14 16:06:44 1.9 +++ mandoc/mandoc_html.3 2018/06/25 14:13:54 1.16 @@ -1,6 +1,6 @@ -.\" $Id: mandoc_html.3,v 1.9 2017/07/14 16:06:44 schwarze Exp $ +.\" $Id: mandoc_html.3,v 1.16 2018/06/25 14:13:54 schwarze Exp $ .\" -.\" Copyright (c) 2014, 2017 Ingo Schwarze +.\" Copyright (c) 2014, 2017, 2018 Ingo Schwarze .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above @@ -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: July 14 2017 $ +.Dd $Mdocdate: June 25 2018 $ .Dt MANDOC_HTML 3 .Os .Sh NAME @@ -25,6 +25,8 @@ .Ft void .Fn print_gen_decls "struct html *h" .Ft void +.Fn print_gen_comment "struct html *h" "struct roff_node *n" +.Ft void .Fn print_gen_head "struct html *h" .Ft struct tag * .Fo print_otag @@ -109,6 +111,18 @@ and declarations required for the current document type. .Pp The function +.Fn print_gen_comment +prints the leading comments, usually containing a Copyright notice +and license, as an HTML comment. +It is intended to be called right after opening the +.Aq Ic HTML +element. +Pass the first +.Dv ROFFT_COMMENT +node in +.Fa n . +.Pp +The function .Fn print_gen_head prints the opening .Aq Ic META @@ -206,11 +220,6 @@ argument type letters and style name letters. .Pp Argument type letters each require one argument as follows: .Bl -tag -width 1n -offset indent -.It Cm h -Requires one -.Vt int -argument, interpreted as a horizontal length in units of -.Dv SCALE_EN . .It Cm s Requires one .Vt char * @@ -219,51 +228,10 @@ argument, used as a style value. Requires one .Vt struct roffsu * argument, used as a length. -.It Cm w -Requires one -.Vt char * -argument, interpreted as an -.Xr mdoc 7 Ns -style -width specifier. -If the argument is -.Dv NULL , -nothing is printed for this pair. -.Pp -The -.Cm w -argument type letter can optionally be followed by one or two -modifier letters. -The modifier -.Cm + -increases the width by 10% to make even bold text fit -and adds two units for padding between columns. -The modifier -.Cm \- -makes the width negative by multiplying it with \-1. .El .Pp Style name letters decide what to do with the preceding argument: .Bl -tag -width 1n -offset indent -.It Cm h -Set -.Cm height -to the given length. -.It Cm i -Set -.Cm text-indent -to the given length. -.It Cm l -Set -.Cm margin-left -to the given length. -.It Cm w -Set -.Cm width -to the given length. -.It Cm W -Set -.Cm min-width -to the given length. .It Cm \&? The special pair .Cm s?