Annotation of src/usr.bin/mandoc/mdoc_term.c, Revision 1.151
1.151 ! schwarze 1: /* $Id: mdoc_term.c,v 1.150 2013/05/29 16:11:32 schwarze Exp $ */
1.1 kristaps 2: /*
1.122 schwarze 3: * Copyright (c) 2008, 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
1.142 schwarze 4: * Copyright (c) 2010, 2012 Ingo Schwarze <schwarze@openbsd.org>
1.1 kristaps 5: *
6: * Permission to use, copy, modify, and distribute this software for any
1.2 schwarze 7: * purpose with or without fee is hereby granted, provided that the above
8: * copyright notice and this permission notice appear in all copies.
1.1 kristaps 9: *
1.2 schwarze 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.
1.1 kristaps 17: */
18: #include <sys/types.h>
19:
20: #include <assert.h>
21: #include <ctype.h>
1.77 schwarze 22: #include <stdint.h>
1.1 kristaps 23: #include <stdio.h>
24: #include <stdlib.h>
25: #include <string.h>
26:
1.81 schwarze 27: #include "mandoc.h"
1.61 schwarze 28: #include "out.h"
1.1 kristaps 29: #include "term.h"
30: #include "mdoc.h"
1.61 schwarze 31: #include "main.h"
1.54 schwarze 32:
1.1 kristaps 33: struct termpair {
34: struct termpair *ppair;
1.27 schwarze 35: int count;
1.1 kristaps 36: };
37:
1.29 schwarze 38: #define DECL_ARGS struct termp *p, \
39: struct termpair *pair, \
1.147 schwarze 40: const struct mdoc_meta *meta, \
1.146 schwarze 41: struct mdoc_node *n
1.1 kristaps 42:
43: struct termact {
44: int (*pre)(DECL_ARGS);
45: void (*post)(DECL_ARGS);
46: };
1.29 schwarze 47:
1.89 schwarze 48: static size_t a2width(const struct termp *, const char *);
49: static size_t a2height(const struct termp *, const char *);
50: static size_t a2offs(const struct termp *, const char *);
1.62 schwarze 51:
52: static void print_bvspace(struct termp *,
53: const struct mdoc_node *,
54: const struct mdoc_node *);
1.65 schwarze 55: static void print_mdoc_node(DECL_ARGS);
56: static void print_mdoc_nodelist(DECL_ARGS);
1.87 schwarze 57: static void print_mdoc_head(struct termp *, const void *);
58: static void print_mdoc_foot(struct termp *, const void *);
1.86 schwarze 59: static void synopsis_pre(struct termp *,
60: const struct mdoc_node *);
1.62 schwarze 61:
1.29 schwarze 62: static void termp____post(DECL_ARGS);
1.120 schwarze 63: static void termp__t_post(DECL_ARGS);
1.49 schwarze 64: static void termp_an_post(DECL_ARGS);
1.29 schwarze 65: static void termp_bd_post(DECL_ARGS);
1.90 schwarze 66: static void termp_bk_post(DECL_ARGS);
1.29 schwarze 67: static void termp_bl_post(DECL_ARGS);
1.143 schwarze 68: static void termp_fd_post(DECL_ARGS);
1.29 schwarze 69: static void termp_fo_post(DECL_ARGS);
70: static void termp_in_post(DECL_ARGS);
71: static void termp_it_post(DECL_ARGS);
72: static void termp_lb_post(DECL_ARGS);
1.94 schwarze 73: static void termp_nm_post(DECL_ARGS);
1.29 schwarze 74: static void termp_pf_post(DECL_ARGS);
1.107 schwarze 75: static void termp_quote_post(DECL_ARGS);
1.29 schwarze 76: static void termp_sh_post(DECL_ARGS);
77: static void termp_ss_post(DECL_ARGS);
78:
1.104 schwarze 79: static int termp__a_pre(DECL_ARGS);
1.120 schwarze 80: static int termp__t_pre(DECL_ARGS);
1.49 schwarze 81: static int termp_an_pre(DECL_ARGS);
1.29 schwarze 82: static int termp_ap_pre(DECL_ARGS);
83: static int termp_bd_pre(DECL_ARGS);
84: static int termp_bf_pre(DECL_ARGS);
1.90 schwarze 85: static int termp_bk_pre(DECL_ARGS);
1.73 schwarze 86: static int termp_bl_pre(DECL_ARGS);
1.54 schwarze 87: static int termp_bold_pre(DECL_ARGS);
1.29 schwarze 88: static int termp_bt_pre(DECL_ARGS);
1.126 schwarze 89: static int termp_bx_pre(DECL_ARGS);
1.29 schwarze 90: static int termp_cd_pre(DECL_ARGS);
91: static int termp_d1_pre(DECL_ARGS);
92: static int termp_ex_pre(DECL_ARGS);
93: static int termp_fa_pre(DECL_ARGS);
1.107 schwarze 94: static int termp_fd_pre(DECL_ARGS);
1.29 schwarze 95: static int termp_fl_pre(DECL_ARGS);
96: static int termp_fn_pre(DECL_ARGS);
97: static int termp_fo_pre(DECL_ARGS);
98: static int termp_ft_pre(DECL_ARGS);
1.109 schwarze 99: static int termp_igndelim_pre(DECL_ARGS);
1.29 schwarze 100: static int termp_in_pre(DECL_ARGS);
101: static int termp_it_pre(DECL_ARGS);
1.65 schwarze 102: static int termp_li_pre(DECL_ARGS);
1.29 schwarze 103: static int termp_lk_pre(DECL_ARGS);
104: static int termp_nd_pre(DECL_ARGS);
105: static int termp_nm_pre(DECL_ARGS);
106: static int termp_ns_pre(DECL_ARGS);
1.107 schwarze 107: static int termp_quote_pre(DECL_ARGS);
1.29 schwarze 108: static int termp_rs_pre(DECL_ARGS);
109: static int termp_rv_pre(DECL_ARGS);
110: static int termp_sh_pre(DECL_ARGS);
111: static int termp_sm_pre(DECL_ARGS);
1.38 schwarze 112: static int termp_sp_pre(DECL_ARGS);
1.29 schwarze 113: static int termp_ss_pre(DECL_ARGS);
1.54 schwarze 114: static int termp_under_pre(DECL_ARGS);
1.29 schwarze 115: static int termp_ud_pre(DECL_ARGS);
1.69 schwarze 116: static int termp_vt_pre(DECL_ARGS);
1.29 schwarze 117: static int termp_xr_pre(DECL_ARGS);
118: static int termp_xx_pre(DECL_ARGS);
1.1 kristaps 119:
1.54 schwarze 120: static const struct termact termacts[MDOC_MAX] = {
1.11 schwarze 121: { termp_ap_pre, NULL }, /* Ap */
1.1 kristaps 122: { NULL, NULL }, /* Dd */
123: { NULL, NULL }, /* Dt */
124: { NULL, NULL }, /* Os */
125: { termp_sh_pre, termp_sh_post }, /* Sh */
126: { termp_ss_pre, termp_ss_post }, /* Ss */
1.54 schwarze 127: { termp_sp_pre, NULL }, /* Pp */
1.143 schwarze 128: { termp_d1_pre, termp_bl_post }, /* D1 */
129: { termp_d1_pre, termp_bl_post }, /* Dl */
1.1 kristaps 130: { termp_bd_pre, termp_bd_post }, /* Bd */
131: { NULL, NULL }, /* Ed */
1.73 schwarze 132: { termp_bl_pre, termp_bl_post }, /* Bl */
1.1 kristaps 133: { NULL, NULL }, /* El */
134: { termp_it_pre, termp_it_post }, /* It */
1.99 schwarze 135: { termp_under_pre, NULL }, /* Ad */
1.49 schwarze 136: { termp_an_pre, termp_an_post }, /* An */
1.54 schwarze 137: { termp_under_pre, NULL }, /* Ar */
1.1 kristaps 138: { termp_cd_pre, NULL }, /* Cd */
1.54 schwarze 139: { termp_bold_pre, NULL }, /* Cm */
1.1 kristaps 140: { NULL, NULL }, /* Dv */
141: { NULL, NULL }, /* Er */
142: { NULL, NULL }, /* Ev */
143: { termp_ex_pre, NULL }, /* Ex */
144: { termp_fa_pre, NULL }, /* Fa */
1.143 schwarze 145: { termp_fd_pre, termp_fd_post }, /* Fd */
1.1 kristaps 146: { termp_fl_pre, NULL }, /* Fl */
1.86 schwarze 147: { termp_fn_pre, NULL }, /* Fn */
1.85 schwarze 148: { termp_ft_pre, NULL }, /* Ft */
1.54 schwarze 149: { termp_bold_pre, NULL }, /* Ic */
1.1 kristaps 150: { termp_in_pre, termp_in_post }, /* In */
1.65 schwarze 151: { termp_li_pre, NULL }, /* Li */
1.1 kristaps 152: { termp_nd_pre, NULL }, /* Nd */
1.94 schwarze 153: { termp_nm_pre, termp_nm_post }, /* Nm */
1.107 schwarze 154: { termp_quote_pre, termp_quote_post }, /* Op */
1.1 kristaps 155: { NULL, NULL }, /* Ot */
1.54 schwarze 156: { termp_under_pre, NULL }, /* Pa */
1.1 kristaps 157: { termp_rv_pre, NULL }, /* Rv */
1.32 schwarze 158: { NULL, NULL }, /* St */
1.54 schwarze 159: { termp_under_pre, NULL }, /* Va */
1.86 schwarze 160: { termp_vt_pre, NULL }, /* Vt */
1.1 kristaps 161: { termp_xr_pre, NULL }, /* Xr */
1.104 schwarze 162: { termp__a_pre, termp____post }, /* %A */
1.58 schwarze 163: { termp_under_pre, termp____post }, /* %B */
1.1 kristaps 164: { NULL, termp____post }, /* %D */
1.58 schwarze 165: { termp_under_pre, termp____post }, /* %I */
1.54 schwarze 166: { termp_under_pre, termp____post }, /* %J */
1.1 kristaps 167: { NULL, termp____post }, /* %N */
168: { NULL, termp____post }, /* %O */
169: { NULL, termp____post }, /* %P */
170: { NULL, termp____post }, /* %R */
1.120 schwarze 171: { termp__t_pre, termp__t_post }, /* %T */
1.1 kristaps 172: { NULL, termp____post }, /* %V */
173: { NULL, NULL }, /* Ac */
1.107 schwarze 174: { termp_quote_pre, termp_quote_post }, /* Ao */
175: { termp_quote_pre, termp_quote_post }, /* Aq */
1.32 schwarze 176: { NULL, NULL }, /* At */
1.1 kristaps 177: { NULL, NULL }, /* Bc */
178: { termp_bf_pre, NULL }, /* Bf */
1.107 schwarze 179: { termp_quote_pre, termp_quote_post }, /* Bo */
180: { termp_quote_pre, termp_quote_post }, /* Bq */
1.26 schwarze 181: { termp_xx_pre, NULL }, /* Bsx */
1.126 schwarze 182: { termp_bx_pre, NULL }, /* Bx */
1.1 kristaps 183: { NULL, NULL }, /* Db */
184: { NULL, NULL }, /* Dc */
1.107 schwarze 185: { termp_quote_pre, termp_quote_post }, /* Do */
186: { termp_quote_pre, termp_quote_post }, /* Dq */
1.73 schwarze 187: { NULL, NULL }, /* Ec */ /* FIXME: no space */
1.1 kristaps 188: { NULL, NULL }, /* Ef */
1.54 schwarze 189: { termp_under_pre, NULL }, /* Em */
1.139 schwarze 190: { termp_quote_pre, termp_quote_post }, /* Eo */
1.26 schwarze 191: { termp_xx_pre, NULL }, /* Fx */
1.98 schwarze 192: { termp_bold_pre, NULL }, /* Ms */
1.109 schwarze 193: { termp_igndelim_pre, NULL }, /* No */
1.1 kristaps 194: { termp_ns_pre, NULL }, /* Ns */
1.26 schwarze 195: { termp_xx_pre, NULL }, /* Nx */
196: { termp_xx_pre, NULL }, /* Ox */
1.1 kristaps 197: { NULL, NULL }, /* Pc */
1.109 schwarze 198: { termp_igndelim_pre, termp_pf_post }, /* Pf */
1.107 schwarze 199: { termp_quote_pre, termp_quote_post }, /* Po */
200: { termp_quote_pre, termp_quote_post }, /* Pq */
1.1 kristaps 201: { NULL, NULL }, /* Qc */
1.107 schwarze 202: { termp_quote_pre, termp_quote_post }, /* Ql */
203: { termp_quote_pre, termp_quote_post }, /* Qo */
204: { termp_quote_pre, termp_quote_post }, /* Qq */
1.1 kristaps 205: { NULL, NULL }, /* Re */
206: { termp_rs_pre, NULL }, /* Rs */
207: { NULL, NULL }, /* Sc */
1.107 schwarze 208: { termp_quote_pre, termp_quote_post }, /* So */
209: { termp_quote_pre, termp_quote_post }, /* Sq */
1.1 kristaps 210: { termp_sm_pre, NULL }, /* Sm */
1.54 schwarze 211: { termp_under_pre, NULL }, /* Sx */
212: { termp_bold_pre, NULL }, /* Sy */
1.1 kristaps 213: { NULL, NULL }, /* Tn */
1.26 schwarze 214: { termp_xx_pre, NULL }, /* Ux */
1.1 kristaps 215: { NULL, NULL }, /* Xc */
216: { NULL, NULL }, /* Xo */
217: { termp_fo_pre, termp_fo_post }, /* Fo */
218: { NULL, NULL }, /* Fc */
1.107 schwarze 219: { termp_quote_pre, termp_quote_post }, /* Oo */
1.1 kristaps 220: { NULL, NULL }, /* Oc */
1.90 schwarze 221: { termp_bk_pre, termp_bk_post }, /* Bk */
1.1 kristaps 222: { NULL, NULL }, /* Ek */
223: { termp_bt_pre, NULL }, /* Bt */
224: { NULL, NULL }, /* Hf */
225: { NULL, NULL }, /* Fr */
226: { termp_ud_pre, NULL }, /* Ud */
1.32 schwarze 227: { NULL, termp_lb_post }, /* Lb */
1.54 schwarze 228: { termp_sp_pre, NULL }, /* Lp */
1.1 kristaps 229: { termp_lk_pre, NULL }, /* Lk */
1.54 schwarze 230: { termp_under_pre, NULL }, /* Mt */
1.107 schwarze 231: { termp_quote_pre, termp_quote_post }, /* Brq */
232: { termp_quote_pre, termp_quote_post }, /* Bro */
1.1 kristaps 233: { NULL, NULL }, /* Brc */
1.58 schwarze 234: { NULL, termp____post }, /* %C */
235: { NULL, NULL }, /* Es */ /* TODO */
236: { NULL, NULL }, /* En */ /* TODO */
1.26 schwarze 237: { termp_xx_pre, NULL }, /* Dx */
1.58 schwarze 238: { NULL, termp____post }, /* %Q */
1.54 schwarze 239: { termp_sp_pre, NULL }, /* br */
1.38 schwarze 240: { termp_sp_pre, NULL }, /* sp */
1.145 schwarze 241: { NULL, termp____post }, /* %U */
1.85 schwarze 242: { NULL, NULL }, /* Ta */
1.1 kristaps 243: };
244:
245:
1.55 schwarze 246: void
1.61 schwarze 247: terminal_mdoc(void *arg, const struct mdoc *mdoc)
1.1 kristaps 248: {
1.55 schwarze 249: const struct mdoc_node *n;
1.147 schwarze 250: const struct mdoc_meta *meta;
1.61 schwarze 251: struct termp *p;
252:
253: p = (struct termp *)arg;
1.71 schwarze 254:
1.140 schwarze 255: if (0 == p->defindent)
256: p->defindent = 5;
257:
1.71 schwarze 258: p->overstep = 0;
1.80 schwarze 259: p->maxrmargin = p->defrmargin;
1.89 schwarze 260: p->tabwidth = term_len(p, 5);
1.61 schwarze 261:
262: if (NULL == p->symtab)
1.133 schwarze 263: p->symtab = mchars_alloc();
1.55 schwarze 264:
265: n = mdoc_node(mdoc);
1.147 schwarze 266: meta = mdoc_meta(mdoc);
1.55 schwarze 267:
1.147 schwarze 268: term_begin(p, print_mdoc_head, print_mdoc_foot, meta);
1.87 schwarze 269:
1.55 schwarze 270: if (n->child)
1.147 schwarze 271: print_mdoc_nodelist(p, NULL, meta, n->child);
1.87 schwarze 272:
273: term_end(p);
1.1 kristaps 274: }
275:
276:
277: static void
1.65 schwarze 278: print_mdoc_nodelist(DECL_ARGS)
1.1 kristaps 279: {
280:
1.147 schwarze 281: print_mdoc_node(p, pair, meta, n);
1.60 schwarze 282: if (n->next)
1.147 schwarze 283: print_mdoc_nodelist(p, pair, meta, n->next);
1.1 kristaps 284: }
285:
286:
1.54 schwarze 287: /* ARGSUSED */
1.1 kristaps 288: static void
1.65 schwarze 289: print_mdoc_node(DECL_ARGS)
1.1 kristaps 290: {
1.65 schwarze 291: int chld;
1.1 kristaps 292: struct termpair npair;
1.28 schwarze 293: size_t offset, rmargin;
1.1 kristaps 294:
1.54 schwarze 295: chld = 1;
1.28 schwarze 296: offset = p->offset;
297: rmargin = p->rmargin;
1.146 schwarze 298: n->prev_font = term_fontq(p);
1.1 kristaps 299:
1.63 schwarze 300: memset(&npair, 0, sizeof(struct termpair));
1.1 kristaps 301: npair.ppair = pair;
1.65 schwarze 302:
1.95 schwarze 303: /*
304: * Keeps only work until the end of a line. If a keep was
305: * invoked in a prior line, revert it to PREKEEP.
1.116 schwarze 306: *
307: * Also let SYNPRETTY sections behave as if they were wrapped
308: * in a `Bk' block.
1.95 schwarze 309: */
310:
1.116 schwarze 311: if (TERMP_KEEP & p->flags || MDOC_SYNPRETTY & n->flags) {
1.150 schwarze 312: if (n->prev ? (n->prev->line != n->line) :
313: (n->parent && n->parent->line != n->line)) {
1.95 schwarze 314: p->flags &= ~TERMP_KEEP;
315: p->flags |= TERMP_PREKEEP;
316: }
317: }
1.116 schwarze 318:
319: /*
320: * Since SYNPRETTY sections aren't "turned off" with `Ek',
321: * we have to intuit whether we should disable formatting.
322: */
323:
324: if ( ! (MDOC_SYNPRETTY & n->flags) &&
325: ((n->prev && MDOC_SYNPRETTY & n->prev->flags) ||
326: (n->parent && MDOC_SYNPRETTY & n->parent->flags)))
327: p->flags &= ~(TERMP_KEEP | TERMP_PREKEEP);
1.128 schwarze 328:
329: /*
330: * After the keep flags have been set up, we may now
331: * produce output. Note that some pre-handlers do so.
332: */
333:
334: switch (n->type) {
335: case (MDOC_TEXT):
336: if (' ' == *n->string && MDOC_LINE & n->flags)
337: term_newln(p);
1.132 schwarze 338: if (MDOC_DELIMC & n->flags)
339: p->flags |= TERMP_NOSPACE;
1.128 schwarze 340: term_word(p, n->string);
1.132 schwarze 341: if (MDOC_DELIMO & n->flags)
342: p->flags |= TERMP_NOSPACE;
1.128 schwarze 343: break;
1.131 schwarze 344: case (MDOC_EQN):
1.135 schwarze 345: term_eqn(p, n->eqn);
1.131 schwarze 346: break;
1.128 schwarze 347: case (MDOC_TBL):
348: term_tbl(p, n->span);
349: break;
350: default:
351: if (termacts[n->tok].pre && ENDBODY_NOT == n->end)
352: chld = (*termacts[n->tok].pre)
1.147 schwarze 353: (p, &npair, meta, n);
1.128 schwarze 354: break;
355: }
1.95 schwarze 356:
1.60 schwarze 357: if (chld && n->child)
1.147 schwarze 358: print_mdoc_nodelist(p, &npair, meta, n->child);
1.1 kristaps 359:
1.146 schwarze 360: term_fontpopq(p,
361: (ENDBODY_NOT == n->end ? n : n->pending)->prev_font);
1.1 kristaps 362:
1.122 schwarze 363: switch (n->type) {
364: case (MDOC_TEXT):
365: break;
366: case (MDOC_TBL):
1.131 schwarze 367: break;
368: case (MDOC_EQN):
1.122 schwarze 369: break;
370: default:
371: if ( ! termacts[n->tok].post || MDOC_ENDED & n->flags)
372: break;
1.147 schwarze 373: (void)(*termacts[n->tok].post)(p, &npair, meta, n);
1.93 schwarze 374:
375: /*
376: * Explicit end tokens not only call the post
377: * handler, but also tell the respective block
378: * that it must not call the post handler again.
379: */
1.95 schwarze 380: if (ENDBODY_NOT != n->end)
1.93 schwarze 381: n->pending->flags |= MDOC_ENDED;
382:
383: /*
384: * End of line terminating an implicit block
385: * while an explicit block is still open.
386: * Continue the explicit block without spacing.
387: */
388: if (ENDBODY_NOSPACE == n->end)
389: p->flags |= TERMP_NOSPACE;
1.122 schwarze 390: break;
1.93 schwarze 391: }
1.28 schwarze 392:
1.78 schwarze 393: if (MDOC_EOS & n->flags)
394: p->flags |= TERMP_SENTENCE;
395:
1.28 schwarze 396: p->offset = offset;
397: p->rmargin = rmargin;
1.1 kristaps 398: }
399:
400:
401: static void
1.87 schwarze 402: print_mdoc_foot(struct termp *p, const void *arg)
1.1 kristaps 403: {
1.147 schwarze 404: const struct mdoc_meta *meta;
1.87 schwarze 405:
1.147 schwarze 406: meta = (const struct mdoc_meta *)arg;
1.1 kristaps 407:
1.65 schwarze 408: term_fontrepl(p, TERMFONT_NONE);
409:
1.7 schwarze 410: /*
411: * Output the footer in new-groff style, that is, three columns
412: * with the middle being the manual date and flanking columns
413: * being the operating system:
414: *
415: * SYSTEM DATE SYSTEM
416: */
417:
1.1 kristaps 418: term_vspace(p);
419:
1.7 schwarze 420: p->offset = 0;
1.89 schwarze 421: p->rmargin = (p->maxrmargin -
1.147 schwarze 422: term_strlen(p, meta->date) + term_len(p, 1)) / 2;
1.1 kristaps 423: p->flags |= TERMP_NOSPACE | TERMP_NOBREAK;
424:
1.147 schwarze 425: term_word(p, meta->os);
1.1 kristaps 426: term_flushln(p);
427:
1.7 schwarze 428: p->offset = p->rmargin;
1.147 schwarze 429: p->rmargin = p->maxrmargin - term_strlen(p, meta->os);
1.136 schwarze 430: p->flags |= TERMP_NOSPACE;
1.7 schwarze 431:
1.147 schwarze 432: term_word(p, meta->date);
1.7 schwarze 433: term_flushln(p);
434:
1.1 kristaps 435: p->offset = p->rmargin;
436: p->rmargin = p->maxrmargin;
437: p->flags &= ~TERMP_NOBREAK;
1.136 schwarze 438: p->flags |= TERMP_NOSPACE;
1.1 kristaps 439:
1.147 schwarze 440: term_word(p, meta->os);
1.1 kristaps 441: term_flushln(p);
1.7 schwarze 442:
443: p->offset = 0;
444: p->rmargin = p->maxrmargin;
445: p->flags = 0;
1.1 kristaps 446: }
447:
448:
449: static void
1.87 schwarze 450: print_mdoc_head(struct termp *p, const void *arg)
1.1 kristaps 451: {
1.63 schwarze 452: char buf[BUFSIZ], title[BUFSIZ];
1.137 schwarze 453: size_t buflen, titlen;
1.147 schwarze 454: const struct mdoc_meta *meta;
1.87 schwarze 455:
1.147 schwarze 456: meta = (const struct mdoc_meta *)arg;
1.1 kristaps 457:
458: /*
459: * The header is strange. It has three components, which are
460: * really two with the first duplicated. It goes like this:
461: *
462: * IDENTIFIER TITLE IDENTIFIER
463: *
464: * The IDENTIFIER is NAME(SECTION), which is the command-name
465: * (if given, or "unknown" if not) followed by the manual page
466: * section. These are given in `Dt'. The TITLE is a free-form
467: * string depending on the manual volume. If not specified, it
468: * switches on the manual section.
469: */
470:
1.137 schwarze 471: p->offset = 0;
472: p->rmargin = p->maxrmargin;
473:
1.147 schwarze 474: assert(meta->vol);
475: strlcpy(buf, meta->vol, BUFSIZ);
1.137 schwarze 476: buflen = term_strlen(p, buf);
1.1 kristaps 477:
1.147 schwarze 478: if (meta->arch) {
1.63 schwarze 479: strlcat(buf, " (", BUFSIZ);
1.147 schwarze 480: strlcat(buf, meta->arch, BUFSIZ);
1.63 schwarze 481: strlcat(buf, ")", BUFSIZ);
1.1 kristaps 482: }
483:
1.147 schwarze 484: snprintf(title, BUFSIZ, "%s(%s)", meta->title, meta->msec);
1.137 schwarze 485: titlen = term_strlen(p, title);
1.1 kristaps 486:
1.137 schwarze 487: p->flags |= TERMP_NOBREAK | TERMP_NOSPACE;
1.1 kristaps 488: p->offset = 0;
1.137 schwarze 489: p->rmargin = 2 * (titlen+1) + buflen < p->maxrmargin ?
490: (p->maxrmargin -
491: term_strlen(p, buf) + term_len(p, 1)) / 2 :
492: p->maxrmargin - buflen;
1.1 kristaps 493:
494: term_word(p, title);
495: term_flushln(p);
496:
1.137 schwarze 497: p->flags |= TERMP_NOSPACE;
1.1 kristaps 498: p->offset = p->rmargin;
1.137 schwarze 499: p->rmargin = p->offset + buflen + titlen < p->maxrmargin ?
500: p->maxrmargin - titlen : p->maxrmargin;
1.1 kristaps 501:
502: term_word(p, buf);
503: term_flushln(p);
504:
505: p->flags &= ~TERMP_NOBREAK;
1.137 schwarze 506: if (p->rmargin + titlen <= p->maxrmargin) {
507: p->flags |= TERMP_NOSPACE;
508: p->offset = p->rmargin;
509: p->rmargin = p->maxrmargin;
510: term_word(p, title);
511: term_flushln(p);
512: }
1.1 kristaps 513:
1.137 schwarze 514: p->flags &= ~TERMP_NOSPACE;
1.8 schwarze 515: p->offset = 0;
1.1 kristaps 516: p->rmargin = p->maxrmargin;
517: }
518:
519:
520: static size_t
1.89 schwarze 521: a2height(const struct termp *p, const char *v)
1.1 kristaps 522: {
1.61 schwarze 523: struct roffsu su;
1.1 kristaps 524:
1.134 schwarze 525:
1.89 schwarze 526: assert(v);
527: if ( ! a2roffsu(v, &su, SCALE_VS))
1.134 schwarze 528: SCALE_VS_INIT(&su, atoi(v));
1.1 kristaps 529:
1.89 schwarze 530: return(term_vspan(p, &su));
1.61 schwarze 531: }
1.34 schwarze 532:
1.1 kristaps 533:
1.61 schwarze 534: static size_t
1.89 schwarze 535: a2width(const struct termp *p, const char *v)
1.61 schwarze 536: {
537: struct roffsu su;
1.1 kristaps 538:
1.88 schwarze 539: assert(v);
540: if ( ! a2roffsu(v, &su, SCALE_MAX))
1.89 schwarze 541: SCALE_HS_INIT(&su, term_strlen(p, v));
1.1 kristaps 542:
1.89 schwarze 543: return(term_hspan(p, &su));
1.1 kristaps 544: }
545:
546:
547: static size_t
1.89 schwarze 548: a2offs(const struct termp *p, const char *v)
1.1 kristaps 549: {
1.61 schwarze 550: struct roffsu su;
1.1 kristaps 551:
1.88 schwarze 552: if ('\0' == *v)
1.61 schwarze 553: return(0);
1.88 schwarze 554: else if (0 == strcmp(v, "left"))
1.9 schwarze 555: return(0);
1.88 schwarze 556: else if (0 == strcmp(v, "indent"))
1.140 schwarze 557: return(term_len(p, p->defindent + 1));
1.88 schwarze 558: else if (0 == strcmp(v, "indent-two"))
1.140 schwarze 559: return(term_len(p, (p->defindent + 1) * 2));
1.88 schwarze 560: else if ( ! a2roffsu(v, &su, SCALE_MAX))
1.89 schwarze 561: SCALE_HS_INIT(&su, term_strlen(p, v));
1.10 schwarze 562:
1.89 schwarze 563: return(term_hspan(p, &su));
1.1 kristaps 564: }
565:
566:
1.68 schwarze 567: /*
568: * Determine how much space to print out before block elements of `It'
569: * (and thus `Bl') and `Bd'. And then go ahead and print that space,
570: * too.
571: */
1.45 schwarze 572: static void
1.61 schwarze 573: print_bvspace(struct termp *p,
1.1 kristaps 574: const struct mdoc_node *bl,
1.60 schwarze 575: const struct mdoc_node *n)
1.1 kristaps 576: {
1.60 schwarze 577: const struct mdoc_node *nn;
1.138 schwarze 578:
579: assert(n);
1.1 kristaps 580:
581: term_newln(p);
1.88 schwarze 582:
1.121 schwarze 583: if (MDOC_Bd == bl->tok && bl->norm->Bd.comp)
1.88 schwarze 584: return;
1.121 schwarze 585: if (MDOC_Bl == bl->tok && bl->norm->Bl.comp)
1.45 schwarze 586: return;
587:
1.60 schwarze 588: /* Do not vspace directly after Ss/Sh. */
1.1 kristaps 589:
1.60 schwarze 590: for (nn = n; nn; nn = nn->parent) {
591: if (MDOC_BLOCK != nn->type)
1.1 kristaps 592: continue;
1.60 schwarze 593: if (MDOC_Ss == nn->tok)
1.45 schwarze 594: return;
1.60 schwarze 595: if (MDOC_Sh == nn->tok)
1.45 schwarze 596: return;
1.60 schwarze 597: if (NULL == nn->prev)
1.1 kristaps 598: continue;
599: break;
600: }
601:
1.60 schwarze 602: /* A `-column' does not assert vspace within the list. */
1.45 schwarze 603:
1.121 schwarze 604: if (MDOC_Bl == bl->tok && LIST_column == bl->norm->Bl.type)
1.60 schwarze 605: if (n->prev && MDOC_It == n->prev->tok)
1.45 schwarze 606: return;
607:
1.60 schwarze 608: /* A `-diag' without body does not vspace. */
609:
1.121 schwarze 610: if (MDOC_Bl == bl->tok && LIST_diag == bl->norm->Bl.type)
1.60 schwarze 611: if (n->prev && MDOC_It == n->prev->tok) {
612: assert(n->prev->body);
613: if (NULL == n->prev->body->child)
1.45 schwarze 614: return;
615: }
616:
617: term_vspace(p);
1.1 kristaps 618: }
619:
620:
621: /* ARGSUSED */
622: static int
623: termp_it_pre(DECL_ARGS)
624: {
1.60 schwarze 625: const struct mdoc_node *bl, *nn;
1.1 kristaps 626: char buf[7];
1.95 schwarze 627: int i;
1.68 schwarze 628: size_t width, offset, ncols, dcol;
1.82 schwarze 629: enum mdoc_list type;
1.1 kristaps 630:
1.60 schwarze 631: if (MDOC_BLOCK == n->type) {
1.61 schwarze 632: print_bvspace(p, n->parent->parent, n);
1.45 schwarze 633: return(1);
634: }
1.1 kristaps 635:
1.60 schwarze 636: bl = n->parent->parent->parent;
1.121 schwarze 637: type = bl->norm->Bl.type;
1.1 kristaps 638:
1.68 schwarze 639: /*
640: * First calculate width and offset. This is pretty easy unless
641: * we're a -column list, in which case all prior columns must
642: * be accounted for.
643: */
644:
645: width = offset = 0;
646:
1.121 schwarze 647: if (bl->norm->Bl.offs)
648: offset = a2offs(p, bl->norm->Bl.offs);
1.66 schwarze 649:
1.1 kristaps 650: switch (type) {
1.82 schwarze 651: case (LIST_column):
1.85 schwarze 652: if (MDOC_HEAD == n->type)
1.1 kristaps 653: break;
1.88 schwarze 654:
1.66 schwarze 655: /*
1.68 schwarze 656: * Imitate groff's column handling:
657: * - For each earlier column, add its width.
658: * - For less than 5 columns, add four more blanks per
659: * column.
660: * - For exactly 5 columns, add three more blank per
661: * column.
662: * - For more than 5 columns, add only one column.
1.66 schwarze 663: */
1.121 schwarze 664: ncols = bl->norm->Bl.ncols;
1.95 schwarze 665:
1.68 schwarze 666: /* LINTED */
1.89 schwarze 667: dcol = ncols < 5 ? term_len(p, 4) :
668: ncols == 5 ? term_len(p, 3) : term_len(p, 1);
1.68 schwarze 669:
1.85 schwarze 670: /*
671: * Calculate the offset by applying all prior MDOC_BODY,
672: * so we stop at the MDOC_HEAD (NULL == nn->prev).
673: */
674:
1.68 schwarze 675: for (i = 0, nn = n->prev;
1.85 schwarze 676: nn->prev && i < (int)ncols;
1.68 schwarze 677: nn = nn->prev, i++)
678: offset += dcol + a2width
1.121 schwarze 679: (p, bl->norm->Bl.cols[i]);
1.66 schwarze 680:
681: /*
1.68 schwarze 682: * When exceeding the declared number of columns, leave
683: * the remaining widths at 0. This will later be
684: * adjusted to the default width of 10, or, for the last
685: * column, stretched to the right margin.
1.46 schwarze 686: */
1.68 schwarze 687: if (i >= (int)ncols)
688: break;
1.46 schwarze 689:
1.66 schwarze 690: /*
1.68 schwarze 691: * Use the declared column widths, extended as explained
692: * in the preceding paragraph.
1.66 schwarze 693: */
1.121 schwarze 694: width = a2width(p, bl->norm->Bl.cols[i]) + dcol;
1.1 kristaps 695: break;
696: default:
1.121 schwarze 697: if (NULL == bl->norm->Bl.width)
1.68 schwarze 698: break;
699:
700: /*
701: * Note: buffer the width by 2, which is groff's magic
702: * number for buffering single arguments. See the above
703: * handling for column for how this changes.
704: */
1.121 schwarze 705: assert(bl->norm->Bl.width);
706: width = a2width(p, bl->norm->Bl.width) + term_len(p, 2);
1.1 kristaps 707: break;
708: }
709:
710: /*
711: * List-type can override the width in the case of fixed-head
712: * values (bullet, dash/hyphen, enum). Tags need a non-zero
1.53 schwarze 713: * offset.
1.1 kristaps 714: */
715:
716: switch (type) {
1.82 schwarze 717: case (LIST_bullet):
1.1 kristaps 718: /* FALLTHROUGH */
1.82 schwarze 719: case (LIST_dash):
1.1 kristaps 720: /* FALLTHROUGH */
1.82 schwarze 721: case (LIST_hyphen):
1.144 schwarze 722: /* FALLTHROUGH */
1.82 schwarze 723: case (LIST_enum):
1.144 schwarze 724: if (width < term_len(p, 2))
725: width = term_len(p, 2);
1.1 kristaps 726: break;
1.82 schwarze 727: case (LIST_hang):
1.33 schwarze 728: if (0 == width)
1.89 schwarze 729: width = term_len(p, 8);
1.33 schwarze 730: break;
1.82 schwarze 731: case (LIST_column):
1.41 schwarze 732: /* FALLTHROUGH */
1.82 schwarze 733: case (LIST_tag):
1.1 kristaps 734: if (0 == width)
1.89 schwarze 735: width = term_len(p, 10);
1.1 kristaps 736: break;
737: default:
738: break;
739: }
740:
741: /*
1.16 schwarze 742: * Whitespace control. Inset bodies need an initial space,
743: * while diagonal bodies need two.
1.1 kristaps 744: */
745:
1.42 schwarze 746: p->flags |= TERMP_NOSPACE;
747:
1.1 kristaps 748: switch (type) {
1.82 schwarze 749: case (LIST_diag):
1.60 schwarze 750: if (MDOC_BODY == n->type)
1.48 schwarze 751: term_word(p, "\\ \\ ");
1.42 schwarze 752: break;
1.82 schwarze 753: case (LIST_inset):
1.60 schwarze 754: if (MDOC_BODY == n->type)
1.42 schwarze 755: term_word(p, "\\ ");
1.1 kristaps 756: break;
757: default:
758: break;
759: }
760:
1.42 schwarze 761: p->flags |= TERMP_NOSPACE;
762:
1.1 kristaps 763: switch (type) {
1.82 schwarze 764: case (LIST_diag):
1.60 schwarze 765: if (MDOC_HEAD == n->type)
1.65 schwarze 766: term_fontpush(p, TERMFONT_BOLD);
1.1 kristaps 767: break;
768: default:
769: break;
770: }
771:
772: /*
1.68 schwarze 773: * Pad and break control. This is the tricky part. These flags
774: * are documented in term_flushln() in term.c. Note that we're
775: * going to unset all of these flags in termp_it_post() when we
776: * exit.
1.1 kristaps 777: */
778:
779: switch (type) {
1.144 schwarze 780: case (LIST_enum):
781: /*
782: * Weird special case.
783: * Very narrow enum lists actually hang.
784: */
785: if (width == term_len(p, 2))
786: p->flags |= TERMP_HANG;
787: /* FALLTHROUGH */
1.82 schwarze 788: case (LIST_bullet):
1.1 kristaps 789: /* FALLTHROUGH */
1.82 schwarze 790: case (LIST_dash):
1.1 kristaps 791: /* FALLTHROUGH */
1.82 schwarze 792: case (LIST_hyphen):
1.60 schwarze 793: if (MDOC_HEAD == n->type)
1.33 schwarze 794: p->flags |= TERMP_NOBREAK;
795: break;
1.82 schwarze 796: case (LIST_hang):
1.60 schwarze 797: if (MDOC_HEAD == n->type)
1.33 schwarze 798: p->flags |= TERMP_NOBREAK;
799: else
1.47 schwarze 800: break;
801:
802: /*
803: * This is ugly. If `-hang' is specified and the body
804: * is a `Bl' or `Bd', then we want basically to nullify
805: * the "overstep" effect in term_flushln() and treat
806: * this as a `-ohang' list instead.
807: */
1.60 schwarze 808: if (n->next->child &&
809: (MDOC_Bl == n->next->child->tok ||
1.136 schwarze 810: MDOC_Bd == n->next->child->tok))
1.47 schwarze 811: p->flags &= ~TERMP_NOBREAK;
1.136 schwarze 812: else
1.33 schwarze 813: p->flags |= TERMP_HANG;
814: break;
1.82 schwarze 815: case (LIST_tag):
1.60 schwarze 816: if (MDOC_HEAD == n->type)
1.42 schwarze 817: p->flags |= TERMP_NOBREAK | TERMP_TWOSPACE;
1.33 schwarze 818:
1.60 schwarze 819: if (MDOC_HEAD != n->type)
1.33 schwarze 820: break;
1.60 schwarze 821: if (NULL == n->next || NULL == n->next->child)
1.33 schwarze 822: p->flags |= TERMP_DANGLE;
1.1 kristaps 823: break;
1.82 schwarze 824: case (LIST_column):
1.85 schwarze 825: if (MDOC_HEAD == n->type)
826: break;
827:
828: if (NULL == n->next)
829: p->flags &= ~TERMP_NOBREAK;
830: else
831: p->flags |= TERMP_NOBREAK;
832:
1.1 kristaps 833: break;
1.82 schwarze 834: case (LIST_diag):
1.60 schwarze 835: if (MDOC_HEAD == n->type)
1.1 kristaps 836: p->flags |= TERMP_NOBREAK;
837: break;
838: default:
839: break;
840: }
841:
842: /*
843: * Margin control. Set-head-width lists have their right
844: * margins shortened. The body for these lists has the offset
845: * necessarily lengthened. Everybody gets the offset.
846: */
847:
848: p->offset += offset;
849:
850: switch (type) {
1.82 schwarze 851: case (LIST_hang):
1.47 schwarze 852: /*
853: * Same stipulation as above, regarding `-hang'. We
854: * don't want to recalculate rmargin and offsets when
855: * using `Bd' or `Bl' within `-hang' overstep lists.
856: */
1.60 schwarze 857: if (MDOC_HEAD == n->type && n->next->child &&
858: (MDOC_Bl == n->next->child->tok ||
859: MDOC_Bd == n->next->child->tok))
1.47 schwarze 860: break;
861: /* FALLTHROUGH */
1.82 schwarze 862: case (LIST_bullet):
1.1 kristaps 863: /* FALLTHROUGH */
1.82 schwarze 864: case (LIST_dash):
1.1 kristaps 865: /* FALLTHROUGH */
1.82 schwarze 866: case (LIST_enum):
1.1 kristaps 867: /* FALLTHROUGH */
1.82 schwarze 868: case (LIST_hyphen):
1.33 schwarze 869: /* FALLTHROUGH */
1.82 schwarze 870: case (LIST_tag):
1.41 schwarze 871: assert(width);
1.60 schwarze 872: if (MDOC_HEAD == n->type)
1.1 kristaps 873: p->rmargin = p->offset + width;
874: else
875: p->offset += width;
876: break;
1.82 schwarze 877: case (LIST_column):
1.41 schwarze 878: assert(width);
1.1 kristaps 879: p->rmargin = p->offset + width;
1.43 schwarze 880: /*
881: * XXX - this behaviour is not documented: the
882: * right-most column is filled to the right margin.
883: */
1.85 schwarze 884: if (MDOC_HEAD == n->type)
885: break;
886: if (NULL == n->next && p->rmargin < p->maxrmargin)
1.43 schwarze 887: p->rmargin = p->maxrmargin;
1.1 kristaps 888: break;
889: default:
890: break;
891: }
892:
893: /*
894: * The dash, hyphen, bullet and enum lists all have a special
1.12 schwarze 895: * HEAD character (temporarily bold, in some cases).
1.1 kristaps 896: */
897:
1.60 schwarze 898: if (MDOC_HEAD == n->type)
1.1 kristaps 899: switch (type) {
1.82 schwarze 900: case (LIST_bullet):
1.65 schwarze 901: term_fontpush(p, TERMFONT_BOLD);
1.1 kristaps 902: term_word(p, "\\[bu]");
1.65 schwarze 903: term_fontpop(p);
1.1 kristaps 904: break;
1.82 schwarze 905: case (LIST_dash):
1.1 kristaps 906: /* FALLTHROUGH */
1.82 schwarze 907: case (LIST_hyphen):
1.65 schwarze 908: term_fontpush(p, TERMFONT_BOLD);
1.35 schwarze 909: term_word(p, "\\(hy");
1.65 schwarze 910: term_fontpop(p);
1.1 kristaps 911: break;
1.82 schwarze 912: case (LIST_enum):
1.1 kristaps 913: (pair->ppair->ppair->count)++;
1.68 schwarze 914: snprintf(buf, sizeof(buf), "%d.",
1.1 kristaps 915: pair->ppair->ppair->count);
916: term_word(p, buf);
917: break;
918: default:
919: break;
920: }
1.12 schwarze 921:
1.1 kristaps 922: /*
923: * If we're not going to process our children, indicate so here.
924: */
925:
926: switch (type) {
1.82 schwarze 927: case (LIST_bullet):
1.1 kristaps 928: /* FALLTHROUGH */
1.82 schwarze 929: case (LIST_item):
1.1 kristaps 930: /* FALLTHROUGH */
1.82 schwarze 931: case (LIST_dash):
1.1 kristaps 932: /* FALLTHROUGH */
1.82 schwarze 933: case (LIST_hyphen):
1.1 kristaps 934: /* FALLTHROUGH */
1.82 schwarze 935: case (LIST_enum):
1.60 schwarze 936: if (MDOC_HEAD == n->type)
1.1 kristaps 937: return(0);
938: break;
1.82 schwarze 939: case (LIST_column):
1.85 schwarze 940: if (MDOC_HEAD == n->type)
1.1 kristaps 941: return(0);
942: break;
943: default:
944: break;
945: }
946:
947: return(1);
948: }
949:
950:
951: /* ARGSUSED */
952: static void
953: termp_it_post(DECL_ARGS)
954: {
1.82 schwarze 955: enum mdoc_list type;
1.1 kristaps 956:
1.68 schwarze 957: if (MDOC_BLOCK == n->type)
1.1 kristaps 958: return;
959:
1.121 schwarze 960: type = n->parent->parent->parent->norm->Bl.type;
1.1 kristaps 961:
962: switch (type) {
1.82 schwarze 963: case (LIST_item):
1.44 schwarze 964: /* FALLTHROUGH */
1.82 schwarze 965: case (LIST_diag):
1.1 kristaps 966: /* FALLTHROUGH */
1.82 schwarze 967: case (LIST_inset):
1.60 schwarze 968: if (MDOC_BODY == n->type)
1.74 schwarze 969: term_newln(p);
1.1 kristaps 970: break;
1.82 schwarze 971: case (LIST_column):
1.85 schwarze 972: if (MDOC_BODY == n->type)
1.1 kristaps 973: term_flushln(p);
974: break;
975: default:
1.74 schwarze 976: term_newln(p);
1.1 kristaps 977: break;
978: }
979:
1.68 schwarze 980: /*
981: * Now that our output is flushed, we can reset our tags. Since
982: * only `It' sets these flags, we're free to assume that nobody
983: * has munged them in the meanwhile.
984: */
985:
986: p->flags &= ~TERMP_DANGLE;
987: p->flags &= ~TERMP_NOBREAK;
988: p->flags &= ~TERMP_TWOSPACE;
989: p->flags &= ~TERMP_HANG;
1.1 kristaps 990: }
991:
992:
993: /* ARGSUSED */
994: static int
995: termp_nm_pre(DECL_ARGS)
996: {
997:
1.94 schwarze 998: if (MDOC_BLOCK == n->type)
999: return(1);
1000:
1001: if (MDOC_BODY == n->type) {
1002: if (NULL == n->child)
1003: return(0);
1.136 schwarze 1004: p->flags |= TERMP_NOSPACE;
1.94 schwarze 1005: p->offset += term_len(p, 1) +
1.147 schwarze 1006: (NULL == n->prev->child ?
1007: term_strlen(p, meta->name) :
1.94 schwarze 1008: MDOC_TEXT == n->prev->child->type ?
1.147 schwarze 1009: term_strlen(p, n->prev->child->string) :
1.94 schwarze 1010: term_len(p, 5));
1011: return(1);
1012: }
1013:
1.147 schwarze 1014: if (NULL == n->child && NULL == meta->name)
1.94 schwarze 1015: return(0);
1.81 schwarze 1016:
1.97 schwarze 1017: if (MDOC_HEAD == n->type)
1018: synopsis_pre(p, n->parent);
1.65 schwarze 1019:
1.94 schwarze 1020: if (MDOC_HEAD == n->type && n->next->child) {
1.105 schwarze 1021: p->flags |= TERMP_NOSPACE | TERMP_NOBREAK;
1022: p->rmargin = p->offset + term_len(p, 1);
1023: if (NULL == n->child) {
1.147 schwarze 1024: p->rmargin += term_strlen(p, meta->name);
1.105 schwarze 1025: } else if (MDOC_TEXT == n->child->type) {
1026: p->rmargin += term_strlen(p, n->child->string);
1027: if (n->child->next)
1028: p->flags |= TERMP_HANG;
1029: } else {
1030: p->rmargin += term_len(p, 5);
1031: p->flags |= TERMP_HANG;
1032: }
1.94 schwarze 1033: }
1034:
1.65 schwarze 1035: term_fontpush(p, TERMFONT_BOLD);
1.60 schwarze 1036: if (NULL == n->child)
1.147 schwarze 1037: term_word(p, meta->name);
1.1 kristaps 1038: return(1);
1039: }
1040:
1041:
1.94 schwarze 1042: /* ARGSUSED */
1043: static void
1044: termp_nm_post(DECL_ARGS)
1045: {
1046:
1047: if (MDOC_HEAD == n->type && n->next->child) {
1048: term_flushln(p);
1049: p->flags &= ~(TERMP_NOBREAK | TERMP_HANG);
1.136 schwarze 1050: } else if (MDOC_BODY == n->type && n->child)
1.94 schwarze 1051: term_flushln(p);
1052: }
1053:
1054:
1.1 kristaps 1055: /* ARGSUSED */
1056: static int
1057: termp_fl_pre(DECL_ARGS)
1058: {
1059:
1.65 schwarze 1060: term_fontpush(p, TERMFONT_BOLD);
1.1 kristaps 1061: term_word(p, "\\-");
1.67 schwarze 1062:
1063: if (n->child)
1064: p->flags |= TERMP_NOSPACE;
1.73 schwarze 1065: else if (n->next && n->next->line == n->line)
1066: p->flags |= TERMP_NOSPACE;
1.67 schwarze 1067:
1.1 kristaps 1068: return(1);
1.49 schwarze 1069: }
1070:
1071:
1072: /* ARGSUSED */
1073: static int
1.104 schwarze 1074: termp__a_pre(DECL_ARGS)
1075: {
1076:
1077: if (n->prev && MDOC__A == n->prev->tok)
1078: if (NULL == n->next || MDOC__A != n->next->tok)
1079: term_word(p, "and");
1080:
1081: return(1);
1082: }
1083:
1084:
1085: /* ARGSUSED */
1086: static int
1.49 schwarze 1087: termp_an_pre(DECL_ARGS)
1088: {
1089:
1.60 schwarze 1090: if (NULL == n->child)
1.49 schwarze 1091: return(1);
1092:
1093: /*
1.60 schwarze 1094: * If not in the AUTHORS section, `An -split' will cause
1095: * newlines to occur before the author name. If in the AUTHORS
1096: * section, by default, the first `An' invocation is nosplit,
1097: * then all subsequent ones, regardless of whether interspersed
1098: * with other macros/text, are split. -split, in this case,
1099: * will override the condition of the implied first -nosplit.
1.49 schwarze 1100: */
1101:
1.60 schwarze 1102: if (n->sec == SEC_AUTHORS) {
1.49 schwarze 1103: if ( ! (TERMP_ANPREC & p->flags)) {
1104: if (TERMP_SPLIT & p->flags)
1105: term_newln(p);
1106: return(1);
1107: }
1108: if (TERMP_NOSPLIT & p->flags)
1109: return(1);
1110: term_newln(p);
1111: return(1);
1112: }
1113:
1114: if (TERMP_SPLIT & p->flags)
1115: term_newln(p);
1116:
1117: return(1);
1118: }
1119:
1120:
1121: /* ARGSUSED */
1122: static void
1123: termp_an_post(DECL_ARGS)
1124: {
1125:
1.60 schwarze 1126: if (n->child) {
1127: if (SEC_AUTHORS == n->sec)
1.49 schwarze 1128: p->flags |= TERMP_ANPREC;
1129: return;
1130: }
1131:
1.121 schwarze 1132: if (AUTH_split == n->norm->An.auth) {
1.49 schwarze 1133: p->flags &= ~TERMP_NOSPLIT;
1134: p->flags |= TERMP_SPLIT;
1.121 schwarze 1135: } else if (AUTH_nosplit == n->norm->An.auth) {
1.49 schwarze 1136: p->flags &= ~TERMP_SPLIT;
1137: p->flags |= TERMP_NOSPLIT;
1138: }
1139:
1.1 kristaps 1140: }
1141:
1142:
1143: /* ARGSUSED */
1144: static int
1145: termp_ns_pre(DECL_ARGS)
1146: {
1147:
1.127 schwarze 1148: if ( ! (MDOC_LINE & n->flags))
1149: p->flags |= TERMP_NOSPACE;
1.1 kristaps 1150: return(1);
1151: }
1152:
1153:
1154: /* ARGSUSED */
1155: static int
1156: termp_rs_pre(DECL_ARGS)
1157: {
1158:
1.60 schwarze 1159: if (SEC_SEE_ALSO != n->sec)
1.57 schwarze 1160: return(1);
1.60 schwarze 1161: if (MDOC_BLOCK == n->type && n->prev)
1.1 kristaps 1162: term_vspace(p);
1163: return(1);
1164: }
1165:
1166:
1167: /* ARGSUSED */
1168: static int
1169: termp_rv_pre(DECL_ARGS)
1170: {
1.132 schwarze 1171: int nchild;
1.1 kristaps 1172:
1173: term_newln(p);
1174: term_word(p, "The");
1175:
1.132 schwarze 1176: nchild = n->nchild;
1177: for (n = n->child; n; n = n->next) {
1.65 schwarze 1178: term_fontpush(p, TERMFONT_BOLD);
1.132 schwarze 1179: term_word(p, n->string);
1.65 schwarze 1180: term_fontpop(p);
1.132 schwarze 1181:
1.53 schwarze 1182: p->flags |= TERMP_NOSPACE;
1.132 schwarze 1183: term_word(p, "()");
1184:
1185: if (nchild > 2 && n->next) {
1186: p->flags |= TERMP_NOSPACE;
1187: term_word(p, ",");
1188: }
1189:
1190: if (n->next && NULL == n->next->next)
1191: term_word(p, "and");
1.53 schwarze 1192: }
1193:
1.132 schwarze 1194: if (nchild > 1)
1.53 schwarze 1195: term_word(p, "functions return");
1196: else
1197: term_word(p, "function returns");
1.1 kristaps 1198:
1.53 schwarze 1199: term_word(p, "the value 0 if successful; otherwise the value "
1200: "-1 is returned and the global variable");
1.1 kristaps 1201:
1.65 schwarze 1202: term_fontpush(p, TERMFONT_UNDER);
1.1 kristaps 1203: term_word(p, "errno");
1.65 schwarze 1204: term_fontpop(p);
1.1 kristaps 1205:
1206: term_word(p, "is set to indicate the error.");
1.84 schwarze 1207: p->flags |= TERMP_SENTENCE;
1.1 kristaps 1208:
1.53 schwarze 1209: return(0);
1.1 kristaps 1210: }
1211:
1212:
1213: /* ARGSUSED */
1214: static int
1215: termp_ex_pre(DECL_ARGS)
1216: {
1.132 schwarze 1217: int nchild;
1.1 kristaps 1218:
1.132 schwarze 1219: term_newln(p);
1.53 schwarze 1220: term_word(p, "The");
1.1 kristaps 1221:
1.132 schwarze 1222: nchild = n->nchild;
1223: for (n = n->child; n; n = n->next) {
1.65 schwarze 1224: term_fontpush(p, TERMFONT_BOLD);
1.132 schwarze 1225: term_word(p, n->string);
1.65 schwarze 1226: term_fontpop(p);
1.132 schwarze 1227:
1228: if (nchild > 2 && n->next) {
1229: p->flags |= TERMP_NOSPACE;
1.53 schwarze 1230: term_word(p, ",");
1.132 schwarze 1231: }
1232:
1233: if (n->next && NULL == n->next->next)
1234: term_word(p, "and");
1.53 schwarze 1235: }
1236:
1.132 schwarze 1237: if (nchild > 1)
1.53 schwarze 1238: term_word(p, "utilities exit");
1239: else
1240: term_word(p, "utility exits");
1241:
1242: term_word(p, "0 on success, and >0 if an error occurs.");
1.132 schwarze 1243:
1.84 schwarze 1244: p->flags |= TERMP_SENTENCE;
1.53 schwarze 1245: return(0);
1.1 kristaps 1246: }
1247:
1248:
1249: /* ARGSUSED */
1250: static int
1251: termp_nd_pre(DECL_ARGS)
1252: {
1.25 schwarze 1253:
1.60 schwarze 1254: if (MDOC_BODY != n->type)
1.25 schwarze 1255: return(1);
1256:
1257: #if defined(__OpenBSD__) || defined(__linux__)
1258: term_word(p, "\\(en");
1.24 schwarze 1259: #else
1260: term_word(p, "\\(em");
1261: #endif
1.1 kristaps 1262: return(1);
1263: }
1264:
1265:
1266: /* ARGSUSED */
1.73 schwarze 1267: static int
1268: termp_bl_pre(DECL_ARGS)
1269: {
1270:
1271: return(MDOC_HEAD != n->type);
1272: }
1273:
1274:
1275: /* ARGSUSED */
1.1 kristaps 1276: static void
1277: termp_bl_post(DECL_ARGS)
1278: {
1279:
1.60 schwarze 1280: if (MDOC_BLOCK == n->type)
1.1 kristaps 1281: term_newln(p);
1282: }
1283:
1284: /* ARGSUSED */
1285: static int
1286: termp_xr_pre(DECL_ARGS)
1287: {
1288:
1.132 schwarze 1289: if (NULL == (n = n->child))
1.72 schwarze 1290: return(0);
1291:
1.132 schwarze 1292: assert(MDOC_TEXT == n->type);
1293: term_word(p, n->string);
1.10 schwarze 1294:
1.132 schwarze 1295: if (NULL == (n = n->next))
1.1 kristaps 1296: return(0);
1.132 schwarze 1297:
1.1 kristaps 1298: p->flags |= TERMP_NOSPACE;
1299: term_word(p, "(");
1.132 schwarze 1300: p->flags |= TERMP_NOSPACE;
1301:
1302: assert(MDOC_TEXT == n->type);
1303: term_word(p, n->string);
1304:
1305: p->flags |= TERMP_NOSPACE;
1.1 kristaps 1306: term_word(p, ")");
1.60 schwarze 1307:
1.1 kristaps 1308: return(0);
1309: }
1310:
1.86 schwarze 1311: /*
1312: * This decides how to assert whitespace before any of the SYNOPSIS set
1313: * of macros (which, as in the case of Ft/Fo and Ft/Fn, may contain
1314: * macro combos).
1315: */
1316: static void
1317: synopsis_pre(struct termp *p, const struct mdoc_node *n)
1318: {
1319: /*
1320: * Obviously, if we're not in a SYNOPSIS or no prior macros
1321: * exist, do nothing.
1322: */
1.92 schwarze 1323: if (NULL == n->prev || ! (MDOC_SYNPRETTY & n->flags))
1.86 schwarze 1324: return;
1325:
1326: /*
1327: * If we're the second in a pair of like elements, emit our
1328: * newline and return. UNLESS we're `Fo', `Fn', `Fn', in which
1329: * case we soldier on.
1330: */
1331: if (n->prev->tok == n->tok &&
1332: MDOC_Ft != n->tok &&
1333: MDOC_Fo != n->tok &&
1334: MDOC_Fn != n->tok) {
1335: term_newln(p);
1336: return;
1337: }
1338:
1339: /*
1340: * If we're one of the SYNOPSIS set and non-like pair-wise after
1341: * another (or Fn/Fo, which we've let slip through) then assert
1342: * vertical space, else only newline and move on.
1343: */
1344: switch (n->prev->tok) {
1345: case (MDOC_Fd):
1346: /* FALLTHROUGH */
1347: case (MDOC_Fn):
1348: /* FALLTHROUGH */
1349: case (MDOC_Fo):
1350: /* FALLTHROUGH */
1351: case (MDOC_In):
1352: /* FALLTHROUGH */
1353: case (MDOC_Vt):
1354: term_vspace(p);
1355: break;
1356: case (MDOC_Ft):
1357: if (MDOC_Fn != n->tok && MDOC_Fo != n->tok) {
1358: term_vspace(p);
1359: break;
1360: }
1361: /* FALLTHROUGH */
1362: default:
1363: term_newln(p);
1364: break;
1365: }
1366: }
1367:
1368:
1.69 schwarze 1369: static int
1370: termp_vt_pre(DECL_ARGS)
1371: {
1372:
1.86 schwarze 1373: if (MDOC_ELEM == n->type) {
1374: synopsis_pre(p, n);
1.147 schwarze 1375: return(termp_under_pre(p, pair, meta, n));
1.86 schwarze 1376: } else if (MDOC_BLOCK == n->type) {
1377: synopsis_pre(p, n);
1378: return(1);
1379: } else if (MDOC_HEAD == n->type)
1.69 schwarze 1380: return(0);
1381:
1.147 schwarze 1382: return(termp_under_pre(p, pair, meta, n));
1.69 schwarze 1383: }
1384:
1385:
1.1 kristaps 1386: /* ARGSUSED */
1387: static int
1.54 schwarze 1388: termp_bold_pre(DECL_ARGS)
1.1 kristaps 1389: {
1390:
1.65 schwarze 1391: term_fontpush(p, TERMFONT_BOLD);
1.1 kristaps 1392: return(1);
1393: }
1394:
1395:
1396: /* ARGSUSED */
1.86 schwarze 1397: static int
1398: termp_fd_pre(DECL_ARGS)
1.1 kristaps 1399: {
1400:
1.86 schwarze 1401: synopsis_pre(p, n);
1.147 schwarze 1402: return(termp_bold_pre(p, pair, meta, n));
1.1 kristaps 1403: }
1404:
1405:
1406: /* ARGSUSED */
1.143 schwarze 1407: static void
1408: termp_fd_post(DECL_ARGS)
1409: {
1410:
1411: term_newln(p);
1412: }
1413:
1414:
1415: /* ARGSUSED */
1.1 kristaps 1416: static int
1417: termp_sh_pre(DECL_ARGS)
1418: {
1.60 schwarze 1419:
1420: /* No vspace between consecutive `Sh' calls. */
1421:
1422: switch (n->type) {
1.52 schwarze 1423: case (MDOC_BLOCK):
1.60 schwarze 1424: if (n->prev && MDOC_Sh == n->prev->tok)
1425: if (NULL == n->prev->body->child)
1.52 schwarze 1426: break;
1427: term_vspace(p);
1428: break;
1.1 kristaps 1429: case (MDOC_HEAD):
1.65 schwarze 1430: term_fontpush(p, TERMFONT_BOLD);
1.1 kristaps 1431: break;
1432: case (MDOC_BODY):
1.140 schwarze 1433: p->offset = term_len(p, p->defindent);
1.141 schwarze 1434: if (SEC_AUTHORS == n->sec)
1435: p->flags &= ~(TERMP_SPLIT|TERMP_NOSPLIT);
1.1 kristaps 1436: break;
1437: default:
1438: break;
1439: }
1440: return(1);
1441: }
1442:
1443:
1444: /* ARGSUSED */
1445: static void
1446: termp_sh_post(DECL_ARGS)
1447: {
1448:
1.60 schwarze 1449: switch (n->type) {
1.1 kristaps 1450: case (MDOC_HEAD):
1451: term_newln(p);
1452: break;
1453: case (MDOC_BODY):
1454: term_newln(p);
1455: p->offset = 0;
1456: break;
1457: default:
1458: break;
1459: }
1460: }
1461:
1462:
1463: /* ARGSUSED */
1464: static int
1465: termp_bt_pre(DECL_ARGS)
1466: {
1467:
1468: term_word(p, "is currently in beta test.");
1.84 schwarze 1469: p->flags |= TERMP_SENTENCE;
1.59 schwarze 1470: return(0);
1.1 kristaps 1471: }
1472:
1473:
1474: /* ARGSUSED */
1475: static void
1476: termp_lb_post(DECL_ARGS)
1477: {
1478:
1.77 schwarze 1479: if (SEC_LIBRARY == n->sec && MDOC_LINE & n->flags)
1.57 schwarze 1480: term_newln(p);
1.1 kristaps 1481: }
1482:
1483:
1484: /* ARGSUSED */
1485: static int
1486: termp_ud_pre(DECL_ARGS)
1487: {
1488:
1489: term_word(p, "currently under development.");
1.84 schwarze 1490: p->flags |= TERMP_SENTENCE;
1.60 schwarze 1491: return(0);
1.1 kristaps 1492: }
1493:
1494:
1495: /* ARGSUSED */
1496: static int
1497: termp_d1_pre(DECL_ARGS)
1498: {
1499:
1.60 schwarze 1500: if (MDOC_BLOCK != n->type)
1.1 kristaps 1501: return(1);
1502: term_newln(p);
1.140 schwarze 1503: p->offset += term_len(p, p->defindent + 1);
1.1 kristaps 1504: return(1);
1505: }
1506:
1507:
1508: /* ARGSUSED */
1509: static int
1510: termp_ft_pre(DECL_ARGS)
1511: {
1512:
1.85 schwarze 1513: /* NB: MDOC_LINE does not effect this! */
1.86 schwarze 1514: synopsis_pre(p, n);
1.65 schwarze 1515: term_fontpush(p, TERMFONT_UNDER);
1.1 kristaps 1516: return(1);
1517: }
1518:
1519:
1520: /* ARGSUSED */
1521: static int
1522: termp_fn_pre(DECL_ARGS)
1523: {
1.132 schwarze 1524: int pretty;
1525:
1526: pretty = MDOC_SYNPRETTY & n->flags;
1.1 kristaps 1527:
1.86 schwarze 1528: synopsis_pre(p, n);
1.85 schwarze 1529:
1.132 schwarze 1530: if (NULL == (n = n->child))
1531: return(0);
1532:
1533: assert(MDOC_TEXT == n->type);
1.65 schwarze 1534: term_fontpush(p, TERMFONT_BOLD);
1.132 schwarze 1535: term_word(p, n->string);
1.65 schwarze 1536: term_fontpop(p);
1.1 kristaps 1537:
1538: p->flags |= TERMP_NOSPACE;
1539: term_word(p, "(");
1.132 schwarze 1540: p->flags |= TERMP_NOSPACE;
1.1 kristaps 1541:
1.132 schwarze 1542: for (n = n->next; n; n = n->next) {
1543: assert(MDOC_TEXT == n->type);
1.65 schwarze 1544: term_fontpush(p, TERMFONT_UNDER);
1.132 schwarze 1545: term_word(p, n->string);
1.65 schwarze 1546: term_fontpop(p);
1547:
1.132 schwarze 1548: if (n->next) {
1549: p->flags |= TERMP_NOSPACE;
1.1 kristaps 1550: term_word(p, ",");
1.132 schwarze 1551: }
1.1 kristaps 1552: }
1553:
1.132 schwarze 1554: p->flags |= TERMP_NOSPACE;
1.1 kristaps 1555: term_word(p, ")");
1556:
1.132 schwarze 1557: if (pretty) {
1558: p->flags |= TERMP_NOSPACE;
1.1 kristaps 1559: term_word(p, ";");
1.132 schwarze 1560: }
1.1 kristaps 1561:
1562: return(0);
1563: }
1564:
1565:
1566: /* ARGSUSED */
1567: static int
1568: termp_fa_pre(DECL_ARGS)
1569: {
1.60 schwarze 1570: const struct mdoc_node *nn;
1.1 kristaps 1571:
1.60 schwarze 1572: if (n->parent->tok != MDOC_Fo) {
1.65 schwarze 1573: term_fontpush(p, TERMFONT_UNDER);
1.1 kristaps 1574: return(1);
1575: }
1576:
1.60 schwarze 1577: for (nn = n->child; nn; nn = nn->next) {
1.65 schwarze 1578: term_fontpush(p, TERMFONT_UNDER);
1.60 schwarze 1579: term_word(p, nn->string);
1.65 schwarze 1580: term_fontpop(p);
1581:
1.132 schwarze 1582: if (nn->next) {
1583: p->flags |= TERMP_NOSPACE;
1.1 kristaps 1584: term_word(p, ",");
1.132 schwarze 1585: }
1.1 kristaps 1586: }
1587:
1.132 schwarze 1588: if (n->child && n->next && n->next->tok == MDOC_Fa) {
1589: p->flags |= TERMP_NOSPACE;
1.1 kristaps 1590: term_word(p, ",");
1.132 schwarze 1591: }
1.1 kristaps 1592:
1593: return(0);
1594: }
1595:
1596:
1597: /* ARGSUSED */
1598: static int
1599: termp_bd_pre(DECL_ARGS)
1600: {
1.99 schwarze 1601: size_t tabwidth, rm, rmax;
1.146 schwarze 1602: struct mdoc_node *nn;
1.1 kristaps 1603:
1.60 schwarze 1604: if (MDOC_BLOCK == n->type) {
1.61 schwarze 1605: print_bvspace(p, n, n);
1.45 schwarze 1606: return(1);
1.73 schwarze 1607: } else if (MDOC_HEAD == n->type)
1608: return(0);
1.1 kristaps 1609:
1.121 schwarze 1610: if (n->norm->Bd.offs)
1611: p->offset += a2offs(p, n->norm->Bd.offs);
1.60 schwarze 1612:
1613: /*
1614: * If -ragged or -filled are specified, the block does nothing
1615: * but change the indentation. If -unfilled or -literal are
1616: * specified, text is printed exactly as entered in the display:
1617: * for macro lines, a newline is appended to the line. Blank
1618: * lines are allowed.
1619: */
1.48 schwarze 1620:
1.121 schwarze 1621: if (DISP_literal != n->norm->Bd.type &&
1622: DISP_unfilled != n->norm->Bd.type)
1.1 kristaps 1623: return(1);
1624:
1.75 schwarze 1625: tabwidth = p->tabwidth;
1.123 schwarze 1626: if (DISP_literal == n->norm->Bd.type)
1627: p->tabwidth = term_len(p, 8);
1628:
1.77 schwarze 1629: rm = p->rmargin;
1630: rmax = p->maxrmargin;
1631: p->rmargin = p->maxrmargin = TERM_MAXMARGIN;
1632:
1.60 schwarze 1633: for (nn = n->child; nn; nn = nn->next) {
1.147 schwarze 1634: print_mdoc_node(p, pair, meta, nn);
1.108 schwarze 1635: /*
1636: * If the printed node flushes its own line, then we
1637: * needn't do it here as well. This is hacky, but the
1638: * notion of selective eoln whitespace is pretty dumb
1639: * anyway, so don't sweat it.
1640: */
1641: switch (nn->tok) {
1.112 schwarze 1642: case (MDOC_Sm):
1643: /* FALLTHROUGH */
1.108 schwarze 1644: case (MDOC_br):
1645: /* FALLTHROUGH */
1646: case (MDOC_sp):
1647: /* FALLTHROUGH */
1648: case (MDOC_Bl):
1.115 schwarze 1649: /* FALLTHROUGH */
1650: case (MDOC_D1):
1651: /* FALLTHROUGH */
1652: case (MDOC_Dl):
1.108 schwarze 1653: /* FALLTHROUGH */
1654: case (MDOC_Lp):
1655: /* FALLTHROUGH */
1656: case (MDOC_Pp):
1657: continue;
1658: default:
1659: break;
1660: }
1.100 schwarze 1661: if (nn->next && nn->next->line == nn->line)
1662: continue;
1663: term_flushln(p);
1.48 schwarze 1664: p->flags |= TERMP_NOSPACE;
1.1 kristaps 1665: }
1.88 schwarze 1666:
1.75 schwarze 1667: p->tabwidth = tabwidth;
1.77 schwarze 1668: p->rmargin = rm;
1669: p->maxrmargin = rmax;
1.1 kristaps 1670: return(0);
1671: }
1672:
1673:
1674: /* ARGSUSED */
1675: static void
1676: termp_bd_post(DECL_ARGS)
1677: {
1.77 schwarze 1678: size_t rm, rmax;
1.1 kristaps 1679:
1.60 schwarze 1680: if (MDOC_BODY != n->type)
1.1 kristaps 1681: return;
1.77 schwarze 1682:
1683: rm = p->rmargin;
1684: rmax = p->maxrmargin;
1685:
1.121 schwarze 1686: if (DISP_literal == n->norm->Bd.type ||
1687: DISP_unfilled == n->norm->Bd.type)
1.77 schwarze 1688: p->rmargin = p->maxrmargin = TERM_MAXMARGIN;
1689:
1.48 schwarze 1690: p->flags |= TERMP_NOSPACE;
1.75 schwarze 1691: term_newln(p);
1.77 schwarze 1692:
1693: p->rmargin = rm;
1694: p->maxrmargin = rmax;
1.1 kristaps 1695: }
1696:
1697:
1698: /* ARGSUSED */
1.126 schwarze 1699: static int
1700: termp_bx_pre(DECL_ARGS)
1.1 kristaps 1701: {
1702:
1.126 schwarze 1703: if (NULL != (n = n->child)) {
1704: term_word(p, n->string);
1705: p->flags |= TERMP_NOSPACE;
1706: term_word(p, "BSD");
1707: } else {
1708: term_word(p, "BSD");
1709: return(0);
1710: }
1711:
1712: if (NULL != (n = n->next)) {
1713: p->flags |= TERMP_NOSPACE;
1714: term_word(p, "-");
1.1 kristaps 1715: p->flags |= TERMP_NOSPACE;
1.126 schwarze 1716: term_word(p, n->string);
1717: }
1718:
1719: return(0);
1.1 kristaps 1720: }
1721:
1722:
1723: /* ARGSUSED */
1724: static int
1.26 schwarze 1725: termp_xx_pre(DECL_ARGS)
1.1 kristaps 1726: {
1.26 schwarze 1727: const char *pp;
1.129 schwarze 1728: int flags;
1.1 kristaps 1729:
1.26 schwarze 1730: pp = NULL;
1.60 schwarze 1731: switch (n->tok) {
1.26 schwarze 1732: case (MDOC_Bsx):
1.113 schwarze 1733: pp = "BSD/OS";
1.26 schwarze 1734: break;
1735: case (MDOC_Dx):
1.64 schwarze 1736: pp = "DragonFly";
1.26 schwarze 1737: break;
1738: case (MDOC_Fx):
1739: pp = "FreeBSD";
1740: break;
1741: case (MDOC_Nx):
1742: pp = "NetBSD";
1743: break;
1744: case (MDOC_Ox):
1745: pp = "OpenBSD";
1746: break;
1747: case (MDOC_Ux):
1748: pp = "UNIX";
1749: break;
1750: default:
1.148 schwarze 1751: abort();
1752: /* NOTREACHED */
1.26 schwarze 1753: }
1.1 kristaps 1754:
1.26 schwarze 1755: term_word(p, pp);
1.129 schwarze 1756: if (n->child) {
1757: flags = p->flags;
1758: p->flags |= TERMP_KEEP;
1759: term_word(p, n->child->string);
1760: p->flags = flags;
1761: }
1762: return(0);
1.1 kristaps 1763: }
1764:
1765:
1766: /* ARGSUSED */
1767: static int
1.109 schwarze 1768: termp_igndelim_pre(DECL_ARGS)
1.1 kristaps 1769: {
1770:
1771: p->flags |= TERMP_IGNDELIM;
1772: return(1);
1773: }
1774:
1775:
1776: /* ARGSUSED */
1777: static void
1778: termp_pf_post(DECL_ARGS)
1779: {
1780:
1781: p->flags |= TERMP_NOSPACE;
1782: }
1783:
1784:
1785: /* ARGSUSED */
1786: static int
1787: termp_ss_pre(DECL_ARGS)
1788: {
1789:
1.60 schwarze 1790: switch (n->type) {
1.1 kristaps 1791: case (MDOC_BLOCK):
1792: term_newln(p);
1.60 schwarze 1793: if (n->prev)
1.1 kristaps 1794: term_vspace(p);
1795: break;
1796: case (MDOC_HEAD):
1.65 schwarze 1797: term_fontpush(p, TERMFONT_BOLD);
1.140 schwarze 1798: p->offset = term_len(p, (p->defindent+1)/2);
1.1 kristaps 1799: break;
1800: default:
1801: break;
1802: }
1803:
1804: return(1);
1805: }
1806:
1807:
1808: /* ARGSUSED */
1809: static void
1810: termp_ss_post(DECL_ARGS)
1811: {
1812:
1.60 schwarze 1813: if (MDOC_HEAD == n->type)
1.1 kristaps 1814: term_newln(p);
1815: }
1816:
1817:
1818: /* ARGSUSED */
1819: static int
1820: termp_cd_pre(DECL_ARGS)
1821: {
1822:
1.86 schwarze 1823: synopsis_pre(p, n);
1.65 schwarze 1824: term_fontpush(p, TERMFONT_BOLD);
1.1 kristaps 1825: return(1);
1826: }
1827:
1828:
1829: /* ARGSUSED */
1830: static int
1831: termp_in_pre(DECL_ARGS)
1832: {
1833:
1.86 schwarze 1834: synopsis_pre(p, n);
1.85 schwarze 1835:
1.92 schwarze 1836: if (MDOC_SYNPRETTY & n->flags && MDOC_LINE & n->flags) {
1.85 schwarze 1837: term_fontpush(p, TERMFONT_BOLD);
1.23 schwarze 1838: term_word(p, "#include");
1.85 schwarze 1839: term_word(p, "<");
1840: } else {
1841: term_word(p, "<");
1842: term_fontpush(p, TERMFONT_UNDER);
1843: }
1.23 schwarze 1844:
1.1 kristaps 1845: p->flags |= TERMP_NOSPACE;
1846: return(1);
1847: }
1848:
1849:
1850: /* ARGSUSED */
1851: static void
1852: termp_in_post(DECL_ARGS)
1853: {
1854:
1.92 schwarze 1855: if (MDOC_SYNPRETTY & n->flags)
1.85 schwarze 1856: term_fontpush(p, TERMFONT_BOLD);
1857:
1.59 schwarze 1858: p->flags |= TERMP_NOSPACE;
1.1 kristaps 1859: term_word(p, ">");
1860:
1.92 schwarze 1861: if (MDOC_SYNPRETTY & n->flags)
1.85 schwarze 1862: term_fontpop(p);
1.38 schwarze 1863: }
1864:
1865:
1866: /* ARGSUSED */
1867: static int
1868: termp_sp_pre(DECL_ARGS)
1869: {
1.61 schwarze 1870: size_t i, len;
1.38 schwarze 1871:
1.60 schwarze 1872: switch (n->tok) {
1.54 schwarze 1873: case (MDOC_sp):
1.89 schwarze 1874: len = n->child ? a2height(p, n->child->string) : 1;
1.54 schwarze 1875: break;
1876: case (MDOC_br):
1877: len = 0;
1878: break;
1879: default:
1880: len = 1;
1881: break;
1.38 schwarze 1882: }
1883:
1884: if (0 == len)
1885: term_newln(p);
1886: for (i = 0; i < len; i++)
1887: term_vspace(p);
1888:
1889: return(0);
1890: }
1891:
1892:
1893: /* ARGSUSED */
1894: static int
1.107 schwarze 1895: termp_quote_pre(DECL_ARGS)
1.1 kristaps 1896: {
1897:
1.120 schwarze 1898: if (MDOC_BODY != n->type && MDOC_ELEM != n->type)
1.1 kristaps 1899: return(1);
1900:
1.107 schwarze 1901: switch (n->tok) {
1902: case (MDOC_Ao):
1903: /* FALLTHROUGH */
1904: case (MDOC_Aq):
1905: term_word(p, "<");
1906: break;
1907: case (MDOC_Bro):
1908: /* FALLTHROUGH */
1909: case (MDOC_Brq):
1910: term_word(p, "{");
1911: break;
1912: case (MDOC_Oo):
1913: /* FALLTHROUGH */
1914: case (MDOC_Op):
1915: /* FALLTHROUGH */
1916: case (MDOC_Bo):
1917: /* FALLTHROUGH */
1918: case (MDOC_Bq):
1919: term_word(p, "[");
1920: break;
1921: case (MDOC_Do):
1922: /* FALLTHROUGH */
1923: case (MDOC_Dq):
1.151 ! schwarze 1924: term_word(p, "\\(lq");
1.107 schwarze 1925: break;
1.139 schwarze 1926: case (MDOC_Eo):
1927: break;
1.107 schwarze 1928: case (MDOC_Po):
1929: /* FALLTHROUGH */
1930: case (MDOC_Pq):
1931: term_word(p, "(");
1932: break;
1.120 schwarze 1933: case (MDOC__T):
1934: /* FALLTHROUGH */
1.107 schwarze 1935: case (MDOC_Qo):
1936: /* FALLTHROUGH */
1937: case (MDOC_Qq):
1938: term_word(p, "\"");
1939: break;
1940: case (MDOC_Ql):
1941: /* FALLTHROUGH */
1942: case (MDOC_So):
1943: /* FALLTHROUGH */
1944: case (MDOC_Sq):
1.151 ! schwarze 1945: term_word(p, "\\(oq");
1.107 schwarze 1946: break;
1947: default:
1948: abort();
1949: /* NOTREACHED */
1950: }
1.1 kristaps 1951:
1952: p->flags |= TERMP_NOSPACE;
1953: return(1);
1954: }
1955:
1956:
1957: /* ARGSUSED */
1958: static void
1.107 schwarze 1959: termp_quote_post(DECL_ARGS)
1.1 kristaps 1960: {
1961:
1.120 schwarze 1962: if (MDOC_BODY != n->type && MDOC_ELEM != n->type)
1.1 kristaps 1963: return;
1964:
1965: p->flags |= TERMP_NOSPACE;
1966:
1.107 schwarze 1967: switch (n->tok) {
1968: case (MDOC_Ao):
1969: /* FALLTHROUGH */
1970: case (MDOC_Aq):
1971: term_word(p, ">");
1972: break;
1973: case (MDOC_Bro):
1974: /* FALLTHROUGH */
1975: case (MDOC_Brq):
1976: term_word(p, "}");
1977: break;
1978: case (MDOC_Oo):
1979: /* FALLTHROUGH */
1980: case (MDOC_Op):
1981: /* FALLTHROUGH */
1982: case (MDOC_Bo):
1983: /* FALLTHROUGH */
1984: case (MDOC_Bq):
1985: term_word(p, "]");
1986: break;
1987: case (MDOC_Do):
1988: /* FALLTHROUGH */
1989: case (MDOC_Dq):
1.151 ! schwarze 1990: term_word(p, "\\(rq");
1.139 schwarze 1991: break;
1992: case (MDOC_Eo):
1.107 schwarze 1993: break;
1994: case (MDOC_Po):
1995: /* FALLTHROUGH */
1996: case (MDOC_Pq):
1997: term_word(p, ")");
1998: break;
1.120 schwarze 1999: case (MDOC__T):
2000: /* FALLTHROUGH */
1.107 schwarze 2001: case (MDOC_Qo):
2002: /* FALLTHROUGH */
2003: case (MDOC_Qq):
2004: term_word(p, "\"");
2005: break;
2006: case (MDOC_Ql):
2007: /* FALLTHROUGH */
2008: case (MDOC_So):
2009: /* FALLTHROUGH */
2010: case (MDOC_Sq):
1.151 ! schwarze 2011: term_word(p, "\\(cq");
1.107 schwarze 2012: break;
2013: default:
2014: abort();
2015: /* NOTREACHED */
2016: }
1.1 kristaps 2017: }
2018:
2019:
2020: /* ARGSUSED */
2021: static int
2022: termp_fo_pre(DECL_ARGS)
2023: {
2024:
1.85 schwarze 2025: if (MDOC_BLOCK == n->type) {
1.86 schwarze 2026: synopsis_pre(p, n);
1.85 schwarze 2027: return(1);
2028: } else if (MDOC_BODY == n->type) {
1.31 schwarze 2029: p->flags |= TERMP_NOSPACE;
1.1 kristaps 2030: term_word(p, "(");
1.132 schwarze 2031: p->flags |= TERMP_NOSPACE;
1.1 kristaps 2032: return(1);
1.85 schwarze 2033: }
2034:
1.95 schwarze 2035: if (NULL == n->child)
2036: return(0);
2037:
1.85 schwarze 2038: /* XXX: we drop non-initial arguments as per groff. */
1.1 kristaps 2039:
1.85 schwarze 2040: assert(n->child->string);
1.65 schwarze 2041: term_fontpush(p, TERMFONT_BOLD);
1.85 schwarze 2042: term_word(p, n->child->string);
1.1 kristaps 2043: return(0);
2044: }
2045:
2046:
2047: /* ARGSUSED */
2048: static void
2049: termp_fo_post(DECL_ARGS)
2050: {
2051:
1.86 schwarze 2052: if (MDOC_BODY != n->type)
2053: return;
2054:
1.132 schwarze 2055: p->flags |= TERMP_NOSPACE;
1.86 schwarze 2056: term_word(p, ")");
2057:
1.132 schwarze 2058: if (MDOC_SYNPRETTY & n->flags) {
2059: p->flags |= TERMP_NOSPACE;
1.86 schwarze 2060: term_word(p, ";");
1.132 schwarze 2061: }
1.1 kristaps 2062: }
2063:
2064:
2065: /* ARGSUSED */
2066: static int
2067: termp_bf_pre(DECL_ARGS)
2068: {
2069:
1.60 schwarze 2070: if (MDOC_HEAD == n->type)
1.1 kristaps 2071: return(0);
1.146 schwarze 2072: else if (MDOC_BODY != n->type)
1.1 kristaps 2073: return(1);
2074:
1.121 schwarze 2075: if (FONT_Em == n->norm->Bf.font)
1.65 schwarze 2076: term_fontpush(p, TERMFONT_UNDER);
1.121 schwarze 2077: else if (FONT_Sy == n->norm->Bf.font)
1.65 schwarze 2078: term_fontpush(p, TERMFONT_BOLD);
1.95 schwarze 2079: else
1.65 schwarze 2080: term_fontpush(p, TERMFONT_NONE);
1.1 kristaps 2081:
2082: return(1);
2083: }
2084:
2085:
2086: /* ARGSUSED */
2087: static int
2088: termp_sm_pre(DECL_ARGS)
2089: {
2090:
1.60 schwarze 2091: assert(n->child && MDOC_TEXT == n->child->type);
1.96 schwarze 2092: if (0 == strcmp("on", n->child->string)) {
2093: if (p->col)
2094: p->flags &= ~TERMP_NOSPACE;
1.1 kristaps 2095: p->flags &= ~TERMP_NONOSPACE;
1.96 schwarze 2096: } else
1.1 kristaps 2097: p->flags |= TERMP_NONOSPACE;
2098:
2099: return(0);
2100: }
2101:
2102:
2103: /* ARGSUSED */
2104: static int
2105: termp_ap_pre(DECL_ARGS)
2106: {
2107:
2108: p->flags |= TERMP_NOSPACE;
1.107 schwarze 2109: term_word(p, "'");
1.1 kristaps 2110: p->flags |= TERMP_NOSPACE;
2111: return(1);
2112: }
2113:
2114:
2115: /* ARGSUSED */
2116: static void
2117: termp____post(DECL_ARGS)
2118: {
1.104 schwarze 2119:
2120: /*
2121: * Handle lists of authors. In general, print each followed by
2122: * a comma. Don't print the comma if there are only two
2123: * authors.
2124: */
2125: if (MDOC__A == n->tok && n->next && MDOC__A == n->next->tok)
2126: if (NULL == n->next->next || MDOC__A != n->next->next->tok)
2127: if (NULL == n->prev || MDOC__A != n->prev->tok)
2128: return;
1.1 kristaps 2129:
1.62 schwarze 2130: /* TODO: %U. */
2131:
1.106 schwarze 2132: if (NULL == n->parent || MDOC_Rs != n->parent->tok)
2133: return;
2134:
1.132 schwarze 2135: p->flags |= TERMP_NOSPACE;
1.106 schwarze 2136: if (NULL == n->next) {
2137: term_word(p, ".");
2138: p->flags |= TERMP_SENTENCE;
2139: } else
2140: term_word(p, ",");
1.1 kristaps 2141: }
2142:
2143:
2144: /* ARGSUSED */
2145: static int
1.65 schwarze 2146: termp_li_pre(DECL_ARGS)
2147: {
2148:
2149: term_fontpush(p, TERMFONT_NONE);
2150: return(1);
2151: }
2152:
2153:
2154: /* ARGSUSED */
2155: static int
1.1 kristaps 2156: termp_lk_pre(DECL_ARGS)
2157: {
1.142 schwarze 2158: const struct mdoc_node *link, *descr;
1.1 kristaps 2159:
1.142 schwarze 2160: if (NULL == (link = n->child))
2161: return(0);
1.101 schwarze 2162:
1.142 schwarze 2163: if (NULL != (descr = link->next)) {
2164: term_fontpush(p, TERMFONT_UNDER);
2165: while (NULL != descr) {
2166: term_word(p, descr->string);
2167: descr = descr->next;
2168: }
2169: p->flags |= TERMP_NOSPACE;
2170: term_word(p, ":");
2171: term_fontpop(p);
2172: }
1.1 kristaps 2173:
1.65 schwarze 2174: term_fontpush(p, TERMFONT_BOLD);
1.142 schwarze 2175: term_word(p, link->string);
1.65 schwarze 2176: term_fontpop(p);
1.6 schwarze 2177:
1.1 kristaps 2178: return(0);
2179: }
2180:
1.90 schwarze 2181:
2182: /* ARGSUSED */
2183: static int
2184: termp_bk_pre(DECL_ARGS)
2185: {
2186:
1.91 schwarze 2187: switch (n->type) {
2188: case (MDOC_BLOCK):
1.95 schwarze 2189: break;
1.91 schwarze 2190: case (MDOC_HEAD):
2191: return(0);
2192: case (MDOC_BODY):
1.117 schwarze 2193: if (n->parent->args || 0 == n->prev->nchild)
2194: p->flags |= TERMP_PREKEEP;
1.95 schwarze 2195: break;
1.91 schwarze 2196: default:
2197: abort();
1.95 schwarze 2198: /* NOTREACHED */
1.91 schwarze 2199: }
1.95 schwarze 2200:
2201: return(1);
1.90 schwarze 2202: }
2203:
2204:
2205: /* ARGSUSED */
2206: static void
2207: termp_bk_post(DECL_ARGS)
2208: {
2209:
1.149 schwarze 2210: if (MDOC_BODY == n->type && ! (MDOC_SYNPRETTY & n->flags))
1.91 schwarze 2211: p->flags &= ~(TERMP_KEEP | TERMP_PREKEEP);
1.90 schwarze 2212: }
1.120 schwarze 2213:
2214: /* ARGSUSED */
2215: static void
2216: termp__t_post(DECL_ARGS)
2217: {
2218:
2219: /*
2220: * If we're in an `Rs' and there's a journal present, then quote
2221: * us instead of underlining us (for disambiguation).
2222: */
1.121 schwarze 2223: if (n->parent && MDOC_Rs == n->parent->tok &&
1.125 schwarze 2224: n->parent->norm->Rs.quote_T)
1.147 schwarze 2225: termp_quote_post(p, pair, meta, n);
1.120 schwarze 2226:
1.147 schwarze 2227: termp____post(p, pair, meta, n);
1.120 schwarze 2228: }
2229:
2230: /* ARGSUSED */
2231: static int
2232: termp__t_pre(DECL_ARGS)
2233: {
2234:
2235: /*
2236: * If we're in an `Rs' and there's a journal present, then quote
2237: * us instead of underlining us (for disambiguation).
2238: */
1.121 schwarze 2239: if (n->parent && MDOC_Rs == n->parent->tok &&
1.125 schwarze 2240: n->parent->norm->Rs.quote_T)
1.147 schwarze 2241: return(termp_quote_pre(p, pair, meta, n));
1.120 schwarze 2242:
2243: term_fontpush(p, TERMFONT_UNDER);
2244: return(1);
1.121 schwarze 2245: }
1.1 kristaps 2246:
2247: /* ARGSUSED */
2248: static int
1.54 schwarze 2249: termp_under_pre(DECL_ARGS)
1.1 kristaps 2250: {
2251:
1.65 schwarze 2252: term_fontpush(p, TERMFONT_UNDER);
1.1 kristaps 2253: return(1);
2254: }
![[BACK]](/icons/back.gif){kind=icon}
Return to mdoc_term.c CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [local] / src / usr.bin / mandoc