8322 nl: misleading-indentation
[unleashed/tickless.git] / usr / src / cmd / mandoc / roff.c
blob13b9439e4df92b49062efcfe1e636e6ea328521e
1 /* $Id: roff.c,v 1.284 2016/01/08 17:48:10 schwarze Exp $ */
2 /*
3 * Copyright (c) 2008-2012, 2014 Kristaps Dzonsons <kristaps@bsd.lv>
4 * Copyright (c) 2010-2015 Ingo Schwarze <schwarze@openbsd.org>
6 * Permission to use, copy, modify, and distribute this software for any
7 * purpose with or without fee is hereby granted, provided that the above
8 * copyright notice and this permission notice appear in all copies.
10 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHORS DISCLAIM ALL WARRANTIES
11 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR
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.
18 #include "config.h"
20 #include <sys/types.h>
22 #include <assert.h>
23 #include <ctype.h>
24 #include <limits.h>
25 #include <stdio.h>
26 #include <stdlib.h>
27 #include <string.h>
29 #include "mandoc.h"
30 #include "mandoc_aux.h"
31 #include "roff.h"
32 #include "libmandoc.h"
33 #include "roff_int.h"
34 #include "libroff.h"
36 /* Maximum number of string expansions per line, to break infinite loops. */
37 #define EXPAND_LIMIT 1000
39 /* --- data types --------------------------------------------------------- */
41 enum rofft {
42 ROFF_ab,
43 ROFF_ad,
44 ROFF_af,
45 ROFF_aln,
46 ROFF_als,
47 ROFF_am,
48 ROFF_am1,
49 ROFF_ami,
50 ROFF_ami1,
51 ROFF_as,
52 ROFF_as1,
53 ROFF_asciify,
54 ROFF_backtrace,
55 ROFF_bd,
56 ROFF_bleedat,
57 ROFF_blm,
58 ROFF_box,
59 ROFF_boxa,
60 ROFF_bp,
61 ROFF_BP,
62 /* MAN_br, MDOC_br */
63 ROFF_break,
64 ROFF_breakchar,
65 ROFF_brnl,
66 ROFF_brp,
67 ROFF_brpnl,
68 ROFF_c2,
69 ROFF_cc,
70 ROFF_ce,
71 ROFF_cf,
72 ROFF_cflags,
73 ROFF_ch,
74 ROFF_char,
75 ROFF_chop,
76 ROFF_class,
77 ROFF_close,
78 ROFF_CL,
79 ROFF_color,
80 ROFF_composite,
81 ROFF_continue,
82 ROFF_cp,
83 ROFF_cropat,
84 ROFF_cs,
85 ROFF_cu,
86 ROFF_da,
87 ROFF_dch,
88 ROFF_Dd,
89 ROFF_de,
90 ROFF_de1,
91 ROFF_defcolor,
92 ROFF_dei,
93 ROFF_dei1,
94 ROFF_device,
95 ROFF_devicem,
96 ROFF_di,
97 ROFF_do,
98 ROFF_ds,
99 ROFF_ds1,
100 ROFF_dwh,
101 ROFF_dt,
102 ROFF_ec,
103 ROFF_ecr,
104 ROFF_ecs,
105 ROFF_el,
106 ROFF_em,
107 ROFF_EN,
108 ROFF_eo,
109 ROFF_EP,
110 ROFF_EQ,
111 ROFF_errprint,
112 ROFF_ev,
113 ROFF_evc,
114 ROFF_ex,
115 ROFF_fallback,
116 ROFF_fam,
117 ROFF_fc,
118 ROFF_fchar,
119 ROFF_fcolor,
120 ROFF_fdeferlig,
121 ROFF_feature,
122 /* MAN_fi; ignored in mdoc(7) */
123 ROFF_fkern,
124 ROFF_fl,
125 ROFF_flig,
126 ROFF_fp,
127 ROFF_fps,
128 ROFF_fschar,
129 ROFF_fspacewidth,
130 ROFF_fspecial,
131 /* MAN_ft; ignored in mdoc(7) */
132 ROFF_ftr,
133 ROFF_fzoom,
134 ROFF_gcolor,
135 ROFF_hc,
136 ROFF_hcode,
137 ROFF_hidechar,
138 ROFF_hla,
139 ROFF_hlm,
140 ROFF_hpf,
141 ROFF_hpfa,
142 ROFF_hpfcode,
143 ROFF_hw,
144 ROFF_hy,
145 ROFF_hylang,
146 ROFF_hylen,
147 ROFF_hym,
148 ROFF_hypp,
149 ROFF_hys,
150 ROFF_ie,
151 ROFF_if,
152 ROFF_ig,
153 /* MAN_in; ignored in mdoc(7) */
154 ROFF_index,
155 ROFF_it,
156 ROFF_itc,
157 ROFF_IX,
158 ROFF_kern,
159 ROFF_kernafter,
160 ROFF_kernbefore,
161 ROFF_kernpair,
162 ROFF_lc,
163 ROFF_lc_ctype,
164 ROFF_lds,
165 ROFF_length,
166 ROFF_letadj,
167 ROFF_lf,
168 ROFF_lg,
169 ROFF_lhang,
170 ROFF_linetabs,
171 /* MAN_ll, MDOC_ll */
172 ROFF_lnr,
173 ROFF_lnrf,
174 ROFF_lpfx,
175 ROFF_ls,
176 ROFF_lsm,
177 ROFF_lt,
178 ROFF_mc,
179 ROFF_mediasize,
180 ROFF_minss,
181 ROFF_mk,
182 ROFF_mso,
183 ROFF_na,
184 ROFF_ne,
185 /* MAN_nf; ignored in mdoc(7) */
186 ROFF_nh,
187 ROFF_nhychar,
188 ROFF_nm,
189 ROFF_nn,
190 ROFF_nop,
191 ROFF_nr,
192 ROFF_nrf,
193 ROFF_nroff,
194 ROFF_ns,
195 ROFF_nx,
196 ROFF_open,
197 ROFF_opena,
198 ROFF_os,
199 ROFF_output,
200 ROFF_padj,
201 ROFF_papersize,
202 ROFF_pc,
203 ROFF_pev,
204 ROFF_pi,
205 ROFF_PI,
206 ROFF_pl,
207 ROFF_pm,
208 ROFF_pn,
209 ROFF_pnr,
210 ROFF_po,
211 ROFF_ps,
212 ROFF_psbb,
213 ROFF_pshape,
214 ROFF_pso,
215 ROFF_ptr,
216 ROFF_pvs,
217 ROFF_rchar,
218 ROFF_rd,
219 ROFF_recursionlimit,
220 ROFF_return,
221 ROFF_rfschar,
222 ROFF_rhang,
223 ROFF_rj,
224 ROFF_rm,
225 ROFF_rn,
226 ROFF_rnn,
227 ROFF_rr,
228 ROFF_rs,
229 ROFF_rt,
230 ROFF_schar,
231 ROFF_sentchar,
232 ROFF_shc,
233 ROFF_shift,
234 ROFF_sizes,
235 ROFF_so,
236 /* MAN_sp, MDOC_sp */
237 ROFF_spacewidth,
238 ROFF_special,
239 ROFF_spreadwarn,
240 ROFF_ss,
241 ROFF_sty,
242 ROFF_substring,
243 ROFF_sv,
244 ROFF_sy,
245 ROFF_T_,
246 ROFF_ta,
247 ROFF_tc,
248 ROFF_TE,
249 ROFF_TH,
250 ROFF_ti,
251 ROFF_tkf,
252 ROFF_tl,
253 ROFF_tm,
254 ROFF_tm1,
255 ROFF_tmc,
256 ROFF_tr,
257 ROFF_track,
258 ROFF_transchar,
259 ROFF_trf,
260 ROFF_trimat,
261 ROFF_trin,
262 ROFF_trnt,
263 ROFF_troff,
264 ROFF_TS,
265 ROFF_uf,
266 ROFF_ul,
267 ROFF_unformat,
268 ROFF_unwatch,
269 ROFF_unwatchn,
270 ROFF_vpt,
271 ROFF_vs,
272 ROFF_warn,
273 ROFF_warnscale,
274 ROFF_watch,
275 ROFF_watchlength,
276 ROFF_watchn,
277 ROFF_wh,
278 ROFF_while,
279 ROFF_write,
280 ROFF_writec,
281 ROFF_writem,
282 ROFF_xflag,
283 ROFF_cblock,
284 ROFF_USERDEF,
285 ROFF_MAX
289 * An incredibly-simple string buffer.
291 struct roffstr {
292 char *p; /* nil-terminated buffer */
293 size_t sz; /* saved strlen(p) */
297 * A key-value roffstr pair as part of a singly-linked list.
299 struct roffkv {
300 struct roffstr key;
301 struct roffstr val;
302 struct roffkv *next; /* next in list */
306 * A single number register as part of a singly-linked list.
308 struct roffreg {
309 struct roffstr key;
310 int val;
311 struct roffreg *next;
314 struct roff {
315 struct mparse *parse; /* parse point */
316 struct roffnode *last; /* leaf of stack */
317 int *rstack; /* stack of inverted `ie' values */
318 struct roffreg *regtab; /* number registers */
319 struct roffkv *strtab; /* user-defined strings & macros */
320 struct roffkv *xmbtab; /* multi-byte trans table (`tr') */
321 struct roffstr *xtab; /* single-byte trans table (`tr') */
322 const char *current_string; /* value of last called user macro */
323 struct tbl_node *first_tbl; /* first table parsed */
324 struct tbl_node *last_tbl; /* last table parsed */
325 struct tbl_node *tbl; /* current table being parsed */
326 struct eqn_node *last_eqn; /* last equation parsed */
327 struct eqn_node *first_eqn; /* first equation parsed */
328 struct eqn_node *eqn; /* current equation being parsed */
329 int eqn_inline; /* current equation is inline */
330 int options; /* parse options */
331 int rstacksz; /* current size limit of rstack */
332 int rstackpos; /* position in rstack */
333 int format; /* current file in mdoc or man format */
334 int argc; /* number of args of the last macro */
335 char control; /* control character */
338 struct roffnode {
339 enum rofft tok; /* type of node */
340 struct roffnode *parent; /* up one in stack */
341 int line; /* parse line */
342 int col; /* parse col */
343 char *name; /* node name, e.g. macro name */
344 char *end; /* end-rules: custom token */
345 int endspan; /* end-rules: next-line or infty */
346 int rule; /* current evaluation rule */
349 #define ROFF_ARGS struct roff *r, /* parse ctx */ \
350 enum rofft tok, /* tok of macro */ \
351 struct buf *buf, /* input buffer */ \
352 int ln, /* parse line */ \
353 int ppos, /* original pos in buffer */ \
354 int pos, /* current pos in buffer */ \
355 int *offs /* reset offset of buffer data */
357 typedef enum rofferr (*roffproc)(ROFF_ARGS);
359 struct roffmac {
360 const char *name; /* macro name */
361 roffproc proc; /* process new macro */
362 roffproc text; /* process as child text of macro */
363 roffproc sub; /* process as child of macro */
364 int flags;
365 #define ROFFMAC_STRUCT (1 << 0) /* always interpret */
366 struct roffmac *next;
369 struct predef {
370 const char *name; /* predefined input name */
371 const char *str; /* replacement symbol */
374 #define PREDEF(__name, __str) \
375 { (__name), (__str) },
377 /* --- function prototypes ------------------------------------------------ */
379 static enum rofft roffhash_find(const char *, size_t);
380 static void roffhash_init(void);
381 static void roffnode_cleanscope(struct roff *);
382 static void roffnode_pop(struct roff *);
383 static void roffnode_push(struct roff *, enum rofft,
384 const char *, int, int);
385 static enum rofferr roff_block(ROFF_ARGS);
386 static enum rofferr roff_block_text(ROFF_ARGS);
387 static enum rofferr roff_block_sub(ROFF_ARGS);
388 static enum rofferr roff_brp(ROFF_ARGS);
389 static enum rofferr roff_cblock(ROFF_ARGS);
390 static enum rofferr roff_cc(ROFF_ARGS);
391 static void roff_ccond(struct roff *, int, int);
392 static enum rofferr roff_cond(ROFF_ARGS);
393 static enum rofferr roff_cond_text(ROFF_ARGS);
394 static enum rofferr roff_cond_sub(ROFF_ARGS);
395 static enum rofferr roff_ds(ROFF_ARGS);
396 static enum rofferr roff_eqndelim(struct roff *, struct buf *, int);
397 static int roff_evalcond(struct roff *r, int, char *, int *);
398 static int roff_evalnum(struct roff *, int,
399 const char *, int *, int *, int);
400 static int roff_evalpar(struct roff *, int,
401 const char *, int *, int *, int);
402 static int roff_evalstrcond(const char *, int *);
403 static void roff_free1(struct roff *);
404 static void roff_freereg(struct roffreg *);
405 static void roff_freestr(struct roffkv *);
406 static size_t roff_getname(struct roff *, char **, int, int);
407 static int roff_getnum(const char *, int *, int *, int);
408 static int roff_getop(const char *, int *, char *);
409 static int roff_getregn(const struct roff *,
410 const char *, size_t);
411 static int roff_getregro(const struct roff *,
412 const char *name);
413 static const char *roff_getstrn(const struct roff *,
414 const char *, size_t);
415 static int roff_hasregn(const struct roff *,
416 const char *, size_t);
417 static enum rofferr roff_insec(ROFF_ARGS);
418 static enum rofferr roff_it(ROFF_ARGS);
419 static enum rofferr roff_line_ignore(ROFF_ARGS);
420 static void roff_man_alloc1(struct roff_man *);
421 static void roff_man_free1(struct roff_man *);
422 static enum rofferr roff_nr(ROFF_ARGS);
423 static enum rofft roff_parse(struct roff *, char *, int *,
424 int, int);
425 static enum rofferr roff_parsetext(struct buf *, int, int *);
426 static enum rofferr roff_res(struct roff *, struct buf *, int, int);
427 static enum rofferr roff_rm(ROFF_ARGS);
428 static enum rofferr roff_rr(ROFF_ARGS);
429 static void roff_setstr(struct roff *,
430 const char *, const char *, int);
431 static void roff_setstrn(struct roffkv **, const char *,
432 size_t, const char *, size_t, int);
433 static enum rofferr roff_so(ROFF_ARGS);
434 static enum rofferr roff_tr(ROFF_ARGS);
435 static enum rofferr roff_Dd(ROFF_ARGS);
436 static enum rofferr roff_TH(ROFF_ARGS);
437 static enum rofferr roff_TE(ROFF_ARGS);
438 static enum rofferr roff_TS(ROFF_ARGS);
439 static enum rofferr roff_EQ(ROFF_ARGS);
440 static enum rofferr roff_EN(ROFF_ARGS);
441 static enum rofferr roff_T_(ROFF_ARGS);
442 static enum rofferr roff_unsupp(ROFF_ARGS);
443 static enum rofferr roff_userdef(ROFF_ARGS);
445 /* --- constant data ------------------------------------------------------ */
447 /* See roffhash_find() */
449 #define ASCII_HI 126
450 #define ASCII_LO 33
451 #define HASHWIDTH (ASCII_HI - ASCII_LO + 1)
453 #define ROFFNUM_SCALE (1 << 0) /* Honour scaling in roff_getnum(). */
454 #define ROFFNUM_WHITE (1 << 1) /* Skip whitespace in roff_evalnum(). */
456 static struct roffmac *hash[HASHWIDTH];
458 static struct roffmac roffs[ROFF_MAX] = {
459 { "ab", roff_unsupp, NULL, NULL, 0, NULL },
460 { "ad", roff_line_ignore, NULL, NULL, 0, NULL },
461 { "af", roff_line_ignore, NULL, NULL, 0, NULL },
462 { "aln", roff_unsupp, NULL, NULL, 0, NULL },
463 { "als", roff_unsupp, NULL, NULL, 0, NULL },
464 { "am", roff_block, roff_block_text, roff_block_sub, 0, NULL },
465 { "am1", roff_block, roff_block_text, roff_block_sub, 0, NULL },
466 { "ami", roff_block, roff_block_text, roff_block_sub, 0, NULL },
467 { "ami1", roff_block, roff_block_text, roff_block_sub, 0, NULL },
468 { "as", roff_ds, NULL, NULL, 0, NULL },
469 { "as1", roff_ds, NULL, NULL, 0, NULL },
470 { "asciify", roff_unsupp, NULL, NULL, 0, NULL },
471 { "backtrace", roff_line_ignore, NULL, NULL, 0, NULL },
472 { "bd", roff_line_ignore, NULL, NULL, 0, NULL },
473 { "bleedat", roff_line_ignore, NULL, NULL, 0, NULL },
474 { "blm", roff_unsupp, NULL, NULL, 0, NULL },
475 { "box", roff_unsupp, NULL, NULL, 0, NULL },
476 { "boxa", roff_unsupp, NULL, NULL, 0, NULL },
477 { "bp", roff_line_ignore, NULL, NULL, 0, NULL },
478 { "BP", roff_unsupp, NULL, NULL, 0, NULL },
479 { "break", roff_unsupp, NULL, NULL, 0, NULL },
480 { "breakchar", roff_line_ignore, NULL, NULL, 0, NULL },
481 { "brnl", roff_line_ignore, NULL, NULL, 0, NULL },
482 { "brp", roff_brp, NULL, NULL, 0, NULL },
483 { "brpnl", roff_line_ignore, NULL, NULL, 0, NULL },
484 { "c2", roff_unsupp, NULL, NULL, 0, NULL },
485 { "cc", roff_cc, NULL, NULL, 0, NULL },
486 { "ce", roff_line_ignore, NULL, NULL, 0, NULL },
487 { "cf", roff_insec, NULL, NULL, 0, NULL },
488 { "cflags", roff_line_ignore, NULL, NULL, 0, NULL },
489 { "ch", roff_line_ignore, NULL, NULL, 0, NULL },
490 { "char", roff_unsupp, NULL, NULL, 0, NULL },
491 { "chop", roff_unsupp, NULL, NULL, 0, NULL },
492 { "class", roff_line_ignore, NULL, NULL, 0, NULL },
493 { "close", roff_insec, NULL, NULL, 0, NULL },
494 { "CL", roff_unsupp, NULL, NULL, 0, NULL },
495 { "color", roff_line_ignore, NULL, NULL, 0, NULL },
496 { "composite", roff_unsupp, NULL, NULL, 0, NULL },
497 { "continue", roff_unsupp, NULL, NULL, 0, NULL },
498 { "cp", roff_line_ignore, NULL, NULL, 0, NULL },
499 { "cropat", roff_line_ignore, NULL, NULL, 0, NULL },
500 { "cs", roff_line_ignore, NULL, NULL, 0, NULL },
501 { "cu", roff_line_ignore, NULL, NULL, 0, NULL },
502 { "da", roff_unsupp, NULL, NULL, 0, NULL },
503 { "dch", roff_unsupp, NULL, NULL, 0, NULL },
504 { "Dd", roff_Dd, NULL, NULL, 0, NULL },
505 { "de", roff_block, roff_block_text, roff_block_sub, 0, NULL },
506 { "de1", roff_block, roff_block_text, roff_block_sub, 0, NULL },
507 { "defcolor", roff_line_ignore, NULL, NULL, 0, NULL },
508 { "dei", roff_block, roff_block_text, roff_block_sub, 0, NULL },
509 { "dei1", roff_block, roff_block_text, roff_block_sub, 0, NULL },
510 { "device", roff_unsupp, NULL, NULL, 0, NULL },
511 { "devicem", roff_unsupp, NULL, NULL, 0, NULL },
512 { "di", roff_unsupp, NULL, NULL, 0, NULL },
513 { "do", roff_unsupp, NULL, NULL, 0, NULL },
514 { "ds", roff_ds, NULL, NULL, 0, NULL },
515 { "ds1", roff_ds, NULL, NULL, 0, NULL },
516 { "dwh", roff_unsupp, NULL, NULL, 0, NULL },
517 { "dt", roff_unsupp, NULL, NULL, 0, NULL },
518 { "ec", roff_unsupp, NULL, NULL, 0, NULL },
519 { "ecr", roff_unsupp, NULL, NULL, 0, NULL },
520 { "ecs", roff_unsupp, NULL, NULL, 0, NULL },
521 { "el", roff_cond, roff_cond_text, roff_cond_sub, ROFFMAC_STRUCT, NULL },
522 { "em", roff_unsupp, NULL, NULL, 0, NULL },
523 { "EN", roff_EN, NULL, NULL, 0, NULL },
524 { "eo", roff_unsupp, NULL, NULL, 0, NULL },
525 { "EP", roff_unsupp, NULL, NULL, 0, NULL },
526 { "EQ", roff_EQ, NULL, NULL, 0, NULL },
527 { "errprint", roff_line_ignore, NULL, NULL, 0, NULL },
528 { "ev", roff_unsupp, NULL, NULL, 0, NULL },
529 { "evc", roff_unsupp, NULL, NULL, 0, NULL },
530 { "ex", roff_unsupp, NULL, NULL, 0, NULL },
531 { "fallback", roff_line_ignore, NULL, NULL, 0, NULL },
532 { "fam", roff_line_ignore, NULL, NULL, 0, NULL },
533 { "fc", roff_unsupp, NULL, NULL, 0, NULL },
534 { "fchar", roff_unsupp, NULL, NULL, 0, NULL },
535 { "fcolor", roff_line_ignore, NULL, NULL, 0, NULL },
536 { "fdeferlig", roff_line_ignore, NULL, NULL, 0, NULL },
537 { "feature", roff_line_ignore, NULL, NULL, 0, NULL },
538 { "fkern", roff_line_ignore, NULL, NULL, 0, NULL },
539 { "fl", roff_line_ignore, NULL, NULL, 0, NULL },
540 { "flig", roff_line_ignore, NULL, NULL, 0, NULL },
541 { "fp", roff_line_ignore, NULL, NULL, 0, NULL },
542 { "fps", roff_line_ignore, NULL, NULL, 0, NULL },
543 { "fschar", roff_unsupp, NULL, NULL, 0, NULL },
544 { "fspacewidth", roff_line_ignore, NULL, NULL, 0, NULL },
545 { "fspecial", roff_line_ignore, NULL, NULL, 0, NULL },
546 { "ftr", roff_line_ignore, NULL, NULL, 0, NULL },
547 { "fzoom", roff_line_ignore, NULL, NULL, 0, NULL },
548 { "gcolor", roff_line_ignore, NULL, NULL, 0, NULL },
549 { "hc", roff_line_ignore, NULL, NULL, 0, NULL },
550 { "hcode", roff_line_ignore, NULL, NULL, 0, NULL },
551 { "hidechar", roff_line_ignore, NULL, NULL, 0, NULL },
552 { "hla", roff_line_ignore, NULL, NULL, 0, NULL },
553 { "hlm", roff_line_ignore, NULL, NULL, 0, NULL },
554 { "hpf", roff_line_ignore, NULL, NULL, 0, NULL },
555 { "hpfa", roff_line_ignore, NULL, NULL, 0, NULL },
556 { "hpfcode", roff_line_ignore, NULL, NULL, 0, NULL },
557 { "hw", roff_line_ignore, NULL, NULL, 0, NULL },
558 { "hy", roff_line_ignore, NULL, NULL, 0, NULL },
559 { "hylang", roff_line_ignore, NULL, NULL, 0, NULL },
560 { "hylen", roff_line_ignore, NULL, NULL, 0, NULL },
561 { "hym", roff_line_ignore, NULL, NULL, 0, NULL },
562 { "hypp", roff_line_ignore, NULL, NULL, 0, NULL },
563 { "hys", roff_line_ignore, NULL, NULL, 0, NULL },
564 { "ie", roff_cond, roff_cond_text, roff_cond_sub, ROFFMAC_STRUCT, NULL },
565 { "if", roff_cond, roff_cond_text, roff_cond_sub, ROFFMAC_STRUCT, NULL },
566 { "ig", roff_block, roff_block_text, roff_block_sub, 0, NULL },
567 { "index", roff_unsupp, NULL, NULL, 0, NULL },
568 { "it", roff_it, NULL, NULL, 0, NULL },
569 { "itc", roff_unsupp, NULL, NULL, 0, NULL },
570 { "IX", roff_line_ignore, NULL, NULL, 0, NULL },
571 { "kern", roff_line_ignore, NULL, NULL, 0, NULL },
572 { "kernafter", roff_line_ignore, NULL, NULL, 0, NULL },
573 { "kernbefore", roff_line_ignore, NULL, NULL, 0, NULL },
574 { "kernpair", roff_line_ignore, NULL, NULL, 0, NULL },
575 { "lc", roff_unsupp, NULL, NULL, 0, NULL },
576 { "lc_ctype", roff_unsupp, NULL, NULL, 0, NULL },
577 { "lds", roff_unsupp, NULL, NULL, 0, NULL },
578 { "length", roff_unsupp, NULL, NULL, 0, NULL },
579 { "letadj", roff_line_ignore, NULL, NULL, 0, NULL },
580 { "lf", roff_insec, NULL, NULL, 0, NULL },
581 { "lg", roff_line_ignore, NULL, NULL, 0, NULL },
582 { "lhang", roff_line_ignore, NULL, NULL, 0, NULL },
583 { "linetabs", roff_unsupp, NULL, NULL, 0, NULL },
584 { "lnr", roff_unsupp, NULL, NULL, 0, NULL },
585 { "lnrf", roff_unsupp, NULL, NULL, 0, NULL },
586 { "lpfx", roff_unsupp, NULL, NULL, 0, NULL },
587 { "ls", roff_line_ignore, NULL, NULL, 0, NULL },
588 { "lsm", roff_unsupp, NULL, NULL, 0, NULL },
589 { "lt", roff_line_ignore, NULL, NULL, 0, NULL },
590 { "mc", roff_line_ignore, NULL, NULL, 0, NULL },
591 { "mediasize", roff_line_ignore, NULL, NULL, 0, NULL },
592 { "minss", roff_line_ignore, NULL, NULL, 0, NULL },
593 { "mk", roff_line_ignore, NULL, NULL, 0, NULL },
594 { "mso", roff_insec, NULL, NULL, 0, NULL },
595 { "na", roff_line_ignore, NULL, NULL, 0, NULL },
596 { "ne", roff_line_ignore, NULL, NULL, 0, NULL },
597 { "nh", roff_line_ignore, NULL, NULL, 0, NULL },
598 { "nhychar", roff_line_ignore, NULL, NULL, 0, NULL },
599 { "nm", roff_unsupp, NULL, NULL, 0, NULL },
600 { "nn", roff_unsupp, NULL, NULL, 0, NULL },
601 { "nop", roff_unsupp, NULL, NULL, 0, NULL },
602 { "nr", roff_nr, NULL, NULL, 0, NULL },
603 { "nrf", roff_unsupp, NULL, NULL, 0, NULL },
604 { "nroff", roff_line_ignore, NULL, NULL, 0, NULL },
605 { "ns", roff_line_ignore, NULL, NULL, 0, NULL },
606 { "nx", roff_insec, NULL, NULL, 0, NULL },
607 { "open", roff_insec, NULL, NULL, 0, NULL },
608 { "opena", roff_insec, NULL, NULL, 0, NULL },
609 { "os", roff_line_ignore, NULL, NULL, 0, NULL },
610 { "output", roff_unsupp, NULL, NULL, 0, NULL },
611 { "padj", roff_line_ignore, NULL, NULL, 0, NULL },
612 { "papersize", roff_line_ignore, NULL, NULL, 0, NULL },
613 { "pc", roff_line_ignore, NULL, NULL, 0, NULL },
614 { "pev", roff_line_ignore, NULL, NULL, 0, NULL },
615 { "pi", roff_insec, NULL, NULL, 0, NULL },
616 { "PI", roff_unsupp, NULL, NULL, 0, NULL },
617 { "pl", roff_line_ignore, NULL, NULL, 0, NULL },
618 { "pm", roff_line_ignore, NULL, NULL, 0, NULL },
619 { "pn", roff_line_ignore, NULL, NULL, 0, NULL },
620 { "pnr", roff_line_ignore, NULL, NULL, 0, NULL },
621 { "po", roff_line_ignore, NULL, NULL, 0, NULL },
622 { "ps", roff_line_ignore, NULL, NULL, 0, NULL },
623 { "psbb", roff_unsupp, NULL, NULL, 0, NULL },
624 { "pshape", roff_unsupp, NULL, NULL, 0, NULL },
625 { "pso", roff_insec, NULL, NULL, 0, NULL },
626 { "ptr", roff_line_ignore, NULL, NULL, 0, NULL },
627 { "pvs", roff_line_ignore, NULL, NULL, 0, NULL },
628 { "rchar", roff_unsupp, NULL, NULL, 0, NULL },
629 { "rd", roff_line_ignore, NULL, NULL, 0, NULL },
630 { "recursionlimit", roff_line_ignore, NULL, NULL, 0, NULL },
631 { "return", roff_unsupp, NULL, NULL, 0, NULL },
632 { "rfschar", roff_unsupp, NULL, NULL, 0, NULL },
633 { "rhang", roff_line_ignore, NULL, NULL, 0, NULL },
634 { "rj", roff_line_ignore, NULL, NULL, 0, NULL },
635 { "rm", roff_rm, NULL, NULL, 0, NULL },
636 { "rn", roff_unsupp, NULL, NULL, 0, NULL },
637 { "rnn", roff_unsupp, NULL, NULL, 0, NULL },
638 { "rr", roff_rr, NULL, NULL, 0, NULL },
639 { "rs", roff_line_ignore, NULL, NULL, 0, NULL },
640 { "rt", roff_line_ignore, NULL, NULL, 0, NULL },
641 { "schar", roff_unsupp, NULL, NULL, 0, NULL },
642 { "sentchar", roff_line_ignore, NULL, NULL, 0, NULL },
643 { "shc", roff_line_ignore, NULL, NULL, 0, NULL },
644 { "shift", roff_unsupp, NULL, NULL, 0, NULL },
645 { "sizes", roff_line_ignore, NULL, NULL, 0, NULL },
646 { "so", roff_so, NULL, NULL, 0, NULL },
647 { "spacewidth", roff_line_ignore, NULL, NULL, 0, NULL },
648 { "special", roff_line_ignore, NULL, NULL, 0, NULL },
649 { "spreadwarn", roff_line_ignore, NULL, NULL, 0, NULL },
650 { "ss", roff_line_ignore, NULL, NULL, 0, NULL },
651 { "sty", roff_line_ignore, NULL, NULL, 0, NULL },
652 { "substring", roff_unsupp, NULL, NULL, 0, NULL },
653 { "sv", roff_line_ignore, NULL, NULL, 0, NULL },
654 { "sy", roff_insec, NULL, NULL, 0, NULL },
655 { "T&", roff_T_, NULL, NULL, 0, NULL },
656 { "ta", roff_unsupp, NULL, NULL, 0, NULL },
657 { "tc", roff_unsupp, NULL, NULL, 0, NULL },
658 { "TE", roff_TE, NULL, NULL, 0, NULL },
659 { "TH", roff_TH, NULL, NULL, 0, NULL },
660 { "ti", roff_unsupp, NULL, NULL, 0, NULL },
661 { "tkf", roff_line_ignore, NULL, NULL, 0, NULL },
662 { "tl", roff_unsupp, NULL, NULL, 0, NULL },
663 { "tm", roff_line_ignore, NULL, NULL, 0, NULL },
664 { "tm1", roff_line_ignore, NULL, NULL, 0, NULL },
665 { "tmc", roff_line_ignore, NULL, NULL, 0, NULL },
666 { "tr", roff_tr, NULL, NULL, 0, NULL },
667 { "track", roff_line_ignore, NULL, NULL, 0, NULL },
668 { "transchar", roff_line_ignore, NULL, NULL, 0, NULL },
669 { "trf", roff_insec, NULL, NULL, 0, NULL },
670 { "trimat", roff_line_ignore, NULL, NULL, 0, NULL },
671 { "trin", roff_unsupp, NULL, NULL, 0, NULL },
672 { "trnt", roff_unsupp, NULL, NULL, 0, NULL },
673 { "troff", roff_line_ignore, NULL, NULL, 0, NULL },
674 { "TS", roff_TS, NULL, NULL, 0, NULL },
675 { "uf", roff_line_ignore, NULL, NULL, 0, NULL },
676 { "ul", roff_line_ignore, NULL, NULL, 0, NULL },
677 { "unformat", roff_unsupp, NULL, NULL, 0, NULL },
678 { "unwatch", roff_line_ignore, NULL, NULL, 0, NULL },
679 { "unwatchn", roff_line_ignore, NULL, NULL, 0, NULL },
680 { "vpt", roff_line_ignore, NULL, NULL, 0, NULL },
681 { "vs", roff_line_ignore, NULL, NULL, 0, NULL },
682 { "warn", roff_line_ignore, NULL, NULL, 0, NULL },
683 { "warnscale", roff_line_ignore, NULL, NULL, 0, NULL },
684 { "watch", roff_line_ignore, NULL, NULL, 0, NULL },
685 { "watchlength", roff_line_ignore, NULL, NULL, 0, NULL },
686 { "watchn", roff_line_ignore, NULL, NULL, 0, NULL },
687 { "wh", roff_unsupp, NULL, NULL, 0, NULL },
688 { "while", roff_unsupp, NULL, NULL, 0, NULL },
689 { "write", roff_insec, NULL, NULL, 0, NULL },
690 { "writec", roff_insec, NULL, NULL, 0, NULL },
691 { "writem", roff_insec, NULL, NULL, 0, NULL },
692 { "xflag", roff_line_ignore, NULL, NULL, 0, NULL },
693 { ".", roff_cblock, NULL, NULL, 0, NULL },
694 { NULL, roff_userdef, NULL, NULL, 0, NULL },
697 /* not currently implemented: Ds em Eq LP Me PP pp Or Rd Sf SH */
698 const char *const __mdoc_reserved[] = {
699 "Ac", "Ad", "An", "Ao", "Ap", "Aq", "Ar", "At",
700 "Bc", "Bd", "Bf", "Bk", "Bl", "Bo", "Bq",
701 "Brc", "Bro", "Brq", "Bsx", "Bt", "Bx",
702 "Cd", "Cm", "Db", "Dc", "Dd", "Dl", "Do", "Dq",
703 "Dt", "Dv", "Dx", "D1",
704 "Ec", "Ed", "Ef", "Ek", "El", "Em",
705 "En", "Eo", "Er", "Es", "Ev", "Ex",
706 "Fa", "Fc", "Fd", "Fl", "Fn", "Fo", "Fr", "Ft", "Fx",
707 "Hf", "Ic", "In", "It", "Lb", "Li", "Lk", "Lp",
708 "Ms", "Mt", "Nd", "Nm", "No", "Ns", "Nx",
709 "Oc", "Oo", "Op", "Os", "Ot", "Ox",
710 "Pa", "Pc", "Pf", "Po", "Pp", "Pq",
711 "Qc", "Ql", "Qo", "Qq", "Re", "Rs", "Rv",
712 "Sc", "Sh", "Sm", "So", "Sq",
713 "Ss", "St", "Sx", "Sy",
714 "Ta", "Tn", "Ud", "Ux", "Va", "Vt", "Xc", "Xo", "Xr",
715 "%A", "%B", "%C", "%D", "%I", "%J", "%N", "%O",
716 "%P", "%Q", "%R", "%T", "%U", "%V",
717 NULL
720 /* not currently implemented: BT DE DS ME MT PT SY TQ YS */
721 const char *const __man_reserved[] = {
722 "AT", "B", "BI", "BR", "DT",
723 "EE", "EN", "EQ", "EX", "HP", "I", "IB", "IP", "IR",
724 "LP", "OP", "P", "PD", "PP",
725 "R", "RB", "RE", "RI", "RS", "SB", "SH", "SM", "SS",
726 "TE", "TH", "TP", "TS", "T&", "UC", "UE", "UR",
727 NULL
730 /* Array of injected predefined strings. */
731 #define PREDEFS_MAX 38
732 static const struct predef predefs[PREDEFS_MAX] = {
733 #include "predefs.in"
736 /* See roffhash_find() */
737 #define ROFF_HASH(p) (p[0] - ASCII_LO)
739 static int roffit_lines; /* number of lines to delay */
740 static char *roffit_macro; /* nil-terminated macro line */
743 /* --- request table ------------------------------------------------------ */
745 static void
746 roffhash_init(void)
748 struct roffmac *n;
749 int buc, i;
751 for (i = 0; i < (int)ROFF_USERDEF; i++) {
752 assert(roffs[i].name[0] >= ASCII_LO);
753 assert(roffs[i].name[0] <= ASCII_HI);
755 buc = ROFF_HASH(roffs[i].name);
757 if (NULL != (n = hash[buc])) {
758 for ( ; n->next; n = n->next)
759 /* Do nothing. */ ;
760 n->next = &roffs[i];
761 } else
762 hash[buc] = &roffs[i];
767 * Look up a roff token by its name. Returns ROFF_MAX if no macro by
768 * the nil-terminated string name could be found.
770 static enum rofft
771 roffhash_find(const char *p, size_t s)
773 int buc;
774 struct roffmac *n;
777 * libroff has an extremely simple hashtable, for the time
778 * being, which simply keys on the first character, which must
779 * be printable, then walks a chain. It works well enough until
780 * optimised.
783 if (p[0] < ASCII_LO || p[0] > ASCII_HI)
784 return ROFF_MAX;
786 buc = ROFF_HASH(p);
788 if (NULL == (n = hash[buc]))
789 return ROFF_MAX;
790 for ( ; n; n = n->next)
791 if (0 == strncmp(n->name, p, s) && '\0' == n->name[(int)s])
792 return (enum rofft)(n - roffs);
794 return ROFF_MAX;
797 /* --- stack of request blocks -------------------------------------------- */
800 * Pop the current node off of the stack of roff instructions currently
801 * pending.
803 static void
804 roffnode_pop(struct roff *r)
806 struct roffnode *p;
808 assert(r->last);
809 p = r->last;
811 r->last = r->last->parent;
812 free(p->name);
813 free(p->end);
814 free(p);
818 * Push a roff node onto the instruction stack. This must later be
819 * removed with roffnode_pop().
821 static void
822 roffnode_push(struct roff *r, enum rofft tok, const char *name,
823 int line, int col)
825 struct roffnode *p;
827 p = mandoc_calloc(1, sizeof(struct roffnode));
828 p->tok = tok;
829 if (name)
830 p->name = mandoc_strdup(name);
831 p->parent = r->last;
832 p->line = line;
833 p->col = col;
834 p->rule = p->parent ? p->parent->rule : 0;
836 r->last = p;
839 /* --- roff parser state data management ---------------------------------- */
841 static void
842 roff_free1(struct roff *r)
844 struct tbl_node *tbl;
845 struct eqn_node *e;
846 int i;
848 while (NULL != (tbl = r->first_tbl)) {
849 r->first_tbl = tbl->next;
850 tbl_free(tbl);
852 r->first_tbl = r->last_tbl = r->tbl = NULL;
854 while (NULL != (e = r->first_eqn)) {
855 r->first_eqn = e->next;
856 eqn_free(e);
858 r->first_eqn = r->last_eqn = r->eqn = NULL;
860 while (r->last)
861 roffnode_pop(r);
863 free (r->rstack);
864 r->rstack = NULL;
865 r->rstacksz = 0;
866 r->rstackpos = -1;
868 roff_freereg(r->regtab);
869 r->regtab = NULL;
871 roff_freestr(r->strtab);
872 roff_freestr(r->xmbtab);
873 r->strtab = r->xmbtab = NULL;
875 if (r->xtab)
876 for (i = 0; i < 128; i++)
877 free(r->xtab[i].p);
878 free(r->xtab);
879 r->xtab = NULL;
882 void
883 roff_reset(struct roff *r)
886 roff_free1(r);
887 r->format = r->options & (MPARSE_MDOC | MPARSE_MAN);
888 r->control = 0;
891 void
892 roff_free(struct roff *r)
895 roff_free1(r);
896 free(r);
899 struct roff *
900 roff_alloc(struct mparse *parse, int options)
902 struct roff *r;
904 r = mandoc_calloc(1, sizeof(struct roff));
905 r->parse = parse;
906 r->options = options;
907 r->format = options & (MPARSE_MDOC | MPARSE_MAN);
908 r->rstackpos = -1;
910 roffhash_init();
912 return r;
915 /* --- syntax tree state data management ---------------------------------- */
917 static void
918 roff_man_free1(struct roff_man *man)
921 if (man->first != NULL)
922 roff_node_delete(man, man->first);
923 free(man->meta.msec);
924 free(man->meta.vol);
925 free(man->meta.os);
926 free(man->meta.arch);
927 free(man->meta.title);
928 free(man->meta.name);
929 free(man->meta.date);
932 static void
933 roff_man_alloc1(struct roff_man *man)
936 memset(&man->meta, 0, sizeof(man->meta));
937 man->first = mandoc_calloc(1, sizeof(*man->first));
938 man->first->type = ROFFT_ROOT;
939 man->last = man->first;
940 man->last_es = NULL;
941 man->flags = 0;
942 man->macroset = MACROSET_NONE;
943 man->lastsec = man->lastnamed = SEC_NONE;
944 man->next = ROFF_NEXT_CHILD;
947 void
948 roff_man_reset(struct roff_man *man)
951 roff_man_free1(man);
952 roff_man_alloc1(man);
955 void
956 roff_man_free(struct roff_man *man)
959 roff_man_free1(man);
960 free(man);
963 struct roff_man *
964 roff_man_alloc(struct roff *roff, struct mparse *parse,
965 const char *defos, int quick)
967 struct roff_man *man;
969 man = mandoc_calloc(1, sizeof(*man));
970 man->parse = parse;
971 man->roff = roff;
972 man->defos = defos;
973 man->quick = quick;
974 roff_man_alloc1(man);
975 return man;
978 /* --- syntax tree handling ----------------------------------------------- */
980 struct roff_node *
981 roff_node_alloc(struct roff_man *man, int line, int pos,
982 enum roff_type type, int tok)
984 struct roff_node *n;
986 n = mandoc_calloc(1, sizeof(*n));
987 n->line = line;
988 n->pos = pos;
989 n->tok = tok;
990 n->type = type;
991 n->sec = man->lastsec;
993 if (man->flags & MDOC_SYNOPSIS)
994 n->flags |= MDOC_SYNPRETTY;
995 else
996 n->flags &= ~MDOC_SYNPRETTY;
997 if (man->flags & MDOC_NEWLINE)
998 n->flags |= MDOC_LINE;
999 man->flags &= ~MDOC_NEWLINE;
1001 return n;
1004 void
1005 roff_node_append(struct roff_man *man, struct roff_node *n)
1008 switch (man->next) {
1009 case ROFF_NEXT_SIBLING:
1010 if (man->last->next != NULL) {
1011 n->next = man->last->next;
1012 man->last->next->prev = n;
1013 } else
1014 man->last->parent->last = n;
1015 man->last->next = n;
1016 n->prev = man->last;
1017 n->parent = man->last->parent;
1018 break;
1019 case ROFF_NEXT_CHILD:
1020 man->last->child = n;
1021 n->parent = man->last;
1022 n->parent->last = n;
1023 break;
1024 default:
1025 abort();
1027 man->last = n;
1029 switch (n->type) {
1030 case ROFFT_HEAD:
1031 n->parent->head = n;
1032 break;
1033 case ROFFT_BODY:
1034 if (n->end != ENDBODY_NOT)
1035 return;
1036 n->parent->body = n;
1037 break;
1038 case ROFFT_TAIL:
1039 n->parent->tail = n;
1040 break;
1041 default:
1042 return;
1046 * Copy over the normalised-data pointer of our parent. Not
1047 * everybody has one, but copying a null pointer is fine.
1050 n->norm = n->parent->norm;
1051 assert(n->parent->type == ROFFT_BLOCK);
1054 void
1055 roff_word_alloc(struct roff_man *man, int line, int pos, const char *word)
1057 struct roff_node *n;
1059 n = roff_node_alloc(man, line, pos, ROFFT_TEXT, TOKEN_NONE);
1060 n->string = roff_strdup(man->roff, word);
1061 roff_node_append(man, n);
1062 if (man->macroset == MACROSET_MDOC)
1063 n->flags |= MDOC_VALID | MDOC_ENDED;
1064 else
1065 n->flags |= MAN_VALID;
1066 man->next = ROFF_NEXT_SIBLING;
1069 void
1070 roff_word_append(struct roff_man *man, const char *word)
1072 struct roff_node *n;
1073 char *addstr, *newstr;
1075 n = man->last;
1076 addstr = roff_strdup(man->roff, word);
1077 mandoc_asprintf(&newstr, "%s %s", n->string, addstr);
1078 free(addstr);
1079 free(n->string);
1080 n->string = newstr;
1081 man->next = ROFF_NEXT_SIBLING;
1084 void
1085 roff_elem_alloc(struct roff_man *man, int line, int pos, int tok)
1087 struct roff_node *n;
1089 n = roff_node_alloc(man, line, pos, ROFFT_ELEM, tok);
1090 roff_node_append(man, n);
1091 man->next = ROFF_NEXT_CHILD;
1094 struct roff_node *
1095 roff_block_alloc(struct roff_man *man, int line, int pos, int tok)
1097 struct roff_node *n;
1099 n = roff_node_alloc(man, line, pos, ROFFT_BLOCK, tok);
1100 roff_node_append(man, n);
1101 man->next = ROFF_NEXT_CHILD;
1102 return n;
1105 struct roff_node *
1106 roff_head_alloc(struct roff_man *man, int line, int pos, int tok)
1108 struct roff_node *n;
1110 n = roff_node_alloc(man, line, pos, ROFFT_HEAD, tok);
1111 roff_node_append(man, n);
1112 man->next = ROFF_NEXT_CHILD;
1113 return n;
1116 struct roff_node *
1117 roff_body_alloc(struct roff_man *man, int line, int pos, int tok)
1119 struct roff_node *n;
1121 n = roff_node_alloc(man, line, pos, ROFFT_BODY, tok);
1122 roff_node_append(man, n);
1123 man->next = ROFF_NEXT_CHILD;
1124 return n;
1127 void
1128 roff_addeqn(struct roff_man *man, const struct eqn *eqn)
1130 struct roff_node *n;
1132 n = roff_node_alloc(man, eqn->ln, eqn->pos, ROFFT_EQN, TOKEN_NONE);
1133 n->eqn = eqn;
1134 if (eqn->ln > man->last->line)
1135 n->flags |= MDOC_LINE;
1136 roff_node_append(man, n);
1137 man->next = ROFF_NEXT_SIBLING;
1140 void
1141 roff_addtbl(struct roff_man *man, const struct tbl_span *tbl)
1143 struct roff_node *n;
1145 if (man->macroset == MACROSET_MAN)
1146 man_breakscope(man, TOKEN_NONE);
1147 n = roff_node_alloc(man, tbl->line, 0, ROFFT_TBL, TOKEN_NONE);
1148 n->span = tbl;
1149 roff_node_append(man, n);
1150 if (man->macroset == MACROSET_MDOC)
1151 n->flags |= MDOC_VALID | MDOC_ENDED;
1152 else
1153 n->flags |= MAN_VALID;
1154 man->next = ROFF_NEXT_SIBLING;
1157 void
1158 roff_node_unlink(struct roff_man *man, struct roff_node *n)
1161 /* Adjust siblings. */
1163 if (n->prev)
1164 n->prev->next = n->next;
1165 if (n->next)
1166 n->next->prev = n->prev;
1168 /* Adjust parent. */
1170 if (n->parent != NULL) {
1171 if (n->parent->child == n)
1172 n->parent->child = n->next;
1173 if (n->parent->last == n)
1174 n->parent->last = n->prev;
1177 /* Adjust parse point. */
1179 if (man == NULL)
1180 return;
1181 if (man->last == n) {
1182 if (n->prev == NULL) {
1183 man->last = n->parent;
1184 man->next = ROFF_NEXT_CHILD;
1185 } else {
1186 man->last = n->prev;
1187 man->next = ROFF_NEXT_SIBLING;
1190 if (man->first == n)
1191 man->first = NULL;
1194 void
1195 roff_node_free(struct roff_node *n)
1198 if (n->args != NULL)
1199 mdoc_argv_free(n->args);
1200 if (n->type == ROFFT_BLOCK || n->type == ROFFT_ELEM)
1201 free(n->norm);
1202 free(n->string);
1203 free(n);
1206 void
1207 roff_node_delete(struct roff_man *man, struct roff_node *n)
1210 while (n->child != NULL)
1211 roff_node_delete(man, n->child);
1212 roff_node_unlink(man, n);
1213 roff_node_free(n);
1216 void
1217 deroff(char **dest, const struct roff_node *n)
1219 char *cp;
1220 size_t sz;
1222 if (n->type != ROFFT_TEXT) {
1223 for (n = n->child; n != NULL; n = n->next)
1224 deroff(dest, n);
1225 return;
1228 /* Skip leading whitespace and escape sequences. */
1230 cp = n->string;
1231 while (*cp != '\0') {
1232 if ('\\' == *cp) {
1233 cp++;
1234 mandoc_escape((const char **)&cp, NULL, NULL);
1235 } else if (isspace((unsigned char)*cp))
1236 cp++;
1237 else
1238 break;
1241 /* Skip trailing whitespace. */
1243 for (sz = strlen(cp); sz; sz--)
1244 if ( ! isspace((unsigned char)cp[sz-1]))
1245 break;
1247 /* Skip empty strings. */
1249 if (sz == 0)
1250 return;
1252 if (*dest == NULL) {
1253 *dest = mandoc_strndup(cp, sz);
1254 return;
1257 mandoc_asprintf(&cp, "%s %*s", *dest, (int)sz, cp);
1258 free(*dest);
1259 *dest = cp;
1262 /* --- main functions of the roff parser ---------------------------------- */
1265 * In the current line, expand escape sequences that tend to get
1266 * used in numerical expressions and conditional requests.
1267 * Also check the syntax of the remaining escape sequences.
1269 static enum rofferr
1270 roff_res(struct roff *r, struct buf *buf, int ln, int pos)
1272 char ubuf[24]; /* buffer to print the number */
1273 const char *start; /* start of the string to process */
1274 char *stesc; /* start of an escape sequence ('\\') */
1275 const char *stnam; /* start of the name, after "[(*" */
1276 const char *cp; /* end of the name, e.g. before ']' */
1277 const char *res; /* the string to be substituted */
1278 char *nbuf; /* new buffer to copy buf->buf to */
1279 size_t maxl; /* expected length of the escape name */
1280 size_t naml; /* actual length of the escape name */
1281 enum mandoc_esc esc; /* type of the escape sequence */
1282 int inaml; /* length returned from mandoc_escape() */
1283 int expand_count; /* to avoid infinite loops */
1284 int npos; /* position in numeric expression */
1285 int arg_complete; /* argument not interrupted by eol */
1286 char term; /* character terminating the escape */
1288 expand_count = 0;
1289 start = buf->buf + pos;
1290 stesc = strchr(start, '\0') - 1;
1291 while (stesc-- > start) {
1293 /* Search backwards for the next backslash. */
1295 if (*stesc != '\\')
1296 continue;
1298 /* If it is escaped, skip it. */
1300 for (cp = stesc - 1; cp >= start; cp--)
1301 if (*cp != '\\')
1302 break;
1304 if ((stesc - cp) % 2 == 0) {
1305 stesc = (char *)cp;
1306 continue;
1309 /* Decide whether to expand or to check only. */
1311 term = '\0';
1312 cp = stesc + 1;
1313 switch (*cp) {
1314 case '*':
1315 res = NULL;
1316 break;
1317 case 'B':
1318 case 'w':
1319 term = cp[1];
1320 /* FALLTHROUGH */
1321 case 'n':
1322 res = ubuf;
1323 break;
1324 default:
1325 esc = mandoc_escape(&cp, &stnam, &inaml);
1326 if (esc == ESCAPE_ERROR ||
1327 (esc == ESCAPE_SPECIAL &&
1328 mchars_spec2cp(stnam, inaml) < 0))
1329 mandoc_vmsg(MANDOCERR_ESC_BAD,
1330 r->parse, ln, (int)(stesc - buf->buf),
1331 "%.*s", (int)(cp - stesc), stesc);
1332 continue;
1335 if (EXPAND_LIMIT < ++expand_count) {
1336 mandoc_msg(MANDOCERR_ROFFLOOP, r->parse,
1337 ln, (int)(stesc - buf->buf), NULL);
1338 return ROFF_IGN;
1342 * The third character decides the length
1343 * of the name of the string or register.
1344 * Save a pointer to the name.
1347 if (term == '\0') {
1348 switch (*++cp) {
1349 case '\0':
1350 maxl = 0;
1351 break;
1352 case '(':
1353 cp++;
1354 maxl = 2;
1355 break;
1356 case '[':
1357 cp++;
1358 term = ']';
1359 maxl = 0;
1360 break;
1361 default:
1362 maxl = 1;
1363 break;
1365 } else {
1366 cp += 2;
1367 maxl = 0;
1369 stnam = cp;
1371 /* Advance to the end of the name. */
1373 naml = 0;
1374 arg_complete = 1;
1375 while (maxl == 0 || naml < maxl) {
1376 if (*cp == '\0') {
1377 mandoc_msg(MANDOCERR_ESC_BAD, r->parse,
1378 ln, (int)(stesc - buf->buf), stesc);
1379 arg_complete = 0;
1380 break;
1382 if (maxl == 0 && *cp == term) {
1383 cp++;
1384 break;
1386 if (*cp++ != '\\' || stesc[1] != 'w') {
1387 naml++;
1388 continue;
1390 switch (mandoc_escape(&cp, NULL, NULL)) {
1391 case ESCAPE_SPECIAL:
1392 case ESCAPE_UNICODE:
1393 case ESCAPE_NUMBERED:
1394 case ESCAPE_OVERSTRIKE:
1395 naml++;
1396 break;
1397 default:
1398 break;
1403 * Retrieve the replacement string; if it is
1404 * undefined, resume searching for escapes.
1407 switch (stesc[1]) {
1408 case '*':
1409 if (arg_complete)
1410 res = roff_getstrn(r, stnam, naml);
1411 break;
1412 case 'B':
1413 npos = 0;
1414 ubuf[0] = arg_complete &&
1415 roff_evalnum(r, ln, stnam, &npos,
1416 NULL, ROFFNUM_SCALE) &&
1417 stnam + npos + 1 == cp ? '1' : '0';
1418 ubuf[1] = '\0';
1419 break;
1420 case 'n':
1421 if (arg_complete)
1422 (void)snprintf(ubuf, sizeof(ubuf), "%d",
1423 roff_getregn(r, stnam, naml));
1424 else
1425 ubuf[0] = '\0';
1426 break;
1427 case 'w':
1428 /* use even incomplete args */
1429 (void)snprintf(ubuf, sizeof(ubuf), "%d",
1430 24 * (int)naml);
1431 break;
1434 if (res == NULL) {
1435 mandoc_vmsg(MANDOCERR_STR_UNDEF,
1436 r->parse, ln, (int)(stesc - buf->buf),
1437 "%.*s", (int)naml, stnam);
1438 res = "";
1439 } else if (buf->sz + strlen(res) > SHRT_MAX) {
1440 mandoc_msg(MANDOCERR_ROFFLOOP, r->parse,
1441 ln, (int)(stesc - buf->buf), NULL);
1442 return ROFF_IGN;
1445 /* Replace the escape sequence by the string. */
1447 *stesc = '\0';
1448 buf->sz = mandoc_asprintf(&nbuf, "%s%s%s",
1449 buf->buf, res, cp) + 1;
1451 /* Prepare for the next replacement. */
1453 start = nbuf + pos;
1454 stesc = nbuf + (stesc - buf->buf) + strlen(res);
1455 free(buf->buf);
1456 buf->buf = nbuf;
1458 return ROFF_CONT;
1462 * Process text streams.
1464 static enum rofferr
1465 roff_parsetext(struct buf *buf, int pos, int *offs)
1467 size_t sz;
1468 const char *start;
1469 char *p;
1470 int isz;
1471 enum mandoc_esc esc;
1473 /* Spring the input line trap. */
1475 if (roffit_lines == 1) {
1476 isz = mandoc_asprintf(&p, "%s\n.%s", buf->buf, roffit_macro);
1477 free(buf->buf);
1478 buf->buf = p;
1479 buf->sz = isz + 1;
1480 *offs = 0;
1481 free(roffit_macro);
1482 roffit_lines = 0;
1483 return ROFF_REPARSE;
1484 } else if (roffit_lines > 1)
1485 --roffit_lines;
1487 /* Convert all breakable hyphens into ASCII_HYPH. */
1489 start = p = buf->buf + pos;
1491 while (*p != '\0') {
1492 sz = strcspn(p, "-\\");
1493 p += sz;
1495 if (*p == '\0')
1496 break;
1498 if (*p == '\\') {
1499 /* Skip over escapes. */
1500 p++;
1501 esc = mandoc_escape((const char **)&p, NULL, NULL);
1502 if (esc == ESCAPE_ERROR)
1503 break;
1504 while (*p == '-')
1505 p++;
1506 continue;
1507 } else if (p == start) {
1508 p++;
1509 continue;
1512 if (isalpha((unsigned char)p[-1]) &&
1513 isalpha((unsigned char)p[1]))
1514 *p = ASCII_HYPH;
1515 p++;
1517 return ROFF_CONT;
1520 enum rofferr
1521 roff_parseln(struct roff *r, int ln, struct buf *buf, int *offs)
1523 enum rofft t;
1524 enum rofferr e;
1525 int pos; /* parse point */
1526 int spos; /* saved parse point for messages */
1527 int ppos; /* original offset in buf->buf */
1528 int ctl; /* macro line (boolean) */
1530 ppos = pos = *offs;
1532 /* Handle in-line equation delimiters. */
1534 if (r->tbl == NULL &&
1535 r->last_eqn != NULL && r->last_eqn->delim &&
1536 (r->eqn == NULL || r->eqn_inline)) {
1537 e = roff_eqndelim(r, buf, pos);
1538 if (e == ROFF_REPARSE)
1539 return e;
1540 assert(e == ROFF_CONT);
1543 /* Expand some escape sequences. */
1545 e = roff_res(r, buf, ln, pos);
1546 if (e == ROFF_IGN)
1547 return e;
1548 assert(e == ROFF_CONT);
1550 ctl = roff_getcontrol(r, buf->buf, &pos);
1553 * First, if a scope is open and we're not a macro, pass the
1554 * text through the macro's filter.
1555 * Equations process all content themselves.
1556 * Tables process almost all content themselves, but we want
1557 * to warn about macros before passing it there.
1560 if (r->last != NULL && ! ctl) {
1561 t = r->last->tok;
1562 assert(roffs[t].text);
1563 e = (*roffs[t].text)(r, t, buf, ln, pos, pos, offs);
1564 assert(e == ROFF_IGN || e == ROFF_CONT);
1565 if (e != ROFF_CONT)
1566 return e;
1568 if (r->eqn != NULL)
1569 return eqn_read(&r->eqn, ln, buf->buf, ppos, offs);
1570 if (r->tbl != NULL && ( ! ctl || buf->buf[pos] == '\0'))
1571 return tbl_read(r->tbl, ln, buf->buf, ppos);
1572 if ( ! ctl)
1573 return roff_parsetext(buf, pos, offs);
1575 /* Skip empty request lines. */
1577 if (buf->buf[pos] == '"') {
1578 mandoc_msg(MANDOCERR_COMMENT_BAD, r->parse,
1579 ln, pos, NULL);
1580 return ROFF_IGN;
1581 } else if (buf->buf[pos] == '\0')
1582 return ROFF_IGN;
1585 * If a scope is open, go to the child handler for that macro,
1586 * as it may want to preprocess before doing anything with it.
1587 * Don't do so if an equation is open.
1590 if (r->last) {
1591 t = r->last->tok;
1592 assert(roffs[t].sub);
1593 return (*roffs[t].sub)(r, t, buf, ln, ppos, pos, offs);
1596 /* No scope is open. This is a new request or macro. */
1598 spos = pos;
1599 t = roff_parse(r, buf->buf, &pos, ln, ppos);
1601 /* Tables ignore most macros. */
1603 if (r->tbl != NULL && (t == ROFF_MAX || t == ROFF_TS)) {
1604 mandoc_msg(MANDOCERR_TBLMACRO, r->parse,
1605 ln, pos, buf->buf + spos);
1606 if (t == ROFF_TS)
1607 return ROFF_IGN;
1608 while (buf->buf[pos] != '\0' && buf->buf[pos] != ' ')
1609 pos++;
1610 while (buf->buf[pos] != '\0' && buf->buf[pos] == ' ')
1611 pos++;
1612 return tbl_read(r->tbl, ln, buf->buf, pos);
1616 * This is neither a roff request nor a user-defined macro.
1617 * Let the standard macro set parsers handle it.
1620 if (t == ROFF_MAX)
1621 return ROFF_CONT;
1623 /* Execute a roff request or a user defined macro. */
1625 assert(roffs[t].proc);
1626 return (*roffs[t].proc)(r, t, buf, ln, ppos, pos, offs);
1629 void
1630 roff_endparse(struct roff *r)
1633 if (r->last)
1634 mandoc_msg(MANDOCERR_BLK_NOEND, r->parse,
1635 r->last->line, r->last->col,
1636 roffs[r->last->tok].name);
1638 if (r->eqn) {
1639 mandoc_msg(MANDOCERR_BLK_NOEND, r->parse,
1640 r->eqn->eqn.ln, r->eqn->eqn.pos, "EQ");
1641 eqn_end(&r->eqn);
1644 if (r->tbl) {
1645 mandoc_msg(MANDOCERR_BLK_NOEND, r->parse,
1646 r->tbl->line, r->tbl->pos, "TS");
1647 tbl_end(&r->tbl);
1652 * Parse a roff node's type from the input buffer. This must be in the
1653 * form of ".foo xxx" in the usual way.
1655 static enum rofft
1656 roff_parse(struct roff *r, char *buf, int *pos, int ln, int ppos)
1658 char *cp;
1659 const char *mac;
1660 size_t maclen;
1661 enum rofft t;
1663 cp = buf + *pos;
1665 if ('\0' == *cp || '"' == *cp || '\t' == *cp || ' ' == *cp)
1666 return ROFF_MAX;
1668 mac = cp;
1669 maclen = roff_getname(r, &cp, ln, ppos);
1671 t = (r->current_string = roff_getstrn(r, mac, maclen))
1672 ? ROFF_USERDEF : roffhash_find(mac, maclen);
1674 if (ROFF_MAX != t)
1675 *pos = cp - buf;
1677 return t;
1680 /* --- handling of request blocks ----------------------------------------- */
1682 static enum rofferr
1683 roff_cblock(ROFF_ARGS)
1687 * A block-close `..' should only be invoked as a child of an
1688 * ignore macro, otherwise raise a warning and just ignore it.
1691 if (r->last == NULL) {
1692 mandoc_msg(MANDOCERR_BLK_NOTOPEN, r->parse,
1693 ln, ppos, "..");
1694 return ROFF_IGN;
1697 switch (r->last->tok) {
1698 case ROFF_am:
1699 /* ROFF_am1 is remapped to ROFF_am in roff_block(). */
1700 case ROFF_ami:
1701 case ROFF_de:
1702 /* ROFF_de1 is remapped to ROFF_de in roff_block(). */
1703 case ROFF_dei:
1704 case ROFF_ig:
1705 break;
1706 default:
1707 mandoc_msg(MANDOCERR_BLK_NOTOPEN, r->parse,
1708 ln, ppos, "..");
1709 return ROFF_IGN;
1712 if (buf->buf[pos] != '\0')
1713 mandoc_vmsg(MANDOCERR_ARG_SKIP, r->parse, ln, pos,
1714 ".. %s", buf->buf + pos);
1716 roffnode_pop(r);
1717 roffnode_cleanscope(r);
1718 return ROFF_IGN;
1722 static void
1723 roffnode_cleanscope(struct roff *r)
1726 while (r->last) {
1727 if (--r->last->endspan != 0)
1728 break;
1729 roffnode_pop(r);
1733 static void
1734 roff_ccond(struct roff *r, int ln, int ppos)
1737 if (NULL == r->last) {
1738 mandoc_msg(MANDOCERR_BLK_NOTOPEN, r->parse,
1739 ln, ppos, "\\}");
1740 return;
1743 switch (r->last->tok) {
1744 case ROFF_el:
1745 case ROFF_ie:
1746 case ROFF_if:
1747 break;
1748 default:
1749 mandoc_msg(MANDOCERR_BLK_NOTOPEN, r->parse,
1750 ln, ppos, "\\}");
1751 return;
1754 if (r->last->endspan > -1) {
1755 mandoc_msg(MANDOCERR_BLK_NOTOPEN, r->parse,
1756 ln, ppos, "\\}");
1757 return;
1760 roffnode_pop(r);
1761 roffnode_cleanscope(r);
1762 return;
1765 static enum rofferr
1766 roff_block(ROFF_ARGS)
1768 const char *name;
1769 char *iname, *cp;
1770 size_t namesz;
1772 /* Ignore groff compatibility mode for now. */
1774 if (tok == ROFF_de1)
1775 tok = ROFF_de;
1776 else if (tok == ROFF_dei1)
1777 tok = ROFF_dei;
1778 else if (tok == ROFF_am1)
1779 tok = ROFF_am;
1780 else if (tok == ROFF_ami1)
1781 tok = ROFF_ami;
1783 /* Parse the macro name argument. */
1785 cp = buf->buf + pos;
1786 if (tok == ROFF_ig) {
1787 iname = NULL;
1788 namesz = 0;
1789 } else {
1790 iname = cp;
1791 namesz = roff_getname(r, &cp, ln, ppos);
1792 iname[namesz] = '\0';
1795 /* Resolve the macro name argument if it is indirect. */
1797 if (namesz && (tok == ROFF_dei || tok == ROFF_ami)) {
1798 if ((name = roff_getstrn(r, iname, namesz)) == NULL) {
1799 mandoc_vmsg(MANDOCERR_STR_UNDEF,
1800 r->parse, ln, (int)(iname - buf->buf),
1801 "%.*s", (int)namesz, iname);
1802 namesz = 0;
1803 } else
1804 namesz = strlen(name);
1805 } else
1806 name = iname;
1808 if (namesz == 0 && tok != ROFF_ig) {
1809 mandoc_msg(MANDOCERR_REQ_EMPTY, r->parse,
1810 ln, ppos, roffs[tok].name);
1811 return ROFF_IGN;
1814 roffnode_push(r, tok, name, ln, ppos);
1817 * At the beginning of a `de' macro, clear the existing string
1818 * with the same name, if there is one. New content will be
1819 * appended from roff_block_text() in multiline mode.
1822 if (tok == ROFF_de || tok == ROFF_dei)
1823 roff_setstrn(&r->strtab, name, namesz, "", 0, 0);
1825 if (*cp == '\0')
1826 return ROFF_IGN;
1828 /* Get the custom end marker. */
1830 iname = cp;
1831 namesz = roff_getname(r, &cp, ln, ppos);
1833 /* Resolve the end marker if it is indirect. */
1835 if (namesz && (tok == ROFF_dei || tok == ROFF_ami)) {
1836 if ((name = roff_getstrn(r, iname, namesz)) == NULL) {
1837 mandoc_vmsg(MANDOCERR_STR_UNDEF,
1838 r->parse, ln, (int)(iname - buf->buf),
1839 "%.*s", (int)namesz, iname);
1840 namesz = 0;
1841 } else
1842 namesz = strlen(name);
1843 } else
1844 name = iname;
1846 if (namesz)
1847 r->last->end = mandoc_strndup(name, namesz);
1849 if (*cp != '\0')
1850 mandoc_vmsg(MANDOCERR_ARG_EXCESS, r->parse,
1851 ln, pos, ".%s ... %s", roffs[tok].name, cp);
1853 return ROFF_IGN;
1856 static enum rofferr
1857 roff_block_sub(ROFF_ARGS)
1859 enum rofft t;
1860 int i, j;
1863 * First check whether a custom macro exists at this level. If
1864 * it does, then check against it. This is some of groff's
1865 * stranger behaviours. If we encountered a custom end-scope
1866 * tag and that tag also happens to be a "real" macro, then we
1867 * need to try interpreting it again as a real macro. If it's
1868 * not, then return ignore. Else continue.
1871 if (r->last->end) {
1872 for (i = pos, j = 0; r->last->end[j]; j++, i++)
1873 if (buf->buf[i] != r->last->end[j])
1874 break;
1876 if (r->last->end[j] == '\0' &&
1877 (buf->buf[i] == '\0' ||
1878 buf->buf[i] == ' ' ||
1879 buf->buf[i] == '\t')) {
1880 roffnode_pop(r);
1881 roffnode_cleanscope(r);
1883 while (buf->buf[i] == ' ' || buf->buf[i] == '\t')
1884 i++;
1886 pos = i;
1887 if (roff_parse(r, buf->buf, &pos, ln, ppos) !=
1888 ROFF_MAX)
1889 return ROFF_RERUN;
1890 return ROFF_IGN;
1895 * If we have no custom end-query or lookup failed, then try
1896 * pulling it out of the hashtable.
1899 t = roff_parse(r, buf->buf, &pos, ln, ppos);
1901 if (t != ROFF_cblock) {
1902 if (tok != ROFF_ig)
1903 roff_setstr(r, r->last->name, buf->buf + ppos, 2);
1904 return ROFF_IGN;
1907 assert(roffs[t].proc);
1908 return (*roffs[t].proc)(r, t, buf, ln, ppos, pos, offs);
1911 static enum rofferr
1912 roff_block_text(ROFF_ARGS)
1915 if (tok != ROFF_ig)
1916 roff_setstr(r, r->last->name, buf->buf + pos, 2);
1918 return ROFF_IGN;
1921 static enum rofferr
1922 roff_cond_sub(ROFF_ARGS)
1924 enum rofft t;
1925 char *ep;
1926 int rr;
1928 rr = r->last->rule;
1929 roffnode_cleanscope(r);
1930 t = roff_parse(r, buf->buf, &pos, ln, ppos);
1933 * Fully handle known macros when they are structurally
1934 * required or when the conditional evaluated to true.
1937 if ((t != ROFF_MAX) &&
1938 (rr || roffs[t].flags & ROFFMAC_STRUCT)) {
1939 assert(roffs[t].proc);
1940 return (*roffs[t].proc)(r, t, buf, ln, ppos, pos, offs);
1944 * If `\}' occurs on a macro line without a preceding macro,
1945 * drop the line completely.
1948 ep = buf->buf + pos;
1949 if (ep[0] == '\\' && ep[1] == '}')
1950 rr = 0;
1952 /* Always check for the closing delimiter `\}'. */
1954 while ((ep = strchr(ep, '\\')) != NULL) {
1955 if (*(++ep) == '}') {
1956 *ep = '&';
1957 roff_ccond(r, ln, ep - buf->buf - 1);
1959 if (*ep != '\0')
1960 ++ep;
1962 return rr ? ROFF_CONT : ROFF_IGN;
1965 static enum rofferr
1966 roff_cond_text(ROFF_ARGS)
1968 char *ep;
1969 int rr;
1971 rr = r->last->rule;
1972 roffnode_cleanscope(r);
1974 ep = buf->buf + pos;
1975 while ((ep = strchr(ep, '\\')) != NULL) {
1976 if (*(++ep) == '}') {
1977 *ep = '&';
1978 roff_ccond(r, ln, ep - buf->buf - 1);
1980 if (*ep != '\0')
1981 ++ep;
1983 return rr ? ROFF_CONT : ROFF_IGN;
1986 /* --- handling of numeric and conditional expressions -------------------- */
1989 * Parse a single signed integer number. Stop at the first non-digit.
1990 * If there is at least one digit, return success and advance the
1991 * parse point, else return failure and let the parse point unchanged.
1992 * Ignore overflows, treat them just like the C language.
1994 static int
1995 roff_getnum(const char *v, int *pos, int *res, int flags)
1997 int myres, scaled, n, p;
1999 if (NULL == res)
2000 res = &myres;
2002 p = *pos;
2003 n = v[p] == '-';
2004 if (n || v[p] == '+')
2005 p++;
2007 if (flags & ROFFNUM_WHITE)
2008 while (isspace((unsigned char)v[p]))
2009 p++;
2011 for (*res = 0; isdigit((unsigned char)v[p]); p++)
2012 *res = 10 * *res + v[p] - '0';
2013 if (p == *pos + n)
2014 return 0;
2016 if (n)
2017 *res = -*res;
2019 /* Each number may be followed by one optional scaling unit. */
2021 switch (v[p]) {
2022 case 'f':
2023 scaled = *res * 65536;
2024 break;
2025 case 'i':
2026 scaled = *res * 240;
2027 break;
2028 case 'c':
2029 scaled = *res * 240 / 2.54;
2030 break;
2031 case 'v':
2032 case 'P':
2033 scaled = *res * 40;
2034 break;
2035 case 'm':
2036 case 'n':
2037 scaled = *res * 24;
2038 break;
2039 case 'p':
2040 scaled = *res * 10 / 3;
2041 break;
2042 case 'u':
2043 scaled = *res;
2044 break;
2045 case 'M':
2046 scaled = *res * 6 / 25;
2047 break;
2048 default:
2049 scaled = *res;
2050 p--;
2051 break;
2053 if (flags & ROFFNUM_SCALE)
2054 *res = scaled;
2056 *pos = p + 1;
2057 return 1;
2061 * Evaluate a string comparison condition.
2062 * The first character is the delimiter.
2063 * Succeed if the string up to its second occurrence
2064 * matches the string up to its third occurence.
2065 * Advance the cursor after the third occurrence
2066 * or lacking that, to the end of the line.
2068 static int
2069 roff_evalstrcond(const char *v, int *pos)
2071 const char *s1, *s2, *s3;
2072 int match;
2074 match = 0;
2075 s1 = v + *pos; /* initial delimiter */
2076 s2 = s1 + 1; /* for scanning the first string */
2077 s3 = strchr(s2, *s1); /* for scanning the second string */
2079 if (NULL == s3) /* found no middle delimiter */
2080 goto out;
2082 while ('\0' != *++s3) {
2083 if (*s2 != *s3) { /* mismatch */
2084 s3 = strchr(s3, *s1);
2085 break;
2087 if (*s3 == *s1) { /* found the final delimiter */
2088 match = 1;
2089 break;
2091 s2++;
2094 out:
2095 if (NULL == s3)
2096 s3 = strchr(s2, '\0');
2097 else if (*s3 != '\0')
2098 s3++;
2099 *pos = s3 - v;
2100 return match;
2104 * Evaluate an optionally negated single character, numerical,
2105 * or string condition.
2107 static int
2108 roff_evalcond(struct roff *r, int ln, char *v, int *pos)
2110 char *cp, *name;
2111 size_t sz;
2112 int number, savepos, wanttrue;
2114 if ('!' == v[*pos]) {
2115 wanttrue = 0;
2116 (*pos)++;
2117 } else
2118 wanttrue = 1;
2120 switch (v[*pos]) {
2121 case '\0':
2122 return 0;
2123 case 'n':
2124 case 'o':
2125 (*pos)++;
2126 return wanttrue;
2127 case 'c':
2128 case 'd':
2129 case 'e':
2130 case 't':
2131 case 'v':
2132 (*pos)++;
2133 return !wanttrue;
2134 case 'r':
2135 cp = name = v + ++*pos;
2136 sz = roff_getname(r, &cp, ln, *pos);
2137 *pos = cp - v;
2138 return (sz && roff_hasregn(r, name, sz)) == wanttrue;
2139 default:
2140 break;
2143 savepos = *pos;
2144 if (roff_evalnum(r, ln, v, pos, &number, ROFFNUM_SCALE))
2145 return (number > 0) == wanttrue;
2146 else if (*pos == savepos)
2147 return roff_evalstrcond(v, pos) == wanttrue;
2148 else
2149 return 0;
2152 static enum rofferr
2153 roff_line_ignore(ROFF_ARGS)
2156 return ROFF_IGN;
2159 static enum rofferr
2160 roff_insec(ROFF_ARGS)
2163 mandoc_msg(MANDOCERR_REQ_INSEC, r->parse,
2164 ln, ppos, roffs[tok].name);
2165 return ROFF_IGN;
2168 static enum rofferr
2169 roff_unsupp(ROFF_ARGS)
2172 mandoc_msg(MANDOCERR_REQ_UNSUPP, r->parse,
2173 ln, ppos, roffs[tok].name);
2174 return ROFF_IGN;
2177 static enum rofferr
2178 roff_cond(ROFF_ARGS)
2181 roffnode_push(r, tok, NULL, ln, ppos);
2184 * An `.el' has no conditional body: it will consume the value
2185 * of the current rstack entry set in prior `ie' calls or
2186 * defaults to DENY.
2188 * If we're not an `el', however, then evaluate the conditional.
2191 r->last->rule = tok == ROFF_el ?
2192 (r->rstackpos < 0 ? 0 : r->rstack[r->rstackpos--]) :
2193 roff_evalcond(r, ln, buf->buf, &pos);
2196 * An if-else will put the NEGATION of the current evaluated
2197 * conditional into the stack of rules.
2200 if (tok == ROFF_ie) {
2201 if (r->rstackpos + 1 == r->rstacksz) {
2202 r->rstacksz += 16;
2203 r->rstack = mandoc_reallocarray(r->rstack,
2204 r->rstacksz, sizeof(int));
2206 r->rstack[++r->rstackpos] = !r->last->rule;
2209 /* If the parent has false as its rule, then so do we. */
2211 if (r->last->parent && !r->last->parent->rule)
2212 r->last->rule = 0;
2215 * Determine scope.
2216 * If there is nothing on the line after the conditional,
2217 * not even whitespace, use next-line scope.
2220 if (buf->buf[pos] == '\0') {
2221 r->last->endspan = 2;
2222 goto out;
2225 while (buf->buf[pos] == ' ')
2226 pos++;
2228 /* An opening brace requests multiline scope. */
2230 if (buf->buf[pos] == '\\' && buf->buf[pos + 1] == '{') {
2231 r->last->endspan = -1;
2232 pos += 2;
2233 while (buf->buf[pos] == ' ')
2234 pos++;
2235 goto out;
2239 * Anything else following the conditional causes
2240 * single-line scope. Warn if the scope contains
2241 * nothing but trailing whitespace.
2244 if (buf->buf[pos] == '\0')
2245 mandoc_msg(MANDOCERR_COND_EMPTY, r->parse,
2246 ln, ppos, roffs[tok].name);
2248 r->last->endspan = 1;
2250 out:
2251 *offs = pos;
2252 return ROFF_RERUN;
2255 static enum rofferr
2256 roff_ds(ROFF_ARGS)
2258 char *string;
2259 const char *name;
2260 size_t namesz;
2262 /* Ignore groff compatibility mode for now. */
2264 if (tok == ROFF_ds1)
2265 tok = ROFF_ds;
2266 else if (tok == ROFF_as1)
2267 tok = ROFF_as;
2270 * The first word is the name of the string.
2271 * If it is empty or terminated by an escape sequence,
2272 * abort the `ds' request without defining anything.
2275 name = string = buf->buf + pos;
2276 if (*name == '\0')
2277 return ROFF_IGN;
2279 namesz = roff_getname(r, &string, ln, pos);
2280 if (name[namesz] == '\\')
2281 return ROFF_IGN;
2283 /* Read past the initial double-quote, if any. */
2284 if (*string == '"')
2285 string++;
2287 /* The rest is the value. */
2288 roff_setstrn(&r->strtab, name, namesz, string, strlen(string),
2289 ROFF_as == tok);
2290 return ROFF_IGN;
2294 * Parse a single operator, one or two characters long.
2295 * If the operator is recognized, return success and advance the
2296 * parse point, else return failure and let the parse point unchanged.
2298 static int
2299 roff_getop(const char *v, int *pos, char *res)
2302 *res = v[*pos];
2304 switch (*res) {
2305 case '+':
2306 case '-':
2307 case '*':
2308 case '/':
2309 case '%':
2310 case '&':
2311 case ':':
2312 break;
2313 case '<':
2314 switch (v[*pos + 1]) {
2315 case '=':
2316 *res = 'l';
2317 (*pos)++;
2318 break;
2319 case '>':
2320 *res = '!';
2321 (*pos)++;
2322 break;
2323 case '?':
2324 *res = 'i';
2325 (*pos)++;
2326 break;
2327 default:
2328 break;
2330 break;
2331 case '>':
2332 switch (v[*pos + 1]) {
2333 case '=':
2334 *res = 'g';
2335 (*pos)++;
2336 break;
2337 case '?':
2338 *res = 'a';
2339 (*pos)++;
2340 break;
2341 default:
2342 break;
2344 break;
2345 case '=':
2346 if ('=' == v[*pos + 1])
2347 (*pos)++;
2348 break;
2349 default:
2350 return 0;
2352 (*pos)++;
2354 return *res;
2358 * Evaluate either a parenthesized numeric expression
2359 * or a single signed integer number.
2361 static int
2362 roff_evalpar(struct roff *r, int ln,
2363 const char *v, int *pos, int *res, int flags)
2366 if ('(' != v[*pos])
2367 return roff_getnum(v, pos, res, flags);
2369 (*pos)++;
2370 if ( ! roff_evalnum(r, ln, v, pos, res, flags | ROFFNUM_WHITE))
2371 return 0;
2374 * Omission of the closing parenthesis
2375 * is an error in validation mode,
2376 * but ignored in evaluation mode.
2379 if (')' == v[*pos])
2380 (*pos)++;
2381 else if (NULL == res)
2382 return 0;
2384 return 1;
2388 * Evaluate a complete numeric expression.
2389 * Proceed left to right, there is no concept of precedence.
2391 static int
2392 roff_evalnum(struct roff *r, int ln, const char *v,
2393 int *pos, int *res, int flags)
2395 int mypos, operand2;
2396 char operator;
2398 if (NULL == pos) {
2399 mypos = 0;
2400 pos = &mypos;
2403 if (flags & ROFFNUM_WHITE)
2404 while (isspace((unsigned char)v[*pos]))
2405 (*pos)++;
2407 if ( ! roff_evalpar(r, ln, v, pos, res, flags))
2408 return 0;
2410 while (1) {
2411 if (flags & ROFFNUM_WHITE)
2412 while (isspace((unsigned char)v[*pos]))
2413 (*pos)++;
2415 if ( ! roff_getop(v, pos, &operator))
2416 break;
2418 if (flags & ROFFNUM_WHITE)
2419 while (isspace((unsigned char)v[*pos]))
2420 (*pos)++;
2422 if ( ! roff_evalpar(r, ln, v, pos, &operand2, flags))
2423 return 0;
2425 if (flags & ROFFNUM_WHITE)
2426 while (isspace((unsigned char)v[*pos]))
2427 (*pos)++;
2429 if (NULL == res)
2430 continue;
2432 switch (operator) {
2433 case '+':
2434 *res += operand2;
2435 break;
2436 case '-':
2437 *res -= operand2;
2438 break;
2439 case '*':
2440 *res *= operand2;
2441 break;
2442 case '/':
2443 if (operand2 == 0) {
2444 mandoc_msg(MANDOCERR_DIVZERO,
2445 r->parse, ln, *pos, v);
2446 *res = 0;
2447 break;
2449 *res /= operand2;
2450 break;
2451 case '%':
2452 if (operand2 == 0) {
2453 mandoc_msg(MANDOCERR_DIVZERO,
2454 r->parse, ln, *pos, v);
2455 *res = 0;
2456 break;
2458 *res %= operand2;
2459 break;
2460 case '<':
2461 *res = *res < operand2;
2462 break;
2463 case '>':
2464 *res = *res > operand2;
2465 break;
2466 case 'l':
2467 *res = *res <= operand2;
2468 break;
2469 case 'g':
2470 *res = *res >= operand2;
2471 break;
2472 case '=':
2473 *res = *res == operand2;
2474 break;
2475 case '!':
2476 *res = *res != operand2;
2477 break;
2478 case '&':
2479 *res = *res && operand2;
2480 break;
2481 case ':':
2482 *res = *res || operand2;
2483 break;
2484 case 'i':
2485 if (operand2 < *res)
2486 *res = operand2;
2487 break;
2488 case 'a':
2489 if (operand2 > *res)
2490 *res = operand2;
2491 break;
2492 default:
2493 abort();
2496 return 1;
2499 /* --- register management ------------------------------------------------ */
2501 void
2502 roff_setreg(struct roff *r, const char *name, int val, char sign)
2504 struct roffreg *reg;
2506 /* Search for an existing register with the same name. */
2507 reg = r->regtab;
2509 while (reg && strcmp(name, reg->key.p))
2510 reg = reg->next;
2512 if (NULL == reg) {
2513 /* Create a new register. */
2514 reg = mandoc_malloc(sizeof(struct roffreg));
2515 reg->key.p = mandoc_strdup(name);
2516 reg->key.sz = strlen(name);
2517 reg->val = 0;
2518 reg->next = r->regtab;
2519 r->regtab = reg;
2522 if ('+' == sign)
2523 reg->val += val;
2524 else if ('-' == sign)
2525 reg->val -= val;
2526 else
2527 reg->val = val;
2531 * Handle some predefined read-only number registers.
2532 * For now, return -1 if the requested register is not predefined;
2533 * in case a predefined read-only register having the value -1
2534 * were to turn up, another special value would have to be chosen.
2536 static int
2537 roff_getregro(const struct roff *r, const char *name)
2540 switch (*name) {
2541 case '$': /* Number of arguments of the last macro evaluated. */
2542 return r->argc;
2543 case 'A': /* ASCII approximation mode is always off. */
2544 return 0;
2545 case 'g': /* Groff compatibility mode is always on. */
2546 return 1;
2547 case 'H': /* Fixed horizontal resolution. */
2548 return 24;
2549 case 'j': /* Always adjust left margin only. */
2550 return 0;
2551 case 'T': /* Some output device is always defined. */
2552 return 1;
2553 case 'V': /* Fixed vertical resolution. */
2554 return 40;
2555 default:
2556 return -1;
2561 roff_getreg(const struct roff *r, const char *name)
2563 struct roffreg *reg;
2564 int val;
2566 if ('.' == name[0] && '\0' != name[1] && '\0' == name[2]) {
2567 val = roff_getregro(r, name + 1);
2568 if (-1 != val)
2569 return val;
2572 for (reg = r->regtab; reg; reg = reg->next)
2573 if (0 == strcmp(name, reg->key.p))
2574 return reg->val;
2576 return 0;
2579 static int
2580 roff_getregn(const struct roff *r, const char *name, size_t len)
2582 struct roffreg *reg;
2583 int val;
2585 if ('.' == name[0] && 2 == len) {
2586 val = roff_getregro(r, name + 1);
2587 if (-1 != val)
2588 return val;
2591 for (reg = r->regtab; reg; reg = reg->next)
2592 if (len == reg->key.sz &&
2593 0 == strncmp(name, reg->key.p, len))
2594 return reg->val;
2596 return 0;
2599 static int
2600 roff_hasregn(const struct roff *r, const char *name, size_t len)
2602 struct roffreg *reg;
2603 int val;
2605 if ('.' == name[0] && 2 == len) {
2606 val = roff_getregro(r, name + 1);
2607 if (-1 != val)
2608 return 1;
2611 for (reg = r->regtab; reg; reg = reg->next)
2612 if (len == reg->key.sz &&
2613 0 == strncmp(name, reg->key.p, len))
2614 return 1;
2616 return 0;
2619 static void
2620 roff_freereg(struct roffreg *reg)
2622 struct roffreg *old_reg;
2624 while (NULL != reg) {
2625 free(reg->key.p);
2626 old_reg = reg;
2627 reg = reg->next;
2628 free(old_reg);
2632 static enum rofferr
2633 roff_nr(ROFF_ARGS)
2635 char *key, *val;
2636 size_t keysz;
2637 int iv;
2638 char sign;
2640 key = val = buf->buf + pos;
2641 if (*key == '\0')
2642 return ROFF_IGN;
2644 keysz = roff_getname(r, &val, ln, pos);
2645 if (key[keysz] == '\\')
2646 return ROFF_IGN;
2647 key[keysz] = '\0';
2649 sign = *val;
2650 if (sign == '+' || sign == '-')
2651 val++;
2653 if (roff_evalnum(r, ln, val, NULL, &iv, ROFFNUM_SCALE))
2654 roff_setreg(r, key, iv, sign);
2656 return ROFF_IGN;
2659 static enum rofferr
2660 roff_rr(ROFF_ARGS)
2662 struct roffreg *reg, **prev;
2663 char *name, *cp;
2664 size_t namesz;
2666 name = cp = buf->buf + pos;
2667 if (*name == '\0')
2668 return ROFF_IGN;
2669 namesz = roff_getname(r, &cp, ln, pos);
2670 name[namesz] = '\0';
2672 prev = &r->regtab;
2673 while (1) {
2674 reg = *prev;
2675 if (reg == NULL || !strcmp(name, reg->key.p))
2676 break;
2677 prev = &reg->next;
2679 if (reg != NULL) {
2680 *prev = reg->next;
2681 free(reg->key.p);
2682 free(reg);
2684 return ROFF_IGN;
2687 /* --- handler functions for roff requests -------------------------------- */
2689 static enum rofferr
2690 roff_rm(ROFF_ARGS)
2692 const char *name;
2693 char *cp;
2694 size_t namesz;
2696 cp = buf->buf + pos;
2697 while (*cp != '\0') {
2698 name = cp;
2699 namesz = roff_getname(r, &cp, ln, (int)(cp - buf->buf));
2700 roff_setstrn(&r->strtab, name, namesz, NULL, 0, 0);
2701 if (name[namesz] == '\\')
2702 break;
2704 return ROFF_IGN;
2707 static enum rofferr
2708 roff_it(ROFF_ARGS)
2710 int iv;
2712 /* Parse the number of lines. */
2714 if ( ! roff_evalnum(r, ln, buf->buf, &pos, &iv, 0)) {
2715 mandoc_msg(MANDOCERR_IT_NONUM, r->parse,
2716 ln, ppos, buf->buf + 1);
2717 return ROFF_IGN;
2720 while (isspace((unsigned char)buf->buf[pos]))
2721 pos++;
2724 * Arm the input line trap.
2725 * Special-casing "an-trap" is an ugly workaround to cope
2726 * with DocBook stupidly fiddling with man(7) internals.
2729 roffit_lines = iv;
2730 roffit_macro = mandoc_strdup(iv != 1 ||
2731 strcmp(buf->buf + pos, "an-trap") ?
2732 buf->buf + pos : "br");
2733 return ROFF_IGN;
2736 static enum rofferr
2737 roff_Dd(ROFF_ARGS)
2739 const char *const *cp;
2741 if ((r->options & (MPARSE_MDOC | MPARSE_QUICK)) == 0)
2742 for (cp = __mdoc_reserved; *cp; cp++)
2743 roff_setstr(r, *cp, NULL, 0);
2745 if (r->format == 0)
2746 r->format = MPARSE_MDOC;
2748 return ROFF_CONT;
2751 static enum rofferr
2752 roff_TH(ROFF_ARGS)
2754 const char *const *cp;
2756 if ((r->options & MPARSE_QUICK) == 0)
2757 for (cp = __man_reserved; *cp; cp++)
2758 roff_setstr(r, *cp, NULL, 0);
2760 if (r->format == 0)
2761 r->format = MPARSE_MAN;
2763 return ROFF_CONT;
2766 static enum rofferr
2767 roff_TE(ROFF_ARGS)
2770 if (NULL == r->tbl)
2771 mandoc_msg(MANDOCERR_BLK_NOTOPEN, r->parse,
2772 ln, ppos, "TE");
2773 else if ( ! tbl_end(&r->tbl)) {
2774 free(buf->buf);
2775 buf->buf = mandoc_strdup(".sp");
2776 buf->sz = 4;
2777 return ROFF_REPARSE;
2779 return ROFF_IGN;
2782 static enum rofferr
2783 roff_T_(ROFF_ARGS)
2786 if (NULL == r->tbl)
2787 mandoc_msg(MANDOCERR_BLK_NOTOPEN, r->parse,
2788 ln, ppos, "T&");
2789 else
2790 tbl_restart(ppos, ln, r->tbl);
2792 return ROFF_IGN;
2796 * Handle in-line equation delimiters.
2798 static enum rofferr
2799 roff_eqndelim(struct roff *r, struct buf *buf, int pos)
2801 char *cp1, *cp2;
2802 const char *bef_pr, *bef_nl, *mac, *aft_nl, *aft_pr;
2805 * Outside equations, look for an opening delimiter.
2806 * If we are inside an equation, we already know it is
2807 * in-line, or this function wouldn't have been called;
2808 * so look for a closing delimiter.
2811 cp1 = buf->buf + pos;
2812 cp2 = strchr(cp1, r->eqn == NULL ?
2813 r->last_eqn->odelim : r->last_eqn->cdelim);
2814 if (cp2 == NULL)
2815 return ROFF_CONT;
2817 *cp2++ = '\0';
2818 bef_pr = bef_nl = aft_nl = aft_pr = "";
2820 /* Handle preceding text, protecting whitespace. */
2822 if (*buf->buf != '\0') {
2823 if (r->eqn == NULL)
2824 bef_pr = "\\&";
2825 bef_nl = "\n";
2829 * Prepare replacing the delimiter with an equation macro
2830 * and drop leading white space from the equation.
2833 if (r->eqn == NULL) {
2834 while (*cp2 == ' ')
2835 cp2++;
2836 mac = ".EQ";
2837 } else
2838 mac = ".EN";
2840 /* Handle following text, protecting whitespace. */
2842 if (*cp2 != '\0') {
2843 aft_nl = "\n";
2844 if (r->eqn != NULL)
2845 aft_pr = "\\&";
2848 /* Do the actual replacement. */
2850 buf->sz = mandoc_asprintf(&cp1, "%s%s%s%s%s%s%s", buf->buf,
2851 bef_pr, bef_nl, mac, aft_nl, aft_pr, cp2) + 1;
2852 free(buf->buf);
2853 buf->buf = cp1;
2855 /* Toggle the in-line state of the eqn subsystem. */
2857 r->eqn_inline = r->eqn == NULL;
2858 return ROFF_REPARSE;
2861 static enum rofferr
2862 roff_EQ(ROFF_ARGS)
2864 struct eqn_node *e;
2866 assert(r->eqn == NULL);
2867 e = eqn_alloc(ppos, ln, r->parse);
2869 if (r->last_eqn) {
2870 r->last_eqn->next = e;
2871 e->delim = r->last_eqn->delim;
2872 e->odelim = r->last_eqn->odelim;
2873 e->cdelim = r->last_eqn->cdelim;
2874 } else
2875 r->first_eqn = r->last_eqn = e;
2877 r->eqn = r->last_eqn = e;
2879 if (buf->buf[pos] != '\0')
2880 mandoc_vmsg(MANDOCERR_ARG_SKIP, r->parse, ln, pos,
2881 ".EQ %s", buf->buf + pos);
2883 return ROFF_IGN;
2886 static enum rofferr
2887 roff_EN(ROFF_ARGS)
2890 mandoc_msg(MANDOCERR_BLK_NOTOPEN, r->parse, ln, ppos, "EN");
2891 return ROFF_IGN;
2894 static enum rofferr
2895 roff_TS(ROFF_ARGS)
2897 struct tbl_node *tbl;
2899 if (r->tbl) {
2900 mandoc_msg(MANDOCERR_BLK_BROKEN, r->parse,
2901 ln, ppos, "TS breaks TS");
2902 tbl_end(&r->tbl);
2905 tbl = tbl_alloc(ppos, ln, r->parse);
2907 if (r->last_tbl)
2908 r->last_tbl->next = tbl;
2909 else
2910 r->first_tbl = r->last_tbl = tbl;
2912 r->tbl = r->last_tbl = tbl;
2913 return ROFF_IGN;
2916 static enum rofferr
2917 roff_brp(ROFF_ARGS)
2920 buf->buf[pos - 1] = '\0';
2921 return ROFF_CONT;
2924 static enum rofferr
2925 roff_cc(ROFF_ARGS)
2927 const char *p;
2929 p = buf->buf + pos;
2931 if (*p == '\0' || (r->control = *p++) == '.')
2932 r->control = 0;
2934 if (*p != '\0')
2935 mandoc_vmsg(MANDOCERR_ARG_EXCESS, r->parse,
2936 ln, p - buf->buf, "cc ... %s", p);
2938 return ROFF_IGN;
2941 static enum rofferr
2942 roff_tr(ROFF_ARGS)
2944 const char *p, *first, *second;
2945 size_t fsz, ssz;
2946 enum mandoc_esc esc;
2948 p = buf->buf + pos;
2950 if (*p == '\0') {
2951 mandoc_msg(MANDOCERR_REQ_EMPTY, r->parse, ln, ppos, "tr");
2952 return ROFF_IGN;
2955 while (*p != '\0') {
2956 fsz = ssz = 1;
2958 first = p++;
2959 if (*first == '\\') {
2960 esc = mandoc_escape(&p, NULL, NULL);
2961 if (esc == ESCAPE_ERROR) {
2962 mandoc_msg(MANDOCERR_ESC_BAD, r->parse,
2963 ln, (int)(p - buf->buf), first);
2964 return ROFF_IGN;
2966 fsz = (size_t)(p - first);
2969 second = p++;
2970 if (*second == '\\') {
2971 esc = mandoc_escape(&p, NULL, NULL);
2972 if (esc == ESCAPE_ERROR) {
2973 mandoc_msg(MANDOCERR_ESC_BAD, r->parse,
2974 ln, (int)(p - buf->buf), second);
2975 return ROFF_IGN;
2977 ssz = (size_t)(p - second);
2978 } else if (*second == '\0') {
2979 mandoc_vmsg(MANDOCERR_TR_ODD, r->parse,
2980 ln, first - buf->buf, "tr %s", first);
2981 second = " ";
2982 p--;
2985 if (fsz > 1) {
2986 roff_setstrn(&r->xmbtab, first, fsz,
2987 second, ssz, 0);
2988 continue;
2991 if (r->xtab == NULL)
2992 r->xtab = mandoc_calloc(128,
2993 sizeof(struct roffstr));
2995 free(r->xtab[(int)*first].p);
2996 r->xtab[(int)*first].p = mandoc_strndup(second, ssz);
2997 r->xtab[(int)*first].sz = ssz;
3000 return ROFF_IGN;
3003 static enum rofferr
3004 roff_so(ROFF_ARGS)
3006 char *name, *cp;
3008 name = buf->buf + pos;
3009 mandoc_vmsg(MANDOCERR_SO, r->parse, ln, ppos, "so %s", name);
3012 * Handle `so'. Be EXTREMELY careful, as we shouldn't be
3013 * opening anything that's not in our cwd or anything beneath
3014 * it. Thus, explicitly disallow traversing up the file-system
3015 * or using absolute paths.
3018 if (*name == '/' || strstr(name, "../") || strstr(name, "/..")) {
3019 mandoc_vmsg(MANDOCERR_SO_PATH, r->parse, ln, ppos,
3020 ".so %s", name);
3021 buf->sz = mandoc_asprintf(&cp,
3022 ".sp\nSee the file %s.\n.sp", name) + 1;
3023 free(buf->buf);
3024 buf->buf = cp;
3025 *offs = 0;
3026 return ROFF_REPARSE;
3029 *offs = pos;
3030 return ROFF_SO;
3033 /* --- user defined strings and macros ------------------------------------ */
3035 static enum rofferr
3036 roff_userdef(ROFF_ARGS)
3038 const char *arg[9], *ap;
3039 char *cp, *n1, *n2;
3040 int i, ib, ie;
3041 size_t asz, rsz;
3044 * Collect pointers to macro argument strings
3045 * and NUL-terminate them.
3048 r->argc = 0;
3049 cp = buf->buf + pos;
3050 for (i = 0; i < 9; i++) {
3051 if (*cp == '\0')
3052 arg[i] = "";
3053 else {
3054 arg[i] = mandoc_getarg(r->parse, &cp, ln, &pos);
3055 r->argc = i + 1;
3060 * Expand macro arguments.
3063 buf->sz = strlen(r->current_string) + 1;
3064 n1 = cp = mandoc_malloc(buf->sz);
3065 memcpy(n1, r->current_string, buf->sz);
3066 while (*cp != '\0') {
3068 /* Scan ahead for the next argument invocation. */
3070 if (*cp++ != '\\')
3071 continue;
3072 if (*cp++ != '$')
3073 continue;
3074 if (*cp == '*') { /* \\$* inserts all arguments */
3075 ib = 0;
3076 ie = r->argc - 1;
3077 } else { /* \\$1 .. \\$9 insert one argument */
3078 ib = ie = *cp - '1';
3079 if (ib < 0 || ib > 8)
3080 continue;
3082 cp -= 2;
3085 * Determine the size of the expanded argument,
3086 * taking escaping of quotes into account.
3089 asz = ie > ib ? ie - ib : 0; /* for blanks */
3090 for (i = ib; i <= ie; i++) {
3091 for (ap = arg[i]; *ap != '\0'; ap++) {
3092 asz++;
3093 if (*ap == '"')
3094 asz += 3;
3097 if (asz != 3) {
3100 * Determine the size of the rest of the
3101 * unexpanded macro, including the NUL.
3104 rsz = buf->sz - (cp - n1) - 3;
3107 * When shrinking, move before
3108 * releasing the storage.
3111 if (asz < 3)
3112 memmove(cp + asz, cp + 3, rsz);
3115 * Resize the storage for the macro
3116 * and readjust the parse pointer.
3119 buf->sz += asz - 3;
3120 n2 = mandoc_realloc(n1, buf->sz);
3121 cp = n2 + (cp - n1);
3122 n1 = n2;
3125 * When growing, make room
3126 * for the expanded argument.
3129 if (asz > 3)
3130 memmove(cp + asz, cp + 3, rsz);
3133 /* Copy the expanded argument, escaping quotes. */
3135 n2 = cp;
3136 for (i = ib; i <= ie; i++) {
3137 for (ap = arg[i]; *ap != '\0'; ap++) {
3138 if (*ap == '"') {
3139 memcpy(n2, "\\(dq", 4);
3140 n2 += 4;
3141 } else
3142 *n2++ = *ap;
3144 if (i < ie)
3145 *n2++ = ' ';
3150 * Replace the macro invocation
3151 * by the expanded macro.
3154 free(buf->buf);
3155 buf->buf = n1;
3156 *offs = 0;
3158 return buf->sz > 1 && buf->buf[buf->sz - 2] == '\n' ?
3159 ROFF_REPARSE : ROFF_APPEND;
3162 static size_t
3163 roff_getname(struct roff *r, char **cpp, int ln, int pos)
3165 char *name, *cp;
3166 size_t namesz;
3168 name = *cpp;
3169 if ('\0' == *name)
3170 return 0;
3172 /* Read until end of name and terminate it with NUL. */
3173 for (cp = name; 1; cp++) {
3174 if ('\0' == *cp || ' ' == *cp) {
3175 namesz = cp - name;
3176 break;
3178 if ('\\' != *cp)
3179 continue;
3180 namesz = cp - name;
3181 if ('{' == cp[1] || '}' == cp[1])
3182 break;
3183 cp++;
3184 if ('\\' == *cp)
3185 continue;
3186 mandoc_vmsg(MANDOCERR_NAMESC, r->parse, ln, pos,
3187 "%.*s", (int)(cp - name + 1), name);
3188 mandoc_escape((const char **)&cp, NULL, NULL);
3189 break;
3192 /* Read past spaces. */
3193 while (' ' == *cp)
3194 cp++;
3196 *cpp = cp;
3197 return namesz;
3201 * Store *string into the user-defined string called *name.
3202 * To clear an existing entry, call with (*r, *name, NULL, 0).
3203 * append == 0: replace mode
3204 * append == 1: single-line append mode
3205 * append == 2: multiline append mode, append '\n' after each call
3207 static void
3208 roff_setstr(struct roff *r, const char *name, const char *string,
3209 int append)
3212 roff_setstrn(&r->strtab, name, strlen(name), string,
3213 string ? strlen(string) : 0, append);
3216 static void
3217 roff_setstrn(struct roffkv **r, const char *name, size_t namesz,
3218 const char *string, size_t stringsz, int append)
3220 struct roffkv *n;
3221 char *c;
3222 int i;
3223 size_t oldch, newch;
3225 /* Search for an existing string with the same name. */
3226 n = *r;
3228 while (n && (namesz != n->key.sz ||
3229 strncmp(n->key.p, name, namesz)))
3230 n = n->next;
3232 if (NULL == n) {
3233 /* Create a new string table entry. */
3234 n = mandoc_malloc(sizeof(struct roffkv));
3235 n->key.p = mandoc_strndup(name, namesz);
3236 n->key.sz = namesz;
3237 n->val.p = NULL;
3238 n->val.sz = 0;
3239 n->next = *r;
3240 *r = n;
3241 } else if (0 == append) {
3242 free(n->val.p);
3243 n->val.p = NULL;
3244 n->val.sz = 0;
3247 if (NULL == string)
3248 return;
3251 * One additional byte for the '\n' in multiline mode,
3252 * and one for the terminating '\0'.
3254 newch = stringsz + (1 < append ? 2u : 1u);
3256 if (NULL == n->val.p) {
3257 n->val.p = mandoc_malloc(newch);
3258 *n->val.p = '\0';
3259 oldch = 0;
3260 } else {
3261 oldch = n->val.sz;
3262 n->val.p = mandoc_realloc(n->val.p, oldch + newch);
3265 /* Skip existing content in the destination buffer. */
3266 c = n->val.p + (int)oldch;
3268 /* Append new content to the destination buffer. */
3269 i = 0;
3270 while (i < (int)stringsz) {
3272 * Rudimentary roff copy mode:
3273 * Handle escaped backslashes.
3275 if ('\\' == string[i] && '\\' == string[i + 1])
3276 i++;
3277 *c++ = string[i++];
3280 /* Append terminating bytes. */
3281 if (1 < append)
3282 *c++ = '\n';
3284 *c = '\0';
3285 n->val.sz = (int)(c - n->val.p);
3288 static const char *
3289 roff_getstrn(const struct roff *r, const char *name, size_t len)
3291 const struct roffkv *n;
3292 int i;
3294 for (n = r->strtab; n; n = n->next)
3295 if (0 == strncmp(name, n->key.p, len) &&
3296 '\0' == n->key.p[(int)len])
3297 return n->val.p;
3299 for (i = 0; i < PREDEFS_MAX; i++)
3300 if (0 == strncmp(name, predefs[i].name, len) &&
3301 '\0' == predefs[i].name[(int)len])
3302 return predefs[i].str;
3304 return NULL;
3307 static void
3308 roff_freestr(struct roffkv *r)
3310 struct roffkv *n, *nn;
3312 for (n = r; n; n = nn) {
3313 free(n->key.p);
3314 free(n->val.p);
3315 nn = n->next;
3316 free(n);
3320 /* --- accessors and utility functions ------------------------------------ */
3322 const struct tbl_span *
3323 roff_span(const struct roff *r)
3326 return r->tbl ? tbl_span(r->tbl) : NULL;
3329 const struct eqn *
3330 roff_eqn(const struct roff *r)
3333 return r->last_eqn ? &r->last_eqn->eqn : NULL;
3337 * Duplicate an input string, making the appropriate character
3338 * conversations (as stipulated by `tr') along the way.
3339 * Returns a heap-allocated string with all the replacements made.
3341 char *
3342 roff_strdup(const struct roff *r, const char *p)
3344 const struct roffkv *cp;
3345 char *res;
3346 const char *pp;
3347 size_t ssz, sz;
3348 enum mandoc_esc esc;
3350 if (NULL == r->xmbtab && NULL == r->xtab)
3351 return mandoc_strdup(p);
3352 else if ('\0' == *p)
3353 return mandoc_strdup("");
3356 * Step through each character looking for term matches
3357 * (remember that a `tr' can be invoked with an escape, which is
3358 * a glyph but the escape is multi-character).
3359 * We only do this if the character hash has been initialised
3360 * and the string is >0 length.
3363 res = NULL;
3364 ssz = 0;
3366 while ('\0' != *p) {
3367 if ('\\' != *p && r->xtab && r->xtab[(int)*p].p) {
3368 sz = r->xtab[(int)*p].sz;
3369 res = mandoc_realloc(res, ssz + sz + 1);
3370 memcpy(res + ssz, r->xtab[(int)*p].p, sz);
3371 ssz += sz;
3372 p++;
3373 continue;
3374 } else if ('\\' != *p) {
3375 res = mandoc_realloc(res, ssz + 2);
3376 res[ssz++] = *p++;
3377 continue;
3380 /* Search for term matches. */
3381 for (cp = r->xmbtab; cp; cp = cp->next)
3382 if (0 == strncmp(p, cp->key.p, cp->key.sz))
3383 break;
3385 if (NULL != cp) {
3387 * A match has been found.
3388 * Append the match to the array and move
3389 * forward by its keysize.
3391 res = mandoc_realloc(res,
3392 ssz + cp->val.sz + 1);
3393 memcpy(res + ssz, cp->val.p, cp->val.sz);
3394 ssz += cp->val.sz;
3395 p += (int)cp->key.sz;
3396 continue;
3400 * Handle escapes carefully: we need to copy
3401 * over just the escape itself, or else we might
3402 * do replacements within the escape itself.
3403 * Make sure to pass along the bogus string.
3405 pp = p++;
3406 esc = mandoc_escape(&p, NULL, NULL);
3407 if (ESCAPE_ERROR == esc) {
3408 sz = strlen(pp);
3409 res = mandoc_realloc(res, ssz + sz + 1);
3410 memcpy(res + ssz, pp, sz);
3411 break;
3414 * We bail out on bad escapes.
3415 * No need to warn: we already did so when
3416 * roff_res() was called.
3418 sz = (int)(p - pp);
3419 res = mandoc_realloc(res, ssz + sz + 1);
3420 memcpy(res + ssz, pp, sz);
3421 ssz += sz;
3424 res[(int)ssz] = '\0';
3425 return res;
3429 roff_getformat(const struct roff *r)
3432 return r->format;
3436 * Find out whether a line is a macro line or not.
3437 * If it is, adjust the current position and return one; if it isn't,
3438 * return zero and don't change the current position.
3439 * If the control character has been set with `.cc', then let that grain
3440 * precedence.
3441 * This is slighly contrary to groff, where using the non-breaking
3442 * control character when `cc' has been invoked will cause the
3443 * non-breaking macro contents to be printed verbatim.
3446 roff_getcontrol(const struct roff *r, const char *cp, int *ppos)
3448 int pos;
3450 pos = *ppos;
3452 if (0 != r->control && cp[pos] == r->control)
3453 pos++;
3454 else if (0 != r->control)
3455 return 0;
3456 else if ('\\' == cp[pos] && '.' == cp[pos + 1])
3457 pos += 2;
3458 else if ('.' == cp[pos] || '\'' == cp[pos])
3459 pos++;
3460 else
3461 return 0;
3463 while (' ' == cp[pos] || '\t' == cp[pos])
3464 pos++;
3466 *ppos = pos;
3467 return 1;