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