version 1.8, 2017/05/12 17:58:21 |
version 1.18, 2018/11/26 01:38:23 |
|
|
.\" $Id$ |
.\" $Id$ |
.\" |
.\" |
.\" Copyright (c) 2014, 2017 Ingo Schwarze <schwarze@openbsd.org> |
.\" Copyright (c) 2014, 2017, 2018 Ingo Schwarze <schwarze@openbsd.org> |
.\" |
.\" |
.\" Permission to use, copy, modify, and distribute this software for any |
.\" Permission to use, copy, modify, and distribute this software for any |
.\" purpose with or without fee is hereby granted, provided that the above |
.\" purpose with or without fee is hereby granted, provided that the above |
|
|
.Ft void |
.Ft void |
.Fn print_gen_decls "struct html *h" |
.Fn print_gen_decls "struct html *h" |
.Ft void |
.Ft void |
|
.Fn print_gen_comment "struct html *h" "struct roff_node *n" |
|
.Ft void |
.Fn print_gen_head "struct html *h" |
.Fn print_gen_head "struct html *h" |
.Ft struct tag * |
.Ft struct tag * |
.Fo print_otag |
.Fo print_otag |
|
|
declarations required for the current document type. |
declarations required for the current document type. |
.Pp |
.Pp |
The function |
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 |
.Fn print_gen_head |
prints the opening |
prints the opening |
.Aq Ic META |
.Aq Ic META |
|
|
.Cm style |
.Cm style |
attribute. |
attribute. |
If present, it must be the last format letter. |
If present, it must be the last format letter. |
In contrast to the other format letters, this one does not yet |
It requires two |
print the value and does not take an argument. |
.Va char * |
Instead, the rest of the format string consists of pairs of |
|
argument type letters and style name letters. |
|
.El |
|
.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 * |
|
argument, used as a style value. |
|
.It Cm u |
|
Requires one |
|
.Vt struct roffsu * |
|
argument, used as a length. |
|
.It Cm v |
|
Requires one |
|
.Vt int |
|
argument, interpreted as a vertical length in units of |
|
.Dv SCALE_VS . |
|
.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 b |
|
Set |
|
.Cm margin-bottom |
|
to the given length. |
|
.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 t |
|
Set |
|
.Cm margin-top |
|
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? |
|
requires two |
|
.Vt char * |
|
arguments. |
arguments. |
The first is the style name, the second its value. |
The first is the name of the style property, the second its value. |
The style name must not be |
The name must not be |
.Dv NULL . |
.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 |