Annotation of src/usr.bin/mandoc/mdoc_man.c, Revision 1.78
1.78 ! schwarze 1: /* $OpenBSD: mdoc_man.c,v 1.77 2014/12/23 10:09:23 schwarze Exp $ */
1.1 schwarze 2: /*
1.57 schwarze 3: * Copyright (c) 2011, 2012, 2013, 2014 Ingo Schwarze <schwarze@openbsd.org>
1.1 schwarze 4: *
5: * Permission to use, copy, modify, and distribute this software for any
6: * purpose with or without fee is hereby granted, provided that the above
7: * copyright notice and this permission notice appear in all copies.
8: *
9: * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10: * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11: * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12: * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13: * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14: * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15: * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16: */
1.69 schwarze 17: #include <sys/types.h>
18:
1.9 schwarze 19: #include <assert.h>
1.1 schwarze 20: #include <stdio.h>
21: #include <string.h>
22:
23: #include "mandoc.h"
1.59 schwarze 24: #include "mandoc_aux.h"
1.8 schwarze 25: #include "out.h"
1.4 schwarze 26: #include "man.h"
1.1 schwarze 27: #include "mdoc.h"
28: #include "main.h"
29:
1.42 schwarze 30: #define DECL_ARGS const struct mdoc_meta *meta, \
1.18 schwarze 31: const struct mdoc_node *n
1.1 schwarze 32:
33: struct manact {
1.4 schwarze 34: int (*cond)(DECL_ARGS); /* DON'T run actions */
35: int (*pre)(DECL_ARGS); /* pre-node action */
36: void (*post)(DECL_ARGS); /* post-node action */
37: const char *prefix; /* pre-node string constant */
38: const char *suffix; /* post-node string constant */
1.1 schwarze 39: };
40:
1.4 schwarze 41: static int cond_body(DECL_ARGS);
1.1 schwarze 42: static int cond_head(DECL_ARGS);
1.24 schwarze 43: static void font_push(char);
44: static void font_pop(void);
1.46 schwarze 45: static void mid_it(void);
1.32 schwarze 46: static void post__t(DECL_ARGS);
1.72 schwarze 47: static void post_aq(DECL_ARGS);
1.4 schwarze 48: static void post_bd(DECL_ARGS);
1.25 schwarze 49: static void post_bf(DECL_ARGS);
1.10 schwarze 50: static void post_bk(DECL_ARGS);
1.28 schwarze 51: static void post_bl(DECL_ARGS);
1.4 schwarze 52: static void post_dl(DECL_ARGS);
1.63 schwarze 53: static void post_en(DECL_ARGS);
1.1 schwarze 54: static void post_enc(DECL_ARGS);
1.26 schwarze 55: static void post_eo(DECL_ARGS);
1.14 schwarze 56: static void post_fa(DECL_ARGS);
1.27 schwarze 57: static void post_fd(DECL_ARGS);
1.24 schwarze 58: static void post_fl(DECL_ARGS);
1.13 schwarze 59: static void post_fn(DECL_ARGS);
1.14 schwarze 60: static void post_fo(DECL_ARGS);
1.24 schwarze 61: static void post_font(DECL_ARGS);
1.12 schwarze 62: static void post_in(DECL_ARGS);
1.28 schwarze 63: static void post_it(DECL_ARGS);
1.11 schwarze 64: static void post_lb(DECL_ARGS);
1.4 schwarze 65: static void post_nm(DECL_ARGS);
1.1 schwarze 66: static void post_percent(DECL_ARGS);
1.4 schwarze 67: static void post_pf(DECL_ARGS);
1.3 schwarze 68: static void post_sect(DECL_ARGS);
1.4 schwarze 69: static void post_sp(DECL_ARGS);
1.15 schwarze 70: static void post_vt(DECL_ARGS);
1.32 schwarze 71: static int pre__t(DECL_ARGS);
1.20 schwarze 72: static int pre_an(DECL_ARGS);
1.3 schwarze 73: static int pre_ap(DECL_ARGS);
1.72 schwarze 74: static int pre_aq(DECL_ARGS);
1.3 schwarze 75: static int pre_bd(DECL_ARGS);
1.25 schwarze 76: static int pre_bf(DECL_ARGS);
1.10 schwarze 77: static int pre_bk(DECL_ARGS);
1.28 schwarze 78: static int pre_bl(DECL_ARGS);
1.3 schwarze 79: static int pre_br(DECL_ARGS);
1.5 schwarze 80: static int pre_bx(DECL_ARGS);
1.1 schwarze 81: static int pre_dl(DECL_ARGS);
1.63 schwarze 82: static int pre_en(DECL_ARGS);
1.4 schwarze 83: static int pre_enc(DECL_ARGS);
1.24 schwarze 84: static int pre_em(DECL_ARGS);
1.73 schwarze 85: static int pre_skip(DECL_ARGS);
1.74 schwarze 86: static int pre_eo(DECL_ARGS);
1.66 schwarze 87: static int pre_ex(DECL_ARGS);
1.14 schwarze 88: static int pre_fa(DECL_ARGS);
1.27 schwarze 89: static int pre_fd(DECL_ARGS);
1.24 schwarze 90: static int pre_fl(DECL_ARGS);
1.13 schwarze 91: static int pre_fn(DECL_ARGS);
1.14 schwarze 92: static int pre_fo(DECL_ARGS);
1.21 schwarze 93: static int pre_ft(DECL_ARGS);
1.12 schwarze 94: static int pre_in(DECL_ARGS);
1.1 schwarze 95: static int pre_it(DECL_ARGS);
1.22 schwarze 96: static int pre_lk(DECL_ARGS);
1.24 schwarze 97: static int pre_li(DECL_ARGS);
1.60 schwarze 98: static int pre_ll(DECL_ARGS);
1.1 schwarze 99: static int pre_nm(DECL_ARGS);
1.23 schwarze 100: static int pre_no(DECL_ARGS);
1.1 schwarze 101: static int pre_ns(DECL_ARGS);
102: static int pre_pp(DECL_ARGS);
1.32 schwarze 103: static int pre_rs(DECL_ARGS);
1.66 schwarze 104: static int pre_rv(DECL_ARGS);
1.9 schwarze 105: static int pre_sm(DECL_ARGS);
1.3 schwarze 106: static int pre_sp(DECL_ARGS);
1.4 schwarze 107: static int pre_sect(DECL_ARGS);
1.24 schwarze 108: static int pre_sy(DECL_ARGS);
1.21 schwarze 109: static void pre_syn(const struct mdoc_node *);
1.15 schwarze 110: static int pre_vt(DECL_ARGS);
1.5 schwarze 111: static int pre_ux(DECL_ARGS);
1.1 schwarze 112: static int pre_xr(DECL_ARGS);
1.18 schwarze 113: static void print_word(const char *);
1.34 schwarze 114: static void print_line(const char *, int);
115: static void print_block(const char *, int);
1.69 schwarze 116: static void print_offs(const char *, int);
1.33 schwarze 117: static void print_width(const char *,
118: const struct mdoc_node *, size_t);
1.28 schwarze 119: static void print_count(int *);
1.4 schwarze 120: static void print_node(DECL_ARGS);
1.1 schwarze 121:
1.3 schwarze 122: static const struct manact manacts[MDOC_MAX + 1] = {
123: { NULL, pre_ap, NULL, NULL, NULL }, /* Ap */
124: { NULL, NULL, NULL, NULL, NULL }, /* Dd */
125: { NULL, NULL, NULL, NULL, NULL }, /* Dt */
1.5 schwarze 126: { NULL, NULL, NULL, NULL, NULL }, /* Os */
1.3 schwarze 127: { NULL, pre_sect, post_sect, ".SH", NULL }, /* Sh */
128: { NULL, pre_sect, post_sect, ".SS", NULL }, /* Ss */
1.1 schwarze 129: { NULL, pre_pp, NULL, NULL, NULL }, /* Pp */
1.3 schwarze 130: { cond_body, pre_dl, post_dl, NULL, NULL }, /* D1 */
1.1 schwarze 131: { cond_body, pre_dl, post_dl, NULL, NULL }, /* Dl */
1.3 schwarze 132: { cond_body, pre_bd, post_bd, NULL, NULL }, /* Bd */
133: { NULL, NULL, NULL, NULL, NULL }, /* Ed */
1.28 schwarze 134: { cond_body, pre_bl, post_bl, NULL, NULL }, /* Bl */
1.3 schwarze 135: { NULL, NULL, NULL, NULL, NULL }, /* El */
1.28 schwarze 136: { NULL, pre_it, post_it, NULL, NULL }, /* It */
1.24 schwarze 137: { NULL, pre_em, post_font, NULL, NULL }, /* Ad */
1.20 schwarze 138: { NULL, pre_an, NULL, NULL, NULL }, /* An */
1.24 schwarze 139: { NULL, pre_em, post_font, NULL, NULL }, /* Ar */
140: { NULL, pre_sy, post_font, NULL, NULL }, /* Cd */
141: { NULL, pre_sy, post_font, NULL, NULL }, /* Cm */
142: { NULL, pre_li, post_font, NULL, NULL }, /* Dv */
143: { NULL, pre_li, post_font, NULL, NULL }, /* Er */
144: { NULL, pre_li, post_font, NULL, NULL }, /* Ev */
1.66 schwarze 145: { NULL, pre_ex, NULL, NULL, NULL }, /* Ex */
1.14 schwarze 146: { NULL, pre_fa, post_fa, NULL, NULL }, /* Fa */
1.27 schwarze 147: { NULL, pre_fd, post_fd, NULL, NULL }, /* Fd */
1.24 schwarze 148: { NULL, pre_fl, post_fl, NULL, NULL }, /* Fl */
1.13 schwarze 149: { NULL, pre_fn, post_fn, NULL, NULL }, /* Fn */
1.24 schwarze 150: { NULL, pre_ft, post_font, NULL, NULL }, /* Ft */
151: { NULL, pre_sy, post_font, NULL, NULL }, /* Ic */
1.12 schwarze 152: { NULL, pre_in, post_in, NULL, NULL }, /* In */
1.24 schwarze 153: { NULL, pre_li, post_font, NULL, NULL }, /* Li */
1.1 schwarze 154: { cond_head, pre_enc, NULL, "\\- ", NULL }, /* Nd */
155: { NULL, pre_nm, post_nm, NULL, NULL }, /* Nm */
156: { cond_body, pre_enc, post_enc, "[", "]" }, /* Op */
1.63 schwarze 157: { NULL, pre_ft, post_font, NULL, NULL }, /* Ot */
1.24 schwarze 158: { NULL, pre_em, post_font, NULL, NULL }, /* Pa */
1.66 schwarze 159: { NULL, pre_rv, NULL, NULL, NULL }, /* Rv */
1.5 schwarze 160: { NULL, NULL, NULL, NULL, NULL }, /* St */
1.24 schwarze 161: { NULL, pre_em, post_font, NULL, NULL }, /* Va */
1.15 schwarze 162: { NULL, pre_vt, post_vt, NULL, NULL }, /* Vt */
1.5 schwarze 163: { NULL, pre_xr, NULL, NULL, NULL }, /* Xr */
1.32 schwarze 164: { NULL, NULL, post_percent, NULL, NULL }, /* %A */
165: { NULL, pre_em, post_percent, NULL, NULL }, /* %B */
166: { NULL, NULL, post_percent, NULL, NULL }, /* %D */
167: { NULL, pre_em, post_percent, NULL, NULL }, /* %I */
168: { NULL, pre_em, post_percent, NULL, NULL }, /* %J */
169: { NULL, NULL, post_percent, NULL, NULL }, /* %N */
170: { NULL, NULL, post_percent, NULL, NULL }, /* %O */
171: { NULL, NULL, post_percent, NULL, NULL }, /* %P */
172: { NULL, NULL, post_percent, NULL, NULL }, /* %R */
173: { NULL, pre__t, post__t, NULL, NULL }, /* %T */
174: { NULL, NULL, post_percent, NULL, NULL }, /* %V */
1.6 schwarze 175: { NULL, NULL, NULL, NULL, NULL }, /* Ac */
1.72 schwarze 176: { cond_body, pre_aq, post_aq, NULL, NULL }, /* Ao */
177: { cond_body, pre_aq, post_aq, NULL, NULL }, /* Aq */
1.5 schwarze 178: { NULL, NULL, NULL, NULL, NULL }, /* At */
1.3 schwarze 179: { NULL, NULL, NULL, NULL, NULL }, /* Bc */
1.25 schwarze 180: { NULL, pre_bf, post_bf, NULL, NULL }, /* Bf */
1.3 schwarze 181: { cond_body, pre_enc, post_enc, "[", "]" }, /* Bo */
182: { cond_body, pre_enc, post_enc, "[", "]" }, /* Bq */
1.5 schwarze 183: { NULL, pre_ux, NULL, "BSD/OS", NULL }, /* Bsx */
184: { NULL, pre_bx, NULL, NULL, NULL }, /* Bx */
1.73 schwarze 185: { NULL, pre_skip, NULL, NULL, NULL }, /* Db */
1.6 schwarze 186: { NULL, NULL, NULL, NULL, NULL }, /* Dc */
1.50 schwarze 187: { cond_body, pre_enc, post_enc, "\\(lq", "\\(rq" }, /* Do */
188: { cond_body, pre_enc, post_enc, "\\(lq", "\\(rq" }, /* Dq */
1.26 schwarze 189: { NULL, NULL, NULL, NULL, NULL }, /* Ec */
190: { NULL, NULL, NULL, NULL, NULL }, /* Ef */
1.24 schwarze 191: { NULL, pre_em, post_font, NULL, NULL }, /* Em */
1.74 schwarze 192: { cond_body, pre_eo, post_eo, NULL, NULL }, /* Eo */
1.5 schwarze 193: { NULL, pre_ux, NULL, "FreeBSD", NULL }, /* Fx */
1.24 schwarze 194: { NULL, pre_sy, post_font, NULL, NULL }, /* Ms */
1.23 schwarze 195: { NULL, pre_no, NULL, NULL, NULL }, /* No */
1.1 schwarze 196: { NULL, pre_ns, NULL, NULL, NULL }, /* Ns */
1.5 schwarze 197: { NULL, pre_ux, NULL, "NetBSD", NULL }, /* Nx */
198: { NULL, pre_ux, NULL, "OpenBSD", NULL }, /* Ox */
1.3 schwarze 199: { NULL, NULL, NULL, NULL, NULL }, /* Pc */
200: { NULL, NULL, post_pf, NULL, NULL }, /* Pf */
201: { cond_body, pre_enc, post_enc, "(", ")" }, /* Po */
202: { cond_body, pre_enc, post_enc, "(", ")" }, /* Pq */
1.6 schwarze 203: { NULL, NULL, NULL, NULL, NULL }, /* Qc */
1.50 schwarze 204: { cond_body, pre_enc, post_enc, "\\(oq", "\\(cq" }, /* Ql */
1.6 schwarze 205: { cond_body, pre_enc, post_enc, "\"", "\"" }, /* Qo */
206: { cond_body, pre_enc, post_enc, "\"", "\"" }, /* Qq */
207: { NULL, NULL, NULL, NULL, NULL }, /* Re */
1.32 schwarze 208: { cond_body, pre_rs, NULL, NULL, NULL }, /* Rs */
1.6 schwarze 209: { NULL, NULL, NULL, NULL, NULL }, /* Sc */
1.50 schwarze 210: { cond_body, pre_enc, post_enc, "\\(oq", "\\(cq" }, /* So */
211: { cond_body, pre_enc, post_enc, "\\(oq", "\\(cq" }, /* Sq */
1.9 schwarze 212: { NULL, pre_sm, NULL, NULL, NULL }, /* Sm */
1.24 schwarze 213: { NULL, pre_em, post_font, NULL, NULL }, /* Sx */
214: { NULL, pre_sy, post_font, NULL, NULL }, /* Sy */
215: { NULL, pre_li, post_font, NULL, NULL }, /* Tn */
1.5 schwarze 216: { NULL, pre_ux, NULL, "UNIX", NULL }, /* Ux */
1.32 schwarze 217: { NULL, NULL, NULL, NULL, NULL }, /* Xc */
218: { NULL, NULL, NULL, NULL, NULL }, /* Xo */
1.14 schwarze 219: { NULL, pre_fo, post_fo, NULL, NULL }, /* Fo */
220: { NULL, NULL, NULL, NULL, NULL }, /* Fc */
1.3 schwarze 221: { cond_body, pre_enc, post_enc, "[", "]" }, /* Oo */
1.6 schwarze 222: { NULL, NULL, NULL, NULL, NULL }, /* Oc */
1.10 schwarze 223: { NULL, pre_bk, post_bk, NULL, NULL }, /* Bk */
224: { NULL, NULL, NULL, NULL, NULL }, /* Ek */
1.5 schwarze 225: { NULL, pre_ux, NULL, "is currently in beta test.", NULL }, /* Bt */
226: { NULL, NULL, NULL, NULL, NULL }, /* Hf */
1.63 schwarze 227: { NULL, pre_em, post_font, NULL, NULL }, /* Fr */
1.5 schwarze 228: { NULL, pre_ux, NULL, "currently under development.", NULL }, /* Ud */
1.11 schwarze 229: { NULL, NULL, post_lb, NULL, NULL }, /* Lb */
1.3 schwarze 230: { NULL, pre_pp, NULL, NULL, NULL }, /* Lp */
1.22 schwarze 231: { NULL, pre_lk, NULL, NULL, NULL }, /* Lk */
1.24 schwarze 232: { NULL, pre_em, post_font, NULL, NULL }, /* Mt */
1.6 schwarze 233: { cond_body, pre_enc, post_enc, "{", "}" }, /* Brq */
234: { cond_body, pre_enc, post_enc, "{", "}" }, /* Bro */
235: { NULL, NULL, NULL, NULL, NULL }, /* Brc */
1.32 schwarze 236: { NULL, NULL, post_percent, NULL, NULL }, /* %C */
1.73 schwarze 237: { NULL, pre_skip, NULL, NULL, NULL }, /* Es */
1.63 schwarze 238: { cond_body, pre_en, post_en, NULL, NULL }, /* En */
1.5 schwarze 239: { NULL, pre_ux, NULL, "DragonFly", NULL }, /* Dx */
1.32 schwarze 240: { NULL, NULL, post_percent, NULL, NULL }, /* %Q */
1.3 schwarze 241: { NULL, pre_br, NULL, NULL, NULL }, /* br */
242: { NULL, pre_sp, post_sp, NULL, NULL }, /* sp */
1.32 schwarze 243: { NULL, NULL, post_percent, NULL, NULL }, /* %U */
244: { NULL, NULL, NULL, NULL, NULL }, /* Ta */
1.60 schwarze 245: { NULL, pre_ll, post_sp, NULL, NULL }, /* ll */
1.3 schwarze 246: { NULL, NULL, NULL, NULL, NULL }, /* ROOT */
1.1 schwarze 247: };
248:
1.18 schwarze 249: static int outflags;
1.34 schwarze 250: #define MMAN_spc (1 << 0) /* blank character before next word */
251: #define MMAN_spc_force (1 << 1) /* even before trailing punctuation */
252: #define MMAN_nl (1 << 2) /* break man(7) code line */
253: #define MMAN_br (1 << 3) /* break output line */
254: #define MMAN_sp (1 << 4) /* insert a blank output line */
255: #define MMAN_PP (1 << 5) /* reset indentation etc. */
256: #define MMAN_Sm (1 << 6) /* horizontal spacing mode */
257: #define MMAN_Bk (1 << 7) /* word keep mode */
1.45 schwarze 258: #define MMAN_Bk_susp (1 << 8) /* suspend this (after a macro) */
259: #define MMAN_An_split (1 << 9) /* author mode is "split" */
260: #define MMAN_An_nosplit (1 << 10) /* author mode is "nosplit" */
261: #define MMAN_PD (1 << 11) /* inter-paragraph spacing disabled */
1.55 schwarze 262: #define MMAN_nbrword (1 << 12) /* do not break the next word */
1.18 schwarze 263:
1.43 schwarze 264: #define BL_STACK_MAX 32
265:
266: static size_t Bl_stack[BL_STACK_MAX]; /* offsets [chars] */
267: static int Bl_stack_post[BL_STACK_MAX]; /* add final .RE */
268: static int Bl_stack_len; /* number of nested Bl blocks */
1.35 schwarze 269: static int TPremain; /* characters before tag is full */
270:
1.24 schwarze 271: static struct {
272: char *head;
273: char *tail;
274: size_t size;
275: } fontqueue;
276:
1.61 schwarze 277:
1.24 schwarze 278: static void
279: font_push(char newfont)
280: {
281:
282: if (fontqueue.head + fontqueue.size <= ++fontqueue.tail) {
283: fontqueue.size += 8;
284: fontqueue.head = mandoc_realloc(fontqueue.head,
1.61 schwarze 285: fontqueue.size);
1.24 schwarze 286: }
287: *fontqueue.tail = newfont;
1.35 schwarze 288: print_word("");
289: printf("\\f");
1.24 schwarze 290: putchar(newfont);
291: outflags &= ~MMAN_spc;
292: }
293:
294: static void
295: font_pop(void)
296: {
297:
298: if (fontqueue.tail > fontqueue.head)
299: fontqueue.tail--;
300: outflags &= ~MMAN_spc;
1.35 schwarze 301: print_word("");
302: printf("\\f");
1.24 schwarze 303: putchar(*fontqueue.tail);
304: }
305:
1.1 schwarze 306: static void
1.18 schwarze 307: print_word(const char *s)
1.1 schwarze 308: {
1.4 schwarze 309:
1.34 schwarze 310: if ((MMAN_PP | MMAN_sp | MMAN_br | MMAN_nl) & outflags) {
1.61 schwarze 311: /*
1.4 schwarze 312: * If we need a newline, print it now and start afresh.
313: */
1.34 schwarze 314: if (MMAN_PP & outflags) {
1.44 schwarze 315: if (MMAN_sp & outflags) {
316: if (MMAN_PD & outflags) {
317: printf("\n.PD");
318: outflags &= ~MMAN_PD;
319: }
320: } else if ( ! (MMAN_PD & outflags)) {
321: printf("\n.PD 0");
322: outflags |= MMAN_PD;
323: }
1.34 schwarze 324: printf("\n.PP\n");
325: } else if (MMAN_sp & outflags)
1.19 schwarze 326: printf("\n.sp\n");
327: else if (MMAN_br & outflags)
328: printf("\n.br\n");
329: else if (MMAN_nl & outflags)
330: putchar('\n');
1.34 schwarze 331: outflags &= ~(MMAN_PP|MMAN_sp|MMAN_br|MMAN_nl|MMAN_spc);
1.35 schwarze 332: if (1 == TPremain)
333: printf(".br\n");
334: TPremain = 0;
335: } else if (MMAN_spc & outflags) {
1.4 schwarze 336: /*
1.23 schwarze 337: * If we need a space, only print it if
338: * (1) it is forced by `No' or
339: * (2) what follows is not terminating punctuation or
340: * (3) what follows is longer than one character.
1.4 schwarze 341: */
1.35 schwarze 342: if (MMAN_spc_force & outflags || '\0' == s[0] ||
1.23 schwarze 343: NULL == strchr(".,:;)]?!", s[0]) || '\0' != s[1]) {
1.45 schwarze 344: if (MMAN_Bk & outflags &&
345: ! (MMAN_Bk_susp & outflags))
1.10 schwarze 346: putchar('\\');
1.39 millert 347: putchar(' ');
1.35 schwarze 348: if (TPremain)
349: TPremain--;
1.10 schwarze 350: }
1.35 schwarze 351: }
1.4 schwarze 352:
353: /*
354: * Reassign needing space if we're not following opening
355: * punctuation.
356: */
1.35 schwarze 357: if (MMAN_Sm & outflags && ('\0' == s[0] ||
358: (('(' != s[0] && '[' != s[0]) || '\0' != s[1])))
1.18 schwarze 359: outflags |= MMAN_spc;
360: else
361: outflags &= ~MMAN_spc;
1.45 schwarze 362: outflags &= ~(MMAN_spc_force | MMAN_Bk_susp);
1.4 schwarze 363:
1.1 schwarze 364: for ( ; *s; s++) {
365: switch (*s) {
1.61 schwarze 366: case ASCII_NBRSP:
1.39 millert 367: printf("\\ ");
1.1 schwarze 368: break;
1.61 schwarze 369: case ASCII_HYPH:
1.1 schwarze 370: putchar('-');
1.57 schwarze 371: break;
1.61 schwarze 372: case ASCII_BREAK:
1.57 schwarze 373: printf("\\:");
1.1 schwarze 374: break;
1.61 schwarze 375: case ' ':
1.55 schwarze 376: if (MMAN_nbrword & outflags) {
377: printf("\\ ");
378: break;
379: }
380: /* FALLTHROUGH */
1.1 schwarze 381: default:
1.4 schwarze 382: putchar((unsigned char)*s);
1.1 schwarze 383: break;
384: }
1.35 schwarze 385: if (TPremain)
386: TPremain--;
1.1 schwarze 387: }
1.55 schwarze 388: outflags &= ~MMAN_nbrword;
1.1 schwarze 389: }
390:
1.8 schwarze 391: static void
1.34 schwarze 392: print_line(const char *s, int newflags)
393: {
394:
395: outflags &= ~MMAN_br;
396: outflags |= MMAN_nl;
397: print_word(s);
398: outflags |= newflags;
399: }
400:
401: static void
402: print_block(const char *s, int newflags)
403: {
404:
405: outflags &= ~MMAN_PP;
1.44 schwarze 406: if (MMAN_sp & outflags) {
1.34 schwarze 407: outflags &= ~(MMAN_sp | MMAN_br);
1.44 schwarze 408: if (MMAN_PD & outflags) {
409: print_line(".PD", 0);
410: outflags &= ~MMAN_PD;
411: }
1.45 schwarze 412: } else if (! (MMAN_PD & outflags))
413: print_line(".PD 0", MMAN_PD);
1.34 schwarze 414: outflags |= MMAN_nl;
415: print_word(s);
1.45 schwarze 416: outflags |= MMAN_Bk_susp | newflags;
1.34 schwarze 417: }
418:
419: static void
1.69 schwarze 420: print_offs(const char *v, int keywords)
1.8 schwarze 421: {
422: char buf[24];
423: struct roffsu su;
424: size_t sz;
425:
1.47 schwarze 426: print_line(".RS", MMAN_Bk_susp);
427:
1.43 schwarze 428: /* Convert v into a number (of characters). */
1.69 schwarze 429: if (NULL == v || '\0' == *v || (keywords && !strcmp(v, "left")))
1.8 schwarze 430: sz = 0;
1.69 schwarze 431: else if (keywords && !strcmp(v, "indent"))
1.8 schwarze 432: sz = 6;
1.69 schwarze 433: else if (keywords && !strcmp(v, "indent-two"))
1.8 schwarze 434: sz = 12;
1.77 schwarze 435: else if (a2roffsu(v, &su, SCALE_EN) > 1) {
1.78 ! schwarze 436: if (su.scale < 0.0)
! 437: su.scale = 0.0;
1.43 schwarze 438: if (SCALE_EN == su.unit)
439: sz = su.scale;
440: else {
441: /*
442: * XXX
443: * If we are inside an enclosing list,
444: * there is no easy way to add the two
445: * indentations because they are provided
446: * in terms of different units.
447: */
448: print_word(v);
1.47 schwarze 449: outflags |= MMAN_nl;
1.43 schwarze 450: return;
451: }
1.8 schwarze 452: } else
453: sz = strlen(v);
454:
1.43 schwarze 455: /*
456: * We are inside an enclosing list.
457: * Add the two indentations.
458: */
459: if (Bl_stack_len)
460: sz += Bl_stack[Bl_stack_len - 1];
461:
1.62 schwarze 462: (void)snprintf(buf, sizeof(buf), "%zun", sz);
1.18 schwarze 463: print_word(buf);
1.47 schwarze 464: outflags |= MMAN_nl;
1.8 schwarze 465: }
466:
1.46 schwarze 467: /*
468: * Set up the indentation for a list item; used from pre_it().
469: */
1.59 schwarze 470: static void
1.33 schwarze 471: print_width(const char *v, const struct mdoc_node *child, size_t defsz)
1.28 schwarze 472: {
473: char buf[24];
474: struct roffsu su;
1.29 schwarze 475: size_t sz, chsz;
1.35 schwarze 476: int numeric, remain;
1.29 schwarze 477:
1.35 schwarze 478: numeric = 1;
479: remain = 0;
1.43 schwarze 480:
481: /* Convert v into a number (of characters). */
1.33 schwarze 482: if (NULL == v)
483: sz = defsz;
1.77 schwarze 484: else if (a2roffsu(v, &su, SCALE_MAX) > 1) {
1.78 ! schwarze 485: if (su.scale < 0.0)
! 486: su.scale = 0.0;
1.28 schwarze 487: if (SCALE_EN == su.unit)
488: sz = su.scale;
489: else {
1.35 schwarze 490: sz = 0;
491: numeric = 0;
1.28 schwarze 492: }
493: } else
494: sz = strlen(v);
495:
1.35 schwarze 496: /* XXX Rough estimation, might have multiple parts. */
497: chsz = (NULL != child && MDOC_TEXT == child->type) ?
1.61 schwarze 498: strlen(child->string) : 0;
1.35 schwarze 499:
1.46 schwarze 500: /* Maybe we are inside an enclosing list? */
501: mid_it();
1.43 schwarze 502:
503: /*
504: * Save our own indentation,
505: * such that child lists can use it.
506: */
507: Bl_stack[Bl_stack_len++] = sz + 2;
508:
509: /* Set up the current list. */
1.35 schwarze 510: if (defsz && chsz > sz)
1.34 schwarze 511: print_block(".HP", 0);
1.35 schwarze 512: else {
1.34 schwarze 513: print_block(".TP", 0);
1.35 schwarze 514: remain = sz + 2;
515: }
516: if (numeric) {
1.62 schwarze 517: (void)snprintf(buf, sizeof(buf), "%zun", sz + 2);
1.35 schwarze 518: print_word(buf);
519: } else
520: print_word(v);
521: TPremain = remain;
1.28 schwarze 522: }
523:
1.59 schwarze 524: static void
1.28 schwarze 525: print_count(int *count)
526: {
1.62 schwarze 527: char buf[24];
1.28 schwarze 528:
1.62 schwarze 529: (void)snprintf(buf, sizeof(buf), "%d.", ++*count);
1.28 schwarze 530: print_word(buf);
531: }
532:
533: void
1.4 schwarze 534: man_man(void *arg, const struct man *man)
535: {
536:
537: /*
538: * Dump the keep buffer.
539: * We're guaranteed by now that this exists (is non-NULL).
540: * Flush stdout afterward, just in case.
541: */
542: fputs(mparse_getkeep(man_mparse(man)), stdout);
543: fflush(stdout);
544: }
545:
546: void
1.1 schwarze 547: man_mdoc(void *arg, const struct mdoc *mdoc)
548: {
1.42 schwarze 549: const struct mdoc_meta *meta;
1.1 schwarze 550: const struct mdoc_node *n;
551:
1.42 schwarze 552: meta = mdoc_meta(mdoc);
1.1 schwarze 553: n = mdoc_node(mdoc);
554:
1.41 millert 555: printf(".TH \"%s\" \"%s\" \"%s\" \"%s\" \"%s\"\n",
1.67 schwarze 556: meta->title,
557: (meta->msec == NULL ? "" : meta->msec),
558: meta->date, meta->os, meta->vol);
1.41 millert 559:
560: /* Disable hyphenation and if nroff, disable justification. */
561: printf(".nh\n.if n .ad l");
1.1 schwarze 562:
1.18 schwarze 563: outflags = MMAN_nl | MMAN_Sm;
1.24 schwarze 564: if (0 == fontqueue.size) {
565: fontqueue.size = 8;
566: fontqueue.head = fontqueue.tail = mandoc_malloc(8);
567: *fontqueue.tail = 'R';
568: }
1.42 schwarze 569: print_node(meta, n);
1.3 schwarze 570: putchar('\n');
1.1 schwarze 571: }
572:
573: static void
574: print_node(DECL_ARGS)
575: {
1.51 schwarze 576: const struct mdoc_node *sub;
1.4 schwarze 577: const struct manact *act;
1.1 schwarze 578: int cond, do_sub;
1.45 schwarze 579:
1.4 schwarze 580: /*
581: * Break the line if we were parsed subsequent the current node.
582: * This makes the page structure be more consistent.
583: */
1.51 schwarze 584: if (MMAN_spc & outflags && MDOC_LINE & n->flags)
1.18 schwarze 585: outflags |= MMAN_nl;
1.1 schwarze 586:
1.4 schwarze 587: act = NULL;
1.1 schwarze 588: cond = 0;
589: do_sub = 1;
1.4 schwarze 590:
1.1 schwarze 591: if (MDOC_TEXT == n->type) {
1.4 schwarze 592: /*
593: * Make sure that we don't happen to start with a
594: * control character at the start of a line.
595: */
1.61 schwarze 596: if (MMAN_nl & outflags &&
597: ('.' == *n->string || '\'' == *n->string)) {
1.35 schwarze 598: print_word("");
599: printf("\\&");
1.18 schwarze 600: outflags &= ~MMAN_spc;
1.3 schwarze 601: }
1.71 schwarze 602: if (outflags & MMAN_Sm && ! (n->flags & MDOC_DELIMC))
603: outflags |= MMAN_spc_force;
1.18 schwarze 604: print_word(n->string);
1.71 schwarze 605: if (outflags & MMAN_Sm && ! (n->flags & MDOC_DELIMO))
606: outflags |= MMAN_spc;
1.1 schwarze 607: } else {
1.4 schwarze 608: /*
609: * Conditionally run the pre-node action handler for a
610: * node.
611: */
1.1 schwarze 612: act = manacts + n->tok;
1.74 schwarze 613: cond = act->cond == NULL || (*act->cond)(meta, n);
614: if (cond && act->pre && (n->end == ENDBODY_NOT || n->nchild))
1.42 schwarze 615: do_sub = (*act->pre)(meta, n);
1.1 schwarze 616: }
617:
1.61 schwarze 618: /*
1.4 schwarze 619: * Conditionally run all child nodes.
620: * Note that this iterates over children instead of using
621: * recursion. This prevents unnecessary depth in the stack.
622: */
1.1 schwarze 623: if (do_sub)
624: for (sub = n->child; sub; sub = sub->next)
1.42 schwarze 625: print_node(meta, sub);
1.1 schwarze 626:
1.4 schwarze 627: /*
628: * Lastly, conditionally run the post-node handler.
629: */
1.58 schwarze 630: if (MDOC_ENDED & n->flags)
631: return;
632:
1.1 schwarze 633: if (cond && act->post)
1.42 schwarze 634: (*act->post)(meta, n);
1.58 schwarze 635:
636: if (ENDBODY_NOT != n->end)
637: n->pending->flags |= MDOC_ENDED;
638:
639: if (ENDBODY_NOSPACE == n->end)
640: outflags &= ~(MMAN_spc | MMAN_nl);
1.1 schwarze 641: }
642:
643: static int
644: cond_head(DECL_ARGS)
645: {
1.4 schwarze 646:
1.1 schwarze 647: return(MDOC_HEAD == n->type);
648: }
649:
650: static int
651: cond_body(DECL_ARGS)
652: {
1.4 schwarze 653:
1.1 schwarze 654: return(MDOC_BODY == n->type);
655: }
656:
657: static int
658: pre_enc(DECL_ARGS)
659: {
1.4 schwarze 660: const char *prefix;
1.1 schwarze 661:
662: prefix = manacts[n->tok].prefix;
663: if (NULL == prefix)
664: return(1);
1.18 schwarze 665: print_word(prefix);
666: outflags &= ~MMAN_spc;
1.1 schwarze 667: return(1);
668: }
669:
670: static void
671: post_enc(DECL_ARGS)
672: {
673: const char *suffix;
674:
675: suffix = manacts[n->tok].suffix;
676: if (NULL == suffix)
677: return;
1.58 schwarze 678: outflags &= ~(MMAN_spc | MMAN_nl);
1.18 schwarze 679: print_word(suffix);
1.24 schwarze 680: }
681:
1.66 schwarze 682: static int
683: pre_ex(DECL_ARGS)
684: {
685: int nchild;
686:
687: outflags |= MMAN_br | MMAN_nl;
688:
689: print_word("The");
690:
691: nchild = n->nchild;
692: for (n = n->child; n; n = n->next) {
693: font_push('B');
694: print_word(n->string);
695: font_pop();
696:
697: if (n->next == NULL)
698: continue;
699:
700: if (nchild > 2) {
701: outflags &= ~MMAN_spc;
702: print_word(",");
703: }
704: if (n->next->next == NULL)
705: print_word("and");
706: }
707:
708: if (nchild > 1)
709: print_word("utilities exit\\~0");
710: else
711: print_word("utility exits\\~0");
712:
713: print_word("on success, and\\~>0 if an error occurs.");
714: outflags |= MMAN_nl;
715: return(0);
716: }
717:
1.24 schwarze 718: static void
719: post_font(DECL_ARGS)
720: {
721:
722: font_pop();
1.1 schwarze 723: }
724:
725: static void
726: post_percent(DECL_ARGS)
727: {
728:
1.32 schwarze 729: if (pre_em == manacts[n->tok].pre)
730: font_pop();
731: if (n->next) {
1.18 schwarze 732: print_word(",");
1.32 schwarze 733: if (n->prev && n->prev->tok == n->tok &&
734: n->next->tok == n->tok)
735: print_word("and");
736: } else {
1.18 schwarze 737: print_word(".");
738: outflags |= MMAN_nl;
1.1 schwarze 739: }
740: }
741:
1.32 schwarze 742: static int
743: pre__t(DECL_ARGS)
744: {
745:
1.61 schwarze 746: if (n->parent && MDOC_Rs == n->parent->tok &&
747: n->parent->norm->Rs.quote_T) {
1.35 schwarze 748: print_word("");
749: putchar('\"');
1.32 schwarze 750: outflags &= ~MMAN_spc;
751: } else
752: font_push('I');
753: return(1);
754: }
755:
756: static void
757: post__t(DECL_ARGS)
758: {
759:
1.61 schwarze 760: if (n->parent && MDOC_Rs == n->parent->tok &&
761: n->parent->norm->Rs.quote_T) {
1.32 schwarze 762: outflags &= ~MMAN_spc;
1.35 schwarze 763: print_word("");
764: putchar('\"');
1.32 schwarze 765: } else
766: font_pop();
1.42 schwarze 767: post_percent(meta, n);
1.32 schwarze 768: }
769:
1.4 schwarze 770: /*
771: * Print before a section header.
772: */
1.1 schwarze 773: static int
1.3 schwarze 774: pre_sect(DECL_ARGS)
775: {
776:
1.53 schwarze 777: if (MDOC_HEAD == n->type) {
1.45 schwarze 778: outflags |= MMAN_sp;
779: print_block(manacts[n->tok].prefix, 0);
780: print_word("");
781: putchar('\"');
782: outflags &= ~MMAN_spc;
783: }
1.3 schwarze 784: return(1);
785: }
786:
1.4 schwarze 787: /*
788: * Print subsequent a section header.
789: */
1.3 schwarze 790: static void
791: post_sect(DECL_ARGS)
792: {
793:
794: if (MDOC_HEAD != n->type)
795: return;
1.18 schwarze 796: outflags &= ~MMAN_spc;
1.35 schwarze 797: print_word("");
798: putchar('\"');
1.18 schwarze 799: outflags |= MMAN_nl;
1.20 schwarze 800: if (MDOC_Sh == n->tok && SEC_AUTHORS == n->sec)
801: outflags &= ~(MMAN_An_split | MMAN_An_nosplit);
802: }
803:
1.21 schwarze 804: /* See mdoc_term.c, synopsis_pre() for comments. */
805: static void
806: pre_syn(const struct mdoc_node *n)
807: {
808:
809: if (NULL == n->prev || ! (MDOC_SYNPRETTY & n->flags))
810: return;
811:
812: if (n->prev->tok == n->tok &&
1.61 schwarze 813: MDOC_Ft != n->tok &&
814: MDOC_Fo != n->tok &&
815: MDOC_Fn != n->tok) {
1.21 schwarze 816: outflags |= MMAN_br;
817: return;
818: }
819:
820: switch (n->prev->tok) {
1.61 schwarze 821: case MDOC_Fd:
1.21 schwarze 822: /* FALLTHROUGH */
1.61 schwarze 823: case MDOC_Fn:
1.21 schwarze 824: /* FALLTHROUGH */
1.61 schwarze 825: case MDOC_Fo:
1.21 schwarze 826: /* FALLTHROUGH */
1.61 schwarze 827: case MDOC_In:
1.21 schwarze 828: /* FALLTHROUGH */
1.61 schwarze 829: case MDOC_Vt:
1.21 schwarze 830: outflags |= MMAN_sp;
831: break;
1.61 schwarze 832: case MDOC_Ft:
1.21 schwarze 833: if (MDOC_Fn != n->tok && MDOC_Fo != n->tok) {
834: outflags |= MMAN_sp;
835: break;
836: }
837: /* FALLTHROUGH */
838: default:
839: outflags |= MMAN_br;
840: break;
841: }
842: }
843:
1.20 schwarze 844: static int
845: pre_an(DECL_ARGS)
846: {
847:
848: switch (n->norm->An.auth) {
1.61 schwarze 849: case AUTH_split:
1.20 schwarze 850: outflags &= ~MMAN_An_nosplit;
851: outflags |= MMAN_An_split;
852: return(0);
1.61 schwarze 853: case AUTH_nosplit:
1.20 schwarze 854: outflags &= ~MMAN_An_split;
855: outflags |= MMAN_An_nosplit;
856: return(0);
857: default:
858: if (MMAN_An_split & outflags)
859: outflags |= MMAN_br;
860: else if (SEC_AUTHORS == n->sec &&
861: ! (MMAN_An_nosplit & outflags))
862: outflags |= MMAN_An_split;
863: return(1);
864: }
1.3 schwarze 865: }
866:
867: static int
868: pre_ap(DECL_ARGS)
869: {
870:
1.18 schwarze 871: outflags &= ~MMAN_spc;
872: print_word("'");
873: outflags &= ~MMAN_spc;
1.3 schwarze 874: return(0);
1.72 schwarze 875: }
876:
877: static int
878: pre_aq(DECL_ARGS)
879: {
880:
881: print_word(n->parent->prev != NULL &&
882: n->parent->prev->tok == MDOC_An ? "<" : "\\(la");
883: outflags &= ~MMAN_spc;
884: return(1);
885: }
886:
887: static void
888: post_aq(DECL_ARGS)
889: {
890:
891: outflags &= ~(MMAN_spc | MMAN_nl);
892: print_word(n->parent->prev != NULL &&
893: n->parent->prev->tok == MDOC_An ? ">" : "\\(ra");
1.3 schwarze 894: }
895:
896: static int
897: pre_bd(DECL_ARGS)
898: {
899:
1.34 schwarze 900: outflags &= ~(MMAN_PP | MMAN_sp | MMAN_br);
901:
902: if (DISP_unfilled == n->norm->Bd.type ||
903: DISP_literal == n->norm->Bd.type)
904: print_line(".nf", 0);
905: if (0 == n->norm->Bd.comp && NULL != n->parent->prev)
1.19 schwarze 906: outflags |= MMAN_sp;
1.69 schwarze 907: print_offs(n->norm->Bd.offs, 1);
1.3 schwarze 908: return(1);
909: }
910:
911: static void
912: post_bd(DECL_ARGS)
913: {
914:
1.43 schwarze 915: /* Close out this display. */
1.34 schwarze 916: print_line(".RE", MMAN_nl);
1.3 schwarze 917: if (DISP_unfilled == n->norm->Bd.type ||
1.34 schwarze 918: DISP_literal == n->norm->Bd.type)
919: print_line(".fi", MMAN_nl);
1.43 schwarze 920:
1.46 schwarze 921: /* Maybe we are inside an enclosing list? */
922: if (NULL != n->parent->next)
923: mid_it();
1.10 schwarze 924: }
925:
926: static int
1.25 schwarze 927: pre_bf(DECL_ARGS)
928: {
929:
930: switch (n->type) {
1.61 schwarze 931: case MDOC_BLOCK:
1.25 schwarze 932: return(1);
1.61 schwarze 933: case MDOC_BODY:
1.25 schwarze 934: break;
935: default:
936: return(0);
937: }
938: switch (n->norm->Bf.font) {
1.61 schwarze 939: case FONT_Em:
1.25 schwarze 940: font_push('I');
941: break;
1.61 schwarze 942: case FONT_Sy:
1.25 schwarze 943: font_push('B');
944: break;
945: default:
946: font_push('R');
947: break;
948: }
949: return(1);
950: }
951:
952: static void
953: post_bf(DECL_ARGS)
954: {
955:
956: if (MDOC_BODY == n->type)
957: font_pop();
958: }
959:
960: static int
1.10 schwarze 961: pre_bk(DECL_ARGS)
962: {
963:
964: switch (n->type) {
1.61 schwarze 965: case MDOC_BLOCK:
1.10 schwarze 966: return(1);
1.61 schwarze 967: case MDOC_BODY:
1.18 schwarze 968: outflags |= MMAN_Bk;
1.10 schwarze 969: return(1);
970: default:
971: return(0);
972: }
973: }
974:
975: static void
976: post_bk(DECL_ARGS)
977: {
978:
1.53 schwarze 979: if (MDOC_BODY == n->type)
1.18 schwarze 980: outflags &= ~MMAN_Bk;
1.3 schwarze 981: }
982:
983: static int
1.28 schwarze 984: pre_bl(DECL_ARGS)
985: {
1.31 schwarze 986: size_t icol;
1.28 schwarze 987:
1.48 schwarze 988: /*
989: * print_offs() will increase the -offset to account for
990: * a possible enclosing .It, but any enclosed .It blocks
991: * just nest and do not add up their indentation.
992: */
993: if (n->norm->Bl.offs) {
1.69 schwarze 994: print_offs(n->norm->Bl.offs, 0);
1.48 schwarze 995: Bl_stack[Bl_stack_len++] = 0;
996: }
997:
1.31 schwarze 998: switch (n->norm->Bl.type) {
1.61 schwarze 999: case LIST_enum:
1.28 schwarze 1000: n->norm->Bl.count = 0;
1.31 schwarze 1001: return(1);
1.61 schwarze 1002: case LIST_column:
1.31 schwarze 1003: break;
1004: default:
1005: return(1);
1006: }
1007:
1.34 schwarze 1008: print_line(".TS", MMAN_nl);
1.31 schwarze 1009: for (icol = 0; icol < n->norm->Bl.ncols; icol++)
1010: print_word("l");
1011: print_word(".");
1.34 schwarze 1012: outflags |= MMAN_nl;
1.28 schwarze 1013: return(1);
1014: }
1015:
1016: static void
1017: post_bl(DECL_ARGS)
1018: {
1019:
1.31 schwarze 1020: switch (n->norm->Bl.type) {
1.61 schwarze 1021: case LIST_column:
1.34 schwarze 1022: print_line(".TE", 0);
1023: break;
1.61 schwarze 1024: case LIST_enum:
1.31 schwarze 1025: n->norm->Bl.count = 0;
1026: break;
1027: default:
1028: break;
1029: }
1.48 schwarze 1030:
1031: if (n->norm->Bl.offs) {
1032: print_line(".RE", MMAN_nl);
1033: assert(Bl_stack_len);
1034: Bl_stack_len--;
1035: assert(0 == Bl_stack[Bl_stack_len]);
1036: } else {
1037: outflags |= MMAN_PP | MMAN_nl;
1038: outflags &= ~(MMAN_sp | MMAN_br);
1039: }
1.46 schwarze 1040:
1041: /* Maybe we are inside an enclosing list? */
1042: if (NULL != n->parent->next)
1043: mid_it();
1044:
1.28 schwarze 1045: }
1046:
1047: static int
1.3 schwarze 1048: pre_br(DECL_ARGS)
1049: {
1050:
1.19 schwarze 1051: outflags |= MMAN_br;
1.3 schwarze 1052: return(0);
1053: }
1054:
1055: static int
1.5 schwarze 1056: pre_bx(DECL_ARGS)
1057: {
1058:
1059: n = n->child;
1060: if (n) {
1.18 schwarze 1061: print_word(n->string);
1062: outflags &= ~MMAN_spc;
1.5 schwarze 1063: n = n->next;
1064: }
1.18 schwarze 1065: print_word("BSD");
1.5 schwarze 1066: if (NULL == n)
1067: return(0);
1.18 schwarze 1068: outflags &= ~MMAN_spc;
1069: print_word("-");
1070: outflags &= ~MMAN_spc;
1071: print_word(n->string);
1.5 schwarze 1072: return(0);
1073: }
1074:
1075: static int
1.1 schwarze 1076: pre_dl(DECL_ARGS)
1077: {
1078:
1.69 schwarze 1079: print_offs("6n", 0);
1.1 schwarze 1080: return(1);
1081: }
1082:
1083: static void
1084: post_dl(DECL_ARGS)
1085: {
1086:
1.34 schwarze 1087: print_line(".RE", MMAN_nl);
1.46 schwarze 1088:
1089: /* Maybe we are inside an enclosing list? */
1090: if (NULL != n->parent->next)
1091: mid_it();
1.13 schwarze 1092: }
1093:
1094: static int
1.24 schwarze 1095: pre_em(DECL_ARGS)
1096: {
1097:
1098: font_push('I');
1099: return(1);
1.26 schwarze 1100: }
1101:
1.63 schwarze 1102: static int
1103: pre_en(DECL_ARGS)
1104: {
1105:
1106: if (NULL == n->norm->Es ||
1107: NULL == n->norm->Es->child)
1108: return(1);
1109:
1110: print_word(n->norm->Es->child->string);
1111: outflags &= ~MMAN_spc;
1112: return(1);
1113: }
1114:
1115: static void
1116: post_en(DECL_ARGS)
1117: {
1118:
1119: if (NULL == n->norm->Es ||
1120: NULL == n->norm->Es->child ||
1121: NULL == n->norm->Es->child->next)
1122: return;
1123:
1124: outflags &= ~MMAN_spc;
1125: print_word(n->norm->Es->child->next->string);
1126: return;
1127: }
1128:
1.74 schwarze 1129: static int
1130: pre_eo(DECL_ARGS)
1131: {
1132:
1133: outflags &= ~(MMAN_spc | MMAN_nl);
1134: return(1);
1135: }
1136:
1.26 schwarze 1137: static void
1138: post_eo(DECL_ARGS)
1139: {
1140:
1.74 schwarze 1141: if (n->end != ENDBODY_SPACE)
1.26 schwarze 1142: outflags &= ~MMAN_spc;
1.63 schwarze 1143: }
1144:
1145: static int
1.14 schwarze 1146: pre_fa(DECL_ARGS)
1147: {
1.56 schwarze 1148: int am_Fa;
1.14 schwarze 1149:
1.56 schwarze 1150: am_Fa = MDOC_Fa == n->tok;
1151:
1152: if (am_Fa)
1.14 schwarze 1153: n = n->child;
1154:
1155: while (NULL != n) {
1.24 schwarze 1156: font_push('I');
1.56 schwarze 1157: if (am_Fa || MDOC_SYNPRETTY & n->flags)
1.55 schwarze 1158: outflags |= MMAN_nbrword;
1.42 schwarze 1159: print_node(meta, n);
1.24 schwarze 1160: font_pop();
1.14 schwarze 1161: if (NULL != (n = n->next))
1.18 schwarze 1162: print_word(",");
1.14 schwarze 1163: }
1164: return(0);
1165: }
1166:
1167: static void
1168: post_fa(DECL_ARGS)
1169: {
1170:
1171: if (NULL != n->next && MDOC_Fa == n->next->tok)
1.18 schwarze 1172: print_word(",");
1.27 schwarze 1173: }
1174:
1175: static int
1176: pre_fd(DECL_ARGS)
1177: {
1178:
1179: pre_syn(n);
1180: font_push('B');
1181: return(1);
1182: }
1183:
1184: static void
1185: post_fd(DECL_ARGS)
1186: {
1187:
1188: font_pop();
1189: outflags |= MMAN_br;
1.14 schwarze 1190: }
1191:
1192: static int
1.24 schwarze 1193: pre_fl(DECL_ARGS)
1194: {
1195:
1196: font_push('B');
1.40 millert 1197: print_word("\\-");
1.68 schwarze 1198: if (n->nchild)
1199: outflags &= ~MMAN_spc;
1.24 schwarze 1200: return(1);
1201: }
1202:
1203: static void
1204: post_fl(DECL_ARGS)
1205: {
1206:
1207: font_pop();
1.68 schwarze 1208: if ( ! (n->nchild ||
1209: n->next == NULL ||
1210: n->next->type == MDOC_TEXT ||
1211: n->next->flags & MDOC_LINE))
1.24 schwarze 1212: outflags &= ~MMAN_spc;
1213: }
1214:
1215: static int
1.13 schwarze 1216: pre_fn(DECL_ARGS)
1217: {
1218:
1.21 schwarze 1219: pre_syn(n);
1220:
1.13 schwarze 1221: n = n->child;
1222: if (NULL == n)
1223: return(0);
1224:
1.54 schwarze 1225: if (MDOC_SYNPRETTY & n->flags)
1226: print_block(".HP 4n", MMAN_nl);
1227:
1.24 schwarze 1228: font_push('B');
1.42 schwarze 1229: print_node(meta, n);
1.24 schwarze 1230: font_pop();
1.18 schwarze 1231: outflags &= ~MMAN_spc;
1.24 schwarze 1232: print_word("(");
1.18 schwarze 1233: outflags &= ~MMAN_spc;
1.33 schwarze 1234:
1235: n = n->next;
1236: if (NULL != n)
1.42 schwarze 1237: pre_fa(meta, n);
1.33 schwarze 1238: return(0);
1.13 schwarze 1239: }
1240:
1241: static void
1242: post_fn(DECL_ARGS)
1243: {
1244:
1.18 schwarze 1245: print_word(")");
1.13 schwarze 1246: if (MDOC_SYNPRETTY & n->flags) {
1.18 schwarze 1247: print_word(";");
1.54 schwarze 1248: outflags |= MMAN_PP;
1.14 schwarze 1249: }
1250: }
1251:
1252: static int
1253: pre_fo(DECL_ARGS)
1254: {
1255:
1256: switch (n->type) {
1.61 schwarze 1257: case MDOC_BLOCK:
1.21 schwarze 1258: pre_syn(n);
1259: break;
1.61 schwarze 1260: case MDOC_HEAD:
1.56 schwarze 1261: if (MDOC_SYNPRETTY & n->flags)
1262: print_block(".HP 4n", MMAN_nl);
1.24 schwarze 1263: font_push('B');
1.14 schwarze 1264: break;
1.61 schwarze 1265: case MDOC_BODY:
1.18 schwarze 1266: outflags &= ~MMAN_spc;
1267: print_word("(");
1268: outflags &= ~MMAN_spc;
1.14 schwarze 1269: break;
1270: default:
1271: break;
1272: }
1273: return(1);
1274: }
1.56 schwarze 1275:
1.14 schwarze 1276: static void
1277: post_fo(DECL_ARGS)
1278: {
1279:
1280: switch (n->type) {
1.61 schwarze 1281: case MDOC_HEAD:
1.24 schwarze 1282: font_pop();
1.14 schwarze 1283: break;
1.61 schwarze 1284: case MDOC_BODY:
1.42 schwarze 1285: post_fn(meta, n);
1.14 schwarze 1286: break;
1287: default:
1288: break;
1.13 schwarze 1289: }
1.12 schwarze 1290: }
1291:
1292: static int
1.21 schwarze 1293: pre_ft(DECL_ARGS)
1294: {
1295:
1296: pre_syn(n);
1.24 schwarze 1297: font_push('I');
1.21 schwarze 1298: return(1);
1299: }
1300:
1301: static int
1.12 schwarze 1302: pre_in(DECL_ARGS)
1303: {
1304:
1305: if (MDOC_SYNPRETTY & n->flags) {
1.21 schwarze 1306: pre_syn(n);
1.24 schwarze 1307: font_push('B');
1308: print_word("#include <");
1309: outflags &= ~MMAN_spc;
1310: } else {
1311: print_word("<");
1312: outflags &= ~MMAN_spc;
1313: font_push('I');
1314: }
1.12 schwarze 1315: return(1);
1316: }
1317:
1318: static void
1319: post_in(DECL_ARGS)
1320: {
1321:
1322: if (MDOC_SYNPRETTY & n->flags) {
1.24 schwarze 1323: outflags &= ~MMAN_spc;
1324: print_word(">");
1325: font_pop();
1.19 schwarze 1326: outflags |= MMAN_br;
1.24 schwarze 1327: } else {
1328: font_pop();
1329: outflags &= ~MMAN_spc;
1330: print_word(">");
1331: }
1.1 schwarze 1332: }
1333:
1334: static int
1335: pre_it(DECL_ARGS)
1336: {
1337: const struct mdoc_node *bln;
1338:
1.28 schwarze 1339: switch (n->type) {
1.61 schwarze 1340: case MDOC_HEAD:
1.34 schwarze 1341: outflags |= MMAN_PP | MMAN_nl;
1.28 schwarze 1342: bln = n->parent->parent;
1.34 schwarze 1343: if (0 == bln->norm->Bl.comp ||
1.37 schwarze 1344: (NULL == n->parent->prev &&
1345: NULL == bln->parent->prev))
1.34 schwarze 1346: outflags |= MMAN_sp;
1347: outflags &= ~MMAN_br;
1.3 schwarze 1348: switch (bln->norm->Bl.type) {
1.61 schwarze 1349: case LIST_item:
1.28 schwarze 1350: return(0);
1.61 schwarze 1351: case LIST_inset:
1.28 schwarze 1352: /* FALLTHROUGH */
1.61 schwarze 1353: case LIST_diag:
1.28 schwarze 1354: /* FALLTHROUGH */
1.61 schwarze 1355: case LIST_ohang:
1.28 schwarze 1356: if (bln->norm->Bl.type == LIST_diag)
1.34 schwarze 1357: print_line(".B \"", 0);
1.28 schwarze 1358: else
1.34 schwarze 1359: print_line(".R \"", 0);
1.28 schwarze 1360: outflags &= ~MMAN_spc;
1361: return(1);
1.61 schwarze 1362: case LIST_bullet:
1.28 schwarze 1363: /* FALLTHROUGH */
1.61 schwarze 1364: case LIST_dash:
1.28 schwarze 1365: /* FALLTHROUGH */
1.61 schwarze 1366: case LIST_hyphen:
1.33 schwarze 1367: print_width(bln->norm->Bl.width, NULL, 0);
1.35 schwarze 1368: TPremain = 0;
1.28 schwarze 1369: outflags |= MMAN_nl;
1370: font_push('B');
1371: if (LIST_bullet == bln->norm->Bl.type)
1.70 schwarze 1372: print_word("\\(bu");
1.28 schwarze 1373: else
1374: print_word("-");
1375: font_pop();
1.65 schwarze 1376: outflags |= MMAN_nl;
1377: return(0);
1.61 schwarze 1378: case LIST_enum:
1.33 schwarze 1379: print_width(bln->norm->Bl.width, NULL, 0);
1.35 schwarze 1380: TPremain = 0;
1.28 schwarze 1381: outflags |= MMAN_nl;
1382: print_count(&bln->norm->Bl.count);
1.65 schwarze 1383: outflags |= MMAN_nl;
1384: return(0);
1.61 schwarze 1385: case LIST_hang:
1.33 schwarze 1386: print_width(bln->norm->Bl.width, n->child, 6);
1.35 schwarze 1387: TPremain = 0;
1.65 schwarze 1388: outflags |= MMAN_nl;
1389: return(1);
1.61 schwarze 1390: case LIST_tag:
1.35 schwarze 1391: print_width(bln->norm->Bl.width, n->child, 0);
1392: putchar('\n');
1393: outflags &= ~MMAN_spc;
1394: return(1);
1.3 schwarze 1395: default:
1.30 schwarze 1396: return(1);
1.3 schwarze 1397: }
1.28 schwarze 1398: default:
1399: break;
1.1 schwarze 1400: }
1401: return(1);
1.28 schwarze 1402: }
1403:
1.46 schwarze 1404: /*
1405: * This function is called after closing out an indented block.
1406: * If we are inside an enclosing list, restore its indentation.
1407: */
1408: static void
1409: mid_it(void)
1410: {
1411: char buf[24];
1412:
1413: /* Nothing to do outside a list. */
1414: if (0 == Bl_stack_len || 0 == Bl_stack[Bl_stack_len - 1])
1415: return;
1416:
1417: /* The indentation has already been set up. */
1418: if (Bl_stack_post[Bl_stack_len - 1])
1419: return;
1420:
1421: /* Restore the indentation of the enclosing list. */
1422: print_line(".RS", MMAN_Bk_susp);
1.62 schwarze 1423: (void)snprintf(buf, sizeof(buf), "%zun",
1424: Bl_stack[Bl_stack_len - 1]);
1.46 schwarze 1425: print_word(buf);
1426:
1427: /* Remeber to close out this .RS block later. */
1428: Bl_stack_post[Bl_stack_len - 1] = 1;
1429: }
1430:
1.28 schwarze 1431: static void
1432: post_it(DECL_ARGS)
1433: {
1434: const struct mdoc_node *bln;
1435:
1.31 schwarze 1436: bln = n->parent->parent;
1437:
1438: switch (n->type) {
1.61 schwarze 1439: case MDOC_HEAD:
1.28 schwarze 1440: switch (bln->norm->Bl.type) {
1.61 schwarze 1441: case LIST_diag:
1.28 schwarze 1442: outflags &= ~MMAN_spc;
1443: print_word("\\ ");
1444: break;
1.61 schwarze 1445: case LIST_ohang:
1.28 schwarze 1446: outflags |= MMAN_br;
1447: break;
1448: default:
1449: break;
1450: }
1.31 schwarze 1451: break;
1.61 schwarze 1452: case MDOC_BODY:
1.43 schwarze 1453: switch (bln->norm->Bl.type) {
1.61 schwarze 1454: case LIST_bullet:
1.43 schwarze 1455: /* FALLTHROUGH */
1.61 schwarze 1456: case LIST_dash:
1.43 schwarze 1457: /* FALLTHROUGH */
1.61 schwarze 1458: case LIST_hyphen:
1.43 schwarze 1459: /* FALLTHROUGH */
1.61 schwarze 1460: case LIST_enum:
1.43 schwarze 1461: /* FALLTHROUGH */
1.61 schwarze 1462: case LIST_hang:
1.43 schwarze 1463: /* FALLTHROUGH */
1.61 schwarze 1464: case LIST_tag:
1.43 schwarze 1465: assert(Bl_stack_len);
1466: Bl_stack[--Bl_stack_len] = 0;
1467:
1468: /*
1469: * Our indentation had to be restored
1.46 schwarze 1470: * after a child display or child list.
1.43 schwarze 1471: * Close out that indentation block now.
1472: */
1473: if (Bl_stack_post[Bl_stack_len]) {
1474: print_line(".RE", MMAN_nl);
1475: Bl_stack_post[Bl_stack_len] = 0;
1476: }
1477: break;
1.61 schwarze 1478: case LIST_column:
1.43 schwarze 1479: if (NULL != n->next) {
1480: putchar('\t');
1481: outflags &= ~MMAN_spc;
1482: }
1483: break;
1484: default:
1485: break;
1.31 schwarze 1486: }
1487: break;
1488: default:
1489: break;
1.28 schwarze 1490: }
1.11 schwarze 1491: }
1492:
1493: static void
1494: post_lb(DECL_ARGS)
1495: {
1496:
1.19 schwarze 1497: if (SEC_LIBRARY == n->sec)
1498: outflags |= MMAN_br;
1.22 schwarze 1499: }
1500:
1501: static int
1502: pre_lk(DECL_ARGS)
1503: {
1504: const struct mdoc_node *link, *descr;
1505:
1506: if (NULL == (link = n->child))
1507: return(0);
1508:
1509: if (NULL != (descr = link->next)) {
1.24 schwarze 1510: font_push('I');
1.22 schwarze 1511: while (NULL != descr) {
1512: print_word(descr->string);
1513: descr = descr->next;
1514: }
1515: print_word(":");
1.24 schwarze 1516: font_pop();
1.22 schwarze 1517: }
1518:
1.24 schwarze 1519: font_push('B');
1.22 schwarze 1520: print_word(link->string);
1.24 schwarze 1521: font_pop();
1.22 schwarze 1522: return(0);
1.60 schwarze 1523: }
1524:
1525: static int
1526: pre_ll(DECL_ARGS)
1527: {
1528:
1529: print_line(".ll", 0);
1530: return(1);
1.1 schwarze 1531: }
1532:
1533: static int
1.24 schwarze 1534: pre_li(DECL_ARGS)
1535: {
1536:
1537: font_push('R');
1538: return(1);
1539: }
1540:
1541: static int
1.1 schwarze 1542: pre_nm(DECL_ARGS)
1543: {
1.36 schwarze 1544: char *name;
1.1 schwarze 1545:
1.53 schwarze 1546: if (MDOC_BLOCK == n->type) {
1547: outflags |= MMAN_Bk;
1.21 schwarze 1548: pre_syn(n);
1.53 schwarze 1549: }
1.1 schwarze 1550: if (MDOC_ELEM != n->type && MDOC_HEAD != n->type)
1551: return(1);
1.42 schwarze 1552: name = n->child ? n->child->string : meta->name;
1.36 schwarze 1553: if (NULL == name)
1.21 schwarze 1554: return(0);
1.36 schwarze 1555: if (MDOC_HEAD == n->type) {
1556: if (NULL == n->parent->prev)
1557: outflags |= MMAN_sp;
1558: print_block(".HP", 0);
1.52 schwarze 1559: printf(" %zun", strlen(name) + 1);
1.36 schwarze 1560: outflags |= MMAN_nl;
1561: }
1.24 schwarze 1562: font_push('B');
1.1 schwarze 1563: if (NULL == n->child)
1.42 schwarze 1564: print_word(meta->name);
1.1 schwarze 1565: return(1);
1566: }
1567:
1568: static void
1569: post_nm(DECL_ARGS)
1570: {
1571:
1.53 schwarze 1572: switch (n->type) {
1.61 schwarze 1573: case MDOC_BLOCK:
1.53 schwarze 1574: outflags &= ~MMAN_Bk;
1575: break;
1.61 schwarze 1576: case MDOC_HEAD:
1.53 schwarze 1577: /* FALLTHROUGH */
1.61 schwarze 1578: case MDOC_ELEM:
1.66 schwarze 1579: if (n->child != NULL || meta->name != NULL)
1580: font_pop();
1.53 schwarze 1581: break;
1582: default:
1583: break;
1584: }
1.23 schwarze 1585: }
1586:
1587: static int
1588: pre_no(DECL_ARGS)
1589: {
1590:
1591: outflags |= MMAN_spc_force;
1592: return(1);
1.1 schwarze 1593: }
1594:
1595: static int
1596: pre_ns(DECL_ARGS)
1597: {
1598:
1.18 schwarze 1599: outflags &= ~MMAN_spc;
1.1 schwarze 1600: return(0);
1601: }
1602:
1.3 schwarze 1603: static void
1604: post_pf(DECL_ARGS)
1605: {
1606:
1.75 schwarze 1607: if ( ! (n->next == NULL || n->next->flags & MDOC_LINE))
1608: outflags &= ~MMAN_spc;
1.3 schwarze 1609: }
1610:
1.1 schwarze 1611: static int
1612: pre_pp(DECL_ARGS)
1613: {
1614:
1.34 schwarze 1615: if (MDOC_It != n->parent->tok)
1616: outflags |= MMAN_PP;
1617: outflags |= MMAN_sp | MMAN_nl;
1618: outflags &= ~MMAN_br;
1.32 schwarze 1619: return(0);
1620: }
1621:
1622: static int
1623: pre_rs(DECL_ARGS)
1624: {
1625:
1626: if (SEC_SEE_ALSO == n->sec) {
1.34 schwarze 1627: outflags |= MMAN_PP | MMAN_sp | MMAN_nl;
1628: outflags &= ~MMAN_br;
1.32 schwarze 1629: }
1630: return(1);
1.66 schwarze 1631: }
1632:
1633: static int
1634: pre_rv(DECL_ARGS)
1635: {
1636: int nchild;
1637:
1638: outflags |= MMAN_br | MMAN_nl;
1639:
1640: nchild = n->nchild;
1641: if (nchild > 0) {
1642: print_word("The");
1643:
1644: for (n = n->child; n; n = n->next) {
1645: font_push('B');
1646: print_word(n->string);
1647: font_pop();
1648:
1649: outflags &= ~MMAN_spc;
1650: print_word("()");
1651:
1652: if (n->next == NULL)
1653: continue;
1654:
1655: if (nchild > 2) {
1656: outflags &= ~MMAN_spc;
1657: print_word(",");
1658: }
1659: if (n->next->next == NULL)
1660: print_word("and");
1661: }
1662:
1663: if (nchild > 1)
1664: print_word("functions return");
1665: else
1666: print_word("function returns");
1667:
1668: print_word("the value\\~0 if successful;");
1669: } else
1670: print_word("Upon successful completion, "
1671: "the value\\~0 is returned;");
1672:
1673: print_word("otherwise the value\\~\\-1 is returned"
1674: " and the global variable");
1675:
1676: font_push('I');
1677: print_word("errno");
1678: font_pop();
1679:
1680: print_word("is set to indicate the error.");
1681: outflags |= MMAN_nl;
1.73 schwarze 1682: return(0);
1683: }
1684:
1685: static int
1686: pre_skip(DECL_ARGS)
1687: {
1688:
1.66 schwarze 1689: return(0);
1.9 schwarze 1690: }
1691:
1692: static int
1693: pre_sm(DECL_ARGS)
1694: {
1695:
1.64 schwarze 1696: if (NULL == n->child)
1697: outflags ^= MMAN_Sm;
1698: else if (0 == strcmp("on", n->child->string))
1699: outflags |= MMAN_Sm;
1.9 schwarze 1700: else
1.18 schwarze 1701: outflags &= ~MMAN_Sm;
1.64 schwarze 1702:
1703: if (MMAN_Sm & outflags)
1704: outflags |= MMAN_spc;
1705:
1.9 schwarze 1706: return(0);
1.1 schwarze 1707: }
1708:
1709: static int
1.3 schwarze 1710: pre_sp(DECL_ARGS)
1.1 schwarze 1711: {
1712:
1.38 schwarze 1713: if (MMAN_PP & outflags) {
1714: outflags &= ~MMAN_PP;
1715: print_line(".PP", 0);
1716: } else
1717: print_line(".sp", 0);
1.1 schwarze 1718: return(1);
1719: }
1720:
1721: static void
1.3 schwarze 1722: post_sp(DECL_ARGS)
1.1 schwarze 1723: {
1724:
1.18 schwarze 1725: outflags |= MMAN_nl;
1.15 schwarze 1726: }
1727:
1728: static int
1.24 schwarze 1729: pre_sy(DECL_ARGS)
1730: {
1731:
1732: font_push('B');
1733: return(1);
1734: }
1735:
1736: static int
1.15 schwarze 1737: pre_vt(DECL_ARGS)
1738: {
1739:
1740: if (MDOC_SYNPRETTY & n->flags) {
1.16 schwarze 1741: switch (n->type) {
1.61 schwarze 1742: case MDOC_BLOCK:
1.21 schwarze 1743: pre_syn(n);
1.16 schwarze 1744: return(1);
1.61 schwarze 1745: case MDOC_BODY:
1.16 schwarze 1746: break;
1747: default:
1748: return(0);
1749: }
1.15 schwarze 1750: }
1.24 schwarze 1751: font_push('I');
1.15 schwarze 1752: return(1);
1753: }
1754:
1755: static void
1756: post_vt(DECL_ARGS)
1757: {
1.16 schwarze 1758:
1.17 schwarze 1759: if (MDOC_SYNPRETTY & n->flags && MDOC_BODY != n->type)
1.16 schwarze 1760: return;
1.24 schwarze 1761: font_pop();
1.1 schwarze 1762: }
1763:
1764: static int
1765: pre_xr(DECL_ARGS)
1766: {
1767:
1768: n = n->child;
1769: if (NULL == n)
1770: return(0);
1.42 schwarze 1771: print_node(meta, n);
1.1 schwarze 1772: n = n->next;
1773: if (NULL == n)
1774: return(0);
1.18 schwarze 1775: outflags &= ~MMAN_spc;
1776: print_word("(");
1.42 schwarze 1777: print_node(meta, n);
1.18 schwarze 1778: print_word(")");
1.1 schwarze 1779: return(0);
1.5 schwarze 1780: }
1781:
1782: static int
1783: pre_ux(DECL_ARGS)
1784: {
1785:
1.18 schwarze 1786: print_word(manacts[n->tok].prefix);
1.5 schwarze 1787: if (NULL == n->child)
1788: return(0);
1.18 schwarze 1789: outflags &= ~MMAN_spc;
1.39 millert 1790: print_word("\\ ");
1.18 schwarze 1791: outflags &= ~MMAN_spc;
1.5 schwarze 1792: return(1);
1.1 schwarze 1793: }
![[BACK]](/icons/back.gif){kind=icon}
Return to mdoc_man.c CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [local] / src / usr.bin / mandoc