version 1.2, 2017/01/17 01:47:51 |
version 1.4, 2017/01/25 02:14:43 |
|
|
.\" $Id$ |
.\" $Id$ |
.\" |
.\" |
.\" Copyright (c) 2014 Ingo Schwarze <schwarze@openbsd.org> |
.\" Copyright (c) 2014, 2017 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 |
|
|
Print a |
Print a |
.Cm href |
.Cm href |
attribute. |
attribute. |
|
This attribute letter can optionally be followed by a modifier letter. |
|
If followed by |
|
.Cm R , |
|
it formats the link as a local one by prefixing a |
|
.Sq # |
|
character. |
|
If followed by |
|
.Cm I , |
|
it interpretes the argument as a header file name |
|
and generates a link using the |
|
.Xr mandoc 1 |
|
.Fl O Cm includes |
|
option. |
|
If followed by |
|
.Cm M , |
|
it takes two arguments instead of one, a manual page name and |
|
section, and formats them as a link to a manual page using the |
|
.Xr mandoc 1 |
|
.Fl O Cm man |
|
option. |
.It Cm i |
.It Cm i |
Print an |
Print an |
.Cm id |
.Cm id |
|
|
argument, interpreted as an |
argument, interpreted as an |
.Xr mdoc 7 Ns -style |
.Xr mdoc 7 Ns -style |
width specifier. |
width specifier. |
|
.It Cm W |
|
Similar to |
|
.Cm w , |
|
but makes the width negative by multiplying it with \(mi1. |
.El |
.El |
.Pp |
.Pp |
Style name letters decide what to do with the preceding argument: |
Style name letters decide what to do with the preceding argument: |
Line 235 The first is the style name, the second its value. |
|
Line 259 The first is the style name, the second its value. |
|
.Pp |
.Pp |
.Fn print_otag |
.Fn print_otag |
uses the private function |
uses the private function |
.Fn print_attr |
|
which in turn uses the private function |
|
.Fn print_encode |
.Fn print_encode |
to take care of HTML encoding. |
to take care of HTML encoding. |
If required by the element type, it remembers in |
If required by the element type, it remembers in |
Line 268 in an HTML font selection element using the |
|
Line 290 in an HTML font selection element using the |
|
and |
and |
.Fn print_tagq |
.Fn print_tagq |
functions. |
functions. |
.Pp |
|
The functions |
|
.Fn bufinit , |
|
.Fn bufcat* , |
|
and |
|
.Fn buffmt* |
|
do not directly produce output but buffer text in the |
|
.Fa buf |
|
member of |
|
.Fa h . |
|
They are not used internally by |
|
.Pa html.c |
|
but intended for use by the language-specific formatters |
|
to ease preparation of strings for the |
|
.Fa p |
|
argument of |
|
.Fn print_otag |
|
and for the |
|
.Fa word |
|
argument of |
|
.Fn print_text . |
|
Consequently, these functions do not do any HTML encoding. |
|
.Pp |
.Pp |
The functions |
The functions |
.Fn html_strlen , |
.Fn html_strlen , |