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