Annotation of src/usr.bin/mandoc/mdoc_macro.c, Revision 1.183
1.183 ! schwarze 1: /* $OpenBSD: mdoc_macro.c,v 1.182 2018/08/17 20:31:52 schwarze Exp $ */
1.1 kristaps 2: /*
1.74 schwarze 3: * Copyright (c) 2008-2012 Kristaps Dzonsons <kristaps@bsd.lv>
1.182 schwarze 4: * Copyright (c) 2010, 2012-2018 Ingo Schwarze <schwarze@openbsd.org>
1.1 kristaps 5: *
6: * Permission to use, copy, modify, and distribute this software for any
1.2 schwarze 7: * purpose with or without fee is hereby granted, provided that the above
8: * copyright notice and this permission notice appear in all copies.
1.1 kristaps 9: *
1.140 schwarze 10: * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHORS DISCLAIM ALL WARRANTIES
1.2 schwarze 11: * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
1.140 schwarze 12: * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR
1.2 schwarze 13: * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14: * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15: * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16: * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
1.1 kristaps 17: */
1.100 schwarze 18: #include <sys/types.h>
19:
1.1 kristaps 20: #include <assert.h>
21: #include <ctype.h>
22: #include <stdlib.h>
23: #include <stdio.h>
24: #include <string.h>
1.26 schwarze 25: #include <time.h>
1.1 kristaps 26:
1.140 schwarze 27: #include "mandoc.h"
28: #include "roff.h"
1.66 schwarze 29: #include "mdoc.h"
1.140 schwarze 30: #include "libmandoc.h"
1.146 schwarze 31: #include "roff_int.h"
1.1 kristaps 32: #include "libmdoc.h"
33:
1.107 schwarze 34: static void blk_full(MACRO_PROT_ARGS);
35: static void blk_exp_close(MACRO_PROT_ARGS);
36: static void blk_part_exp(MACRO_PROT_ARGS);
37: static void blk_part_imp(MACRO_PROT_ARGS);
38: static void ctx_synopsis(MACRO_PROT_ARGS);
39: static void in_line_eoln(MACRO_PROT_ARGS);
40: static void in_line_argn(MACRO_PROT_ARGS);
41: static void in_line(MACRO_PROT_ARGS);
42: static void phrase_ta(MACRO_PROT_ARGS);
1.36 schwarze 43:
1.145 schwarze 44: static void append_delims(struct roff_man *, int, int *, char *);
45: static void dword(struct roff_man *, int, int, const char *,
1.143 schwarze 46: enum mdelim, int);
1.176 schwarze 47: static int find_pending(struct roff_man *, enum roff_tok,
48: int, int, struct roff_node *);
1.145 schwarze 49: static int lookup(struct roff_man *, int, int, int, const char *);
1.109 schwarze 50: static int macro_or_word(MACRO_PROT_ARGS, int);
1.170 schwarze 51: static void break_intermediate(struct roff_node *,
1.176 schwarze 52: struct roff_node *);
53: static int parse_rest(struct roff_man *, enum roff_tok,
54: int, int *, char *);
55: static enum roff_tok rew_alt(enum roff_tok);
56: static void rew_elem(struct roff_man *, enum roff_tok);
1.145 schwarze 57: static void rew_last(struct roff_man *, const struct roff_node *);
58: static void rew_pending(struct roff_man *,
59: const struct roff_node *);
1.1 kristaps 60:
1.182 schwarze 61: static const struct mdoc_macro mdoc_macros[MDOC_MAX - MDOC_Dd] = {
1.1 kristaps 62: { in_line_eoln, MDOC_PROLOGUE }, /* Dd */
63: { in_line_eoln, MDOC_PROLOGUE }, /* Dt */
64: { in_line_eoln, MDOC_PROLOGUE }, /* Os */
1.80 schwarze 65: { blk_full, MDOC_PARSED | MDOC_JOIN }, /* Sh */
66: { blk_full, MDOC_PARSED | MDOC_JOIN }, /* Ss */
67: { in_line_eoln, 0 }, /* Pp */
68: { blk_part_imp, MDOC_PARSED | MDOC_JOIN }, /* D1 */
69: { blk_part_imp, MDOC_PARSED | MDOC_JOIN }, /* Dl */
1.1 kristaps 70: { blk_full, MDOC_EXPLICIT }, /* Bd */
1.80 schwarze 71: { blk_exp_close, MDOC_EXPLICIT | MDOC_JOIN }, /* Ed */
1.1 kristaps 72: { blk_full, MDOC_EXPLICIT }, /* Bl */
1.80 schwarze 73: { blk_exp_close, MDOC_EXPLICIT | MDOC_JOIN }, /* El */
74: { blk_full, MDOC_PARSED | MDOC_JOIN }, /* It */
75: { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Ad */
76: { in_line, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* An */
1.181 schwarze 77: { in_line_argn, MDOC_CALLABLE | MDOC_PARSED |
78: MDOC_IGNDELIM | MDOC_JOIN }, /* Ap */
1.1 kristaps 79: { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Ar */
1.86 schwarze 80: { in_line, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Cd */
1.1 kristaps 81: { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Cm */
1.80 schwarze 82: { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Dv */
83: { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Er */
84: { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Ev */
1.1 kristaps 85: { in_line_eoln, 0 }, /* Ex */
1.80 schwarze 86: { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Fa */
87: { in_line_eoln, 0 }, /* Fd */
1.1 kristaps 88: { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Fl */
1.80 schwarze 89: { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Fn */
90: { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Ft */
1.85 schwarze 91: { in_line, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Ic */
1.11 schwarze 92: { in_line_argn, MDOC_CALLABLE | MDOC_PARSED }, /* In */
1.80 schwarze 93: { in_line, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Li */
94: { blk_full, MDOC_JOIN }, /* Nd */
95: { ctx_synopsis, MDOC_CALLABLE | MDOC_PARSED }, /* Nm */
1.1 kristaps 96: { blk_part_imp, MDOC_CALLABLE | MDOC_PARSED }, /* Op */
1.89 schwarze 97: { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Ot */
1.1 kristaps 98: { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Pa */
99: { in_line_eoln, 0 }, /* Rv */
1.80 schwarze 100: { in_line_argn, MDOC_CALLABLE | MDOC_PARSED }, /* St */
1.1 kristaps 101: { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Va */
1.80 schwarze 102: { ctx_synopsis, MDOC_CALLABLE | MDOC_PARSED }, /* Vt */
1.28 schwarze 103: { in_line_argn, MDOC_CALLABLE | MDOC_PARSED }, /* Xr */
1.80 schwarze 104: { in_line_eoln, MDOC_JOIN }, /* %A */
105: { in_line_eoln, MDOC_JOIN }, /* %B */
106: { in_line_eoln, MDOC_JOIN }, /* %D */
107: { in_line_eoln, MDOC_JOIN }, /* %I */
108: { in_line_eoln, MDOC_JOIN }, /* %J */
1.1 kristaps 109: { in_line_eoln, 0 }, /* %N */
1.80 schwarze 110: { in_line_eoln, MDOC_JOIN }, /* %O */
1.1 kristaps 111: { in_line_eoln, 0 }, /* %P */
1.80 schwarze 112: { in_line_eoln, MDOC_JOIN }, /* %R */
113: { in_line_eoln, MDOC_JOIN }, /* %T */
1.1 kristaps 114: { in_line_eoln, 0 }, /* %V */
1.80 schwarze 115: { blk_exp_close, MDOC_CALLABLE | MDOC_PARSED |
116: MDOC_EXPLICIT | MDOC_JOIN }, /* Ac */
117: { blk_part_exp, MDOC_CALLABLE | MDOC_PARSED |
118: MDOC_EXPLICIT | MDOC_JOIN }, /* Ao */
119: { blk_part_imp, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Aq */
1.1 kristaps 120: { in_line_argn, MDOC_CALLABLE | MDOC_PARSED }, /* At */
1.80 schwarze 121: { blk_exp_close, MDOC_CALLABLE | MDOC_PARSED |
122: MDOC_EXPLICIT | MDOC_JOIN }, /* Bc */
123: { blk_full, MDOC_EXPLICIT }, /* Bf */
124: { blk_part_exp, MDOC_CALLABLE | MDOC_PARSED |
125: MDOC_EXPLICIT | MDOC_JOIN }, /* Bo */
126: { blk_part_imp, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Bq */
1.1 kristaps 127: { in_line_argn, MDOC_CALLABLE | MDOC_PARSED }, /* Bsx */
128: { in_line_argn, MDOC_CALLABLE | MDOC_PARSED }, /* Bx */
129: { in_line_eoln, 0 }, /* Db */
1.80 schwarze 130: { blk_exp_close, MDOC_CALLABLE | MDOC_PARSED |
131: MDOC_EXPLICIT | MDOC_JOIN }, /* Dc */
132: { blk_part_exp, MDOC_CALLABLE | MDOC_PARSED |
133: MDOC_EXPLICIT | MDOC_JOIN }, /* Do */
134: { blk_part_imp, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Dq */
135: { blk_exp_close, MDOC_CALLABLE | MDOC_PARSED | MDOC_EXPLICIT }, /* Ec */
136: { blk_exp_close, MDOC_EXPLICIT | MDOC_JOIN }, /* Ef */
137: { in_line, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Em */
1.1 kristaps 138: { blk_part_exp, MDOC_CALLABLE | MDOC_PARSED | MDOC_EXPLICIT }, /* Eo */
139: { in_line_argn, MDOC_CALLABLE | MDOC_PARSED }, /* Fx */
1.3 schwarze 140: { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Ms */
1.100 schwarze 141: { in_line, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* No */
1.80 schwarze 142: { in_line_argn, MDOC_CALLABLE | MDOC_PARSED |
143: MDOC_IGNDELIM | MDOC_JOIN }, /* Ns */
1.1 kristaps 144: { in_line_argn, MDOC_CALLABLE | MDOC_PARSED }, /* Nx */
145: { in_line_argn, MDOC_CALLABLE | MDOC_PARSED }, /* Ox */
1.80 schwarze 146: { blk_exp_close, MDOC_CALLABLE | MDOC_PARSED |
147: MDOC_EXPLICIT | MDOC_JOIN }, /* Pc */
1.35 schwarze 148: { in_line_argn, MDOC_CALLABLE | MDOC_PARSED | MDOC_IGNDELIM }, /* Pf */
1.80 schwarze 149: { blk_part_exp, MDOC_CALLABLE | MDOC_PARSED |
150: MDOC_EXPLICIT | MDOC_JOIN }, /* Po */
151: { blk_part_imp, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Pq */
152: { blk_exp_close, MDOC_CALLABLE | MDOC_PARSED |
153: MDOC_EXPLICIT | MDOC_JOIN }, /* Qc */
154: { blk_part_imp, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Ql */
155: { blk_part_exp, MDOC_CALLABLE | MDOC_PARSED |
156: MDOC_EXPLICIT | MDOC_JOIN }, /* Qo */
157: { blk_part_imp, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Qq */
158: { blk_exp_close, MDOC_EXPLICIT | MDOC_JOIN }, /* Re */
1.1 kristaps 159: { blk_full, MDOC_EXPLICIT }, /* Rs */
1.80 schwarze 160: { blk_exp_close, MDOC_CALLABLE | MDOC_PARSED |
161: MDOC_EXPLICIT | MDOC_JOIN }, /* Sc */
162: { blk_part_exp, MDOC_CALLABLE | MDOC_PARSED |
163: MDOC_EXPLICIT | MDOC_JOIN }, /* So */
164: { blk_part_imp, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Sq */
1.103 schwarze 165: { in_line_argn, 0 }, /* Sm */
1.80 schwarze 166: { in_line, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Sx */
167: { in_line, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Sy */
1.1 kristaps 168: { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Tn */
1.80 schwarze 169: { in_line_argn, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Ux */
1.1 kristaps 170: { blk_exp_close, MDOC_EXPLICIT | MDOC_CALLABLE | MDOC_PARSED }, /* Xc */
171: { blk_part_exp, MDOC_CALLABLE | MDOC_PARSED | MDOC_EXPLICIT }, /* Xo */
1.80 schwarze 172: { blk_full, MDOC_EXPLICIT | MDOC_CALLABLE }, /* Fo */
173: { blk_exp_close, MDOC_CALLABLE | MDOC_PARSED |
174: MDOC_EXPLICIT | MDOC_JOIN }, /* Fc */
175: { blk_part_exp, MDOC_CALLABLE | MDOC_PARSED |
176: MDOC_EXPLICIT | MDOC_JOIN }, /* Oo */
177: { blk_exp_close, MDOC_CALLABLE | MDOC_PARSED |
178: MDOC_EXPLICIT | MDOC_JOIN }, /* Oc */
1.1 kristaps 179: { blk_full, MDOC_EXPLICIT }, /* Bk */
1.80 schwarze 180: { blk_exp_close, MDOC_EXPLICIT | MDOC_JOIN }, /* Ek */
1.1 kristaps 181: { in_line_eoln, 0 }, /* Bt */
182: { in_line_eoln, 0 }, /* Hf */
1.89 schwarze 183: { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Fr */
1.1 kristaps 184: { in_line_eoln, 0 }, /* Ud */
1.45 schwarze 185: { in_line, 0 }, /* Lb */
1.80 schwarze 186: { in_line_eoln, 0 }, /* Lp */
187: { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Lk */
188: { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Mt */
189: { blk_part_imp, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Brq */
190: { blk_part_exp, MDOC_CALLABLE | MDOC_PARSED |
191: MDOC_EXPLICIT | MDOC_JOIN }, /* Bro */
192: { blk_exp_close, MDOC_CALLABLE | MDOC_PARSED |
193: MDOC_EXPLICIT | MDOC_JOIN }, /* Brc */
194: { in_line_eoln, MDOC_JOIN }, /* %C */
1.89 schwarze 195: { in_line_argn, MDOC_CALLABLE | MDOC_PARSED }, /* Es */
196: { blk_part_imp, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* En */
1.1 kristaps 197: { in_line_argn, MDOC_CALLABLE | MDOC_PARSED }, /* Dx */
1.80 schwarze 198: { in_line_eoln, MDOC_JOIN }, /* %Q */
1.25 schwarze 199: { in_line_eoln, 0 }, /* %U */
1.80 schwarze 200: { phrase_ta, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Ta */
1.1 kristaps 201: };
202:
203:
1.182 schwarze 204: const struct mdoc_macro *
205: mdoc_macro(enum roff_tok tok)
206: {
207: assert(tok >= MDOC_Dd && tok < MDOC_MAX);
208: return mdoc_macros + (tok - MDOC_Dd);
209: }
210:
1.1 kristaps 211: /*
212: * This is called at the end of parsing. It must traverse up the tree,
213: * closing out open [implicit] scopes. Obviously, open explicit scopes
214: * are errors.
215: */
1.107 schwarze 216: void
1.151 schwarze 217: mdoc_endparse(struct roff_man *mdoc)
1.1 kristaps 218: {
1.141 schwarze 219: struct roff_node *n;
1.1 kristaps 220:
221: /* Scan for open explicit scopes. */
222:
1.166 schwarze 223: n = mdoc->last->flags & NODE_VALID ?
1.88 schwarze 224: mdoc->last->parent : mdoc->last;
1.1 kristaps 225:
1.56 schwarze 226: for ( ; n; n = n->parent)
1.140 schwarze 227: if (n->type == ROFFT_BLOCK &&
1.182 schwarze 228: mdoc_macro(n->tok)->flags & MDOC_EXPLICIT)
1.94 schwarze 229: mandoc_msg(MANDOCERR_BLK_NOEND, mdoc->parse,
1.176 schwarze 230: n->line, n->pos, roff_name[n->tok]);
1.1 kristaps 231:
1.22 schwarze 232: /* Rewind to the first. */
233:
1.105 schwarze 234: rew_last(mdoc, mdoc->first);
1.162 schwarze 235: mdoc_state_reset(mdoc);
1.1 kristaps 236: }
237:
1.22 schwarze 238: /*
1.109 schwarze 239: * Look up the macro at *p called by "from",
1.147 schwarze 240: * or as a line macro if from == TOKEN_NONE.
1.22 schwarze 241: */
1.141 schwarze 242: static int
1.145 schwarze 243: lookup(struct roff_man *mdoc, int from, int line, int ppos, const char *p)
1.21 schwarze 244: {
1.176 schwarze 245: enum roff_tok res;
1.1 kristaps 246:
1.161 schwarze 247: if (mdoc->flags & MDOC_PHRASEQF) {
248: mdoc->flags &= ~MDOC_PHRASEQF;
249: return TOKEN_NONE;
250: }
1.182 schwarze 251: if (from == TOKEN_NONE || mdoc_macro(from)->flags & MDOC_PARSED) {
1.177 schwarze 252: res = roffhash_find(mdoc->mdocmac, p, 0);
1.147 schwarze 253: if (res != TOKEN_NONE) {
1.182 schwarze 254: if (mdoc_macro(res)->flags & MDOC_CALLABLE)
1.158 schwarze 255: return res;
1.180 schwarze 256: mandoc_msg(MANDOCERR_MACRO_CALL,
257: mdoc->parse, line, ppos, p);
1.111 schwarze 258: }
1.109 schwarze 259: }
1.158 schwarze 260: return TOKEN_NONE;
1.1 kristaps 261: }
262:
1.122 schwarze 263: /*
264: * Rewind up to and including a specific node.
265: */
1.105 schwarze 266: static void
1.145 schwarze 267: rew_last(struct roff_man *mdoc, const struct roff_node *to)
1.1 kristaps 268: {
269:
1.166 schwarze 270: if (to->flags & NODE_VALID)
1.142 schwarze 271: return;
272:
1.1 kristaps 273: while (mdoc->last != to) {
1.162 schwarze 274: mdoc_state(mdoc, mdoc->last);
1.166 schwarze 275: mdoc->last->flags |= NODE_VALID | NODE_ENDED;
1.162 schwarze 276: mdoc->last = mdoc->last->parent;
1.1 kristaps 277: }
1.162 schwarze 278: mdoc_state(mdoc, mdoc->last);
1.166 schwarze 279: mdoc->last->flags |= NODE_VALID | NODE_ENDED;
1.156 schwarze 280: mdoc->next = ROFF_NEXT_SIBLING;
1.1 kristaps 281: }
282:
1.22 schwarze 283: /*
1.122 schwarze 284: * Rewind up to a specific block, including all blocks that broke it.
285: */
286: static void
1.145 schwarze 287: rew_pending(struct roff_man *mdoc, const struct roff_node *n)
1.122 schwarze 288: {
289:
1.139 schwarze 290: for (;;) {
291: rew_last(mdoc, n);
292:
1.150 schwarze 293: if (mdoc->last == n) {
294: switch (n->type) {
295: case ROFFT_HEAD:
296: roff_body_alloc(mdoc, n->line, n->pos,
297: n->tok);
1.163 schwarze 298: break;
1.150 schwarze 299: case ROFFT_BLOCK:
300: break;
301: default:
302: return;
303: }
1.166 schwarze 304: if ( ! (n->flags & NODE_BROKEN))
1.150 schwarze 305: return;
306: } else
307: n = mdoc->last;
1.122 schwarze 308:
1.139 schwarze 309: for (;;) {
310: if ((n = n->parent) == NULL)
311: return;
312:
1.140 schwarze 313: if (n->type == ROFFT_BLOCK ||
314: n->type == ROFFT_HEAD) {
1.166 schwarze 315: if (n->flags & NODE_ENDED)
1.139 schwarze 316: break;
317: else
318: return;
319: }
320: }
1.122 schwarze 321: }
322: }
323:
324: /*
1.48 schwarze 325: * For a block closing macro, return the corresponding opening one.
326: * Otherwise, return the macro itself.
1.22 schwarze 327: */
1.176 schwarze 328: static enum roff_tok
329: rew_alt(enum roff_tok tok)
1.1 kristaps 330: {
331: switch (tok) {
1.88 schwarze 332: case MDOC_Ac:
1.158 schwarze 333: return MDOC_Ao;
1.88 schwarze 334: case MDOC_Bc:
1.158 schwarze 335: return MDOC_Bo;
1.88 schwarze 336: case MDOC_Brc:
1.158 schwarze 337: return MDOC_Bro;
1.88 schwarze 338: case MDOC_Dc:
1.158 schwarze 339: return MDOC_Do;
1.88 schwarze 340: case MDOC_Ec:
1.158 schwarze 341: return MDOC_Eo;
1.88 schwarze 342: case MDOC_Ed:
1.158 schwarze 343: return MDOC_Bd;
1.88 schwarze 344: case MDOC_Ef:
1.158 schwarze 345: return MDOC_Bf;
1.88 schwarze 346: case MDOC_Ek:
1.158 schwarze 347: return MDOC_Bk;
1.88 schwarze 348: case MDOC_El:
1.158 schwarze 349: return MDOC_Bl;
1.88 schwarze 350: case MDOC_Fc:
1.158 schwarze 351: return MDOC_Fo;
1.88 schwarze 352: case MDOC_Oc:
1.158 schwarze 353: return MDOC_Oo;
1.88 schwarze 354: case MDOC_Pc:
1.158 schwarze 355: return MDOC_Po;
1.88 schwarze 356: case MDOC_Qc:
1.158 schwarze 357: return MDOC_Qo;
1.88 schwarze 358: case MDOC_Re:
1.158 schwarze 359: return MDOC_Rs;
1.88 schwarze 360: case MDOC_Sc:
1.158 schwarze 361: return MDOC_So;
1.88 schwarze 362: case MDOC_Xc:
1.158 schwarze 363: return MDOC_Xo;
1.1 kristaps 364: default:
1.158 schwarze 365: return tok;
1.1 kristaps 366: }
367: }
368:
1.105 schwarze 369: static void
1.176 schwarze 370: rew_elem(struct roff_man *mdoc, enum roff_tok tok)
1.1 kristaps 371: {
1.141 schwarze 372: struct roff_node *n;
1.1 kristaps 373:
374: n = mdoc->last;
1.140 schwarze 375: if (n->type != ROFFT_ELEM)
1.1 kristaps 376: n = n->parent;
1.140 schwarze 377: assert(n->type == ROFFT_ELEM);
1.1 kristaps 378: assert(tok == n->tok);
1.105 schwarze 379: rew_last(mdoc, n);
1.1 kristaps 380: }
381:
1.170 schwarze 382: static void
383: break_intermediate(struct roff_node *n, struct roff_node *breaker)
384: {
1.174 schwarze 385: if (n != breaker &&
386: n->type != ROFFT_BLOCK && n->type != ROFFT_HEAD &&
387: (n->type != ROFFT_BODY || n->end != ENDBODY_NOT))
388: n = n->parent;
1.170 schwarze 389: while (n != breaker) {
390: if ( ! (n->flags & NODE_VALID))
391: n->flags |= NODE_BROKEN;
392: n = n->parent;
393: }
394: }
395:
1.47 schwarze 396: /*
1.143 schwarze 397: * If there is an open sub-block of the target requiring
398: * explicit close-out, postpone closing out the target until
399: * the rew_pending() call closing out the sub-block.
400: */
401: static int
1.176 schwarze 402: find_pending(struct roff_man *mdoc, enum roff_tok tok, int line, int ppos,
1.143 schwarze 403: struct roff_node *target)
404: {
405: struct roff_node *n;
406: int irc;
407:
1.172 schwarze 408: if (target->flags & NODE_VALID)
409: return 0;
410:
1.143 schwarze 411: irc = 0;
412: for (n = mdoc->last; n != NULL && n != target; n = n->parent) {
1.170 schwarze 413: if (n->flags & NODE_ENDED)
1.143 schwarze 414: continue;
415: if (n->type == ROFFT_BLOCK &&
1.182 schwarze 416: mdoc_macro(n->tok)->flags & MDOC_EXPLICIT) {
1.143 schwarze 417: irc = 1;
1.174 schwarze 418: break_intermediate(mdoc->last, target);
1.143 schwarze 419: if (target->type == ROFFT_HEAD)
1.169 schwarze 420: target->flags |= NODE_ENDED;
1.166 schwarze 421: else if ( ! (target->flags & NODE_ENDED)) {
1.143 schwarze 422: mandoc_vmsg(MANDOCERR_BLK_NEST,
423: mdoc->parse, line, ppos,
1.176 schwarze 424: "%s breaks %s", roff_name[tok],
425: roff_name[n->tok]);
1.143 schwarze 426: mdoc_endbody_alloc(mdoc, line, ppos,
1.173 schwarze 427: tok, target);
1.143 schwarze 428: }
429: }
430: }
1.158 schwarze 431: return irc;
1.143 schwarze 432: }
433:
434: /*
1.66 schwarze 435: * Allocate a word and check whether it's punctuation or not.
436: * Punctuation consists of those tokens found in mdoc_isdelim().
437: */
1.106 schwarze 438: static void
1.145 schwarze 439: dword(struct roff_man *mdoc, int line, int col, const char *p,
1.80 schwarze 440: enum mdelim d, int may_append)
1.66 schwarze 441: {
1.88 schwarze 442:
1.106 schwarze 443: if (d == DELIM_MAX)
1.66 schwarze 444: d = mdoc_isdelim(p);
445:
1.80 schwarze 446: if (may_append &&
1.106 schwarze 447: ! (mdoc->flags & (MDOC_SYNOPSIS | MDOC_KEEP | MDOC_SMOFF)) &&
1.140 schwarze 448: d == DELIM_NONE && mdoc->last->type == ROFFT_TEXT &&
1.106 schwarze 449: mdoc_isdelim(mdoc->last->string) == DELIM_NONE) {
1.148 schwarze 450: roff_word_append(mdoc, p);
1.106 schwarze 451: return;
1.80 schwarze 452: }
453:
1.148 schwarze 454: roff_word_alloc(mdoc, line, col, p);
1.66 schwarze 455:
1.71 schwarze 456: /*
1.100 schwarze 457: * If the word consists of a bare delimiter,
458: * flag the new node accordingly,
459: * unless doing so was vetoed by the invoking macro.
460: * Always clear the veto, it is only valid for one word.
1.71 schwarze 461: */
462:
1.100 schwarze 463: if (d == DELIM_OPEN)
1.166 schwarze 464: mdoc->last->flags |= NODE_DELIMO;
1.100 schwarze 465: else if (d == DELIM_CLOSE &&
466: ! (mdoc->flags & MDOC_NODELIMC) &&
1.88 schwarze 467: mdoc->last->parent->tok != MDOC_Fd)
1.166 schwarze 468: mdoc->last->flags |= NODE_DELIMC;
1.100 schwarze 469: mdoc->flags &= ~MDOC_NODELIMC;
1.66 schwarze 470: }
1.1 kristaps 471:
1.106 schwarze 472: static void
1.145 schwarze 473: append_delims(struct roff_man *mdoc, int line, int *pos, char *buf)
1.1 kristaps 474: {
1.109 schwarze 475: char *p;
1.42 schwarze 476: int la;
1.1 kristaps 477:
1.106 schwarze 478: if (buf[*pos] == '\0')
479: return;
1.1 kristaps 480:
481: for (;;) {
1.42 schwarze 482: la = *pos;
1.147 schwarze 483: if (mdoc_args(mdoc, line, pos, buf, TOKEN_NONE, &p) ==
484: ARGS_EOLN)
1.1 kristaps 485: break;
1.80 schwarze 486: dword(mdoc, line, la, p, DELIM_MAX, 1);
1.43 schwarze 487:
1.42 schwarze 488: /*
489: * If we encounter end-of-sentence symbols, then trigger
490: * the double-space.
491: *
1.68 schwarze 492: * XXX: it's easy to allow this to propagate outward to
1.42 schwarze 493: * the last symbol, such that `. )' will cause the
494: * correct double-spacing. However, (1) groff isn't
495: * smart enough to do this and (2) it would require
496: * knowing which symbols break this behaviour, for
1.68 schwarze 497: * example, `. ;' shouldn't propagate the double-space.
1.42 schwarze 498: */
1.106 schwarze 499:
1.84 schwarze 500: if (mandoc_eos(p, strlen(p)))
1.166 schwarze 501: mdoc->last->flags |= NODE_EOS;
1.1 kristaps 502: }
503: }
504:
505: /*
1.109 schwarze 506: * Parse one word.
507: * If it is a macro, call it and return 1.
508: * Otherwise, allocate it and return 0.
509: */
510: static int
511: macro_or_word(MACRO_PROT_ARGS, int parsed)
512: {
513: char *p;
1.141 schwarze 514: int ntok;
1.109 schwarze 515:
516: p = buf + ppos;
1.147 schwarze 517: ntok = TOKEN_NONE;
1.113 schwarze 518: if (*p == '"')
1.109 schwarze 519: p++;
1.113 schwarze 520: else if (parsed && ! (mdoc->flags & MDOC_PHRASELIT))
1.111 schwarze 521: ntok = lookup(mdoc, tok, line, ppos, p);
1.109 schwarze 522:
1.147 schwarze 523: if (ntok == TOKEN_NONE) {
524: dword(mdoc, line, ppos, p, DELIM_MAX, tok == TOKEN_NONE ||
1.182 schwarze 525: mdoc_macro(tok)->flags & MDOC_JOIN);
1.158 schwarze 526: return 0;
1.109 schwarze 527: } else {
1.176 schwarze 528: if (tok != TOKEN_NONE &&
1.182 schwarze 529: mdoc_macro(tok)->fp == in_line_eoln)
1.109 schwarze 530: rew_elem(mdoc, tok);
1.182 schwarze 531: (*mdoc_macro(ntok)->fp)(mdoc, ntok, line, ppos, pos, buf);
1.147 schwarze 532: if (tok == TOKEN_NONE)
1.109 schwarze 533: append_delims(mdoc, line, pos, buf);
1.158 schwarze 534: return 1;
1.109 schwarze 535: }
536: }
537:
538: /*
1.88 schwarze 539: * Close out block partial/full explicit.
1.1 kristaps 540: */
1.107 schwarze 541: static void
1.1 kristaps 542: blk_exp_close(MACRO_PROT_ARGS)
543: {
1.141 schwarze 544: struct roff_node *body; /* Our own body. */
545: struct roff_node *endbody; /* Our own end marker. */
546: struct roff_node *itblk; /* An It block starting later. */
547: struct roff_node *later; /* A sub-block starting later. */
548: struct roff_node *n; /* Search back to our block. */
1.144 schwarze 549: struct roff_node *target; /* For find_pending(). */
1.47 schwarze 550:
1.144 schwarze 551: int j, lastarg, maxargs, nl, pending;
1.36 schwarze 552: enum margserr ac;
1.176 schwarze 553: enum roff_tok atok, ntok;
1.1 kristaps 554: char *p;
555:
1.76 schwarze 556: nl = MDOC_NEWLINE & mdoc->flags;
1.37 schwarze 557:
1.1 kristaps 558: switch (tok) {
1.88 schwarze 559: case MDOC_Ec:
1.1 kristaps 560: maxargs = 1;
561: break;
1.88 schwarze 562: case MDOC_Ek:
1.82 schwarze 563: mdoc->flags &= ~MDOC_KEEP;
1.107 schwarze 564: /* FALLTHROUGH */
1.1 kristaps 565: default:
566: maxargs = 0;
567: break;
568: }
569:
1.165 schwarze 570: /* Search backwards for the beginning of our own body. */
571:
572: atok = rew_alt(tok);
573: body = NULL;
574: for (n = mdoc->last; n; n = n->parent) {
1.166 schwarze 575: if (n->flags & NODE_ENDED || n->tok != atok ||
1.165 schwarze 576: n->type != ROFFT_BODY || n->end != ENDBODY_NOT)
577: continue;
578: body = n;
579: break;
580: }
581:
1.47 schwarze 582: /*
583: * Search backwards for beginnings of blocks,
584: * both of our own and of pending sub-blocks.
585: */
1.107 schwarze 586:
1.165 schwarze 587: endbody = itblk = later = NULL;
1.76 schwarze 588: for (n = mdoc->last; n; n = n->parent) {
1.170 schwarze 589: if (n->flags & NODE_ENDED)
1.47 schwarze 590: continue;
591:
1.165 schwarze 592: /*
1.167 schwarze 593: * Mismatching end macros can never break anything
1.165 schwarze 594: * and we only care about the breaking of BLOCKs.
595: */
1.47 schwarze 596:
1.167 schwarze 597: if (body == NULL || n->type != ROFFT_BLOCK)
1.47 schwarze 598: continue;
1.116 schwarze 599:
1.167 schwarze 600: /*
601: * SYNOPSIS name blocks can not be broken themselves,
602: * but they do get broken together with a broken child.
603: */
604:
605: if (n->tok == MDOC_Nm) {
606: if (later != NULL)
607: n->flags |= NODE_BROKEN | NODE_ENDED;
608: continue;
609: }
610:
1.116 schwarze 611: if (n->tok == MDOC_It) {
1.127 schwarze 612: itblk = n;
1.116 schwarze 613: continue;
614: }
615:
1.47 schwarze 616: if (atok == n->tok) {
617:
618: /*
619: * Found the start of our own block.
620: * When there is no pending sub block,
621: * just proceed to closing out.
622: */
1.107 schwarze 623:
1.116 schwarze 624: if (later == NULL ||
1.127 schwarze 625: (tok == MDOC_El && itblk == NULL))
1.47 schwarze 626: break;
627:
1.88 schwarze 628: /*
1.123 schwarze 629: * When there is a pending sub block, postpone
630: * closing out the current block until the
631: * rew_pending() closing out the sub-block.
1.47 schwarze 632: * Mark the place where the formatting - but not
633: * the scope - of the current block ends.
634: */
1.107 schwarze 635:
1.139 schwarze 636: mandoc_vmsg(MANDOCERR_BLK_NEST, mdoc->parse,
637: line, ppos, "%s breaks %s",
1.176 schwarze 638: roff_name[atok], roff_name[later->tok]);
1.139 schwarze 639:
1.122 schwarze 640: endbody = mdoc_endbody_alloc(mdoc, line, ppos,
1.173 schwarze 641: atok, body);
1.107 schwarze 642:
1.139 schwarze 643: if (tok == MDOC_El)
1.166 schwarze 644: itblk->flags |= NODE_ENDED | NODE_BROKEN;
1.139 schwarze 645:
1.107 schwarze 646: /*
647: * If a block closing macro taking arguments
648: * breaks another block, put the arguments
1.122 schwarze 649: * into the end marker.
1.107 schwarze 650: */
651:
1.122 schwarze 652: if (maxargs)
1.145 schwarze 653: mdoc->next = ROFF_NEXT_CHILD;
1.47 schwarze 654: break;
1.138 schwarze 655: }
656:
1.171 schwarze 657: /*
658: * Explicit blocks close out description lines, but
659: * even those can get broken together with a child.
660: */
1.138 schwarze 661:
662: if (n->tok == MDOC_Nd) {
1.171 schwarze 663: if (later != NULL)
664: n->flags |= NODE_BROKEN | NODE_ENDED;
665: else
666: rew_last(mdoc, n);
1.138 schwarze 667: continue;
1.47 schwarze 668: }
669:
1.139 schwarze 670: /* Breaking an open sub block. */
1.107 schwarze 671:
1.170 schwarze 672: break_intermediate(mdoc->last, body);
1.166 schwarze 673: n->flags |= NODE_BROKEN;
1.139 schwarze 674: if (later == NULL)
1.47 schwarze 675: later = n;
676: }
1.122 schwarze 677:
678: if (body == NULL) {
679: mandoc_msg(MANDOCERR_BLK_NOTOPEN, mdoc->parse,
1.176 schwarze 680: line, ppos, roff_name[tok]);
1.122 schwarze 681: if (maxargs && endbody == NULL) {
682: /*
683: * Stray .Ec without previous .Eo:
684: * Break the output line, keep the arguments.
685: */
1.178 schwarze 686: roff_elem_alloc(mdoc, line, ppos, ROFF_br);
687: rew_elem(mdoc, ROFF_br);
1.122 schwarze 688: }
689: } else if (endbody == NULL) {
690: rew_last(mdoc, body);
691: if (maxargs)
692: mdoc_tail_alloc(mdoc, line, ppos, atok);
693: }
1.47 schwarze 694:
1.182 schwarze 695: if ((mdoc_macro(tok)->flags & MDOC_PARSED) == 0) {
1.106 schwarze 696: if (buf[*pos] != '\0')
1.93 schwarze 697: mandoc_vmsg(MANDOCERR_ARG_SKIP,
698: mdoc->parse, line, ppos,
1.176 schwarze 699: "%s %s", roff_name[tok],
1.93 schwarze 700: buf + *pos);
1.127 schwarze 701: if (endbody == NULL && n != NULL)
1.123 schwarze 702: rew_pending(mdoc, n);
1.107 schwarze 703: return;
1.1 kristaps 704: }
705:
1.122 schwarze 706: if (endbody != NULL)
707: n = endbody;
1.153 schwarze 708:
709: ntok = TOKEN_NONE;
1.104 schwarze 710: for (j = 0; ; j++) {
1.1 kristaps 711: lastarg = *pos;
712:
1.142 schwarze 713: if (j == maxargs && n != NULL)
714: rew_last(mdoc, n);
1.1 kristaps 715:
1.76 schwarze 716: ac = mdoc_args(mdoc, line, pos, buf, tok, &p);
1.106 schwarze 717: if (ac == ARGS_PUNCT || ac == ARGS_EOLN)
1.1 kristaps 718: break;
719:
1.181 schwarze 720: ntok = lookup(mdoc, tok, line, lastarg, p);
1.36 schwarze 721:
1.147 schwarze 722: if (ntok == TOKEN_NONE) {
1.106 schwarze 723: dword(mdoc, line, lastarg, p, DELIM_MAX,
1.182 schwarze 724: mdoc_macro(tok)->flags & MDOC_JOIN);
1.36 schwarze 725: continue;
726: }
1.1 kristaps 727:
1.142 schwarze 728: if (n != NULL)
729: rew_last(mdoc, n);
1.79 schwarze 730: mdoc->flags &= ~MDOC_NEWLINE;
1.182 schwarze 731: (*mdoc_macro(ntok)->fp)(mdoc, ntok, line, lastarg, pos, buf);
1.36 schwarze 732: break;
1.1 kristaps 733: }
734:
1.144 schwarze 735: if (n != NULL) {
1.169 schwarze 736: pending = 0;
1.166 schwarze 737: if (ntok != TOKEN_NONE && n->flags & NODE_BROKEN) {
1.144 schwarze 738: target = n;
739: do
740: target = target->parent;
1.166 schwarze 741: while ( ! (target->flags & NODE_ENDED));
1.172 schwarze 742: pending = find_pending(mdoc, ntok, line, ppos, target);
1.169 schwarze 743: }
1.144 schwarze 744: if ( ! pending)
745: rew_pending(mdoc, n);
746: }
1.106 schwarze 747: if (nl)
748: append_delims(mdoc, line, pos, buf);
1.1 kristaps 749: }
750:
1.107 schwarze 751: static void
1.1 kristaps 752: in_line(MACRO_PROT_ARGS)
753: {
1.100 schwarze 754: int la, scope, cnt, firstarg, mayopen, nc, nl;
1.176 schwarze 755: enum roff_tok ntok;
1.36 schwarze 756: enum margserr ac;
1.40 schwarze 757: enum mdelim d;
1.36 schwarze 758: struct mdoc_arg *arg;
759: char *p;
1.1 kristaps 760:
1.76 schwarze 761: nl = MDOC_NEWLINE & mdoc->flags;
1.37 schwarze 762:
1.1 kristaps 763: /*
764: * Whether we allow ignored elements (those without content,
765: * usually because of reserved words) to squeak by.
766: */
1.32 schwarze 767:
1.1 kristaps 768: switch (tok) {
1.88 schwarze 769: case MDOC_An:
770: case MDOC_Ar:
771: case MDOC_Fl:
772: case MDOC_Mt:
773: case MDOC_Nm:
774: case MDOC_Pa:
1.1 kristaps 775: nc = 1;
776: break;
777: default:
778: nc = 0;
779: break;
780: }
781:
1.108 schwarze 782: mdoc_argv(mdoc, line, tok, &arg, pos, buf);
1.1 kristaps 783:
1.100 schwarze 784: d = DELIM_NONE;
785: firstarg = 1;
1.98 schwarze 786: mayopen = 1;
1.45 schwarze 787: for (cnt = scope = 0;; ) {
1.1 kristaps 788: la = *pos;
1.76 schwarze 789: ac = mdoc_args(mdoc, line, pos, buf, tok, &p);
1.1 kristaps 790:
1.100 schwarze 791: /*
792: * At the end of a macro line,
793: * opening delimiters do not suppress spacing.
794: */
795:
796: if (ac == ARGS_EOLN) {
797: if (d == DELIM_OPEN)
1.166 schwarze 798: mdoc->last->flags &= ~NODE_DELIMO;
1.1 kristaps 799: break;
1.100 schwarze 800: }
801:
802: /*
803: * The rest of the macro line is only punctuation,
804: * to be handled by append_delims().
805: * If there were no other arguments,
806: * do not allow the first one to suppress spacing,
807: * even if it turns out to be a closing one.
808: */
809:
810: if (ac == ARGS_PUNCT) {
1.132 schwarze 811: if (cnt == 0 && (nc == 0 || tok == MDOC_An))
1.100 schwarze 812: mdoc->flags |= MDOC_NODELIMC;
1.1 kristaps 813: break;
1.100 schwarze 814: }
1.1 kristaps 815:
1.181 schwarze 816: ntok = (tok == MDOC_Fn && !cnt) ?
1.147 schwarze 817: TOKEN_NONE : lookup(mdoc, tok, line, la, p);
1.1 kristaps 818:
1.88 schwarze 819: /*
1.1 kristaps 820: * In this case, we've located a submacro and must
821: * execute it. Close out scope, if open. If no
822: * elements have been generated, either create one (nc)
823: * or raise a warning.
824: */
825:
1.147 schwarze 826: if (ntok != TOKEN_NONE) {
1.105 schwarze 827: if (scope)
828: rew_elem(mdoc, tok);
1.106 schwarze 829: if (nc && ! cnt) {
830: mdoc_elem_alloc(mdoc, line, ppos, tok, arg);
1.105 schwarze 831: rew_last(mdoc, mdoc->last);
1.106 schwarze 832: } else if ( ! nc && ! cnt) {
1.1 kristaps 833: mdoc_argv_free(arg);
1.92 schwarze 834: mandoc_msg(MANDOCERR_MACRO_EMPTY,
835: mdoc->parse, line, ppos,
1.176 schwarze 836: roff_name[tok]);
1.1 kristaps 837: }
1.182 schwarze 838: (*mdoc_macro(ntok)->fp)(mdoc, ntok,
839: line, la, pos, buf);
1.106 schwarze 840: if (nl)
841: append_delims(mdoc, line, pos, buf);
1.107 schwarze 842: return;
1.88 schwarze 843: }
1.1 kristaps 844:
1.88 schwarze 845: /*
1.181 schwarze 846: * Handle punctuation. Set up our scope, if a word;
847: * rewind the scope, if a delimiter; then append the word.
1.1 kristaps 848: */
849:
1.181 schwarze 850: if ((d = mdoc_isdelim(p)) != DELIM_NONE) {
1.45 schwarze 851: /*
852: * If we encounter closing punctuation, no word
1.100 schwarze 853: * has been emitted, no scope is open, and we're
1.45 schwarze 854: * allowed to have an empty element, then start
1.98 schwarze 855: * a new scope.
1.45 schwarze 856: */
1.98 schwarze 857: if ((d == DELIM_CLOSE ||
858: (d == DELIM_MIDDLE && tok == MDOC_Fl)) &&
1.100 schwarze 859: !cnt && !scope && nc && mayopen) {
1.106 schwarze 860: mdoc_elem_alloc(mdoc, line, ppos, tok, arg);
1.45 schwarze 861: scope = 1;
1.98 schwarze 862: cnt++;
1.106 schwarze 863: if (tok == MDOC_Nm)
1.98 schwarze 864: mayopen = 0;
1.45 schwarze 865: }
866: /*
867: * Close out our scope, if one is open, before
868: * any punctuation.
869: */
1.181 schwarze 870: if (scope && tok != MDOC_Lk) {
1.105 schwarze 871: rew_elem(mdoc, tok);
1.181 schwarze 872: scope = 0;
873: if (tok == MDOC_Fn)
874: mayopen = 0;
875: }
1.98 schwarze 876: } else if (mayopen && !scope) {
1.106 schwarze 877: mdoc_elem_alloc(mdoc, line, ppos, tok, arg);
1.45 schwarze 878: scope = 1;
1.98 schwarze 879: cnt++;
1.1 kristaps 880: }
1.66 schwarze 881:
1.106 schwarze 882: dword(mdoc, line, la, p, d,
1.182 schwarze 883: mdoc_macro(tok)->flags & MDOC_JOIN);
1.27 schwarze 884:
885: /*
1.100 schwarze 886: * If the first argument is a closing delimiter,
887: * do not suppress spacing before it.
888: */
889:
890: if (firstarg && d == DELIM_CLOSE && !nc)
1.166 schwarze 891: mdoc->last->flags &= ~NODE_DELIMC;
1.100 schwarze 892: firstarg = 0;
893:
894: /*
1.27 schwarze 895: * `Fl' macros have their scope re-opened with each new
896: * word so that the `-' can be added to each one without
897: * having to parse out spaces.
898: */
1.106 schwarze 899: if (scope && tok == MDOC_Fl) {
1.105 schwarze 900: rew_elem(mdoc, tok);
1.45 schwarze 901: scope = 0;
1.27 schwarze 902: }
1.1 kristaps 903: }
904:
1.175 schwarze 905: if (scope && tok != MDOC_Lk) {
1.105 schwarze 906: rew_elem(mdoc, tok);
1.175 schwarze 907: scope = 0;
908: }
1.1 kristaps 909:
910: /*
911: * If no elements have been collected and we're allowed to have
912: * empties (nc), open a scope and close it out. Otherwise,
913: * raise a warning.
914: */
1.32 schwarze 915:
1.106 schwarze 916: if ( ! cnt) {
917: if (nc) {
918: mdoc_elem_alloc(mdoc, line, ppos, tok, arg);
919: rew_last(mdoc, mdoc->last);
920: } else {
921: mdoc_argv_free(arg);
922: mandoc_msg(MANDOCERR_MACRO_EMPTY, mdoc->parse,
1.176 schwarze 923: line, ppos, roff_name[tok]);
1.106 schwarze 924: }
1.1 kristaps 925: }
1.106 schwarze 926: if (nl)
927: append_delims(mdoc, line, pos, buf);
1.175 schwarze 928: if (scope)
929: rew_elem(mdoc, tok);
1.1 kristaps 930: }
931:
1.107 schwarze 932: static void
1.1 kristaps 933: blk_full(MACRO_PROT_ARGS)
934: {
1.109 schwarze 935: int la, nl, parsed;
1.1 kristaps 936: struct mdoc_arg *arg;
1.141 schwarze 937: struct roff_node *blk; /* Our own or a broken block. */
938: struct roff_node *head; /* Our own head. */
939: struct roff_node *body; /* Our own body. */
940: struct roff_node *n;
1.37 schwarze 941: enum margserr ac, lac;
1.1 kristaps 942: char *p;
943:
1.76 schwarze 944: nl = MDOC_NEWLINE & mdoc->flags;
1.95 schwarze 945:
1.133 schwarze 946: if (buf[*pos] == '\0' && (tok == MDOC_Sh || tok == MDOC_Ss)) {
947: mandoc_msg(MANDOCERR_MACRO_EMPTY, mdoc->parse,
1.176 schwarze 948: line, ppos, roff_name[tok]);
1.133 schwarze 949: return;
950: }
951:
1.182 schwarze 952: if ((mdoc_macro(tok)->flags & MDOC_EXPLICIT) == 0) {
1.127 schwarze 953:
954: /* Here, tok is one of Sh Ss Nm Nd It. */
955:
956: blk = NULL;
957: for (n = mdoc->last; n != NULL; n = n->parent) {
1.166 schwarze 958: if (n->flags & NODE_ENDED) {
959: if ( ! (n->flags & NODE_VALID))
960: n->flags |= NODE_BROKEN;
1.139 schwarze 961: continue;
962: }
1.140 schwarze 963: if (n->type != ROFFT_BLOCK)
1.127 schwarze 964: continue;
1.139 schwarze 965:
1.127 schwarze 966: if (tok == MDOC_It && n->tok == MDOC_Bl) {
967: if (blk != NULL) {
968: mandoc_vmsg(MANDOCERR_BLK_BROKEN,
969: mdoc->parse, line, ppos,
970: "It breaks %s",
1.176 schwarze 971: roff_name[blk->tok]);
1.127 schwarze 972: rew_pending(mdoc, blk);
973: }
974: break;
975: }
976:
1.182 schwarze 977: if (mdoc_macro(n->tok)->flags & MDOC_EXPLICIT) {
1.127 schwarze 978: switch (tok) {
979: case MDOC_Sh:
980: case MDOC_Ss:
981: mandoc_vmsg(MANDOCERR_BLK_BROKEN,
982: mdoc->parse, line, ppos,
1.176 schwarze 983: "%s breaks %s", roff_name[tok],
984: roff_name[n->tok]);
1.127 schwarze 985: rew_pending(mdoc, n);
1.136 schwarze 986: n = mdoc->last;
1.127 schwarze 987: continue;
988: case MDOC_It:
989: /* Delay in case it's astray. */
990: blk = n;
991: continue;
992: default:
993: break;
994: }
995: break;
996: }
997:
998: /* Here, n is one of Sh Ss Nm Nd It. */
1.95 schwarze 999:
1.127 schwarze 1000: if (tok != MDOC_Sh && (n->tok == MDOC_Sh ||
1001: (tok != MDOC_Ss && (n->tok == MDOC_Ss ||
1002: (tok != MDOC_It && n->tok == MDOC_It)))))
1.95 schwarze 1003: break;
1.127 schwarze 1004:
1005: /* Item breaking an explicit block. */
1006:
1007: if (blk != NULL) {
1008: mandoc_vmsg(MANDOCERR_BLK_BROKEN,
1009: mdoc->parse, line, ppos,
1.176 schwarze 1010: "It breaks %s", roff_name[blk->tok]);
1.127 schwarze 1011: rew_pending(mdoc, blk);
1.128 schwarze 1012: blk = NULL;
1.127 schwarze 1013: }
1014:
1015: /* Close out prior implicit scopes. */
1016:
1.167 schwarze 1017: rew_pending(mdoc, n);
1.127 schwarze 1018: }
1019:
1020: /* Skip items outside lists. */
1021:
1022: if (tok == MDOC_It && (n == NULL || n->tok != MDOC_Bl)) {
1.95 schwarze 1023: mandoc_vmsg(MANDOCERR_IT_STRAY, mdoc->parse,
1024: line, ppos, "It %s", buf + *pos);
1.178 schwarze 1025: roff_elem_alloc(mdoc, line, ppos, ROFF_br);
1026: rew_elem(mdoc, ROFF_br);
1.107 schwarze 1027: return;
1.95 schwarze 1028: }
1.1 kristaps 1029: }
1030:
1.32 schwarze 1031: /*
1.68 schwarze 1032: * This routine accommodates implicitly- and explicitly-scoped
1.32 schwarze 1033: * macro openings. Implicit ones first close out prior scope
1034: * (seen above). Delay opening the head until necessary to
1035: * allow leading punctuation to print. Special consideration
1036: * for `It -column', which has phrase-part syntax instead of
1037: * regular child nodes.
1038: */
1039:
1.108 schwarze 1040: mdoc_argv(mdoc, line, tok, &arg, pos, buf);
1.121 schwarze 1041: blk = mdoc_block_alloc(mdoc, line, ppos, tok, arg);
1.34 schwarze 1042: head = body = NULL;
1.1 kristaps 1043:
1.32 schwarze 1044: /*
1.73 schwarze 1045: * Exception: Heads of `It' macros in `-diag' lists are not
1046: * parsed, even though `It' macros in general are parsed.
1047: */
1.107 schwarze 1048:
1.109 schwarze 1049: parsed = tok != MDOC_It ||
1050: mdoc->last->parent->tok != MDOC_Bl ||
1051: mdoc->last->parent->norm->Bl.type != LIST_diag;
1.73 schwarze 1052:
1053: /*
1.32 schwarze 1054: * The `Nd' macro has all arguments in its body: it's a hybrid
1055: * of block partial-explicit and full-implicit. Stupid.
1056: */
1.12 schwarze 1057:
1.106 schwarze 1058: if (tok == MDOC_Nd) {
1.146 schwarze 1059: head = roff_head_alloc(mdoc, line, ppos, tok);
1.118 schwarze 1060: rew_last(mdoc, head);
1.146 schwarze 1061: body = roff_body_alloc(mdoc, line, ppos, tok);
1.80 schwarze 1062: }
1063:
1.106 schwarze 1064: if (tok == MDOC_Bk)
1.80 schwarze 1065: mdoc->flags |= MDOC_KEEP;
1.12 schwarze 1066:
1.161 schwarze 1067: ac = ARGS_EOLN;
1.106 schwarze 1068: for (;;) {
1.161 schwarze 1069:
1070: /*
1071: * If we are right after a tab character,
1072: * do not parse the first word for macros.
1073: */
1074:
1075: if (mdoc->flags & MDOC_PHRASEQN) {
1076: mdoc->flags &= ~MDOC_PHRASEQN;
1077: mdoc->flags |= MDOC_PHRASEQF;
1078: }
1079:
1.32 schwarze 1080: la = *pos;
1.106 schwarze 1081: lac = ac;
1.76 schwarze 1082: ac = mdoc_args(mdoc, line, pos, buf, tok, &p);
1.106 schwarze 1083: if (ac == ARGS_EOLN) {
1.161 schwarze 1084: if (lac != ARGS_PHRASE ||
1085: ! (mdoc->flags & MDOC_PHRASEQF))
1.46 schwarze 1086: break;
1.161 schwarze 1087:
1.46 schwarze 1088: /*
1.161 schwarze 1089: * This line ends in a tab; start the next
1090: * column now, with a leading blank.
1.46 schwarze 1091: */
1.161 schwarze 1092:
1.123 schwarze 1093: if (body != NULL)
1094: rew_last(mdoc, body);
1.146 schwarze 1095: body = roff_body_alloc(mdoc, line, ppos, tok);
1.161 schwarze 1096: roff_word_alloc(mdoc, line, ppos, "\\&");
1.1 kristaps 1097: break;
1.41 schwarze 1098: }
1.161 schwarze 1099:
1.130 schwarze 1100: if (tok == MDOC_Bd || tok == MDOC_Bk) {
1101: mandoc_vmsg(MANDOCERR_ARG_EXCESS,
1102: mdoc->parse, line, la, "%s ... %s",
1.176 schwarze 1103: roff_name[tok], buf + la);
1.130 schwarze 1104: break;
1105: }
1.129 schwarze 1106: if (tok == MDOC_Rs) {
1107: mandoc_vmsg(MANDOCERR_ARG_SKIP, mdoc->parse,
1108: line, la, "Rs %s", buf + la);
1109: break;
1110: }
1111: if (ac == ARGS_PUNCT)
1112: break;
1.41 schwarze 1113:
1.88 schwarze 1114: /*
1.46 schwarze 1115: * Emit leading punctuation (i.e., punctuation before
1.140 schwarze 1116: * the ROFFT_HEAD) for non-phrase types.
1.46 schwarze 1117: */
1.32 schwarze 1118:
1.106 schwarze 1119: if (head == NULL &&
1120: ac != ARGS_PHRASE &&
1121: mdoc_isdelim(p) == DELIM_OPEN) {
1122: dword(mdoc, line, la, p, DELIM_OPEN, 0);
1.32 schwarze 1123: continue;
1124: }
1125:
1.46 schwarze 1126: /* Open a head if one hasn't been opened. */
1.32 schwarze 1127:
1.106 schwarze 1128: if (head == NULL)
1.146 schwarze 1129: head = roff_head_alloc(mdoc, line, ppos, tok);
1.32 schwarze 1130:
1.161 schwarze 1131: if (ac == ARGS_PHRASE) {
1.107 schwarze 1132:
1.46 schwarze 1133: /*
1134: * If we haven't opened a body yet, rewind the
1135: * head; if we have, rewind that instead.
1136: */
1137:
1.123 schwarze 1138: rew_last(mdoc, body == NULL ? head : body);
1.146 schwarze 1139: body = roff_body_alloc(mdoc, line, ppos, tok);
1.46 schwarze 1140:
1.161 schwarze 1141: /* Process to the tab or to the end of the line. */
1.46 schwarze 1142:
1.161 schwarze 1143: mdoc->flags |= MDOC_PHRASE;
1.147 schwarze 1144: parse_rest(mdoc, TOKEN_NONE, line, &la, buf);
1.161 schwarze 1145: mdoc->flags &= ~MDOC_PHRASE;
1.160 schwarze 1146:
1147: /* There may have been `Ta' macros. */
1148:
1149: while (body->next != NULL)
1150: body = body->next;
1.1 kristaps 1151: continue;
1152: }
1153:
1.109 schwarze 1154: if (macro_or_word(mdoc, tok, line, la, pos, buf, parsed))
1.107 schwarze 1155: break;
1.32 schwarze 1156: }
1.1 kristaps 1157:
1.166 schwarze 1158: if (blk->flags & NODE_VALID)
1.121 schwarze 1159: return;
1.106 schwarze 1160: if (head == NULL)
1.146 schwarze 1161: head = roff_head_alloc(mdoc, line, ppos, tok);
1.130 schwarze 1162: if (nl && tok != MDOC_Bd && tok != MDOC_Bl && tok != MDOC_Rs)
1.106 schwarze 1163: append_delims(mdoc, line, pos, buf);
1.107 schwarze 1164: if (body != NULL)
1.46 schwarze 1165: goto out;
1.143 schwarze 1166: if (find_pending(mdoc, tok, line, ppos, head))
1.139 schwarze 1167: return;
1.54 schwarze 1168:
1.32 schwarze 1169: /* Close out scopes to remain in a consistent state. */
1.12 schwarze 1170:
1.123 schwarze 1171: rew_last(mdoc, head);
1.146 schwarze 1172: body = roff_body_alloc(mdoc, line, ppos, tok);
1.46 schwarze 1173: out:
1.106 schwarze 1174: if (mdoc->flags & MDOC_FREECOL) {
1.123 schwarze 1175: rew_last(mdoc, body);
1176: rew_last(mdoc, blk);
1.106 schwarze 1177: mdoc->flags &= ~MDOC_FREECOL;
1178: }
1.1 kristaps 1179: }
1180:
1.107 schwarze 1181: static void
1.1 kristaps 1182: blk_part_imp(MACRO_PROT_ARGS)
1183: {
1.43 schwarze 1184: int la, nl;
1.36 schwarze 1185: enum margserr ac;
1.1 kristaps 1186: char *p;
1.141 schwarze 1187: struct roff_node *blk; /* saved block context */
1188: struct roff_node *body; /* saved body context */
1189: struct roff_node *n;
1.1 kristaps 1190:
1.76 schwarze 1191: nl = MDOC_NEWLINE & mdoc->flags;
1.43 schwarze 1192:
1.32 schwarze 1193: /*
1194: * A macro that spans to the end of the line. This is generally
1195: * (but not necessarily) called as the first macro. The block
1196: * has a head as the immediate child, which is always empty,
1197: * followed by zero or more opening punctuation nodes, then the
1198: * body (which may be empty, depending on the macro), then zero
1199: * or more closing punctuation nodes.
1200: */
1.22 schwarze 1201:
1.106 schwarze 1202: blk = mdoc_block_alloc(mdoc, line, ppos, tok, NULL);
1.146 schwarze 1203: rew_last(mdoc, roff_head_alloc(mdoc, line, ppos, tok));
1.1 kristaps 1204:
1.32 schwarze 1205: /*
1206: * Open the body scope "on-demand", that is, after we've
1207: * processed all our the leading delimiters (open parenthesis,
1208: * etc.).
1209: */
1.1 kristaps 1210:
1.32 schwarze 1211: for (body = NULL; ; ) {
1.22 schwarze 1212: la = *pos;
1.76 schwarze 1213: ac = mdoc_args(mdoc, line, pos, buf, tok, &p);
1.106 schwarze 1214: if (ac == ARGS_EOLN || ac == ARGS_PUNCT)
1.1 kristaps 1215: break;
1216:
1.181 schwarze 1217: if (body == NULL && mdoc_isdelim(p) == DELIM_OPEN) {
1.106 schwarze 1218: dword(mdoc, line, la, p, DELIM_OPEN, 0);
1.1 kristaps 1219: continue;
1.80 schwarze 1220: }
1.1 kristaps 1221:
1.106 schwarze 1222: if (body == NULL)
1.146 schwarze 1223: body = roff_body_alloc(mdoc, line, ppos, tok);
1.32 schwarze 1224:
1.109 schwarze 1225: if (macro_or_word(mdoc, tok, line, la, pos, buf, 1))
1.107 schwarze 1226: break;
1.32 schwarze 1227: }
1.106 schwarze 1228: if (body == NULL)
1.146 schwarze 1229: body = roff_body_alloc(mdoc, line, ppos, tok);
1.1 kristaps 1230:
1.143 schwarze 1231: if (find_pending(mdoc, tok, line, ppos, body))
1.139 schwarze 1232: return;
1233:
1.120 schwarze 1234: rew_last(mdoc, body);
1.106 schwarze 1235: if (nl)
1236: append_delims(mdoc, line, pos, buf);
1.122 schwarze 1237: rew_pending(mdoc, blk);
1.74 schwarze 1238:
1239: /* Move trailing .Ns out of scope. */
1240:
1241: for (n = body->child; n && n->next; n = n->next)
1242: /* Do nothing. */ ;
1.106 schwarze 1243: if (n && n->tok == MDOC_Ns)
1.183 ! schwarze 1244: roff_node_relink(mdoc, n);
1.1 kristaps 1245: }
1246:
1.107 schwarze 1247: static void
1.1 kristaps 1248: blk_part_exp(MACRO_PROT_ARGS)
1249: {
1.37 schwarze 1250: int la, nl;
1.36 schwarze 1251: enum margserr ac;
1.141 schwarze 1252: struct roff_node *head; /* keep track of head */
1.1 kristaps 1253: char *p;
1254:
1.76 schwarze 1255: nl = MDOC_NEWLINE & mdoc->flags;
1.37 schwarze 1256:
1.32 schwarze 1257: /*
1258: * The opening of an explicit macro having zero or more leading
1259: * punctuation nodes; a head with optional single element (the
1260: * case of `Eo'); and a body that may be empty.
1261: */
1.22 schwarze 1262:
1.149 schwarze 1263: roff_block_alloc(mdoc, line, ppos, tok);
1.119 schwarze 1264: head = NULL;
1265: for (;;) {
1.22 schwarze 1266: la = *pos;
1.76 schwarze 1267: ac = mdoc_args(mdoc, line, pos, buf, tok, &p);
1.106 schwarze 1268: if (ac == ARGS_PUNCT || ac == ARGS_EOLN)
1.1 kristaps 1269: break;
1270:
1.32 schwarze 1271: /* Flush out leading punctuation. */
1272:
1.181 schwarze 1273: if (head == NULL && mdoc_isdelim(p) == DELIM_OPEN) {
1.106 schwarze 1274: dword(mdoc, line, la, p, DELIM_OPEN, 0);
1.32 schwarze 1275: continue;
1.80 schwarze 1276: }
1.32 schwarze 1277:
1.106 schwarze 1278: if (head == NULL) {
1.146 schwarze 1279: head = roff_head_alloc(mdoc, line, ppos, tok);
1.119 schwarze 1280: if (tok == MDOC_Eo) /* Not parsed. */
1.106 schwarze 1281: dword(mdoc, line, la, p, DELIM_MAX, 0);
1.119 schwarze 1282: rew_last(mdoc, head);
1.146 schwarze 1283: roff_body_alloc(mdoc, line, ppos, tok);
1.106 schwarze 1284: if (tok == MDOC_Eo)
1.32 schwarze 1285: continue;
1286: }
1287:
1.109 schwarze 1288: if (macro_or_word(mdoc, tok, line, la, pos, buf, 1))
1.107 schwarze 1289: break;
1.1 kristaps 1290: }
1291:
1.32 schwarze 1292: /* Clean-up to leave in a consistent state. */
1293:
1.119 schwarze 1294: if (head == NULL) {
1.146 schwarze 1295: rew_last(mdoc, roff_head_alloc(mdoc, line, ppos, tok));
1296: roff_body_alloc(mdoc, line, ppos, tok);
1.1 kristaps 1297: }
1.106 schwarze 1298: if (nl)
1299: append_delims(mdoc, line, pos, buf);
1.1 kristaps 1300: }
1301:
1.107 schwarze 1302: static void
1.1 kristaps 1303: in_line_argn(MACRO_PROT_ARGS)
1304: {
1.36 schwarze 1305: struct mdoc_arg *arg;
1306: char *p;
1.137 schwarze 1307: enum margserr ac;
1.176 schwarze 1308: enum roff_tok ntok;
1.137 schwarze 1309: int state; /* arg#; -1: not yet open; -2: closed */
1310: int la, maxargs, nl;
1.1 kristaps 1311:
1.112 schwarze 1312: nl = mdoc->flags & MDOC_NEWLINE;
1.37 schwarze 1313:
1.32 schwarze 1314: /*
1315: * A line macro that has a fixed number of arguments (maxargs).
1316: * Only open the scope once the first non-leading-punctuation is
1317: * found (unless MDOC_IGNDELIM is noted, like in `Pf'), then
1318: * keep it open until the maximum number of arguments are
1319: * exhausted.
1320: */
1.1 kristaps 1321:
1322: switch (tok) {
1.88 schwarze 1323: case MDOC_Ap:
1324: case MDOC_Ns:
1325: case MDOC_Ux:
1.1 kristaps 1326: maxargs = 0;
1327: break;
1.88 schwarze 1328: case MDOC_Bx:
1.89 schwarze 1329: case MDOC_Es:
1.88 schwarze 1330: case MDOC_Xr:
1.28 schwarze 1331: maxargs = 2;
1332: break;
1.1 kristaps 1333: default:
1334: maxargs = 1;
1335: break;
1336: }
1337:
1.108 schwarze 1338: mdoc_argv(mdoc, line, tok, &arg, pos, buf);
1.1 kristaps 1339:
1.137 schwarze 1340: state = -1;
1.112 schwarze 1341: p = NULL;
1342: for (;;) {
1.22 schwarze 1343: la = *pos;
1.76 schwarze 1344: ac = mdoc_args(mdoc, line, pos, buf, tok, &p);
1.137 schwarze 1345:
1346: if (ac == ARGS_WORD && state == -1 &&
1.182 schwarze 1347: (mdoc_macro(tok)->flags & MDOC_IGNDELIM) == 0 &&
1.137 schwarze 1348: mdoc_isdelim(p) == DELIM_OPEN) {
1349: dword(mdoc, line, la, p, DELIM_OPEN, 0);
1350: continue;
1351: }
1352:
1353: if (state == -1 && tok != MDOC_In &&
1354: tok != MDOC_St && tok != MDOC_Xr) {
1355: mdoc_elem_alloc(mdoc, line, ppos, tok, arg);
1356: state = 0;
1357: }
1358:
1.112 schwarze 1359: if (ac == ARGS_PUNCT || ac == ARGS_EOLN) {
1.137 schwarze 1360: if (abs(state) < 2 && tok == MDOC_Pf)
1.112 schwarze 1361: mandoc_vmsg(MANDOCERR_PF_SKIP,
1362: mdoc->parse, line, ppos, "Pf %s",
1363: p == NULL ? "at eol" : p);
1.1 kristaps 1364: break;
1.112 schwarze 1365: }
1.1 kristaps 1366:
1.137 schwarze 1367: if (state == maxargs) {
1.105 schwarze 1368: rew_elem(mdoc, tok);
1.137 schwarze 1369: state = -2;
1.32 schwarze 1370: }
1371:
1.181 schwarze 1372: ntok = (tok == MDOC_Pf && state == 0) ?
1.147 schwarze 1373: TOKEN_NONE : lookup(mdoc, tok, line, la, p);
1.36 schwarze 1374:
1.147 schwarze 1375: if (ntok != TOKEN_NONE) {
1.137 schwarze 1376: if (state >= 0) {
1.105 schwarze 1377: rew_elem(mdoc, tok);
1.137 schwarze 1378: state = -2;
1379: }
1.182 schwarze 1380: (*mdoc_macro(ntok)->fp)(mdoc, ntok,
1381: line, la, pos, buf);
1.1 kristaps 1382: break;
1383: }
1384:
1.182 schwarze 1385: if (mdoc_macro(tok)->flags & MDOC_IGNDELIM ||
1.137 schwarze 1386: mdoc_isdelim(p) == DELIM_NONE) {
1387: if (state == -1) {
1388: mdoc_elem_alloc(mdoc, line, ppos, tok, arg);
1389: state = 1;
1390: } else if (state >= 0)
1391: state++;
1392: } else if (state >= 0) {
1.105 schwarze 1393: rew_elem(mdoc, tok);
1.137 schwarze 1394: state = -2;
1.28 schwarze 1395: }
1396:
1.106 schwarze 1397: dword(mdoc, line, la, p, DELIM_MAX,
1.182 schwarze 1398: mdoc_macro(tok)->flags & MDOC_JOIN);
1.1 kristaps 1399: }
1400:
1.137 schwarze 1401: if (state == -1) {
1402: mandoc_msg(MANDOCERR_MACRO_EMPTY, mdoc->parse,
1.176 schwarze 1403: line, ppos, roff_name[tok]);
1.137 schwarze 1404: return;
1.112 schwarze 1405: }
1.137 schwarze 1406:
1407: if (state == 0 && tok == MDOC_Pf)
1408: append_delims(mdoc, line, pos, buf);
1409: if (state >= 0)
1.105 schwarze 1410: rew_elem(mdoc, tok);
1.106 schwarze 1411: if (nl)
1412: append_delims(mdoc, line, pos, buf);
1.1 kristaps 1413: }
1414:
1.107 schwarze 1415: static void
1.1 kristaps 1416: in_line_eoln(MACRO_PROT_ARGS)
1417: {
1.141 schwarze 1418: struct roff_node *n;
1.126 schwarze 1419: struct mdoc_arg *arg;
1.1 kristaps 1420:
1.126 schwarze 1421: if ((tok == MDOC_Pp || tok == MDOC_Lp) &&
1422: ! (mdoc->flags & MDOC_SYNOPSIS)) {
1423: n = mdoc->last;
1.145 schwarze 1424: if (mdoc->next == ROFF_NEXT_SIBLING)
1.126 schwarze 1425: n = n->parent;
1426: if (n->tok == MDOC_Nm)
1.154 schwarze 1427: rew_last(mdoc, n->parent);
1.134 schwarze 1428: }
1429:
1.135 schwarze 1430: if (buf[*pos] == '\0' &&
1.176 schwarze 1431: (tok == MDOC_Fd || *roff_name[tok] == '%')) {
1.134 schwarze 1432: mandoc_msg(MANDOCERR_MACRO_EMPTY, mdoc->parse,
1.176 schwarze 1433: line, ppos, roff_name[tok]);
1.134 schwarze 1434: return;
1.126 schwarze 1435: }
1.53 schwarze 1436:
1.108 schwarze 1437: mdoc_argv(mdoc, line, tok, &arg, pos, buf);
1.106 schwarze 1438: mdoc_elem_alloc(mdoc, line, ppos, tok, arg);
1.110 schwarze 1439: if (parse_rest(mdoc, tok, line, pos, buf))
1440: return;
1441: rew_elem(mdoc, tok);
1442: }
1443:
1444: /*
1445: * The simplest argument parser available: Parse the remaining
1446: * words until the end of the phrase or line and return 0
1447: * or until the next macro, call that macro, and return 1.
1448: */
1449: static int
1.176 schwarze 1450: parse_rest(struct roff_man *mdoc, enum roff_tok tok,
1451: int line, int *pos, char *buf)
1.110 schwarze 1452: {
1453: int la;
1.1 kristaps 1454:
1455: for (;;) {
1456: la = *pos;
1.109 schwarze 1457: if (mdoc_args(mdoc, line, pos, buf, tok, NULL) == ARGS_EOLN)
1.158 schwarze 1458: return 0;
1.109 schwarze 1459: if (macro_or_word(mdoc, tok, line, la, pos, buf, 1))
1.158 schwarze 1460: return 1;
1.1 kristaps 1461: }
1.28 schwarze 1462: }
1463:
1.107 schwarze 1464: static void
1.28 schwarze 1465: ctx_synopsis(MACRO_PROT_ARGS)
1466: {
1.37 schwarze 1467:
1.107 schwarze 1468: if (~mdoc->flags & (MDOC_SYNOPSIS | MDOC_NEWLINE))
1469: in_line(mdoc, tok, line, ppos, pos, buf);
1470: else if (tok == MDOC_Nm)
1471: blk_full(mdoc, tok, line, ppos, pos, buf);
1472: else {
1473: assert(tok == MDOC_Vt);
1474: blk_part_imp(mdoc, tok, line, ppos, pos, buf);
1475: }
1.1 kristaps 1476: }
1477:
1.17 schwarze 1478: /*
1479: * Phrases occur within `Bl -column' entries, separated by `Ta' or tabs.
1480: * They're unusual because they're basically free-form text until a
1481: * macro is encountered.
1482: */
1.107 schwarze 1483: static void
1.46 schwarze 1484: phrase_ta(MACRO_PROT_ARGS)
1485: {
1.141 schwarze 1486: struct roff_node *body, *n;
1.46 schwarze 1487:
1.78 schwarze 1488: /* Make sure we are in a column list or ignore this macro. */
1.107 schwarze 1489:
1.123 schwarze 1490: body = NULL;
1491: for (n = mdoc->last; n != NULL; n = n->parent) {
1.166 schwarze 1492: if (n->flags & NODE_ENDED)
1.123 schwarze 1493: continue;
1.140 schwarze 1494: if (n->tok == MDOC_It && n->type == ROFFT_BODY)
1.123 schwarze 1495: body = n;
1.164 schwarze 1496: if (n->tok == MDOC_Bl && n->end == ENDBODY_NOT)
1.123 schwarze 1497: break;
1498: }
1499:
1.107 schwarze 1500: if (n == NULL || n->norm->Bl.type != LIST_column) {
1.94 schwarze 1501: mandoc_msg(MANDOCERR_TA_STRAY, mdoc->parse,
1.96 schwarze 1502: line, ppos, "Ta");
1.107 schwarze 1503: return;
1.78 schwarze 1504: }
1.46 schwarze 1505:
1.78 schwarze 1506: /* Advance to the next column. */
1.106 schwarze 1507:
1.123 schwarze 1508: rew_last(mdoc, body);
1.146 schwarze 1509: roff_body_alloc(mdoc, line, ppos, MDOC_It);
1.147 schwarze 1510: parse_rest(mdoc, TOKEN_NONE, line, pos, buf);
1.46 schwarze 1511: }