Annotation of mandoc/mdoc_term.c, Revision 1.25
1.25 ! kristaps 1: /* $Id: mdoc_term.c,v 1.24 2009/07/12 08:49:50 kristaps Exp $ */
1.1 kristaps 2: /*
1.7 kristaps 3: * Copyright (c) 2008, 2009 Kristaps Dzonsons <kristaps@kth.se>
1.1 kristaps 4: *
5: * Permission to use, copy, modify, and distribute this software for any
1.6 kristaps 6: * purpose with or without fee is hereby granted, provided that the above
7: * copyright notice and this permission notice appear in all copies.
1.1 kristaps 8: *
1.6 kristaps 9: * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10: * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11: * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12: * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13: * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14: * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15: * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
1.1 kristaps 16: */
17: #include <sys/types.h>
18:
19: #include <assert.h>
20: #include <ctype.h>
21: #include <err.h>
22: #include <stdio.h>
23: #include <stdlib.h>
24: #include <string.h>
25:
26: #include "term.h"
27: #include "mdoc.h"
28:
29: /* FIXME: macro arguments can be escaped. */
30: /* FIXME: support more offset/width tokens. */
31:
32: #define TTYPE_PROG 0
33: #define TTYPE_CMD_FLAG 1
34: #define TTYPE_CMD_ARG 2
35: #define TTYPE_SECTION 3
36: #define TTYPE_FUNC_DECL 4
37: #define TTYPE_VAR_DECL 5
38: #define TTYPE_FUNC_TYPE 6
39: #define TTYPE_FUNC_NAME 7
40: #define TTYPE_FUNC_ARG 8
41: #define TTYPE_LINK 9
42: #define TTYPE_SSECTION 10
43: #define TTYPE_FILE 11
44: #define TTYPE_EMPH 12
45: #define TTYPE_CONFIG 13
46: #define TTYPE_CMD 14
47: #define TTYPE_INCLUDE 15
48: #define TTYPE_SYMB 16
49: #define TTYPE_SYMBOL 17
50: #define TTYPE_DIAG 18
51: #define TTYPE_LINK_ANCHOR 19
52: #define TTYPE_LINK_TEXT 20
53: #define TTYPE_REF_JOURNAL 21
54: #define TTYPE_LIST 22
55: #define TTYPE_NMAX 23
56:
57: const int ttypes[TTYPE_NMAX] = {
58: TERMP_BOLD, /* TTYPE_PROG */
59: TERMP_BOLD, /* TTYPE_CMD_FLAG */
60: TERMP_UNDER, /* TTYPE_CMD_ARG */
61: TERMP_BOLD, /* TTYPE_SECTION */
62: TERMP_BOLD, /* TTYPE_FUNC_DECL */
63: TERMP_UNDER, /* TTYPE_VAR_DECL */
64: TERMP_UNDER, /* TTYPE_FUNC_TYPE */
65: TERMP_BOLD, /* TTYPE_FUNC_NAME */
66: TERMP_UNDER, /* TTYPE_FUNC_ARG */
67: TERMP_UNDER, /* TTYPE_LINK */
68: TERMP_BOLD, /* TTYPE_SSECTION */
69: TERMP_UNDER, /* TTYPE_FILE */
70: TERMP_UNDER, /* TTYPE_EMPH */
71: TERMP_BOLD, /* TTYPE_CONFIG */
72: TERMP_BOLD, /* TTYPE_CMD */
73: TERMP_BOLD, /* TTYPE_INCLUDE */
74: TERMP_BOLD, /* TTYPE_SYMB */
75: TERMP_BOLD, /* TTYPE_SYMBOL */
76: TERMP_BOLD, /* TTYPE_DIAG */
77: TERMP_UNDER, /* TTYPE_LINK_ANCHOR */
78: TERMP_BOLD, /* TTYPE_LINK_TEXT */
79: TERMP_UNDER, /* TTYPE_REF_JOURNAL */
80: TERMP_BOLD /* TTYPE_LIST */
81: };
82:
83: /* XXX - clean this up. */
84:
85: struct termpair {
86: struct termpair *ppair;
87: int type;
88: #define TERMPAIR_FLAG (1 << 0)
1.10 kristaps 89: int flag; /* Whether being used. */
90: size_t offset; /* Left margin. */
91: size_t rmargin; /* Right margin. */
92: int count; /* Enum count. */
1.1 kristaps 93: };
94:
95: #define TERMPAIR_SETFLAG(termp, p, fl) \
96: do { \
97: assert(! (TERMPAIR_FLAG & (p)->type)); \
98: (termp)->flags |= (fl); \
99: (p)->flag = (fl); \
100: (p)->type |= TERMPAIR_FLAG; \
101: } while ( /* CONSTCOND */ 0)
102:
103: #define DECL_ARGS \
104: struct termp *p, struct termpair *pair, \
105: const struct mdoc_meta *meta, \
106: const struct mdoc_node *node
107:
108: #define DECL_PRE(name) \
109: static int name##_pre(DECL_ARGS)
110: #define DECL_POST(name) \
111: static void name##_post(DECL_ARGS)
112: #define DECL_PREPOST(name) \
113: DECL_PRE(name); \
114: DECL_POST(name);
115:
116: DECL_PREPOST(termp__t);
117: DECL_PREPOST(termp_aq);
118: DECL_PREPOST(termp_bd);
119: DECL_PREPOST(termp_bq);
120: DECL_PREPOST(termp_brq);
121: DECL_PREPOST(termp_d1);
122: DECL_PREPOST(termp_dq);
123: DECL_PREPOST(termp_fd);
124: DECL_PREPOST(termp_fn);
125: DECL_PREPOST(termp_fo);
126: DECL_PREPOST(termp_ft);
127: DECL_PREPOST(termp_in);
128: DECL_PREPOST(termp_it);
129: DECL_PREPOST(termp_lb);
130: DECL_PREPOST(termp_op);
131: DECL_PREPOST(termp_pf);
132: DECL_PREPOST(termp_pq);
133: DECL_PREPOST(termp_qq);
134: DECL_PREPOST(termp_sh);
135: DECL_PREPOST(termp_ss);
136: DECL_PREPOST(termp_sq);
137: DECL_PREPOST(termp_vt);
138:
139: DECL_PRE(termp__j);
140: DECL_PRE(termp_ap);
141: DECL_PRE(termp_ar);
142: DECL_PRE(termp_at);
143: DECL_PRE(termp_bf);
144: DECL_PRE(termp_bsx);
145: DECL_PRE(termp_bt);
146: DECL_PRE(termp_cd);
147: DECL_PRE(termp_cm);
148: DECL_PRE(termp_dx);
149: DECL_PRE(termp_em);
150: DECL_PRE(termp_ex);
151: DECL_PRE(termp_fa);
152: DECL_PRE(termp_fl);
153: DECL_PRE(termp_fx);
154: DECL_PRE(termp_ic);
155: DECL_PRE(termp_lk);
156: DECL_PRE(termp_ms);
157: DECL_PRE(termp_mt);
158: DECL_PRE(termp_nd);
159: DECL_PRE(termp_nm);
160: DECL_PRE(termp_ns);
161: DECL_PRE(termp_nx);
162: DECL_PRE(termp_ox);
163: DECL_PRE(termp_pa);
164: DECL_PRE(termp_pp);
165: DECL_PRE(termp_rs);
166: DECL_PRE(termp_rv);
167: DECL_PRE(termp_sm);
168: DECL_PRE(termp_st);
169: DECL_PRE(termp_sx);
170: DECL_PRE(termp_sy);
171: DECL_PRE(termp_ud);
172: DECL_PRE(termp_ux);
173: DECL_PRE(termp_va);
174: DECL_PRE(termp_xr);
175:
176: DECL_POST(termp___);
177: DECL_POST(termp_bl);
178: DECL_POST(termp_bx);
179:
180: struct termact {
181: int (*pre)(DECL_ARGS);
182: void (*post)(DECL_ARGS);
183: };
184:
185: static const struct termact termacts[MDOC_MAX] = {
1.14 kristaps 186: { termp_ap_pre, NULL }, /* Ap */
1.1 kristaps 187: { NULL, NULL }, /* Dd */
188: { NULL, NULL }, /* Dt */
189: { NULL, NULL }, /* Os */
190: { termp_sh_pre, termp_sh_post }, /* Sh */
191: { termp_ss_pre, termp_ss_post }, /* Ss */
192: { termp_pp_pre, NULL }, /* Pp */
193: { termp_d1_pre, termp_d1_post }, /* D1 */
194: { termp_d1_pre, termp_d1_post }, /* Dl */
195: { termp_bd_pre, termp_bd_post }, /* Bd */
196: { NULL, NULL }, /* Ed */
197: { NULL, termp_bl_post }, /* Bl */
198: { NULL, NULL }, /* El */
199: { termp_it_pre, termp_it_post }, /* It */
200: { NULL, NULL }, /* Ad */
201: { NULL, NULL }, /* An */
202: { termp_ar_pre, NULL }, /* Ar */
203: { termp_cd_pre, NULL }, /* Cd */
204: { termp_cm_pre, NULL }, /* Cm */
205: { NULL, NULL }, /* Dv */
206: { NULL, NULL }, /* Er */
207: { NULL, NULL }, /* Ev */
208: { termp_ex_pre, NULL }, /* Ex */
209: { termp_fa_pre, NULL }, /* Fa */
210: { termp_fd_pre, termp_fd_post }, /* Fd */
211: { termp_fl_pre, NULL }, /* Fl */
212: { termp_fn_pre, termp_fn_post }, /* Fn */
213: { termp_ft_pre, termp_ft_post }, /* Ft */
214: { termp_ic_pre, NULL }, /* Ic */
215: { termp_in_pre, termp_in_post }, /* In */
216: { NULL, NULL }, /* Li */
217: { termp_nd_pre, NULL }, /* Nd */
218: { termp_nm_pre, NULL }, /* Nm */
219: { termp_op_pre, termp_op_post }, /* Op */
220: { NULL, NULL }, /* Ot */
221: { termp_pa_pre, NULL }, /* Pa */
222: { termp_rv_pre, NULL }, /* Rv */
223: { termp_st_pre, NULL }, /* St */
224: { termp_va_pre, NULL }, /* Va */
225: { termp_vt_pre, termp_vt_post }, /* Vt */
226: { termp_xr_pre, NULL }, /* Xr */
227: { NULL, termp____post }, /* %A */
228: { NULL, termp____post }, /* %B */
229: { NULL, termp____post }, /* %D */
230: { NULL, termp____post }, /* %I */
231: { termp__j_pre, termp____post }, /* %J */
232: { NULL, termp____post }, /* %N */
233: { NULL, termp____post }, /* %O */
234: { NULL, termp____post }, /* %P */
235: { NULL, termp____post }, /* %R */
236: { termp__t_pre, termp__t_post }, /* %T */
237: { NULL, termp____post }, /* %V */
238: { NULL, NULL }, /* Ac */
239: { termp_aq_pre, termp_aq_post }, /* Ao */
240: { termp_aq_pre, termp_aq_post }, /* Aq */
241: { termp_at_pre, NULL }, /* At */
242: { NULL, NULL }, /* Bc */
243: { termp_bf_pre, NULL }, /* Bf */
244: { termp_bq_pre, termp_bq_post }, /* Bo */
245: { termp_bq_pre, termp_bq_post }, /* Bq */
246: { termp_bsx_pre, NULL }, /* Bsx */
247: { NULL, termp_bx_post }, /* Bx */
248: { NULL, NULL }, /* Db */
249: { NULL, NULL }, /* Dc */
250: { termp_dq_pre, termp_dq_post }, /* Do */
251: { termp_dq_pre, termp_dq_post }, /* Dq */
252: { NULL, NULL }, /* Ec */
253: { NULL, NULL }, /* Ef */
254: { termp_em_pre, NULL }, /* Em */
255: { NULL, NULL }, /* Eo */
256: { termp_fx_pre, NULL }, /* Fx */
257: { termp_ms_pre, NULL }, /* Ms */
258: { NULL, NULL }, /* No */
259: { termp_ns_pre, NULL }, /* Ns */
260: { termp_nx_pre, NULL }, /* Nx */
261: { termp_ox_pre, NULL }, /* Ox */
262: { NULL, NULL }, /* Pc */
263: { termp_pf_pre, termp_pf_post }, /* Pf */
264: { termp_pq_pre, termp_pq_post }, /* Po */
265: { termp_pq_pre, termp_pq_post }, /* Pq */
266: { NULL, NULL }, /* Qc */
267: { termp_sq_pre, termp_sq_post }, /* Ql */
268: { termp_qq_pre, termp_qq_post }, /* Qo */
269: { termp_qq_pre, termp_qq_post }, /* Qq */
270: { NULL, NULL }, /* Re */
271: { termp_rs_pre, NULL }, /* Rs */
272: { NULL, NULL }, /* Sc */
273: { termp_sq_pre, termp_sq_post }, /* So */
274: { termp_sq_pre, termp_sq_post }, /* Sq */
275: { termp_sm_pre, NULL }, /* Sm */
276: { termp_sx_pre, NULL }, /* Sx */
277: { termp_sy_pre, NULL }, /* Sy */
278: { NULL, NULL }, /* Tn */
279: { termp_ux_pre, NULL }, /* Ux */
280: { NULL, NULL }, /* Xc */
281: { NULL, NULL }, /* Xo */
282: { termp_fo_pre, termp_fo_post }, /* Fo */
283: { NULL, NULL }, /* Fc */
284: { termp_op_pre, termp_op_post }, /* Oo */
285: { NULL, NULL }, /* Oc */
286: { NULL, NULL }, /* Bk */
287: { NULL, NULL }, /* Ek */
288: { termp_bt_pre, NULL }, /* Bt */
289: { NULL, NULL }, /* Hf */
290: { NULL, NULL }, /* Fr */
291: { termp_ud_pre, NULL }, /* Ud */
292: { termp_lb_pre, termp_lb_post }, /* Lb */
1.14 kristaps 293: { termp_pp_pre, NULL }, /* Lp */
1.1 kristaps 294: { termp_lk_pre, NULL }, /* Lk */
295: { termp_mt_pre, NULL }, /* Mt */
296: { termp_brq_pre, termp_brq_post }, /* Brq */
297: { termp_brq_pre, termp_brq_post }, /* Bro */
298: { NULL, NULL }, /* Brc */
299: { NULL, NULL }, /* %C */
300: { NULL, NULL }, /* Es */
301: { NULL, NULL }, /* En */
302: { termp_dx_pre, NULL }, /* Dx */
303: { NULL, NULL }, /* %Q */
304: };
305:
1.2 kristaps 306: #ifdef __linux__
1.9 kristaps 307: extern size_t strlcpy(char *, const char *, size_t);
308: extern size_t strlcat(char *, const char *, size_t);
1.2 kristaps 309: #endif
310:
1.1 kristaps 311: static int arg_hasattr(int, const struct mdoc_node *);
312: static int arg_getattrs(const int *, int *, size_t,
313: const struct mdoc_node *);
314: static int arg_getattr(int, const struct mdoc_node *);
315: static size_t arg_offset(const struct mdoc_argv *);
316: static size_t arg_width(const struct mdoc_argv *, int);
317: static int arg_listtype(const struct mdoc_node *);
318: static int fmt_block_vspace(struct termp *,
319: const struct mdoc_node *,
320: const struct mdoc_node *);
1.3 kristaps 321: static void print_node(DECL_ARGS);
322: static void print_head(struct termp *,
1.1 kristaps 323: const struct mdoc_meta *);
1.3 kristaps 324: static void print_body(DECL_ARGS);
325: static void print_foot(struct termp *,
1.1 kristaps 326: const struct mdoc_meta *);
327:
328:
329: int
330: mdoc_run(struct termp *p, const struct mdoc *m)
331: {
1.9 kristaps 332: /*
333: * Main output function. When this is called, assume that the
334: * tree is properly formed.
335: */
1.1 kristaps 336:
1.3 kristaps 337: print_head(p, mdoc_meta(m));
1.14 kristaps 338: assert(mdoc_node(m));
339: assert(MDOC_ROOT == mdoc_node(m)->type);
340: if (mdoc_node(m)->child)
341: print_body(p, NULL, mdoc_meta(m), mdoc_node(m)->child);
1.3 kristaps 342: print_foot(p, mdoc_meta(m));
343: return(1);
1.1 kristaps 344: }
345:
346:
1.3 kristaps 347: static void
1.1 kristaps 348: print_body(DECL_ARGS)
349: {
350:
1.3 kristaps 351: print_node(p, pair, meta, node);
1.1 kristaps 352: if ( ! node->next)
1.3 kristaps 353: return;
354: print_body(p, pair, meta, node->next);
1.1 kristaps 355: }
356:
357:
1.3 kristaps 358: static void
1.1 kristaps 359: print_node(DECL_ARGS)
360: {
361: int dochild;
362: struct termpair npair;
363:
364: /* Pre-processing. */
365:
366: dochild = 1;
367: npair.ppair = pair;
368: npair.type = 0;
369: npair.offset = npair.rmargin = 0;
370: npair.flag = 0;
371: npair.count = 0;
372:
373: if (MDOC_TEXT != node->type) {
374: if (termacts[node->tok].pre)
375: if ( ! (*termacts[node->tok].pre)(p, &npair, meta, node))
376: dochild = 0;
377: } else /* MDOC_TEXT == node->type */
378: term_word(p, node->string);
379:
380: /* Children. */
381:
382: if (TERMPAIR_FLAG & npair.type)
383: p->flags |= npair.flag;
384:
385: if (dochild && node->child)
386: print_body(p, &npair, meta, node->child);
387:
388: if (TERMPAIR_FLAG & npair.type)
389: p->flags &= ~npair.flag;
390:
391: /* Post-processing. */
392:
393: if (MDOC_TEXT != node->type)
394: if (termacts[node->tok].post)
395: (*termacts[node->tok].post)(p, &npair, meta, node);
396: }
397:
398:
1.3 kristaps 399: static void
1.1 kristaps 400: print_foot(struct termp *p, const struct mdoc_meta *meta)
401: {
402: struct tm *tm;
403: char *buf, *os;
404:
1.9 kristaps 405: /*
406: * Output the footer in new-groff style, that is, three columns
407: * with the middle being the manual date and flanking columns
408: * being the operating system:
409: *
410: * SYSTEM DATE SYSTEM
411: */
412:
1.1 kristaps 413: if (NULL == (buf = malloc(p->rmargin)))
414: err(1, "malloc");
415: if (NULL == (os = malloc(p->rmargin)))
416: err(1, "malloc");
417:
418: tm = localtime(&meta->date);
419:
420: if (0 == strftime(buf, p->rmargin, "%B %d, %Y", tm))
421: err(1, "strftime");
422:
423: (void)strlcpy(os, meta->os, p->rmargin);
424:
425: term_vspace(p);
426:
1.9 kristaps 427: p->offset = 0;
428: p->rmargin = (p->maxrmargin - strlen(buf) + 1) / 2;
1.1 kristaps 429: p->flags |= TERMP_NOSPACE | TERMP_NOBREAK;
430:
431: term_word(p, os);
432: term_flushln(p);
433:
1.9 kristaps 434: p->offset = p->rmargin;
435: p->rmargin = p->maxrmargin - strlen(os);
1.1 kristaps 436: p->flags |= TERMP_NOLPAD | TERMP_NOSPACE;
1.9 kristaps 437:
438: term_word(p, buf);
439: term_flushln(p);
440:
1.1 kristaps 441: p->offset = p->rmargin;
442: p->rmargin = p->maxrmargin;
443: p->flags &= ~TERMP_NOBREAK;
1.9 kristaps 444: p->flags |= TERMP_NOLPAD | TERMP_NOSPACE;
1.1 kristaps 445:
1.9 kristaps 446: term_word(p, os);
1.1 kristaps 447: term_flushln(p);
448:
1.9 kristaps 449: p->offset = 0;
450: p->rmargin = p->maxrmargin;
451: p->flags = 0;
452:
1.1 kristaps 453: free(buf);
454: free(os);
455: }
456:
457:
1.3 kristaps 458: static void
1.1 kristaps 459: print_head(struct termp *p, const struct mdoc_meta *meta)
460: {
461: char *buf, *title;
462:
463: p->rmargin = p->maxrmargin;
464: p->offset = 0;
465:
466: if (NULL == (buf = malloc(p->rmargin)))
467: err(1, "malloc");
468: if (NULL == (title = malloc(p->rmargin)))
469: err(1, "malloc");
470:
471: /*
472: * The header is strange. It has three components, which are
473: * really two with the first duplicated. It goes like this:
474: *
475: * IDENTIFIER TITLE IDENTIFIER
476: *
477: * The IDENTIFIER is NAME(SECTION), which is the command-name
478: * (if given, or "unknown" if not) followed by the manual page
479: * section. These are given in `Dt'. The TITLE is a free-form
480: * string depending on the manual volume. If not specified, it
481: * switches on the manual section.
482: */
483:
484: assert(meta->vol);
485: (void)strlcpy(buf, meta->vol, p->rmargin);
486:
487: if (meta->arch) {
488: (void)strlcat(buf, " (", p->rmargin);
489: (void)strlcat(buf, meta->arch, p->rmargin);
490: (void)strlcat(buf, ")", p->rmargin);
491: }
492:
493: (void)snprintf(title, p->rmargin, "%s(%d)",
494: meta->title, meta->msec);
495:
496: p->offset = 0;
1.8 kristaps 497: p->rmargin = (p->maxrmargin - strlen(buf) + 1) / 2;
1.1 kristaps 498: p->flags |= TERMP_NOBREAK | TERMP_NOSPACE;
499:
500: term_word(p, title);
501: term_flushln(p);
502:
503: p->offset = p->rmargin;
504: p->rmargin = p->maxrmargin - strlen(title);
1.9 kristaps 505: p->flags |= TERMP_NOLPAD | TERMP_NOSPACE;
1.1 kristaps 506:
507: term_word(p, buf);
508: term_flushln(p);
509:
510: p->offset = p->rmargin;
511: p->rmargin = p->maxrmargin;
512: p->flags &= ~TERMP_NOBREAK;
513: p->flags |= TERMP_NOLPAD | TERMP_NOSPACE;
514:
515: term_word(p, title);
516: term_flushln(p);
517:
1.9 kristaps 518: p->offset = 0;
1.1 kristaps 519: p->rmargin = p->maxrmargin;
520: p->flags &= ~TERMP_NOSPACE;
521:
522: free(title);
523: free(buf);
524: }
525:
526:
527: static size_t
528: arg_width(const struct mdoc_argv *arg, int pos)
529: {
530: size_t v;
531: int i, len;
532:
533: assert(pos < (int)arg->sz && pos >= 0);
534: assert(arg->value[pos]);
535:
536: if (0 == (len = (int)strlen(arg->value[pos])))
537: return(0);
538:
539: for (i = 0; i < len - 1; i++)
540: if ( ! isdigit((u_char)arg->value[pos][i]))
541: break;
542:
543: if (i == len - 1) {
1.16 kristaps 544: if ('n' == arg->value[pos][len - 1] ||
545: 'm' == arg->value[pos][len - 1]) {
1.1 kristaps 546: v = (size_t)atoi(arg->value[pos]);
1.16 kristaps 547: return(v + 2);
1.1 kristaps 548: }
549:
550: }
1.16 kristaps 551: return(strlen(arg->value[pos]) + 2);
1.1 kristaps 552: }
553:
554:
555: static int
556: arg_listtype(const struct mdoc_node *n)
557: {
558: int i, len;
559:
560: assert(MDOC_BLOCK == n->type);
561:
562: len = (int)(n->args ? n->args->argc : 0);
563:
564: for (i = 0; i < len; i++)
565: switch (n->args->argv[i].arg) {
566: case (MDOC_Bullet):
567: /* FALLTHROUGH */
568: case (MDOC_Dash):
569: /* FALLTHROUGH */
570: case (MDOC_Enum):
571: /* FALLTHROUGH */
572: case (MDOC_Hyphen):
573: /* FALLTHROUGH */
574: case (MDOC_Tag):
575: /* FALLTHROUGH */
576: case (MDOC_Inset):
577: /* FALLTHROUGH */
578: case (MDOC_Diag):
579: /* FALLTHROUGH */
580: case (MDOC_Item):
581: /* FALLTHROUGH */
582: case (MDOC_Column):
583: /* FALLTHROUGH */
584: case (MDOC_Ohang):
585: return(n->args->argv[i].arg);
586: default:
587: break;
588: }
589:
1.11 kristaps 590: /* FIXME: mandated by parser. */
591:
1.1 kristaps 592: errx(1, "list type not supported");
593: /* NOTREACHED */
594: }
595:
596:
597: static size_t
598: arg_offset(const struct mdoc_argv *arg)
599: {
600:
601: assert(*arg->value);
1.10 kristaps 602: if (0 == strcmp(*arg->value, "left"))
1.19 kristaps 603: return(0);
1.1 kristaps 604: if (0 == strcmp(*arg->value, "indent"))
1.16 kristaps 605: return(INDENT + 1);
1.1 kristaps 606: if (0 == strcmp(*arg->value, "indent-two"))
1.20 kristaps 607: return((INDENT + 1) * 2);
1.10 kristaps 608:
609: /* FIXME: needs to support field-widths (10n, etc.). */
1.11 kristaps 610:
1.1 kristaps 611: return(strlen(*arg->value));
612: }
613:
614:
615: static int
616: arg_hasattr(int arg, const struct mdoc_node *n)
617: {
618:
619: return(-1 != arg_getattr(arg, n));
620: }
621:
622:
623: static int
624: arg_getattr(int v, const struct mdoc_node *n)
625: {
626: int val;
627:
628: return(arg_getattrs(&v, &val, 1, n) ? val : -1);
629: }
630:
631:
632: static int
633: arg_getattrs(const int *keys, int *vals,
634: size_t sz, const struct mdoc_node *n)
635: {
636: int i, j, k;
637:
638: if (NULL == n->args)
639: return(0);
640:
641: for (k = i = 0; i < (int)n->args->argc; i++)
642: for (j = 0; j < (int)sz; j++)
643: if (n->args->argv[i].arg == keys[j]) {
644: vals[j] = i;
645: k++;
646: }
647: return(k);
648: }
649:
650:
651: /* ARGSUSED */
652: static int
653: fmt_block_vspace(struct termp *p,
654: const struct mdoc_node *bl,
655: const struct mdoc_node *node)
656: {
657: const struct mdoc_node *n;
658:
659: term_newln(p);
660:
661: if (arg_hasattr(MDOC_Compact, bl))
662: return(1);
663:
664: for (n = node; n; n = n->parent) {
665: if (MDOC_BLOCK != n->type)
666: continue;
667: if (MDOC_Ss == n->tok)
668: break;
669: if (MDOC_Sh == n->tok)
670: break;
671: if (NULL == n->prev)
672: continue;
673: term_vspace(p);
674: break;
675: }
676:
677: return(1);
678: }
679:
680:
681: /* ARGSUSED */
682: static int
683: termp_dq_pre(DECL_ARGS)
684: {
685:
686: if (MDOC_BODY != node->type)
687: return(1);
688:
689: term_word(p, "\\(lq");
690: p->flags |= TERMP_NOSPACE;
691: return(1);
692: }
693:
694:
695: /* ARGSUSED */
696: static void
697: termp_dq_post(DECL_ARGS)
698: {
699:
700: if (MDOC_BODY != node->type)
701: return;
702:
703: p->flags |= TERMP_NOSPACE;
704: term_word(p, "\\(rq");
705: }
706:
707:
708: /* ARGSUSED */
709: static int
710: termp_it_pre(DECL_ARGS)
711: {
712: const struct mdoc_node *bl, *n;
713: char buf[7];
1.15 kristaps 714: int i, type, keys[3], vals[3], sv;
1.1 kristaps 715: size_t width, offset;
716:
717: if (MDOC_BLOCK == node->type)
718: return(fmt_block_vspace(p, node->parent->parent, node));
719:
720: bl = node->parent->parent->parent;
721:
722: /* Save parent attributes. */
723:
724: pair->offset = p->offset;
725: pair->rmargin = p->rmargin;
726: pair->flag = p->flags;
727:
728: /* Get list width and offset. */
729:
730: keys[0] = MDOC_Width;
731: keys[1] = MDOC_Offset;
732: keys[2] = MDOC_Column;
733:
734: vals[0] = vals[1] = vals[2] = -1;
735:
736: width = offset = 0;
737:
738: (void)arg_getattrs(keys, vals, 3, bl);
739:
740: type = arg_listtype(bl);
741:
742: /* Calculate real width and offset. */
743:
744: switch (type) {
745: case (MDOC_Column):
746: if (MDOC_BODY == node->type)
747: break;
748: for (i = 0, n = node->prev; n; n = n->prev, i++)
749: offset += arg_width
750: (&bl->args->argv[vals[2]], i);
751: assert(i < (int)bl->args->argv[vals[2]].sz);
752: width = arg_width(&bl->args->argv[vals[2]], i);
753: if (vals[1] >= 0)
754: offset += arg_offset(&bl->args->argv[vals[1]]);
755: break;
756: default:
757: if (vals[0] >= 0)
758: width = arg_width(&bl->args->argv[vals[0]], 0);
759: if (vals[1] >= 0)
1.19 kristaps 760: offset += arg_offset(&bl->args->argv[vals[1]]);
1.1 kristaps 761: break;
762: }
763:
764: /*
765: * List-type can override the width in the case of fixed-head
766: * values (bullet, dash/hyphen, enum). Tags need a non-zero
767: * offset.
768: */
769:
770: switch (type) {
771: case (MDOC_Bullet):
772: /* FALLTHROUGH */
773: case (MDOC_Dash):
774: /* FALLTHROUGH */
775: case (MDOC_Hyphen):
776: if (width < 4)
777: width = 4;
778: break;
1.17 kristaps 779: case (MDOC_Enum):
780: if (width < 5)
781: width = 5;
782: break;
1.1 kristaps 783: case (MDOC_Tag):
784: if (0 == width)
785: width = 10;
786: break;
787: default:
788: break;
789: }
790:
791: /*
1.17 kristaps 792: * Whitespace control. Inset bodies need an initial space,
793: * while diagonal bodies need two.
1.1 kristaps 794: */
795:
796: switch (type) {
797: case (MDOC_Diag):
1.17 kristaps 798: term_word(p, "\\ ");
1.1 kristaps 799: /* FALLTHROUGH */
800: case (MDOC_Inset):
801: if (MDOC_BODY == node->type)
802: p->flags &= ~TERMP_NOSPACE;
803: else
804: p->flags |= TERMP_NOSPACE;
805: break;
806: default:
807: p->flags |= TERMP_NOSPACE;
808: break;
809: }
810:
811: /*
812: * Style flags. Diagnostic heads need TTYPE_DIAG.
813: */
814:
815: switch (type) {
816: case (MDOC_Diag):
817: if (MDOC_HEAD == node->type)
818: p->flags |= ttypes[TTYPE_DIAG];
819: break;
820: default:
821: break;
822: }
823:
824: /*
825: * Pad and break control. This is the tricker part. Lists with
826: * set right-margins for the head get TERMP_NOBREAK because, if
827: * they overrun the margin, they wrap to the new margin.
828: * Correspondingly, the body for these types don't left-pad, as
829: * the head will pad out to to the right.
830: */
831:
832: switch (type) {
833: case (MDOC_Bullet):
834: /* FALLTHROUGH */
835: case (MDOC_Dash):
836: /* FALLTHROUGH */
837: case (MDOC_Enum):
838: /* FALLTHROUGH */
839: case (MDOC_Hyphen):
840: /* FALLTHROUGH */
841: case (MDOC_Tag):
842: if (MDOC_HEAD == node->type)
843: p->flags |= TERMP_NOBREAK;
844: else
845: p->flags |= TERMP_NOLPAD;
846: if (MDOC_HEAD == node->type && MDOC_Tag == type)
847: if (NULL == node->next ||
848: NULL == node->next->child)
849: p->flags |= TERMP_NONOBREAK;
850: break;
851: case (MDOC_Column):
852: if (MDOC_HEAD == node->type) {
853: assert(node->next);
854: if (MDOC_BODY == node->next->type)
855: p->flags &= ~TERMP_NOBREAK;
856: else
857: p->flags |= TERMP_NOBREAK;
858: if (node->prev)
859: p->flags |= TERMP_NOLPAD;
860: }
861: break;
862: case (MDOC_Diag):
863: if (MDOC_HEAD == node->type)
864: p->flags |= TERMP_NOBREAK;
865: break;
866: default:
867: break;
868: }
869:
870: /*
871: * Margin control. Set-head-width lists have their right
872: * margins shortened. The body for these lists has the offset
873: * necessarily lengthened. Everybody gets the offset.
874: */
875:
876: p->offset += offset;
877:
878: switch (type) {
879: case (MDOC_Bullet):
880: /* FALLTHROUGH */
881: case (MDOC_Dash):
882: /* FALLTHROUGH */
883: case (MDOC_Enum):
884: /* FALLTHROUGH */
885: case (MDOC_Hyphen):
886: /* FALLTHROUGH */
887: case (MDOC_Tag):
888: if (MDOC_HEAD == node->type)
889: p->rmargin = p->offset + width;
890: else
891: p->offset += width;
892: break;
893: case (MDOC_Column):
894: p->rmargin = p->offset + width;
895: break;
896: default:
897: break;
898: }
899:
900: /*
901: * The dash, hyphen, bullet and enum lists all have a special
1.15 kristaps 902: * HEAD character (temporarily bold, in some cases).
1.1 kristaps 903: */
904:
1.15 kristaps 905: sv = p->flags;
1.1 kristaps 906: if (MDOC_HEAD == node->type)
907: switch (type) {
908: case (MDOC_Bullet):
1.15 kristaps 909: p->flags |= TERMP_BOLD;
1.1 kristaps 910: term_word(p, "\\[bu]");
911: break;
912: case (MDOC_Dash):
913: /* FALLTHROUGH */
914: case (MDOC_Hyphen):
1.15 kristaps 915: p->flags |= TERMP_BOLD;
1.1 kristaps 916: term_word(p, "\\-");
917: break;
918: case (MDOC_Enum):
919: (pair->ppair->ppair->count)++;
920: (void)snprintf(buf, sizeof(buf), "%d.",
921: pair->ppair->ppair->count);
922: term_word(p, buf);
923: break;
924: default:
925: break;
926: }
927:
1.15 kristaps 928: p->flags = sv; /* Restore saved flags. */
929:
1.1 kristaps 930: /*
931: * If we're not going to process our children, indicate so here.
932: */
933:
934: switch (type) {
935: case (MDOC_Bullet):
936: /* FALLTHROUGH */
937: case (MDOC_Item):
938: /* FALLTHROUGH */
939: case (MDOC_Dash):
940: /* FALLTHROUGH */
941: case (MDOC_Hyphen):
942: /* FALLTHROUGH */
943: case (MDOC_Enum):
944: if (MDOC_HEAD == node->type)
945: return(0);
946: break;
947: case (MDOC_Column):
948: if (MDOC_BODY == node->type)
949: return(0);
950: break;
951: default:
952: break;
953: }
954:
955: return(1);
956: }
957:
958:
959: /* ARGSUSED */
960: static void
961: termp_it_post(DECL_ARGS)
962: {
963: int type;
964:
965: if (MDOC_BODY != node->type && MDOC_HEAD != node->type)
966: return;
967:
968: type = arg_listtype(node->parent->parent->parent);
969:
970: switch (type) {
971: case (MDOC_Diag):
972: /* FALLTHROUGH */
973: case (MDOC_Item):
974: /* FALLTHROUGH */
975: case (MDOC_Inset):
976: if (MDOC_BODY == node->type)
977: term_flushln(p);
978: break;
979: case (MDOC_Column):
980: if (MDOC_HEAD == node->type)
981: term_flushln(p);
982: break;
983: default:
984: term_flushln(p);
985: break;
986: }
987:
988: p->offset = pair->offset;
989: p->rmargin = pair->rmargin;
990: p->flags = pair->flag;
991: }
992:
993:
994: /* ARGSUSED */
995: static int
996: termp_nm_pre(DECL_ARGS)
997: {
998:
999: if (SEC_SYNOPSIS == node->sec)
1000: term_newln(p);
1001:
1002: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_PROG]);
1003: if (NULL == node->child)
1004: term_word(p, meta->name);
1005:
1006: return(1);
1007: }
1008:
1009:
1010: /* ARGSUSED */
1011: static int
1012: termp_fl_pre(DECL_ARGS)
1013: {
1014:
1015: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_CMD_FLAG]);
1016: term_word(p, "\\-");
1017: p->flags |= TERMP_NOSPACE;
1018: return(1);
1019: }
1020:
1021:
1022: /* ARGSUSED */
1023: static int
1024: termp_ar_pre(DECL_ARGS)
1025: {
1026:
1027: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_CMD_ARG]);
1028: return(1);
1029: }
1030:
1031:
1032: /* ARGSUSED */
1033: static int
1034: termp_ns_pre(DECL_ARGS)
1035: {
1036:
1037: p->flags |= TERMP_NOSPACE;
1038: return(1);
1039: }
1040:
1041:
1042: /* ARGSUSED */
1043: static int
1044: termp_pp_pre(DECL_ARGS)
1045: {
1046:
1047: term_vspace(p);
1048: return(1);
1049: }
1050:
1051:
1052: /* ARGSUSED */
1053: static int
1054: termp_st_pre(DECL_ARGS)
1055: {
1056: const char *cp;
1057:
1058: if (node->child && (cp = mdoc_a2st(node->child->string)))
1059: term_word(p, cp);
1060: return(0);
1061: }
1062:
1063:
1064: /* ARGSUSED */
1065: static int
1066: termp_rs_pre(DECL_ARGS)
1067: {
1068:
1069: if (MDOC_BLOCK == node->type && node->prev)
1070: term_vspace(p);
1071: return(1);
1072: }
1073:
1074:
1075: /* ARGSUSED */
1076: static int
1077: termp_rv_pre(DECL_ARGS)
1078: {
1079: int i;
1080:
1.11 kristaps 1081: /* FIXME: mandated by parser. */
1082:
1.1 kristaps 1083: if (-1 == (i = arg_getattr(MDOC_Std, node)))
1084: errx(1, "expected -std argument");
1085: if (1 != node->args->argv[i].sz)
1086: errx(1, "expected -std argument");
1087:
1088: term_newln(p);
1089: term_word(p, "The");
1090:
1091: p->flags |= ttypes[TTYPE_FUNC_NAME];
1092: term_word(p, *node->args->argv[i].value);
1093: p->flags &= ~ttypes[TTYPE_FUNC_NAME];
1094: p->flags |= TERMP_NOSPACE;
1095:
1096: term_word(p, "() function returns the value 0 if successful;");
1097: term_word(p, "otherwise the value -1 is returned and the");
1098: term_word(p, "global variable");
1099:
1100: p->flags |= ttypes[TTYPE_VAR_DECL];
1101: term_word(p, "errno");
1102: p->flags &= ~ttypes[TTYPE_VAR_DECL];
1103:
1104: term_word(p, "is set to indicate the error.");
1105:
1106: return(1);
1107: }
1108:
1109:
1110: /* ARGSUSED */
1111: static int
1112: termp_ex_pre(DECL_ARGS)
1113: {
1114: int i;
1115:
1.11 kristaps 1116: /* FIXME: mandated by parser? */
1117:
1.1 kristaps 1118: if (-1 == (i = arg_getattr(MDOC_Std, node)))
1119: errx(1, "expected -std argument");
1120: if (1 != node->args->argv[i].sz)
1121: errx(1, "expected -std argument");
1122:
1123: term_word(p, "The");
1124: p->flags |= ttypes[TTYPE_PROG];
1125: term_word(p, *node->args->argv[i].value);
1126: p->flags &= ~ttypes[TTYPE_PROG];
1127: term_word(p, "utility exits 0 on success, and >0 if an error occurs.");
1128:
1129: return(1);
1130: }
1131:
1132:
1133: /* ARGSUSED */
1134: static int
1135: termp_nd_pre(DECL_ARGS)
1136: {
1.25 ! kristaps 1137:
! 1138: if (MDOC_BODY != node->type)
! 1139: return(1);
1.24 kristaps 1140: /*
1141: * XXX: signed off by jmc@openbsd.org. This technically
1142: * produces a minus sign after the Nd, which is wrong, but is
1143: * consistent with the historic OpenBSD tmac file.
1144: */
1.23 kristaps 1145: #ifdef __OpenBSD__
1.1 kristaps 1146: term_word(p, "\\-");
1.23 kristaps 1147: #else
1148: term_word(p, "\\(em");
1149: #endif
1.1 kristaps 1150: return(1);
1151: }
1152:
1153:
1154: /* ARGSUSED */
1155: static void
1156: termp_bl_post(DECL_ARGS)
1157: {
1158:
1159: if (MDOC_BLOCK == node->type)
1160: term_newln(p);
1161: }
1162:
1163:
1164: /* ARGSUSED */
1165: static void
1166: termp_op_post(DECL_ARGS)
1167: {
1168:
1169: if (MDOC_BODY != node->type)
1170: return;
1171: p->flags |= TERMP_NOSPACE;
1172: term_word(p, "\\(rB");
1173: }
1174:
1175:
1176: /* ARGSUSED */
1177: static int
1178: termp_xr_pre(DECL_ARGS)
1179: {
1180: const struct mdoc_node *n;
1181:
1.11 kristaps 1182: assert(node->child && MDOC_TEXT == node->child->type);
1183: n = node->child;
1184:
1.1 kristaps 1185: term_word(p, n->string);
1186: if (NULL == (n = n->next))
1187: return(0);
1188: p->flags |= TERMP_NOSPACE;
1189: term_word(p, "(");
1190: p->flags |= TERMP_NOSPACE;
1191: term_word(p, n->string);
1192: p->flags |= TERMP_NOSPACE;
1193: term_word(p, ")");
1194: return(0);
1195: }
1196:
1197:
1198: /* ARGSUSED */
1199: static int
1200: termp_vt_pre(DECL_ARGS)
1201: {
1202:
1203: /* FIXME: this can be "type name". */
1204: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_VAR_DECL]);
1205: return(1);
1206: }
1207:
1208:
1209: /* ARGSUSED */
1210: static void
1211: termp_vt_post(DECL_ARGS)
1212: {
1213:
1214: if (node->sec == SEC_SYNOPSIS)
1215: term_vspace(p);
1216: }
1217:
1218:
1219: /* ARGSUSED */
1220: static int
1221: termp_fd_pre(DECL_ARGS)
1222: {
1223:
1224: /*
1225: * FIXME: this naming is bad. This value is used, in general,
1226: * for the #include header or other preprocessor statement.
1227: */
1228: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_FUNC_DECL]);
1229: return(1);
1230: }
1231:
1232:
1233: /* ARGSUSED */
1234: static void
1235: termp_fd_post(DECL_ARGS)
1236: {
1237:
1238: if (node->sec != SEC_SYNOPSIS)
1239: return;
1240: term_newln(p);
1241: if (node->next && MDOC_Fd != node->next->tok)
1242: term_vspace(p);
1243: }
1244:
1245:
1246: /* ARGSUSED */
1247: static int
1248: termp_sh_pre(DECL_ARGS)
1249: {
1250:
1251: switch (node->type) {
1252: case (MDOC_HEAD):
1253: term_vspace(p);
1254: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_SECTION]);
1255: break;
1256: case (MDOC_BODY):
1257: p->offset = INDENT;
1258: break;
1259: default:
1260: break;
1261: }
1262: return(1);
1263: }
1264:
1265:
1266: /* ARGSUSED */
1267: static void
1268: termp_sh_post(DECL_ARGS)
1269: {
1270:
1271: switch (node->type) {
1272: case (MDOC_HEAD):
1273: term_newln(p);
1274: break;
1275: case (MDOC_BODY):
1276: term_newln(p);
1277: p->offset = 0;
1278: break;
1279: default:
1280: break;
1281: }
1282: }
1283:
1284:
1285: /* ARGSUSED */
1286: static int
1287: termp_op_pre(DECL_ARGS)
1288: {
1289:
1290: switch (node->type) {
1291: case (MDOC_BODY):
1292: term_word(p, "\\(lB");
1293: p->flags |= TERMP_NOSPACE;
1294: break;
1295: default:
1296: break;
1297: }
1298: return(1);
1299: }
1300:
1301:
1302: /* ARGSUSED */
1303: static int
1304: termp_bt_pre(DECL_ARGS)
1305: {
1306:
1307: term_word(p, "is currently in beta test.");
1308: return(1);
1309: }
1310:
1311:
1312: /* ARGSUSED */
1313: static int
1314: termp_lb_pre(DECL_ARGS)
1315: {
1316: const char *lb;
1317:
1.11 kristaps 1318: assert(node->child && MDOC_TEXT == node->child->type);
1.18 kristaps 1319: lb = mdoc_a2lib(node->child->string);
1320: if (lb) {
1.1 kristaps 1321: term_word(p, lb);
1322: return(0);
1323: }
1324: term_word(p, "library");
1325: return(1);
1326: }
1327:
1328:
1329: /* ARGSUSED */
1330: static void
1331: termp_lb_post(DECL_ARGS)
1332: {
1333:
1334: term_newln(p);
1335: }
1336:
1337:
1338: /* ARGSUSED */
1339: static int
1340: termp_ud_pre(DECL_ARGS)
1341: {
1342:
1343: term_word(p, "currently under development.");
1344: return(1);
1345: }
1346:
1347:
1348: /* ARGSUSED */
1349: static int
1350: termp_d1_pre(DECL_ARGS)
1351: {
1352:
1.4 kristaps 1353: if (MDOC_BLOCK != node->type)
1.1 kristaps 1354: return(1);
1355: term_newln(p);
1.16 kristaps 1356: pair->offset = INDENT + 1;
1357: p->offset += pair->offset;
1.1 kristaps 1358: return(1);
1359: }
1360:
1361:
1362: /* ARGSUSED */
1363: static void
1364: termp_d1_post(DECL_ARGS)
1365: {
1366:
1.4 kristaps 1367: if (MDOC_BLOCK != node->type)
1.1 kristaps 1368: return;
1369: term_newln(p);
1370: p->offset -= pair->offset;
1371: }
1372:
1373:
1374: /* ARGSUSED */
1375: static int
1376: termp_aq_pre(DECL_ARGS)
1377: {
1378:
1379: if (MDOC_BODY != node->type)
1380: return(1);
1381: term_word(p, "\\(la");
1382: p->flags |= TERMP_NOSPACE;
1383: return(1);
1384: }
1385:
1386:
1387: /* ARGSUSED */
1388: static void
1389: termp_aq_post(DECL_ARGS)
1390: {
1391:
1392: if (MDOC_BODY != node->type)
1393: return;
1394: p->flags |= TERMP_NOSPACE;
1395: term_word(p, "\\(ra");
1396: }
1397:
1398:
1399: /* ARGSUSED */
1400: static int
1401: termp_ft_pre(DECL_ARGS)
1402: {
1403:
1404: if (SEC_SYNOPSIS == node->sec)
1405: if (node->prev && MDOC_Fo == node->prev->tok)
1406: term_vspace(p);
1407: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_FUNC_TYPE]);
1408: return(1);
1409: }
1410:
1411:
1412: /* ARGSUSED */
1413: static void
1414: termp_ft_post(DECL_ARGS)
1415: {
1416:
1417: if (SEC_SYNOPSIS == node->sec)
1418: term_newln(p);
1419: }
1420:
1421:
1422: /* ARGSUSED */
1423: static int
1424: termp_fn_pre(DECL_ARGS)
1425: {
1426: const struct mdoc_node *n;
1427:
1.11 kristaps 1428: assert(node->child && MDOC_TEXT == node->child->type);
1.1 kristaps 1429:
1430: /* FIXME: can be "type funcname" "type varname"... */
1431:
1432: p->flags |= ttypes[TTYPE_FUNC_NAME];
1433: term_word(p, node->child->string);
1434: p->flags &= ~ttypes[TTYPE_FUNC_NAME];
1435:
1436: p->flags |= TERMP_NOSPACE;
1437: term_word(p, "(");
1438:
1439: for (n = node->child->next; n; n = n->next) {
1440: p->flags |= ttypes[TTYPE_FUNC_ARG];
1441: term_word(p, n->string);
1442: p->flags &= ~ttypes[TTYPE_FUNC_ARG];
1443: if (n->next)
1444: term_word(p, ",");
1445: }
1446:
1447: term_word(p, ")");
1448:
1449: if (SEC_SYNOPSIS == node->sec)
1450: term_word(p, ";");
1451:
1452: return(0);
1453: }
1454:
1455:
1456: /* ARGSUSED */
1457: static void
1458: termp_fn_post(DECL_ARGS)
1459: {
1460:
1461: if (node->sec == SEC_SYNOPSIS && node->next)
1462: term_vspace(p);
1463:
1464: }
1465:
1466:
1467: /* ARGSUSED */
1468: static int
1469: termp_sx_pre(DECL_ARGS)
1470: {
1471:
1472: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_LINK]);
1473: return(1);
1474: }
1475:
1476:
1477: /* ARGSUSED */
1478: static int
1479: termp_fa_pre(DECL_ARGS)
1480: {
1481: struct mdoc_node *n;
1482:
1483: if (node->parent->tok != MDOC_Fo) {
1484: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_FUNC_ARG]);
1485: return(1);
1486: }
1487:
1488: for (n = node->child; n; n = n->next) {
1489: p->flags |= ttypes[TTYPE_FUNC_ARG];
1490: term_word(p, n->string);
1491: p->flags &= ~ttypes[TTYPE_FUNC_ARG];
1492: if (n->next)
1493: term_word(p, ",");
1494: }
1495:
1496: if (node->child && node->next && node->next->tok == MDOC_Fa)
1497: term_word(p, ",");
1498:
1499: return(0);
1500: }
1501:
1502:
1503: /* ARGSUSED */
1504: static int
1505: termp_va_pre(DECL_ARGS)
1506: {
1507:
1508: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_VAR_DECL]);
1509: return(1);
1510: }
1511:
1512:
1513: /* ARGSUSED */
1514: static int
1515: termp_bd_pre(DECL_ARGS)
1516: {
1517: int i, type, ln;
1518:
1519: /*
1520: * This is fairly tricky due primarily to crappy documentation.
1521: * If -ragged or -filled are specified, the block does nothing
1522: * but change the indentation.
1523: *
1524: * If, on the other hand, -unfilled or -literal are specified,
1525: * then the game changes. Text is printed exactly as entered in
1526: * the display: if a macro line, a newline is appended to the
1527: * line. Blank lines are allowed.
1528: */
1529:
1530: if (MDOC_BLOCK == node->type)
1531: return(fmt_block_vspace(p, node, node));
1532: else if (MDOC_BODY != node->type)
1533: return(1);
1534:
1.11 kristaps 1535: /* FIXME: display type should be mandated by parser. */
1536:
1.1 kristaps 1537: if (NULL == node->parent->args)
1538: errx(1, "missing display type");
1539:
1540: pair->offset = p->offset;
1541:
1542: for (type = -1, i = 0;
1543: i < (int)node->parent->args->argc; i++) {
1544: switch (node->parent->args->argv[i].arg) {
1545: case (MDOC_Ragged):
1546: /* FALLTHROUGH */
1547: case (MDOC_Filled):
1548: /* FALLTHROUGH */
1549: case (MDOC_Unfilled):
1550: /* FALLTHROUGH */
1551: case (MDOC_Literal):
1552: type = node->parent->args->argv[i].arg;
1553: i = (int)node->parent->args->argc;
1554: break;
1555: default:
1556: break;
1557: }
1558: }
1559:
1560: if (NULL == node->parent->args)
1561: errx(1, "missing display type");
1562:
1563: i = arg_getattr(MDOC_Offset, node->parent);
1564: if (-1 != i) {
1565: if (1 != node->parent->args->argv[i].sz)
1566: errx(1, "expected single value");
1567: p->offset += arg_offset(&node->parent->args->argv[i]);
1568: }
1569:
1570: switch (type) {
1571: case (MDOC_Literal):
1572: /* FALLTHROUGH */
1573: case (MDOC_Unfilled):
1574: break;
1575: default:
1576: return(1);
1577: }
1578:
1579: /*
1580: * Tricky. Iterate through all children. If we're on a
1581: * different parse line, append a newline and then the contents.
1582: * Ew.
1583: */
1584:
1585: p->flags |= TERMP_LITERAL;
1586: ln = node->child ? node->child->line : 0;
1587:
1588: for (node = node->child; node; node = node->next) {
1589: if (ln < node->line) {
1590: term_flushln(p);
1591: p->flags |= TERMP_NOSPACE;
1592: }
1593: ln = node->line;
1594: print_node(p, pair, meta, node);
1595: }
1596:
1597: return(0);
1598: }
1599:
1600:
1601: /* ARGSUSED */
1602: static void
1603: termp_bd_post(DECL_ARGS)
1604: {
1605:
1606: if (MDOC_BODY != node->type)
1607: return;
1608:
1609: term_flushln(p);
1610: p->flags &= ~TERMP_LITERAL;
1611: p->offset = pair->offset;
1612: p->flags |= TERMP_NOSPACE;
1613: }
1614:
1615:
1616: /* ARGSUSED */
1617: static int
1618: termp_qq_pre(DECL_ARGS)
1619: {
1620:
1621: if (MDOC_BODY != node->type)
1622: return(1);
1623: term_word(p, "\"");
1624: p->flags |= TERMP_NOSPACE;
1625: return(1);
1626: }
1627:
1628:
1629: /* ARGSUSED */
1630: static void
1631: termp_qq_post(DECL_ARGS)
1632: {
1633:
1634: if (MDOC_BODY != node->type)
1635: return;
1636: p->flags |= TERMP_NOSPACE;
1637: term_word(p, "\"");
1638: }
1639:
1640:
1641: /* ARGSUSED */
1642: static int
1643: termp_bsx_pre(DECL_ARGS)
1644: {
1645:
1646: term_word(p, "BSDI BSD/OS");
1647: return(1);
1648: }
1649:
1650:
1651: /* ARGSUSED */
1652: static void
1653: termp_bx_post(DECL_ARGS)
1654: {
1655:
1656: if (node->child)
1657: p->flags |= TERMP_NOSPACE;
1658: term_word(p, "BSD");
1659: }
1660:
1661:
1662: /* ARGSUSED */
1663: static int
1664: termp_ox_pre(DECL_ARGS)
1665: {
1666:
1667: term_word(p, "OpenBSD");
1668: return(1);
1669: }
1670:
1671:
1672: /* ARGSUSED */
1673: static int
1674: termp_dx_pre(DECL_ARGS)
1675: {
1676:
1677: term_word(p, "DragonFly");
1678: return(1);
1679: }
1680:
1681:
1682: /* ARGSUSED */
1683: static int
1684: termp_ux_pre(DECL_ARGS)
1685: {
1686:
1687: term_word(p, "UNIX");
1688: return(1);
1689: }
1690:
1691:
1692: /* ARGSUSED */
1693: static int
1694: termp_fx_pre(DECL_ARGS)
1695: {
1696:
1697: term_word(p, "FreeBSD");
1698: return(1);
1699: }
1700:
1701:
1702: /* ARGSUSED */
1703: static int
1704: termp_nx_pre(DECL_ARGS)
1705: {
1706:
1707: term_word(p, "NetBSD");
1708: return(1);
1709: }
1710:
1711:
1712: /* ARGSUSED */
1713: static int
1714: termp_sq_pre(DECL_ARGS)
1715: {
1716:
1717: if (MDOC_BODY != node->type)
1718: return(1);
1719: term_word(p, "\\(oq");
1720: p->flags |= TERMP_NOSPACE;
1721: return(1);
1722: }
1723:
1724:
1725: /* ARGSUSED */
1726: static void
1727: termp_sq_post(DECL_ARGS)
1728: {
1729:
1730: if (MDOC_BODY != node->type)
1731: return;
1732: p->flags |= TERMP_NOSPACE;
1733: term_word(p, "\\(aq");
1734: }
1735:
1736:
1737: /* ARGSUSED */
1738: static int
1739: termp_pf_pre(DECL_ARGS)
1740: {
1741:
1742: p->flags |= TERMP_IGNDELIM;
1743: return(1);
1744: }
1745:
1746:
1747: /* ARGSUSED */
1748: static void
1749: termp_pf_post(DECL_ARGS)
1750: {
1751:
1752: p->flags &= ~TERMP_IGNDELIM;
1753: p->flags |= TERMP_NOSPACE;
1754: }
1755:
1756:
1757: /* ARGSUSED */
1758: static int
1759: termp_ss_pre(DECL_ARGS)
1760: {
1761:
1762: switch (node->type) {
1763: case (MDOC_BLOCK):
1764: term_newln(p);
1765: if (node->prev)
1766: term_vspace(p);
1767: break;
1768: case (MDOC_HEAD):
1769: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_SSECTION]);
1.5 kristaps 1770: p->offset = HALFINDENT;
1.1 kristaps 1771: break;
1772: default:
1773: break;
1774: }
1775:
1776: return(1);
1777: }
1778:
1779:
1780: /* ARGSUSED */
1781: static void
1782: termp_ss_post(DECL_ARGS)
1783: {
1784:
1785: switch (node->type) {
1786: case (MDOC_HEAD):
1787: term_newln(p);
1788: p->offset = INDENT;
1789: break;
1790: default:
1791: break;
1792: }
1793: }
1794:
1795:
1796: /* ARGSUSED */
1797: static int
1798: termp_pa_pre(DECL_ARGS)
1799: {
1800:
1801: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_FILE]);
1802: return(1);
1803: }
1804:
1805:
1806: /* ARGSUSED */
1807: static int
1808: termp_em_pre(DECL_ARGS)
1809: {
1810:
1811: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_EMPH]);
1812: return(1);
1813: }
1814:
1815:
1816: /* ARGSUSED */
1817: static int
1818: termp_cd_pre(DECL_ARGS)
1819: {
1820:
1821: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_CONFIG]);
1822: term_newln(p);
1823: return(1);
1824: }
1825:
1826:
1827: /* ARGSUSED */
1828: static int
1829: termp_cm_pre(DECL_ARGS)
1830: {
1831:
1832: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_CMD_FLAG]);
1833: return(1);
1834: }
1835:
1836:
1837: /* ARGSUSED */
1838: static int
1839: termp_ic_pre(DECL_ARGS)
1840: {
1841:
1842: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_CMD]);
1843: return(1);
1844: }
1845:
1846:
1847: /* ARGSUSED */
1848: static int
1849: termp_in_pre(DECL_ARGS)
1850: {
1851:
1.22 kristaps 1852: /* XXX This conforms to new-groff style. */
1.1 kristaps 1853: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_INCLUDE]);
1.22 kristaps 1854:
1855: if (SEC_SYNOPSIS == node->sec)
1856: term_word(p, "#include");
1857:
1.1 kristaps 1858: term_word(p, "<");
1859: p->flags |= TERMP_NOSPACE;
1860: return(1);
1861: }
1862:
1863:
1864: /* ARGSUSED */
1865: static void
1866: termp_in_post(DECL_ARGS)
1867: {
1868:
1869: p->flags |= TERMP_NOSPACE;
1870: term_word(p, ">");
1871:
1872: if (SEC_SYNOPSIS != node->sec)
1873: return;
1.22 kristaps 1874:
1875: term_newln(p);
1876: /*
1877: * XXX Not entirely correct. If `.In foo bar' is specified in
1878: * the SYNOPSIS section, then it produces a single break after
1879: * the <foo>; mandoc asserts a vertical space. Since this
1880: * construction is rarely used, I think it's fine.
1881: */
1.1 kristaps 1882: if (node->next && MDOC_In != node->next->tok)
1883: term_vspace(p);
1884: }
1885:
1886:
1887: /* ARGSUSED */
1888: static int
1889: termp_at_pre(DECL_ARGS)
1890: {
1891: const char *att;
1892:
1893: att = NULL;
1894:
1895: if (node->child)
1896: att = mdoc_a2att(node->child->string);
1897: if (NULL == att)
1898: att = "AT&T UNIX";
1899:
1900: term_word(p, att);
1901: return(0);
1902: }
1903:
1904:
1905: /* ARGSUSED */
1906: static int
1907: termp_brq_pre(DECL_ARGS)
1908: {
1909:
1910: if (MDOC_BODY != node->type)
1911: return(1);
1912: term_word(p, "\\(lC");
1913: p->flags |= TERMP_NOSPACE;
1914: return(1);
1915: }
1916:
1917:
1918: /* ARGSUSED */
1919: static void
1920: termp_brq_post(DECL_ARGS)
1921: {
1922:
1923: if (MDOC_BODY != node->type)
1924: return;
1925: p->flags |= TERMP_NOSPACE;
1926: term_word(p, "\\(rC");
1927: }
1928:
1929:
1930: /* ARGSUSED */
1931: static int
1932: termp_bq_pre(DECL_ARGS)
1933: {
1934:
1935: if (MDOC_BODY != node->type)
1936: return(1);
1937: term_word(p, "\\(lB");
1938: p->flags |= TERMP_NOSPACE;
1939: return(1);
1940: }
1941:
1942:
1943: /* ARGSUSED */
1944: static void
1945: termp_bq_post(DECL_ARGS)
1946: {
1947:
1948: if (MDOC_BODY != node->type)
1949: return;
1950: p->flags |= TERMP_NOSPACE;
1951: term_word(p, "\\(rB");
1952: }
1953:
1954:
1955: /* ARGSUSED */
1956: static int
1957: termp_pq_pre(DECL_ARGS)
1958: {
1959:
1960: if (MDOC_BODY != node->type)
1961: return(1);
1962: term_word(p, "\\&(");
1963: p->flags |= TERMP_NOSPACE;
1964: return(1);
1965: }
1966:
1967:
1968: /* ARGSUSED */
1969: static void
1970: termp_pq_post(DECL_ARGS)
1971: {
1972:
1973: if (MDOC_BODY != node->type)
1974: return;
1975: term_word(p, ")");
1976: }
1977:
1978:
1979: /* ARGSUSED */
1980: static int
1981: termp_fo_pre(DECL_ARGS)
1982: {
1983: const struct mdoc_node *n;
1984:
1985: if (MDOC_BODY == node->type) {
1986: term_word(p, "(");
1987: p->flags |= TERMP_NOSPACE;
1988: return(1);
1989: } else if (MDOC_HEAD != node->type)
1990: return(1);
1991:
1992: /* XXX - groff shows only first parameter */
1993:
1994: p->flags |= ttypes[TTYPE_FUNC_NAME];
1995: for (n = node->child; n; n = n->next) {
1.11 kristaps 1996: assert(MDOC_TEXT == n->type);
1.1 kristaps 1997: term_word(p, n->string);
1998: }
1999: p->flags &= ~ttypes[TTYPE_FUNC_NAME];
2000:
2001: return(0);
2002: }
2003:
2004:
2005: /* ARGSUSED */
2006: static void
2007: termp_fo_post(DECL_ARGS)
2008: {
2009:
2010: if (MDOC_BODY != node->type)
2011: return;
2012: p->flags |= TERMP_NOSPACE;
2013: term_word(p, ")");
2014: p->flags |= TERMP_NOSPACE;
2015: term_word(p, ";");
2016: term_newln(p);
2017: }
2018:
2019:
2020: /* ARGSUSED */
2021: static int
2022: termp_bf_pre(DECL_ARGS)
2023: {
2024: const struct mdoc_node *n;
2025:
2026: if (MDOC_HEAD == node->type) {
2027: return(0);
2028: } else if (MDOC_BLOCK != node->type)
2029: return(1);
2030:
2031: if (NULL == (n = node->head->child)) {
2032: if (arg_hasattr(MDOC_Emphasis, node))
2033: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_EMPH]);
2034: else if (arg_hasattr(MDOC_Symbolic, node))
2035: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_SYMB]);
2036:
2037: return(1);
2038: }
2039:
1.11 kristaps 2040: assert(MDOC_TEXT == n->type);
1.1 kristaps 2041: if (0 == strcmp("Em", n->string))
2042: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_EMPH]);
2043: else if (0 == strcmp("Sy", n->string))
2044: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_EMPH]);
2045:
2046: return(1);
2047: }
2048:
2049:
2050: /* ARGSUSED */
2051: static int
2052: termp_sy_pre(DECL_ARGS)
2053: {
2054:
2055: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_SYMB]);
2056: return(1);
2057: }
2058:
2059:
2060: /* ARGSUSED */
2061: static int
2062: termp_ms_pre(DECL_ARGS)
2063: {
2064:
2065: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_SYMBOL]);
2066: return(1);
2067: }
2068:
2069:
2070:
2071: /* ARGSUSED */
2072: static int
2073: termp_sm_pre(DECL_ARGS)
2074: {
2075:
1.11 kristaps 2076: assert(node->child && MDOC_TEXT == node->child->type);
1.1 kristaps 2077: if (0 == strcmp("on", node->child->string)) {
2078: p->flags &= ~TERMP_NONOSPACE;
2079: p->flags &= ~TERMP_NOSPACE;
2080: } else
2081: p->flags |= TERMP_NONOSPACE;
2082:
2083: return(0);
2084: }
2085:
2086:
2087: /* ARGSUSED */
2088: static int
2089: termp_ap_pre(DECL_ARGS)
2090: {
2091:
2092: p->flags |= TERMP_NOSPACE;
2093: term_word(p, "\\(aq");
2094: p->flags |= TERMP_NOSPACE;
2095: return(1);
2096: }
2097:
2098:
2099: /* ARGSUSED */
2100: static int
2101: termp__j_pre(DECL_ARGS)
2102: {
2103:
2104: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_REF_JOURNAL]);
2105: return(1);
2106: }
2107:
2108:
2109: /* ARGSUSED */
2110: static int
2111: termp__t_pre(DECL_ARGS)
2112: {
2113:
2114: term_word(p, "\"");
2115: p->flags |= TERMP_NOSPACE;
2116: return(1);
2117: }
2118:
2119:
2120: /* ARGSUSED */
2121: static void
2122: termp__t_post(DECL_ARGS)
2123: {
2124:
2125: p->flags |= TERMP_NOSPACE;
2126: term_word(p, "\"");
2127: termp____post(p, pair, meta, node);
2128: }
2129:
2130:
2131: /* ARGSUSED */
2132: static void
2133: termp____post(DECL_ARGS)
2134: {
2135:
2136: p->flags |= TERMP_NOSPACE;
2137: term_word(p, node->next ? "," : ".");
2138: }
2139:
2140:
2141: /* ARGSUSED */
2142: static int
2143: termp_lk_pre(DECL_ARGS)
2144: {
2145: const struct mdoc_node *n;
2146:
1.11 kristaps 2147: assert(node->child);
2148: n = node->child;
1.1 kristaps 2149:
1.12 kristaps 2150: if (NULL == n->next) {
2151: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_LINK_ANCHOR]);
2152: return(1);
2153: }
2154:
1.1 kristaps 2155: p->flags |= ttypes[TTYPE_LINK_ANCHOR];
2156: term_word(p, n->string);
2157: p->flags |= TERMP_NOSPACE;
2158: term_word(p, ":");
1.12 kristaps 2159: p->flags &= ~ttypes[TTYPE_LINK_ANCHOR];
1.1 kristaps 2160:
2161: p->flags |= ttypes[TTYPE_LINK_TEXT];
1.12 kristaps 2162: for (n = n->next; n; n = n->next)
1.1 kristaps 2163: term_word(p, n->string);
1.12 kristaps 2164:
1.1 kristaps 2165: p->flags &= ~ttypes[TTYPE_LINK_TEXT];
2166: return(0);
2167: }
2168:
2169:
2170: /* ARGSUSED */
2171: static int
2172: termp_mt_pre(DECL_ARGS)
2173: {
2174:
2175: TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_LINK_ANCHOR]);
2176: return(1);
2177: }
2178:
2179:
CVSweb