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