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