Import mdocml-1.13.1
[dragonfly.git] / contrib / mdocml / html.c
CommitLineData
070c62a6 1/* $Id: html.c,v 1.159 2014/07/23 15:00:08 schwarze Exp $ */
80387638 2/*
60e1e752 3 * Copyright (c) 2008, 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
070c62a6 4 * Copyright (c) 2011, 2012, 2013, 2014 Ingo Schwarze <schwarze@openbsd.org>
80387638
SW
5 *
6 * Permission to use, copy, modify, and distribute this software for any
7 * purpose with or without fee is hereby granted, provided that the above
8 * copyright notice and this permission notice appear in all copies.
9 *
10 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17 */
18#ifdef HAVE_CONFIG_H
19#include "config.h"
20#endif
21
22#include <sys/types.h>
23
24#include <assert.h>
25#include <ctype.h>
26#include <stdarg.h>
27#include <stdio.h>
28#include <stdint.h>
29#include <stdlib.h>
30#include <string.h>
31#include <unistd.h>
32
33#include "mandoc.h"
070c62a6 34#include "mandoc_aux.h"
a4c7eb57 35#include "libmandoc.h"
80387638 36#include "out.h"
80387638
SW
37#include "html.h"
38#include "main.h"
39
40struct htmldata {
41 const char *name;
42 int flags;
43#define HTML_CLRLINE (1 << 0)
44#define HTML_NOSTACK (1 << 1)
45#define HTML_AUTOCLOSE (1 << 2) /* Tag has auto-closure. */
46};
47
48static const struct htmldata htmltags[TAG_MAX] = {
49 {"html", HTML_CLRLINE}, /* TAG_HTML */
50 {"head", HTML_CLRLINE}, /* TAG_HEAD */
51 {"body", HTML_CLRLINE}, /* TAG_BODY */
52 {"meta", HTML_CLRLINE | HTML_NOSTACK | HTML_AUTOCLOSE}, /* TAG_META */
53 {"title", HTML_CLRLINE}, /* TAG_TITLE */
54 {"div", HTML_CLRLINE}, /* TAG_DIV */
55 {"h1", 0}, /* TAG_H1 */
56 {"h2", 0}, /* TAG_H2 */
57 {"span", 0}, /* TAG_SPAN */
58 {"link", HTML_CLRLINE | HTML_NOSTACK | HTML_AUTOCLOSE}, /* TAG_LINK */
59 {"br", HTML_CLRLINE | HTML_NOSTACK | HTML_AUTOCLOSE}, /* TAG_BR */
60 {"a", 0}, /* TAG_A */
61 {"table", HTML_CLRLINE}, /* TAG_TABLE */
62 {"tbody", HTML_CLRLINE}, /* TAG_TBODY */
63 {"col", HTML_CLRLINE | HTML_NOSTACK | HTML_AUTOCLOSE}, /* TAG_COL */
64 {"tr", HTML_CLRLINE}, /* TAG_TR */
65 {"td", HTML_CLRLINE}, /* TAG_TD */
66 {"li", HTML_CLRLINE}, /* TAG_LI */
67 {"ul", HTML_CLRLINE}, /* TAG_UL */
68 {"ol", HTML_CLRLINE}, /* TAG_OL */
69 {"dl", HTML_CLRLINE}, /* TAG_DL */
70 {"dt", HTML_CLRLINE}, /* TAG_DT */
71 {"dd", HTML_CLRLINE}, /* TAG_DD */
72 {"blockquote", HTML_CLRLINE}, /* TAG_BLOCKQUOTE */
73 {"p", HTML_CLRLINE | HTML_NOSTACK | HTML_AUTOCLOSE}, /* TAG_P */
74 {"pre", HTML_CLRLINE }, /* TAG_PRE */
75 {"b", 0 }, /* TAG_B */
76 {"i", 0 }, /* TAG_I */
77 {"code", 0 }, /* TAG_CODE */
78 {"small", 0 }, /* TAG_SMALL */
79};
80
81static const char *const htmlattrs[ATTR_MAX] = {
82 "http-equiv", /* ATTR_HTTPEQUIV */
83 "content", /* ATTR_CONTENT */
84 "name", /* ATTR_NAME */
85 "rel", /* ATTR_REL */
86 "href", /* ATTR_HREF */
87 "type", /* ATTR_TYPE */
88 "media", /* ATTR_MEDIA */
89 "class", /* ATTR_CLASS */
90 "style", /* ATTR_STYLE */
91 "width", /* ATTR_WIDTH */
92 "id", /* ATTR_ID */
93 "summary", /* ATTR_SUMMARY */
94 "align", /* ATTR_ALIGN */
60e1e752 95 "colspan", /* ATTR_COLSPAN */
80387638
SW
96};
97
a4c7eb57
SW
98static const char *const roffscales[SCALE_MAX] = {
99 "cm", /* SCALE_CM */
100 "in", /* SCALE_IN */
101 "pc", /* SCALE_PC */
102 "pt", /* SCALE_PT */
103 "em", /* SCALE_EM */
104 "em", /* SCALE_MM */
105 "ex", /* SCALE_EN */
106 "ex", /* SCALE_BU */
107 "em", /* SCALE_VS */
108 "ex", /* SCALE_FS */
109};
80387638 110
a4c7eb57
SW
111static void bufncat(struct html *, const char *, size_t);
112static void print_ctag(struct html *, enum htmltag);
070c62a6 113static int print_escape(char);
a4c7eb57
SW
114static int print_encode(struct html *, const char *, int);
115static void print_metaf(struct html *, enum mandoc_esc);
116static void print_attr(struct html *, const char *, const char *);
117static void *ml_alloc(char *, enum htmltype);
80387638 118
070c62a6 119
80387638
SW
120static void *
121ml_alloc(char *outopts, enum htmltype type)
122{
123 struct html *h;
36342e81 124 const char *toks[5];
80387638
SW
125 char *v;
126
127 toks[0] = "style";
128 toks[1] = "man";
129 toks[2] = "includes";
36342e81
SW
130 toks[3] = "fragment";
131 toks[4] = NULL;
80387638 132
60e1e752 133 h = mandoc_calloc(1, sizeof(struct html));
80387638
SW
134
135 h->type = type;
136 h->tags.head = NULL;
a4c7eb57 137 h->symtab = mchars_alloc();
80387638
SW
138
139 while (outopts && *outopts)
140 switch (getsubopt(&outopts, UNCONST(toks), &v)) {
070c62a6 141 case 0:
80387638
SW
142 h->style = v;
143 break;
070c62a6 144 case 1:
80387638
SW
145 h->base_man = v;
146 break;
070c62a6 147 case 2:
80387638
SW
148 h->base_includes = v;
149 break;
070c62a6 150 case 3:
36342e81
SW
151 h->oflags |= HTML_FRAGMENT;
152 break;
80387638
SW
153 default:
154 break;
155 }
156
157 return(h);
158}
159
160void *
161html_alloc(char *outopts)
162{
163
164 return(ml_alloc(outopts, HTML_HTML_4_01_STRICT));
165}
166
80387638
SW
167void *
168xhtml_alloc(char *outopts)
169{
170
171 return(ml_alloc(outopts, HTML_XHTML_1_0_STRICT));
172}
173
80387638
SW
174void
175html_free(void *p)
176{
177 struct tag *tag;
178 struct html *h;
179
180 h = (struct html *)p;
181
182 while ((tag = h->tags.head) != NULL) {
070c62a6 183 h->tags.head = tag->next;
80387638
SW
184 free(tag);
185 }
070c62a6 186
80387638 187 if (h->symtab)
a4c7eb57 188 mchars_free(h->symtab);
80387638
SW
189
190 free(h);
191}
192
80387638
SW
193void
194print_gen_head(struct html *h)
195{
196 struct htmlpair tag[4];
197
198 tag[0].key = ATTR_HTTPEQUIV;
199 tag[0].val = "Content-Type";
200 tag[1].key = ATTR_CONTENT;
201 tag[1].val = "text/html; charset=utf-8";
202 print_otag(h, TAG_META, 2, tag);
203
204 tag[0].key = ATTR_NAME;
205 tag[0].val = "resource-type";
206 tag[1].key = ATTR_CONTENT;
207 tag[1].val = "document";
208 print_otag(h, TAG_META, 2, tag);
209
210 if (h->style) {
211 tag[0].key = ATTR_REL;
212 tag[0].val = "stylesheet";
213 tag[1].key = ATTR_HREF;
214 tag[1].val = h->style;
215 tag[2].key = ATTR_TYPE;
216 tag[2].val = "text/css";
217 tag[3].key = ATTR_MEDIA;
218 tag[3].val = "all";
219 print_otag(h, TAG_LINK, 4, tag);
220 }
221}
222
80387638 223static void
a4c7eb57 224print_metaf(struct html *h, enum mandoc_esc deco)
80387638
SW
225{
226 enum htmlfont font;
227
228 switch (deco) {
070c62a6 229 case ESCAPE_FONTPREV:
80387638
SW
230 font = h->metal;
231 break;
070c62a6 232 case ESCAPE_FONTITALIC:
80387638
SW
233 font = HTMLFONT_ITALIC;
234 break;
070c62a6 235 case ESCAPE_FONTBOLD:
80387638
SW
236 font = HTMLFONT_BOLD;
237 break;
070c62a6 238 case ESCAPE_FONTBI:
f88b6c16
FF
239 font = HTMLFONT_BI;
240 break;
070c62a6 241 case ESCAPE_FONT:
a4c7eb57 242 /* FALLTHROUGH */
070c62a6 243 case ESCAPE_FONTROMAN:
80387638
SW
244 font = HTMLFONT_NONE;
245 break;
246 default:
247 abort();
248 /* NOTREACHED */
249 }
250
251 if (h->metaf) {
252 print_tagq(h, h->metaf);
253 h->metaf = NULL;
254 }
255
256 h->metal = h->metac;
257 h->metac = font;
258
f88b6c16 259 switch (font) {
070c62a6 260 case HTMLFONT_ITALIC:
f88b6c16
FF
261 h->metaf = print_otag(h, TAG_I, 0, NULL);
262 break;
070c62a6 263 case HTMLFONT_BOLD:
f88b6c16
FF
264 h->metaf = print_otag(h, TAG_B, 0, NULL);
265 break;
070c62a6 266 case HTMLFONT_BI:
f88b6c16
FF
267 h->metaf = print_otag(h, TAG_B, 0, NULL);
268 print_otag(h, TAG_I, 0, NULL);
269 break;
270 default:
271 break;
272 }
80387638
SW
273}
274
a4c7eb57
SW
275int
276html_strlen(const char *cp)
277{
f88b6c16
FF
278 size_t rsz;
279 int skip, sz;
a4c7eb57
SW
280
281 /*
282 * Account for escaped sequences within string length
283 * calculations. This follows the logic in term_strlen() as we
284 * must calculate the width of produced strings.
285 * Assume that characters are always width of "1". This is
286 * hacky, but it gets the job done for approximation of widths.
287 */
288
289 sz = 0;
f88b6c16
FF
290 skip = 0;
291 while (1) {
292 rsz = strcspn(cp, "\\");
293 if (rsz) {
294 cp += rsz;
295 if (skip) {
296 skip = 0;
297 rsz--;
298 }
299 sz += rsz;
300 }
301 if ('\0' == *cp)
302 break;
303 cp++;
304 switch (mandoc_escape(&cp, NULL, NULL)) {
070c62a6 305 case ESCAPE_ERROR:
a4c7eb57 306 return(sz);
070c62a6 307 case ESCAPE_UNICODE:
a4c7eb57 308 /* FALLTHROUGH */
070c62a6 309 case ESCAPE_NUMBERED:
a4c7eb57 310 /* FALLTHROUGH */
070c62a6 311 case ESCAPE_SPECIAL:
f88b6c16
FF
312 if (skip)
313 skip = 0;
314 else
315 sz++;
316 break;
070c62a6 317 case ESCAPE_SKIPCHAR:
f88b6c16 318 skip = 1;
a4c7eb57
SW
319 break;
320 default:
321 break;
322 }
323 }
f88b6c16 324 return(sz);
a4c7eb57 325}
80387638 326
070c62a6
FF
327static int
328print_escape(char c)
329{
330
331 switch (c) {
332 case '<':
333 printf("&lt;");
334 break;
335 case '>':
336 printf("&gt;");
337 break;
338 case '&':
339 printf("&amp;");
340 break;
341 case '"':
342 printf("&quot;");
343 break;
344 case ASCII_NBRSP:
345 putchar('-');
346 break;
347 case ASCII_HYPH:
348 putchar('-');
349 /* FALLTHROUGH */
350 case ASCII_BREAK:
351 break;
352 default:
353 return(0);
354 }
355 return(1);
356}
357
80387638
SW
358static int
359print_encode(struct html *h, const char *p, int norecurse)
360{
361 size_t sz;
a4c7eb57 362 int c, len, nospace;
80387638 363 const char *seq;
a4c7eb57 364 enum mandoc_esc esc;
070c62a6
FF
365 static const char rejs[9] = { '\\', '<', '>', '&', '"',
366 ASCII_NBRSP, ASCII_HYPH, ASCII_BREAK, '\0' };
80387638
SW
367
368 nospace = 0;
369
a4c7eb57 370 while ('\0' != *p) {
f88b6c16
FF
371 if (HTML_SKIPCHAR & h->flags && '\\' != *p) {
372 h->flags &= ~HTML_SKIPCHAR;
373 p++;
374 continue;
375 }
376
80387638
SW
377 sz = strcspn(p, rejs);
378
379 fwrite(p, 1, sz, stdout);
a4c7eb57
SW
380 p += (int)sz;
381
382 if ('\0' == *p)
383 break;
80387638 384
070c62a6 385 if (print_escape(*p++))
80387638 386 continue;
80387638 387
a4c7eb57
SW
388 esc = mandoc_escape(&p, &seq, &len);
389 if (ESCAPE_ERROR == esc)
390 break;
80387638 391
f88b6c16 392 switch (esc) {
070c62a6 393 case ESCAPE_FONT:
f88b6c16 394 /* FALLTHROUGH */
070c62a6 395 case ESCAPE_FONTPREV:
f88b6c16 396 /* FALLTHROUGH */
070c62a6 397 case ESCAPE_FONTBOLD:
f88b6c16 398 /* FALLTHROUGH */
070c62a6 399 case ESCAPE_FONTITALIC:
f88b6c16 400 /* FALLTHROUGH */
070c62a6 401 case ESCAPE_FONTBI:
f88b6c16 402 /* FALLTHROUGH */
070c62a6 403 case ESCAPE_FONTROMAN:
f88b6c16
FF
404 if (0 == norecurse)
405 print_metaf(h, esc);
406 continue;
070c62a6 407 case ESCAPE_SKIPCHAR:
f88b6c16
FF
408 h->flags |= HTML_SKIPCHAR;
409 continue;
410 default:
411 break;
412 }
413
414 if (h->flags & HTML_SKIPCHAR) {
415 h->flags &= ~HTML_SKIPCHAR;
416 continue;
417 }
418
a4c7eb57 419 switch (esc) {
070c62a6
FF
420 case ESCAPE_UNICODE:
421 /* Skip past "u" header. */
a4c7eb57
SW
422 c = mchars_num2uc(seq + 1, len - 1);
423 if ('\0' != c)
424 printf("&#x%x;", c);
60e1e752 425 break;
070c62a6 426 case ESCAPE_NUMBERED:
a4c7eb57 427 c = mchars_num2char(seq, len);
070c62a6 428 if ( ! ('\0' == c || print_escape(c)))
a4c7eb57 429 putchar(c);
80387638 430 break;
070c62a6 431 case ESCAPE_SPECIAL:
a4c7eb57
SW
432 c = mchars_spec2cp(h->symtab, seq, len);
433 if (c > 0)
434 printf("&#%d;", c);
070c62a6
FF
435 else if (-1 == c && 1 == len &&
436 !print_escape(*seq))
a4c7eb57 437 putchar((int)*seq);
80387638 438 break;
070c62a6 439 case ESCAPE_NOSPACE:
a4c7eb57
SW
440 if ('\0' == *p)
441 nospace = 1;
80387638
SW
442 break;
443 default:
444 break;
445 }
80387638
SW
446 }
447
448 return(nospace);
449}
450
80387638
SW
451static void
452print_attr(struct html *h, const char *key, const char *val)
453{
454 printf(" %s=\"", key);
455 (void)print_encode(h, val, 1);
456 putchar('\"');
457}
458
80387638 459struct tag *
070c62a6 460print_otag(struct html *h, enum htmltag tag,
80387638
SW
461 int sz, const struct htmlpair *p)
462{
463 int i;
464 struct tag *t;
465
466 /* Push this tags onto the stack of open scopes. */
467
468 if ( ! (HTML_NOSTACK & htmltags[tag].flags)) {
60e1e752 469 t = mandoc_malloc(sizeof(struct tag));
80387638
SW
470 t->tag = tag;
471 t->next = h->tags.head;
472 h->tags.head = t;
473 } else
474 t = NULL;
475
476 if ( ! (HTML_NOSPACE & h->flags))
477 if ( ! (HTML_CLRLINE & htmltags[tag].flags)) {
478 /* Manage keeps! */
479 if ( ! (HTML_KEEP & h->flags)) {
480 if (HTML_PREKEEP & h->flags)
481 h->flags |= HTML_KEEP;
482 putchar(' ');
483 } else
484 printf("&#160;");
485 }
486
487 if ( ! (h->flags & HTML_NONOSPACE))
488 h->flags &= ~HTML_NOSPACE;
489 else
490 h->flags |= HTML_NOSPACE;
491
492 /* Print out the tag name and attributes. */
493
494 printf("<%s", htmltags[tag].name);
495 for (i = 0; i < sz; i++)
496 print_attr(h, htmlattrs[p[i].key], p[i].val);
497
498 /* Add non-overridable attributes. */
499
500 if (TAG_HTML == tag && HTML_XHTML_1_0_STRICT == h->type) {
501 print_attr(h, "xmlns", "http://www.w3.org/1999/xhtml");
502 print_attr(h, "xml:lang", "en");
503 print_attr(h, "lang", "en");
504 }
505
a4c7eb57 506 /* Accommodate for XML "well-formed" singleton escaping. */
80387638
SW
507
508 if (HTML_AUTOCLOSE & htmltags[tag].flags)
509 switch (h->type) {
070c62a6 510 case HTML_XHTML_1_0_STRICT:
80387638
SW
511 putchar('/');
512 break;
513 default:
514 break;
515 }
516
517 putchar('>');
518
519 h->flags |= HTML_NOSPACE;
520
521 if ((HTML_AUTOCLOSE | HTML_CLRLINE) & htmltags[tag].flags)
522 putchar('\n');
523
524 return(t);
525}
526
80387638
SW
527static void
528print_ctag(struct html *h, enum htmltag tag)
529{
070c62a6 530
80387638
SW
531 printf("</%s>", htmltags[tag].name);
532 if (HTML_CLRLINE & htmltags[tag].flags) {
533 h->flags |= HTML_NOSPACE;
534 putchar('\n');
070c62a6 535 }
80387638
SW
536}
537
80387638
SW
538void
539print_gen_decls(struct html *h)
80387638
SW
540{
541 const char *doctype;
542 const char *dtd;
543 const char *name;
544
545 switch (h->type) {
070c62a6 546 case HTML_HTML_4_01_STRICT:
80387638
SW
547 name = "HTML";
548 doctype = "-//W3C//DTD HTML 4.01//EN";
549 dtd = "http://www.w3.org/TR/html4/strict.dtd";
550 break;
551 default:
a4c7eb57 552 puts("<?xml version=\"1.0\" encoding=\"UTF-8\"?>");
80387638
SW
553 name = "html";
554 doctype = "-//W3C//DTD XHTML 1.0 Strict//EN";
555 dtd = "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd";
556 break;
557 }
558
070c62a6
FF
559 printf("<!DOCTYPE %s PUBLIC \"%s\" \"%s\">\n",
560 name, doctype, dtd);
80387638
SW
561}
562
80387638
SW
563void
564print_text(struct html *h, const char *word)
565{
566
80387638
SW
567 if ( ! (HTML_NOSPACE & h->flags)) {
568 /* Manage keeps! */
569 if ( ! (HTML_KEEP & h->flags)) {
570 if (HTML_PREKEEP & h->flags)
571 h->flags |= HTML_KEEP;
572 putchar(' ');
573 } else
574 printf("&#160;");
575 }
576
577 assert(NULL == h->metaf);
f88b6c16 578 switch (h->metac) {
070c62a6 579 case HTMLFONT_ITALIC:
f88b6c16
FF
580 h->metaf = print_otag(h, TAG_I, 0, NULL);
581 break;
070c62a6 582 case HTMLFONT_BOLD:
f88b6c16
FF
583 h->metaf = print_otag(h, TAG_B, 0, NULL);
584 break;
070c62a6 585 case HTMLFONT_BI:
f88b6c16
FF
586 h->metaf = print_otag(h, TAG_B, 0, NULL);
587 print_otag(h, TAG_I, 0, NULL);
588 break;
589 default:
590 break;
591 }
80387638
SW
592
593 assert(word);
36342e81 594 if ( ! print_encode(h, word, 0)) {
80387638
SW
595 if ( ! (h->flags & HTML_NONOSPACE))
596 h->flags &= ~HTML_NOSPACE;
36342e81
SW
597 } else
598 h->flags |= HTML_NOSPACE;
80387638
SW
599
600 if (h->metaf) {
601 print_tagq(h, h->metaf);
602 h->metaf = NULL;
603 }
604
605 h->flags &= ~HTML_IGNDELIM;
80387638
SW
606}
607
80387638
SW
608void
609print_tagq(struct html *h, const struct tag *until)
610{
611 struct tag *tag;
612
613 while ((tag = h->tags.head) != NULL) {
070c62a6 614 /*
60e1e752
SW
615 * Remember to close out and nullify the current
616 * meta-font and table, if applicable.
617 */
80387638
SW
618 if (tag == h->metaf)
619 h->metaf = NULL;
60e1e752
SW
620 if (tag == h->tblt)
621 h->tblt = NULL;
80387638
SW
622 print_ctag(h, tag->tag);
623 h->tags.head = tag->next;
624 free(tag);
625 if (until && tag == until)
626 return;
627 }
628}
629
80387638
SW
630void
631print_stagq(struct html *h, const struct tag *suntil)
632{
633 struct tag *tag;
634
635 while ((tag = h->tags.head) != NULL) {
636 if (suntil && tag == suntil)
637 return;
070c62a6 638 /*
60e1e752
SW
639 * Remember to close out and nullify the current
640 * meta-font and table, if applicable.
641 */
80387638
SW
642 if (tag == h->metaf)
643 h->metaf = NULL;
60e1e752
SW
644 if (tag == h->tblt)
645 h->tblt = NULL;
80387638
SW
646 print_ctag(h, tag->tag);
647 h->tags.head = tag->next;
648 free(tag);
649 }
650}
651
80387638
SW
652void
653bufinit(struct html *h)
654{
655
656 h->buf[0] = '\0';
657 h->buflen = 0;
658}
659
80387638
SW
660void
661bufcat_style(struct html *h, const char *key, const char *val)
662{
663
664 bufcat(h, key);
a4c7eb57 665 bufcat(h, ":");
80387638 666 bufcat(h, val);
a4c7eb57 667 bufcat(h, ";");
80387638
SW
668}
669
80387638
SW
670void
671bufcat(struct html *h, const char *p)
672{
673
070c62a6
FF
674 /*
675 * XXX This is broken and not easy to fix.
676 * When using the -Oincludes option, buffmt_includes()
677 * may pass in strings overrunning BUFSIZ, causing a crash.
678 */
679
a4c7eb57
SW
680 h->buflen = strlcat(h->buf, p, BUFSIZ);
681 assert(h->buflen < BUFSIZ);
80387638
SW
682}
683
80387638 684void
a4c7eb57 685bufcat_fmt(struct html *h, const char *fmt, ...)
80387638
SW
686{
687 va_list ap;
688
689 va_start(ap, fmt);
070c62a6
FF
690 (void)vsnprintf(h->buf + (int)h->buflen,
691 BUFSIZ - h->buflen - 1, fmt, ap);
80387638
SW
692 va_end(ap);
693 h->buflen = strlen(h->buf);
694}
695
a4c7eb57 696static void
80387638
SW
697bufncat(struct html *h, const char *p, size_t sz)
698{
699
a4c7eb57
SW
700 assert(h->buflen + sz + 1 < BUFSIZ);
701 strncat(h->buf, p, sz);
80387638
SW
702 h->buflen += sz;
703}
704
80387638
SW
705void
706buffmt_includes(struct html *h, const char *name)
707{
708 const char *p, *pp;
709
710 pp = h->base_includes;
070c62a6 711
a4c7eb57 712 bufinit(h);
80387638
SW
713 while (NULL != (p = strchr(pp, '%'))) {
714 bufncat(h, pp, (size_t)(p - pp));
715 switch (*(p + 1)) {
070c62a6 716 case'I':
80387638
SW
717 bufcat(h, name);
718 break;
719 default:
720 bufncat(h, p, 2);
721 break;
722 }
723 pp = p + 2;
724 }
725 if (pp)
726 bufcat(h, pp);
727}
728
80387638 729void
070c62a6 730buffmt_man(struct html *h, const char *name, const char *sec)
80387638
SW
731{
732 const char *p, *pp;
733
734 pp = h->base_man;
070c62a6 735
a4c7eb57 736 bufinit(h);
80387638
SW
737 while (NULL != (p = strchr(pp, '%'))) {
738 bufncat(h, pp, (size_t)(p - pp));
739 switch (*(p + 1)) {
070c62a6 740 case 'S':
80387638
SW
741 bufcat(h, sec ? sec : "1");
742 break;
070c62a6
FF
743 case 'N':
744 bufcat_fmt(h, "%s", name);
80387638
SW
745 break;
746 default:
747 bufncat(h, p, 2);
748 break;
749 }
750 pp = p + 2;
751 }
752 if (pp)
753 bufcat(h, pp);
754}
755
80387638
SW
756void
757bufcat_su(struct html *h, const char *p, const struct roffsu *su)
758{
759 double v;
80387638
SW
760
761 v = su->scale;
a4c7eb57
SW
762 if (SCALE_MM == su->unit && 0.0 == (v /= 100.0))
763 v = 1.0;
80387638 764
a4c7eb57 765 bufcat_fmt(h, "%s: %.2f%s;", p, v, roffscales[su->unit]);
80387638
SW
766}
767
80387638 768void
a4c7eb57 769bufcat_id(struct html *h, const char *src)
80387638 770{
80387638
SW
771
772 /* Cf. <http://www.w3.org/TR/html4/types.html#h-6.2>. */
773
a4c7eb57
SW
774 while ('\0' != *src)
775 bufcat_fmt(h, "%.2x", *src++);
80387638 776}