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