version 1.13, 2018/06/10 16:47:15 |
version 1.18, 2018/11/26 01:38:23 |
|
|
.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 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 the modifier |
|
.Cm + |
|
which increases the width by 20% to make even bold text fit |
|
and adds three units for padding between columns. |
|
.El |
|
.Pp |
|
Style name letters decide what to do with the preceding argument: |
|
.Bl -tag -width 1n -offset indent |
|
.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? |
|
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 |