Annotation of mandoc/mdoc_action.c, Revision 1.74
1.74 ! kristaps 1: /* $Id: mdoc_action.c,v 1.73 2010/07/01 22:35:54 schwarze Exp $ */
1.1 kristaps 2: /*
1.71 kristaps 3: * Copyright (c) 2008, 2009 Kristaps Dzonsons <kristaps@bsd.lv>
1.1 kristaps 4: *
5: * Permission to use, copy, modify, and distribute this software for any
1.8 kristaps 6: * purpose with or without fee is hereby granted, provided that the above
7: * copyright notice and this permission notice appear in all copies.
1.1 kristaps 8: *
1.8 kristaps 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.
1.1 kristaps 16: */
1.50 kristaps 17: #ifdef HAVE_CONFIG_H
18: #include "config.h"
19: #endif
20:
1.44 kristaps 21: #ifndef OSNAME
1.1 kristaps 22: #include <sys/utsname.h>
1.44 kristaps 23: #endif
1.1 kristaps 24:
25: #include <assert.h>
26: #include <stdio.h>
27: #include <stdlib.h>
28: #include <string.h>
1.44 kristaps 29: #include <time.h>
1.1 kristaps 30:
1.59 kristaps 31: #include "mandoc.h"
1.1 kristaps 32: #include "libmdoc.h"
1.46 kristaps 33: #include "libmandoc.h"
1.72 kristaps 34:
35: /*
36: * FIXME: this file is deprecated. All future "actions" should be
37: * pushed into mdoc_validate.c.
38: */
1.1 kristaps 39:
1.35 kristaps 40: #define POST_ARGS struct mdoc *m, struct mdoc_node *n
1.60 kristaps 41: #define PRE_ARGS struct mdoc *m, struct mdoc_node *n
1.1 kristaps 42:
1.46 kristaps 43: #define NUMSIZ 32
44: #define DATESIZ 32
45:
1.1 kristaps 46: struct actions {
47: int (*pre)(PRE_ARGS);
48: int (*post)(POST_ARGS);
49: };
50:
1.46 kristaps 51: static int concat(struct mdoc *, char *,
52: const struct mdoc_node *, size_t);
1.54 kristaps 53: static inline int order_rs(enum mdoct);
1.39 kristaps 54:
1.1 kristaps 55: static int post_ar(POST_ARGS);
1.25 kristaps 56: static int post_at(POST_ARGS);
1.1 kristaps 57: static int post_bl(POST_ARGS);
1.14 kristaps 58: static int post_bl_head(POST_ARGS);
1.25 kristaps 59: static int post_bl_tagwidth(POST_ARGS);
1.70 kristaps 60: static int post_bl_width(POST_ARGS);
1.1 kristaps 61: static int post_dd(POST_ARGS);
62: static int post_display(POST_ARGS);
63: static int post_dt(POST_ARGS);
1.27 kristaps 64: static int post_lb(POST_ARGS);
1.62 kristaps 65: static int post_li(POST_ARGS);
1.1 kristaps 66: static int post_nm(POST_ARGS);
67: static int post_os(POST_ARGS);
1.46 kristaps 68: static int post_pa(POST_ARGS);
1.1 kristaps 69: static int post_prol(POST_ARGS);
1.39 kristaps 70: static int post_rs(POST_ARGS);
1.1 kristaps 71: static int post_sh(POST_ARGS);
1.26 kristaps 72: static int post_st(POST_ARGS);
1.1 kristaps 73: static int post_std(POST_ARGS);
74:
75: static int pre_bd(PRE_ARGS);
76: static int pre_dl(PRE_ARGS);
77:
1.37 kristaps 78: static const struct actions mdoc_actions[MDOC_MAX] = {
1.12 kristaps 79: { NULL, NULL }, /* Ap */
1.1 kristaps 80: { NULL, post_dd }, /* Dd */
81: { NULL, post_dt }, /* Dt */
82: { NULL, post_os }, /* Os */
83: { NULL, post_sh }, /* Sh */
84: { NULL, NULL }, /* Ss */
85: { NULL, NULL }, /* Pp */
86: { NULL, NULL }, /* D1 */
87: { pre_dl, post_display }, /* Dl */
88: { pre_bd, post_display }, /* Bd */
89: { NULL, NULL }, /* Ed */
1.68 kristaps 90: { NULL, post_bl }, /* Bl */
1.1 kristaps 91: { NULL, NULL }, /* El */
92: { NULL, NULL }, /* It */
93: { NULL, NULL }, /* Ad */
94: { NULL, NULL }, /* An */
95: { NULL, post_ar }, /* Ar */
1.35 kristaps 96: { NULL, NULL }, /* Cd */
1.1 kristaps 97: { NULL, NULL }, /* Cm */
98: { NULL, NULL }, /* Dv */
99: { NULL, NULL }, /* Er */
100: { NULL, NULL }, /* Ev */
101: { NULL, post_std }, /* Ex */
102: { NULL, NULL }, /* Fa */
103: { NULL, NULL }, /* Fd */
104: { NULL, NULL }, /* Fl */
105: { NULL, NULL }, /* Fn */
106: { NULL, NULL }, /* Ft */
107: { NULL, NULL }, /* Ic */
108: { NULL, NULL }, /* In */
1.62 kristaps 109: { NULL, post_li }, /* Li */
1.1 kristaps 110: { NULL, NULL }, /* Nd */
111: { NULL, post_nm }, /* Nm */
112: { NULL, NULL }, /* Op */
113: { NULL, NULL }, /* Ot */
1.46 kristaps 114: { NULL, post_pa }, /* Pa */
1.1 kristaps 115: { NULL, post_std }, /* Rv */
1.26 kristaps 116: { NULL, post_st }, /* St */
1.1 kristaps 117: { NULL, NULL }, /* Va */
118: { NULL, NULL }, /* Vt */
119: { NULL, NULL }, /* Xr */
120: { NULL, NULL }, /* %A */
121: { NULL, NULL }, /* %B */
122: { NULL, NULL }, /* %D */
123: { NULL, NULL }, /* %I */
124: { NULL, NULL }, /* %J */
125: { NULL, NULL }, /* %N */
126: { NULL, NULL }, /* %O */
127: { NULL, NULL }, /* %P */
128: { NULL, NULL }, /* %R */
129: { NULL, NULL }, /* %T */
130: { NULL, NULL }, /* %V */
131: { NULL, NULL }, /* Ac */
132: { NULL, NULL }, /* Ao */
133: { NULL, NULL }, /* Aq */
1.25 kristaps 134: { NULL, post_at }, /* At */
1.1 kristaps 135: { NULL, NULL }, /* Bc */
136: { NULL, NULL }, /* Bf */
137: { NULL, NULL }, /* Bo */
138: { NULL, NULL }, /* Bq */
139: { NULL, NULL }, /* Bsx */
140: { NULL, NULL }, /* Bx */
141: { NULL, NULL }, /* Db */
142: { NULL, NULL }, /* Dc */
143: { NULL, NULL }, /* Do */
144: { NULL, NULL }, /* Dq */
145: { NULL, NULL }, /* Ec */
146: { NULL, NULL }, /* Ef */
147: { NULL, NULL }, /* Em */
148: { NULL, NULL }, /* Eo */
149: { NULL, NULL }, /* Fx */
150: { NULL, NULL }, /* Ms */
151: { NULL, NULL }, /* No */
152: { NULL, NULL }, /* Ns */
153: { NULL, NULL }, /* Nx */
154: { NULL, NULL }, /* Ox */
155: { NULL, NULL }, /* Pc */
156: { NULL, NULL }, /* Pf */
157: { NULL, NULL }, /* Po */
158: { NULL, NULL }, /* Pq */
159: { NULL, NULL }, /* Qc */
160: { NULL, NULL }, /* Ql */
161: { NULL, NULL }, /* Qo */
162: { NULL, NULL }, /* Qq */
163: { NULL, NULL }, /* Re */
1.39 kristaps 164: { NULL, post_rs }, /* Rs */
1.1 kristaps 165: { NULL, NULL }, /* Sc */
166: { NULL, NULL }, /* So */
167: { NULL, NULL }, /* Sq */
168: { NULL, NULL }, /* Sm */
169: { NULL, NULL }, /* Sx */
170: { NULL, NULL }, /* Sy */
171: { NULL, NULL }, /* Tn */
172: { NULL, NULL }, /* Ux */
173: { NULL, NULL }, /* Xc */
174: { NULL, NULL }, /* Xo */
175: { NULL, NULL }, /* Fo */
176: { NULL, NULL }, /* Fc */
177: { NULL, NULL }, /* Oo */
178: { NULL, NULL }, /* Oc */
179: { NULL, NULL }, /* Bk */
180: { NULL, NULL }, /* Ek */
181: { NULL, NULL }, /* Bt */
182: { NULL, NULL }, /* Hf */
183: { NULL, NULL }, /* Fr */
184: { NULL, NULL }, /* Ud */
1.27 kristaps 185: { NULL, post_lb }, /* Lb */
1.1 kristaps 186: { NULL, NULL }, /* Lp */
1.44 kristaps 187: { NULL, NULL }, /* Lk */
1.1 kristaps 188: { NULL, NULL }, /* Mt */
189: { NULL, NULL }, /* Brq */
190: { NULL, NULL }, /* Bro */
191: { NULL, NULL }, /* Brc */
192: { NULL, NULL }, /* %C */
193: { NULL, NULL }, /* Es */
194: { NULL, NULL }, /* En */
195: { NULL, NULL }, /* Dx */
196: { NULL, NULL }, /* %Q */
1.30 kristaps 197: { NULL, NULL }, /* br */
198: { NULL, NULL }, /* sp */
1.43 kristaps 199: { NULL, NULL }, /* %U */
1.64 kristaps 200: { NULL, NULL }, /* Ta */
1.1 kristaps 201: };
202:
1.45 kristaps 203: #define RSORD_MAX 14
1.1 kristaps 204:
1.54 kristaps 205: static const enum mdoct rsord[RSORD_MAX] = {
1.39 kristaps 206: MDOC__A,
207: MDOC__T,
208: MDOC__B,
209: MDOC__I,
210: MDOC__J,
211: MDOC__R,
212: MDOC__N,
213: MDOC__V,
214: MDOC__P,
215: MDOC__Q,
216: MDOC__D,
217: MDOC__O,
1.45 kristaps 218: MDOC__C,
219: MDOC__U
1.39 kristaps 220: };
1.2 kristaps 221:
222:
1.1 kristaps 223: int
1.60 kristaps 224: mdoc_action_pre(struct mdoc *m, struct mdoc_node *n)
1.1 kristaps 225: {
226:
227: switch (n->type) {
228: case (MDOC_ROOT):
1.2 kristaps 229: /* FALLTHROUGH */
1.1 kristaps 230: case (MDOC_TEXT):
1.2 kristaps 231: return(1);
232: default:
1.1 kristaps 233: break;
234: }
1.2 kristaps 235:
1.6 kristaps 236: if (NULL == mdoc_actions[n->tok].pre)
1.2 kristaps 237: return(1);
1.6 kristaps 238: return((*mdoc_actions[n->tok].pre)(m, n));
1.1 kristaps 239: }
240:
241:
242: int
243: mdoc_action_post(struct mdoc *m)
244: {
245:
246: if (MDOC_ACTED & m->last->flags)
247: return(1);
248: m->last->flags |= MDOC_ACTED;
249:
250: switch (m->last->type) {
251: case (MDOC_TEXT):
1.2 kristaps 252: /* FALLTHROUGH */
1.1 kristaps 253: case (MDOC_ROOT):
1.2 kristaps 254: return(1);
255: default:
1.1 kristaps 256: break;
257: }
1.2 kristaps 258:
259: if (NULL == mdoc_actions[m->last->tok].post)
260: return(1);
1.35 kristaps 261: return((*mdoc_actions[m->last->tok].post)(m, m->last));
1.2 kristaps 262: }
263:
264:
1.46 kristaps 265: /*
266: * Concatenate sibling nodes together. All siblings must be of type
267: * MDOC_TEXT or an assertion is raised. Concatenation is separated by a
268: * single whitespace.
269: */
1.2 kristaps 270: static int
1.46 kristaps 271: concat(struct mdoc *m, char *p, const struct mdoc_node *n, size_t sz)
1.2 kristaps 272: {
273:
1.46 kristaps 274: assert(sz);
275: p[0] = '\0';
1.2 kristaps 276: for ( ; n; n = n->next) {
277: assert(MDOC_TEXT == n->type);
1.59 kristaps 278: /*
279: * XXX: yes, these can technically be resized, but it's
280: * highly unlikely that we're going to get here, so let
281: * it slip for now.
282: */
283: if (strlcat(p, n->string, sz) >= sz) {
284: mdoc_nmsg(m, n, MANDOCERR_MEM);
285: return(0);
286: }
1.2 kristaps 287: if (NULL == n->next)
288: continue;
1.59 kristaps 289: if (strlcat(p, " ", sz) >= sz) {
290: mdoc_nmsg(m, n, MANDOCERR_MEM);
291: return(0);
292: }
1.2 kristaps 293: }
294:
1.1 kristaps 295: return(1);
296: }
297:
298:
1.46 kristaps 299: /*
300: * Macros accepting `-std' as an argument have the name of the current
301: * document (`Nm') filled in as the argument if it's not provided.
302: */
1.1 kristaps 303: static int
304: post_std(POST_ARGS)
305: {
1.59 kristaps 306: struct mdoc_node *nn;
1.1 kristaps 307:
1.35 kristaps 308: if (n->child)
1.1 kristaps 309: return(1);
1.59 kristaps 310: if (NULL == m->meta.name)
311: return(1);
1.35 kristaps 312:
313: nn = n;
314: m->next = MDOC_NEXT_CHILD;
1.59 kristaps 315:
1.35 kristaps 316: if ( ! mdoc_word_alloc(m, n->line, n->pos, m->meta.name))
317: return(0);
318: m->last = nn;
1.1 kristaps 319: return(1);
320: }
321:
322:
1.46 kristaps 323: /*
324: * The `Nm' macro's first use sets the name of the document. See also
325: * post_std(), etc.
326: */
1.1 kristaps 327: static int
328: post_nm(POST_ARGS)
329: {
1.46 kristaps 330: char buf[BUFSIZ];
1.1 kristaps 331:
332: if (m->meta.name)
333: return(1);
1.46 kristaps 334: if ( ! concat(m, buf, n->child, BUFSIZ))
1.2 kristaps 335: return(0);
1.46 kristaps 336: m->meta.name = mandoc_strdup(buf);
1.1 kristaps 337: return(1);
338: }
339:
340:
1.46 kristaps 341: /*
342: * Look up the value of `Lb' for matching predefined strings. If it has
343: * one, then substitute the current value for the formatted value. Note
344: * that the lookup may fail (we can provide arbitrary strings).
345: */
346: /* ARGSUSED */
1.1 kristaps 347: static int
1.27 kristaps 348: post_lb(POST_ARGS)
349: {
350: const char *p;
351: char *buf;
352: size_t sz;
353:
1.35 kristaps 354: assert(MDOC_TEXT == n->child->type);
355: p = mdoc_a2lib(n->child->string);
1.46 kristaps 356:
357: if (p) {
1.35 kristaps 358: free(n->child->string);
1.46 kristaps 359: n->child->string = mandoc_strdup(p);
1.27 kristaps 360: return(1);
361: }
362:
1.46 kristaps 363: sz = strlen(n->child->string) +
364: 2 + strlen("\\(lqlibrary\\(rq");
365: buf = mandoc_malloc(sz);
366: snprintf(buf, sz, "library \\(lq%s\\(rq", n->child->string);
1.35 kristaps 367: free(n->child->string);
1.46 kristaps 368: n->child->string = buf;
1.27 kristaps 369: return(1);
370: }
371:
372:
1.46 kristaps 373: /*
374: * Substitute the value of `St' for the corresponding formatted string.
375: * We're guaranteed that this exists (it's been verified during the
376: * validation phase).
377: */
378: /* ARGSUSED */
1.27 kristaps 379: static int
1.26 kristaps 380: post_st(POST_ARGS)
381: {
382: const char *p;
383:
1.35 kristaps 384: assert(MDOC_TEXT == n->child->type);
385: p = mdoc_a2st(n->child->string);
1.56 kristaps 386: if (p != NULL) {
387: free(n->child->string);
388: n->child->string = mandoc_strdup(p);
389: }
1.26 kristaps 390: return(1);
391: }
392:
393:
1.46 kristaps 394: /*
395: * Look up the standard string in a table. We know that it exists from
396: * the validation phase, so assert on failure. If a standard key wasn't
397: * supplied, supply the default ``AT&T UNIX''.
398: */
1.26 kristaps 399: static int
1.25 kristaps 400: post_at(POST_ARGS)
401: {
1.57 kristaps 402: struct mdoc_node *nn;
403: const char *p, *q;
404: char *buf;
405: size_t sz;
1.25 kristaps 406:
1.35 kristaps 407: if (n->child) {
408: assert(MDOC_TEXT == n->child->type);
409: p = mdoc_a2att(n->child->string);
1.57 kristaps 410: if (p) {
411: free(n->child->string);
412: n->child->string = mandoc_strdup(p);
413: } else {
414: p = "AT&T UNIX ";
415: q = n->child->string;
416: sz = strlen(p) + strlen(q) + 1;
417: buf = mandoc_malloc(sz);
418: strlcpy(buf, p, sz);
419: strlcat(buf, q, sz);
420: free(n->child->string);
421: n->child->string = buf;
422: }
1.25 kristaps 423: return(1);
424: }
425:
1.35 kristaps 426: nn = n;
1.25 kristaps 427: m->next = MDOC_NEXT_CHILD;
1.35 kristaps 428: if ( ! mdoc_word_alloc(m, nn->line, nn->pos, "AT&T UNIX"))
1.25 kristaps 429: return(0);
1.35 kristaps 430: m->last = nn;
1.25 kristaps 431: return(1);
432: }
433:
434:
1.46 kristaps 435: /*
436: * Mark the current section. The ``named'' section (lastnamed) is set
437: * whenever the current section isn't a custom section--we use this to
438: * keep track of section ordering. Also check that the section is
439: * allowed within the document's manual section.
440: */
1.25 kristaps 441: static int
1.1 kristaps 442: post_sh(POST_ARGS)
443: {
444: enum mdoc_sec sec;
1.46 kristaps 445: char buf[BUFSIZ];
1.1 kristaps 446:
1.35 kristaps 447: if (MDOC_HEAD != n->type)
1.1 kristaps 448: return(1);
1.5 kristaps 449:
1.46 kristaps 450: if ( ! concat(m, buf, n->child, BUFSIZ))
1.2 kristaps 451: return(0);
1.55 kristaps 452: sec = mdoc_str2sec(buf);
1.52 kristaps 453: /*
454: * The first section should always make us move into a non-new
455: * state.
456: */
457: if (SEC_NONE == m->lastnamed || SEC_CUSTOM != sec)
1.1 kristaps 458: m->lastnamed = sec;
1.73 schwarze 459:
460: /*
461: * Switch the parser's SYNOPSIS mode, to be copied
462: * into individual nodes when creating them.
463: * Note that this mode can also be set and unset
464: * using the roff nS register.
465: */
466: if (SEC_SYNOPSIS == sec)
467: m->flags |= MDOC_SYNOPSIS;
468: else
469: m->flags &= ~MDOC_SYNOPSIS;
1.1 kristaps 470:
1.46 kristaps 471: /* Some sections only live in certain manual sections. */
472:
1.1 kristaps 473: switch ((m->lastsec = sec)) {
474: case (SEC_RETURN_VALUES):
475: /* FALLTHROUGH */
476: case (SEC_ERRORS):
1.58 kristaps 477: assert(m->meta.msec);
478: if (*m->meta.msec == '2')
1.1 kristaps 479: break;
1.58 kristaps 480: if (*m->meta.msec == '3')
481: break;
482: if (*m->meta.msec == '9')
483: break;
1.59 kristaps 484: return(mdoc_nmsg(m, n, MANDOCERR_SECMSEC));
1.1 kristaps 485: default:
486: break;
487: }
488: return(1);
489: }
490:
491:
1.46 kristaps 492: /*
493: * Parse out the contents of `Dt'. See in-line documentation for how we
494: * handle the various fields of this macro.
495: */
1.1 kristaps 496: static int
497: post_dt(POST_ARGS)
498: {
1.35 kristaps 499: struct mdoc_node *nn;
1.1 kristaps 500: const char *cp;
501:
502: if (m->meta.title)
503: free(m->meta.title);
504: if (m->meta.vol)
505: free(m->meta.vol);
506: if (m->meta.arch)
507: free(m->meta.arch);
508:
509: m->meta.title = m->meta.vol = m->meta.arch = NULL;
510: /* Handles: `.Dt'
511: * --> title = unknown, volume = local, msec = 0, arch = NULL
512: */
513:
1.35 kristaps 514: if (NULL == (nn = n->child)) {
1.46 kristaps 515: /* XXX: make these macro values. */
1.58 kristaps 516: /* FIXME: warn about missing values. */
1.63 kristaps 517: m->meta.title = mandoc_strdup("UNKNOWN");
518: m->meta.vol = mandoc_strdup("LOCAL");
1.58 kristaps 519: m->meta.msec = mandoc_strdup("1");
1.35 kristaps 520: return(post_prol(m, n));
1.1 kristaps 521: }
522:
523: /* Handles: `.Dt TITLE'
524: * --> title = TITLE, volume = local, msec = 0, arch = NULL
525: */
526:
1.63 kristaps 527: m->meta.title = mandoc_strdup
528: ('\0' == nn->string[0] ? "UNKNOWN" : nn->string);
1.1 kristaps 529:
1.35 kristaps 530: if (NULL == (nn = nn->next)) {
1.58 kristaps 531: /* FIXME: warn about missing msec. */
1.46 kristaps 532: /* XXX: make this a macro value. */
1.63 kristaps 533: m->meta.vol = mandoc_strdup("LOCAL");
1.58 kristaps 534: m->meta.msec = mandoc_strdup("1");
1.35 kristaps 535: return(post_prol(m, n));
1.1 kristaps 536: }
537:
538: /* Handles: `.Dt TITLE SEC'
539: * --> title = TITLE, volume = SEC is msec ?
540: * format(msec) : SEC,
541: * msec = SEC is msec ? atoi(msec) : 0,
542: * arch = NULL
543: */
544:
1.35 kristaps 545: cp = mdoc_a2msec(nn->string);
1.1 kristaps 546: if (cp) {
1.46 kristaps 547: m->meta.vol = mandoc_strdup(cp);
1.58 kristaps 548: m->meta.msec = mandoc_strdup(nn->string);
1.59 kristaps 549: } else if (mdoc_nmsg(m, n, MANDOCERR_BADMSEC)) {
1.46 kristaps 550: m->meta.vol = mandoc_strdup(nn->string);
1.58 kristaps 551: m->meta.msec = mandoc_strdup(nn->string);
552: } else
553: return(0);
1.1 kristaps 554:
1.35 kristaps 555: if (NULL == (nn = nn->next))
556: return(post_prol(m, n));
1.1 kristaps 557:
558: /* Handles: `.Dt TITLE SEC VOL'
559: * --> title = TITLE, volume = VOL is vol ?
560: * format(VOL) :
561: * VOL is arch ? format(arch) :
562: * VOL
563: */
564:
1.35 kristaps 565: cp = mdoc_a2vol(nn->string);
1.1 kristaps 566: if (cp) {
567: free(m->meta.vol);
1.46 kristaps 568: m->meta.vol = mandoc_strdup(cp);
1.1 kristaps 569: } else {
1.58 kristaps 570: /* FIXME: warn about bad arch. */
1.35 kristaps 571: cp = mdoc_a2arch(nn->string);
1.1 kristaps 572: if (NULL == cp) {
573: free(m->meta.vol);
1.46 kristaps 574: m->meta.vol = mandoc_strdup(nn->string);
575: } else
576: m->meta.arch = mandoc_strdup(cp);
1.1 kristaps 577: }
578:
579: /* Ignore any subsequent parameters... */
1.46 kristaps 580: /* FIXME: warn about subsequent parameters. */
1.1 kristaps 581:
1.35 kristaps 582: return(post_prol(m, n));
1.1 kristaps 583: }
584:
585:
1.46 kristaps 586: /*
587: * Set the operating system by way of the `Os' macro. Note that if an
588: * argument isn't provided and -DOSNAME="\"foo\"" is provided during
589: * compilation, this value will be used instead of filling in "sysname
590: * release" from uname().
591: */
1.1 kristaps 592: static int
593: post_os(POST_ARGS)
594: {
1.46 kristaps 595: char buf[BUFSIZ];
596: #ifndef OSNAME
1.1 kristaps 597: struct utsname utsname;
1.42 kristaps 598: #endif
599:
1.1 kristaps 600: if (m->meta.os)
601: free(m->meta.os);
1.4 kristaps 602:
1.46 kristaps 603: if ( ! concat(m, buf, n->child, BUFSIZ))
1.2 kristaps 604: return(0);
1.1 kristaps 605:
1.59 kristaps 606: /* XXX: yes, these can all be dynamically-adjusted buffers, but
607: * it's really not worth the extra hackery.
608: */
609:
1.46 kristaps 610: if ('\0' == buf[0]) {
611: #ifdef OSNAME
1.59 kristaps 612: if (strlcat(buf, OSNAME, BUFSIZ) >= BUFSIZ) {
613: mdoc_nmsg(m, n, MANDOCERR_MEM);
614: return(0);
615: }
1.46 kristaps 616: #else /*!OSNAME */
1.1 kristaps 617: if (-1 == uname(&utsname))
1.59 kristaps 618: return(mdoc_nmsg(m, n, MANDOCERR_UTSNAME));
619:
620: if (strlcat(buf, utsname.sysname, BUFSIZ) >= BUFSIZ) {
621: mdoc_nmsg(m, n, MANDOCERR_MEM);
622: return(0);
623: }
624: if (strlcat(buf, " ", 64) >= BUFSIZ) {
625: mdoc_nmsg(m, n, MANDOCERR_MEM);
626: return(0);
627: }
628: if (strlcat(buf, utsname.release, BUFSIZ) >= BUFSIZ) {
629: mdoc_nmsg(m, n, MANDOCERR_MEM);
630: return(0);
631: }
1.46 kristaps 632: #endif /*!OSNAME*/
1.1 kristaps 633: }
634:
1.46 kristaps 635: m->meta.os = mandoc_strdup(buf);
1.35 kristaps 636: return(post_prol(m, n));
1.1 kristaps 637: }
638:
639:
640: /*
641: * Calculate the -width for a `Bl -tag' list if it hasn't been provided.
1.46 kristaps 642: * Uses the first head macro. NOTE AGAIN: this is ONLY if the -width
643: * argument has NOT been provided. See post_bl_width() for converting
644: * the -width string.
1.1 kristaps 645: */
646: static int
1.35 kristaps 647: post_bl_tagwidth(POST_ARGS)
1.1 kristaps 648: {
1.46 kristaps 649: struct mdoc_node *nn;
1.69 kristaps 650: size_t sz, ssz;
1.46 kristaps 651: int i;
652: char buf[NUMSIZ];
1.1 kristaps 653:
1.69 kristaps 654: sz = 10;
1.61 joerg 655:
656: for (nn = n->body->child; nn; nn = nn->next) {
1.69 kristaps 657: if (MDOC_It != nn->tok)
658: continue;
1.46 kristaps 659:
1.35 kristaps 660: assert(MDOC_BLOCK == nn->type);
661: nn = nn->head->child;
1.69 kristaps 662:
663: if (MDOC_TEXT == nn->type) {
1.46 kristaps 664: sz = strlen(nn->string) + 1;
1.69 kristaps 665: break;
666: }
667:
668: if (0 != (ssz = mdoc_macro2len(nn->tok)))
669: sz = ssz;
670: else if ( ! mdoc_nmsg(m, n, MANDOCERR_NOWIDTHARG))
671: return(0);
672:
673: break;
1.1 kristaps 674: }
675:
1.69 kristaps 676: /* Defaults to ten ens. */
677:
1.46 kristaps 678: snprintf(buf, NUMSIZ, "%zun", sz);
1.1 kristaps 679:
680: /*
681: * We have to dynamically add this to the macro's argument list.
682: * We're guaranteed that a MDOC_Width doesn't already exist.
683: */
684:
1.70 kristaps 685: assert(n->args);
686: i = (int)(n->args->argc)++;
687:
688: n->args->argv = mandoc_realloc(n->args->argv,
689: n->args->argc * sizeof(struct mdoc_argv));
1.1 kristaps 690:
1.70 kristaps 691: n->args->argv[i].arg = MDOC_Width;
692: n->args->argv[i].line = n->line;
693: n->args->argv[i].pos = n->pos;
694: n->args->argv[i].sz = 1;
695: n->args->argv[i].value = mandoc_malloc(sizeof(char *));
696: n->args->argv[i].value[0] = mandoc_strdup(buf);
1.1 kristaps 697:
1.70 kristaps 698: /* Set our width! */
1.74 ! kristaps 699: n->data.Bl->width = n->args->argv[i].value[0];
1.1 kristaps 700: return(1);
701: }
702:
703:
1.46 kristaps 704: /*
705: * Calculate the real width of a list from the -width string, which may
706: * contain a macro (with a known default width), a literal string, or a
707: * scaling width.
708: */
1.1 kristaps 709: static int
1.70 kristaps 710: post_bl_width(POST_ARGS)
1.1 kristaps 711: {
712: size_t width;
1.70 kristaps 713: int i;
1.51 kristaps 714: enum mdoct tok;
1.46 kristaps 715: char buf[NUMSIZ];
1.1 kristaps 716:
717: /*
718: * If the value to -width is a macro, then we re-write it to be
719: * the macro's width as set in share/tmac/mdoc/doc-common.
720: */
721:
1.74 ! kristaps 722: if (0 == strcmp(n->data.Bl->width, "Ds"))
1.18 kristaps 723: width = 6;
1.74 ! kristaps 724: else if (MDOC_MAX == (tok = mdoc_hash_find(n->data.Bl->width)))
1.1 kristaps 725: return(1);
726: else if (0 == (width = mdoc_macro2len(tok)))
1.59 kristaps 727: return(mdoc_nmsg(m, n, MANDOCERR_BADWIDTH));
1.1 kristaps 728:
729: /* The value already exists: free and reallocate it. */
730:
1.70 kristaps 731: assert(n->args);
732:
733: for (i = 0; i < (int)n->args->argc; i++)
734: if (MDOC_Width == n->args->argv[i].arg)
735: break;
736:
737: assert(i < (int)n->args->argc);
738:
1.46 kristaps 739: snprintf(buf, NUMSIZ, "%zun", width);
1.70 kristaps 740: free(n->args->argv[i].value[0]);
741: n->args->argv[i].value[0] = mandoc_strdup(buf);
742:
743: /* Set our width! */
1.74 ! kristaps 744: n->data.Bl->width = n->args->argv[i].value[0];
1.1 kristaps 745: return(1);
746: }
747:
748:
1.46 kristaps 749: /*
750: * Do processing for -column lists, which can have two distinct styles
751: * of invocation. Merge this two styles into a consistent form.
752: */
1.35 kristaps 753: /* ARGSUSED */
1.1 kristaps 754: static int
1.14 kristaps 755: post_bl_head(POST_ARGS)
756: {
757: int i, c;
1.35 kristaps 758: struct mdoc_node *np, *nn, *nnp;
1.14 kristaps 759:
1.74 ! kristaps 760: if (LIST_column != n->data.Bl->type)
1.69 kristaps 761: return(1);
762: else if (NULL == n->child)
1.14 kristaps 763: return(1);
764:
1.35 kristaps 765: np = n->parent;
766: assert(np->args);
1.14 kristaps 767:
1.35 kristaps 768: for (c = 0; c < (int)np->args->argc; c++)
769: if (MDOC_Column == np->args->argv[c].arg)
1.14 kristaps 770: break;
771:
1.69 kristaps 772: assert(c < (int)np->args->argc);
1.35 kristaps 773: assert(0 == np->args->argv[c].sz);
1.14 kristaps 774:
775: /*
776: * Accomodate for new-style groff column syntax. Shuffle the
777: * child nodes, all of which must be TEXT, as arguments for the
778: * column field. Then, delete the head children.
779: */
780:
1.35 kristaps 781: np->args->argv[c].sz = (size_t)n->nchild;
1.46 kristaps 782: np->args->argv[c].value = mandoc_malloc
1.35 kristaps 783: ((size_t)n->nchild * sizeof(char *));
1.14 kristaps 784:
1.35 kristaps 785: for (i = 0, nn = n->child; nn; i++) {
786: np->args->argv[c].value[i] = nn->string;
1.14 kristaps 787: nn->string = NULL;
788: nnp = nn;
789: nn = nn->next;
1.53 kristaps 790: mdoc_node_delete(NULL, nnp);
1.14 kristaps 791: }
792:
1.35 kristaps 793: n->nchild = 0;
794: n->child = NULL;
1.14 kristaps 795: return(1);
796: }
797:
798:
799: static int
1.1 kristaps 800: post_bl(POST_ARGS)
801: {
802:
1.35 kristaps 803: if (MDOC_HEAD == n->type)
804: return(post_bl_head(m, n));
805: if (MDOC_BLOCK != n->type)
1.1 kristaps 806: return(1);
807:
808: /*
809: * These are fairly complicated, so we've broken them into two
810: * functions. post_bl_tagwidth() is called when a -tag is
811: * specified, but no -width (it must be guessed). The second
812: * when a -width is specified (macro indicators must be
813: * rewritten into real lengths).
814: */
815:
1.74 ! kristaps 816: if (LIST_tag == n->data.Bl->type && NULL == n->data.Bl->width) {
1.35 kristaps 817: if ( ! post_bl_tagwidth(m, n))
1.1 kristaps 818: return(0);
1.74 ! kristaps 819: } else if (NULL != n->data.Bl->width) {
1.70 kristaps 820: if ( ! post_bl_width(m, n))
1.1 kristaps 821: return(0);
1.70 kristaps 822: } else
823: return(1);
824:
1.74 ! kristaps 825: assert(n->data.Bl->width);
1.1 kristaps 826: return(1);
827: }
828:
829:
1.46 kristaps 830: /*
831: * The `Pa' macro defaults to a tilde if no value is provided as an
832: * argument.
833: */
1.1 kristaps 834: static int
1.46 kristaps 835: post_pa(POST_ARGS)
1.10 kristaps 836: {
1.35 kristaps 837: struct mdoc_node *np;
1.10 kristaps 838:
1.35 kristaps 839: if (n->child)
1.10 kristaps 840: return(1);
841:
1.35 kristaps 842: np = n;
1.10 kristaps 843: m->next = MDOC_NEXT_CHILD;
1.35 kristaps 844: if ( ! mdoc_word_alloc(m, n->line, n->pos, "~"))
1.62 kristaps 845: return(0);
846: m->last = np;
847: return(1);
848: }
849:
850:
851: /*
852: * Empty `Li' macros get an empty string to make front-ends add an extra
853: * space.
854: */
855: static int
856: post_li(POST_ARGS)
857: {
858: struct mdoc_node *np;
859:
860: if (n->child)
861: return(1);
862:
863: np = n;
864: m->next = MDOC_NEXT_CHILD;
865: if ( ! mdoc_word_alloc(m, n->line, n->pos, ""))
1.10 kristaps 866: return(0);
1.35 kristaps 867: m->last = np;
1.10 kristaps 868: return(1);
869: }
870:
871:
1.46 kristaps 872: /*
873: * The `Ar' macro defaults to two strings "file ..." if no value is
874: * provided as an argument.
875: */
1.10 kristaps 876: static int
1.1 kristaps 877: post_ar(POST_ARGS)
878: {
1.35 kristaps 879: struct mdoc_node *np;
1.1 kristaps 880:
1.35 kristaps 881: if (n->child)
1.1 kristaps 882: return(1);
883:
1.35 kristaps 884: np = n;
1.1 kristaps 885: m->next = MDOC_NEXT_CHILD;
1.46 kristaps 886: /* XXX: make into macro values. */
1.35 kristaps 887: if ( ! mdoc_word_alloc(m, n->line, n->pos, "file"))
1.1 kristaps 888: return(0);
1.35 kristaps 889: if ( ! mdoc_word_alloc(m, n->line, n->pos, "..."))
1.1 kristaps 890: return(0);
1.35 kristaps 891: m->last = np;
1.1 kristaps 892: return(1);
893: }
894:
895:
1.46 kristaps 896: /*
1.49 kristaps 897: * Parse the date field in `Dd'.
1.46 kristaps 898: */
1.1 kristaps 899: static int
900: post_dd(POST_ARGS)
901: {
1.46 kristaps 902: char buf[DATESIZ];
1.1 kristaps 903:
1.46 kristaps 904: if ( ! concat(m, buf, n->child, DATESIZ))
1.2 kristaps 905: return(0);
1.1 kristaps 906:
1.49 kristaps 907: m->meta.date = mandoc_a2time
908: (MTIME_MDOCDATE | MTIME_CANONICAL, buf);
909:
1.46 kristaps 910: if (0 == m->meta.date) {
1.59 kristaps 911: if ( ! mdoc_nmsg(m, n, MANDOCERR_BADDATE))
1.1 kristaps 912: return(0);
913: m->meta.date = time(NULL);
914: }
915:
1.35 kristaps 916: return(post_prol(m, n));
1.1 kristaps 917: }
918:
919:
1.46 kristaps 920: /*
921: * Remove prologue macros from the document after they're processed.
922: * The final document uses mdoc_meta for these values and discards the
923: * originals.
924: */
1.1 kristaps 925: static int
926: post_prol(POST_ARGS)
927: {
1.34 kristaps 928:
1.53 kristaps 929: mdoc_node_delete(m, n);
1.34 kristaps 930: if (m->meta.title && m->meta.date && m->meta.os)
931: m->flags |= MDOC_PBODY;
1.1 kristaps 932: return(1);
933: }
934:
935:
1.46 kristaps 936: /*
937: * Trigger a literal context.
938: */
1.1 kristaps 939: static int
940: pre_dl(PRE_ARGS)
941: {
942:
1.16 kristaps 943: if (MDOC_BODY == n->type)
944: m->flags |= MDOC_LITERAL;
1.65 kristaps 945: return(1);
1.38 kristaps 946: }
947:
948:
949: static int
1.1 kristaps 950: pre_bd(PRE_ARGS)
951: {
952:
953: if (MDOC_BODY != n->type)
954: return(1);
955:
1.74 ! kristaps 956: assert(n->data.Bd);
! 957: if (DISP_literal == n->data.Bd->type)
1.66 kristaps 958: m->flags |= MDOC_LITERAL;
1.74 ! kristaps 959: if (DISP_unfilled == n->data.Bd->type)
1.66 kristaps 960: m->flags |= MDOC_LITERAL;
1.1 kristaps 961:
962: return(1);
963: }
964:
965:
966: static int
967: post_display(POST_ARGS)
968: {
969:
1.35 kristaps 970: if (MDOC_BODY == n->type)
1.1 kristaps 971: m->flags &= ~MDOC_LITERAL;
972: return(1);
973: }
974:
975:
1.39 kristaps 976: static inline int
1.54 kristaps 977: order_rs(enum mdoct t)
1.39 kristaps 978: {
979: int i;
980:
1.54 kristaps 981: for (i = 0; i < (int)RSORD_MAX; i++)
1.39 kristaps 982: if (rsord[i] == t)
983: return(i);
984:
985: abort();
986: /* NOTREACHED */
987: }
988:
989:
1.41 kristaps 990: /* ARGSUSED */
1.39 kristaps 991: static int
992: post_rs(POST_ARGS)
993: {
994: struct mdoc_node *nn, *next, *prev;
995: int o;
996:
997: if (MDOC_BLOCK != n->type)
998: return(1);
999:
1.40 kristaps 1000: assert(n->body->child);
1.39 kristaps 1001: for (next = NULL, nn = n->body->child->next; nn; nn = next) {
1002: o = order_rs(nn->tok);
1003:
1004: /* Remove `nn' from the chain. */
1005: next = nn->next;
1006: if (next)
1007: next->prev = nn->prev;
1008:
1009: prev = nn->prev;
1010: if (prev)
1011: prev->next = nn->next;
1012:
1013: nn->prev = nn->next = NULL;
1014:
1015: /*
1016: * Scan back until we reach a node that's ordered before
1017: * us, then set ourselves as being the next.
1018: */
1019: for ( ; prev; prev = prev->prev)
1020: if (order_rs(prev->tok) <= o)
1021: break;
1022:
1023: nn->prev = prev;
1024: if (prev) {
1025: if (prev->next)
1026: prev->next->prev = nn;
1027: nn->next = prev->next;
1028: prev->next = nn;
1029: continue;
1030: }
1031:
1032: n->body->child->prev = nn;
1033: nn->next = n->body->child;
1034: n->body->child = nn;
1035: }
1036: return(1);
1037: }
CVSweb