1 /* $Id: roff.c,v 1.284 2016/01/08 17:48:10 schwarze Exp $ */
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.
20 #include <sys/types.h>
30 #include "mandoc_aux.h"
32 #include "libmandoc.h"
36 /* Maximum number of string expansions per line, to break infinite loops. */
37 #define EXPAND_LIMIT 1000
39 /* --- data types --------------------------------------------------------- */
122 /* MAN_fi; ignored in mdoc(7) */
131 /* MAN_ft; ignored in mdoc(7) */
153 /* MAN_in; ignored in mdoc(7) */
171 /* MAN_ll, MDOC_ll */
185 /* MAN_nf; ignored in mdoc(7) */
236 /* MAN_sp, MDOC_sp */
289 * An incredibly-simple string buffer.
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.
302 struct roffkv
*next
; /* next in list */
306 * A single number register as part of a singly-linked list.
311 struct roffreg
*next
;
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 */
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
);
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 */
365 #define ROFFMAC_STRUCT (1 << 0) /* always interpret */
366 struct roffmac
*next
;
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
*,
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 *,
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() */
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",
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",
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 ------------------------------------------------------ */
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
)
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.
771 roffhash_find(const char *p
, size_t s
)
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
783 if (p
[0] < ASCII_LO
|| p
[0] > ASCII_HI
)
788 if (NULL
== (n
= hash
[buc
]))
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
);
797 /* --- stack of request blocks -------------------------------------------- */
800 * Pop the current node off of the stack of roff instructions currently
804 roffnode_pop(struct roff
*r
)
811 r
->last
= r
->last
->parent
;
818 * Push a roff node onto the instruction stack. This must later be
819 * removed with roffnode_pop().
822 roffnode_push(struct roff
*r
, enum rofft tok
, const char *name
,
827 p
= mandoc_calloc(1, sizeof(struct roffnode
));
830 p
->name
= mandoc_strdup(name
);
834 p
->rule
= p
->parent
? p
->parent
->rule
: 0;
839 /* --- roff parser state data management ---------------------------------- */
842 roff_free1(struct roff
*r
)
844 struct tbl_node
*tbl
;
848 while (NULL
!= (tbl
= r
->first_tbl
)) {
849 r
->first_tbl
= tbl
->next
;
852 r
->first_tbl
= r
->last_tbl
= r
->tbl
= NULL
;
854 while (NULL
!= (e
= r
->first_eqn
)) {
855 r
->first_eqn
= e
->next
;
858 r
->first_eqn
= r
->last_eqn
= r
->eqn
= NULL
;
868 roff_freereg(r
->regtab
);
871 roff_freestr(r
->strtab
);
872 roff_freestr(r
->xmbtab
);
873 r
->strtab
= r
->xmbtab
= NULL
;
876 for (i
= 0; i
< 128; i
++)
883 roff_reset(struct roff
*r
)
887 r
->format
= r
->options
& (MPARSE_MDOC
| MPARSE_MAN
);
892 roff_free(struct roff
*r
)
900 roff_alloc(struct mparse
*parse
, int options
)
904 r
= mandoc_calloc(1, sizeof(struct roff
));
906 r
->options
= options
;
907 r
->format
= options
& (MPARSE_MDOC
| MPARSE_MAN
);
915 /* --- syntax tree state data management ---------------------------------- */
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
);
926 free(man
->meta
.arch
);
927 free(man
->meta
.title
);
928 free(man
->meta
.name
);
929 free(man
->meta
.date
);
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
;
942 man
->macroset
= MACROSET_NONE
;
943 man
->lastsec
= man
->lastnamed
= SEC_NONE
;
944 man
->next
= ROFF_NEXT_CHILD
;
948 roff_man_reset(struct roff_man
*man
)
952 roff_man_alloc1(man
);
956 roff_man_free(struct roff_man
*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
));
974 roff_man_alloc1(man
);
978 /* --- syntax tree handling ----------------------------------------------- */
981 roff_node_alloc(struct roff_man
*man
, int line
, int pos
,
982 enum roff_type type
, int tok
)
986 n
= mandoc_calloc(1, sizeof(*n
));
991 n
->sec
= man
->lastsec
;
993 if (man
->flags
& MDOC_SYNOPSIS
)
994 n
->flags
|= MDOC_SYNPRETTY
;
996 n
->flags
&= ~MDOC_SYNPRETTY
;
997 if (man
->flags
& MDOC_NEWLINE
)
998 n
->flags
|= MDOC_LINE
;
999 man
->flags
&= ~MDOC_NEWLINE
;
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
;
1014 man
->last
->parent
->last
= n
;
1015 man
->last
->next
= n
;
1016 n
->prev
= man
->last
;
1017 n
->parent
= man
->last
->parent
;
1019 case ROFF_NEXT_CHILD
:
1020 man
->last
->child
= n
;
1021 n
->parent
= man
->last
;
1022 n
->parent
->last
= n
;
1031 n
->parent
->head
= n
;
1034 if (n
->end
!= ENDBODY_NOT
)
1036 n
->parent
->body
= n
;
1039 n
->parent
->tail
= n
;
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
);
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
;
1065 n
->flags
|= MAN_VALID
;
1066 man
->next
= ROFF_NEXT_SIBLING
;
1070 roff_word_append(struct roff_man
*man
, const char *word
)
1072 struct roff_node
*n
;
1073 char *addstr
, *newstr
;
1076 addstr
= roff_strdup(man
->roff
, word
);
1077 mandoc_asprintf(&newstr
, "%s %s", n
->string
, addstr
);
1081 man
->next
= ROFF_NEXT_SIBLING
;
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
;
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
;
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
;
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
;
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
);
1134 if (eqn
->ln
> man
->last
->line
)
1135 n
->flags
|= MDOC_LINE
;
1136 roff_node_append(man
, n
);
1137 man
->next
= ROFF_NEXT_SIBLING
;
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
);
1149 roff_node_append(man
, n
);
1150 if (man
->macroset
== MACROSET_MDOC
)
1151 n
->flags
|= MDOC_VALID
| MDOC_ENDED
;
1153 n
->flags
|= MAN_VALID
;
1154 man
->next
= ROFF_NEXT_SIBLING
;
1158 roff_node_unlink(struct roff_man
*man
, struct roff_node
*n
)
1161 /* Adjust siblings. */
1164 n
->prev
->next
= 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. */
1181 if (man
->last
== n
) {
1182 if (n
->prev
== NULL
) {
1183 man
->last
= n
->parent
;
1184 man
->next
= ROFF_NEXT_CHILD
;
1186 man
->last
= n
->prev
;
1187 man
->next
= ROFF_NEXT_SIBLING
;
1190 if (man
->first
== n
)
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
)
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
);
1217 deroff(char **dest
, const struct roff_node
*n
)
1222 if (n
->type
!= ROFFT_TEXT
) {
1223 for (n
= n
->child
; n
!= NULL
; n
= n
->next
)
1228 /* Skip leading whitespace and escape sequences. */
1231 while (*cp
!= '\0') {
1234 mandoc_escape((const char **)&cp
, NULL
, NULL
);
1235 } else if (isspace((unsigned char)*cp
))
1241 /* Skip trailing whitespace. */
1243 for (sz
= strlen(cp
); sz
; sz
--)
1244 if ( ! isspace((unsigned char)cp
[sz
-1]))
1247 /* Skip empty strings. */
1252 if (*dest
== NULL
) {
1253 *dest
= mandoc_strndup(cp
, sz
);
1257 mandoc_asprintf(&cp
, "%s %*s", *dest
, (int)sz
, 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.
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 */
1289 start
= buf
->buf
+ pos
;
1290 stesc
= strchr(start
, '\0') - 1;
1291 while (stesc
-- > start
) {
1293 /* Search backwards for the next backslash. */
1298 /* If it is escaped, skip it. */
1300 for (cp
= stesc
- 1; cp
>= start
; cp
--)
1304 if ((stesc
- cp
) % 2 == 0) {
1309 /* Decide whether to expand or to check only. */
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
);
1335 if (EXPAND_LIMIT
< ++expand_count
) {
1336 mandoc_msg(MANDOCERR_ROFFLOOP
, r
->parse
,
1337 ln
, (int)(stesc
- buf
->buf
), NULL
);
1342 * The third character decides the length
1343 * of the name of the string or register.
1344 * Save a pointer to the name.
1371 /* Advance to the end of the name. */
1375 while (maxl
== 0 || naml
< maxl
) {
1377 mandoc_msg(MANDOCERR_ESC_BAD
, r
->parse
,
1378 ln
, (int)(stesc
- buf
->buf
), stesc
);
1382 if (maxl
== 0 && *cp
== term
) {
1386 if (*cp
++ != '\\' || stesc
[1] != 'w') {
1390 switch (mandoc_escape(&cp
, NULL
, NULL
)) {
1391 case ESCAPE_SPECIAL
:
1392 case ESCAPE_UNICODE
:
1393 case ESCAPE_NUMBERED
:
1394 case ESCAPE_OVERSTRIKE
:
1403 * Retrieve the replacement string; if it is
1404 * undefined, resume searching for escapes.
1410 res
= roff_getstrn(r
, stnam
, naml
);
1414 ubuf
[0] = arg_complete
&&
1415 roff_evalnum(r
, ln
, stnam
, &npos
,
1416 NULL
, ROFFNUM_SCALE
) &&
1417 stnam
+ npos
+ 1 == cp
? '1' : '0';
1422 (void)snprintf(ubuf
, sizeof(ubuf
), "%d",
1423 roff_getregn(r
, stnam
, naml
));
1428 /* use even incomplete args */
1429 (void)snprintf(ubuf
, sizeof(ubuf
), "%d",
1435 mandoc_vmsg(MANDOCERR_STR_UNDEF
,
1436 r
->parse
, ln
, (int)(stesc
- buf
->buf
),
1437 "%.*s", (int)naml
, stnam
);
1439 } else if (buf
->sz
+ strlen(res
) > SHRT_MAX
) {
1440 mandoc_msg(MANDOCERR_ROFFLOOP
, r
->parse
,
1441 ln
, (int)(stesc
- buf
->buf
), NULL
);
1445 /* Replace the escape sequence by the string. */
1448 buf
->sz
= mandoc_asprintf(&nbuf
, "%s%s%s",
1449 buf
->buf
, res
, cp
) + 1;
1451 /* Prepare for the next replacement. */
1454 stesc
= nbuf
+ (stesc
- buf
->buf
) + strlen(res
);
1462 * Process text streams.
1465 roff_parsetext(struct buf
*buf
, int pos
, int *offs
)
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
);
1483 return ROFF_REPARSE
;
1484 } else if (roffit_lines
> 1)
1487 /* Convert all breakable hyphens into ASCII_HYPH. */
1489 start
= p
= buf
->buf
+ pos
;
1491 while (*p
!= '\0') {
1492 sz
= strcspn(p
, "-\\");
1499 /* Skip over escapes. */
1501 esc
= mandoc_escape((const char **)&p
, NULL
, NULL
);
1502 if (esc
== ESCAPE_ERROR
)
1507 } else if (p
== start
) {
1512 if (isalpha((unsigned char)p
[-1]) &&
1513 isalpha((unsigned char)p
[1]))
1521 roff_parseln(struct roff
*r
, int ln
, struct buf
*buf
, int *offs
)
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) */
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
)
1540 assert(e
== ROFF_CONT
);
1543 /* Expand some escape sequences. */
1545 e
= roff_res(r
, buf
, ln
, pos
);
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
) {
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
);
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
);
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
,
1581 } else if (buf
->buf
[pos
] == '\0')
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.
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. */
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
);
1608 while (buf
->buf
[pos
] != '\0' && buf
->buf
[pos
] != ' ')
1610 while (buf
->buf
[pos
] != '\0' && buf
->buf
[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.
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
);
1630 roff_endparse(struct roff
*r
)
1634 mandoc_msg(MANDOCERR_BLK_NOEND
, r
->parse
,
1635 r
->last
->line
, r
->last
->col
,
1636 roffs
[r
->last
->tok
].name
);
1639 mandoc_msg(MANDOCERR_BLK_NOEND
, r
->parse
,
1640 r
->eqn
->eqn
.ln
, r
->eqn
->eqn
.pos
, "EQ");
1645 mandoc_msg(MANDOCERR_BLK_NOEND
, r
->parse
,
1646 r
->tbl
->line
, r
->tbl
->pos
, "TS");
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.
1656 roff_parse(struct roff
*r
, char *buf
, int *pos
, int ln
, int ppos
)
1665 if ('\0' == *cp
|| '"' == *cp
|| '\t' == *cp
|| ' ' == *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
);
1680 /* --- handling of request blocks ----------------------------------------- */
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
,
1697 switch (r
->last
->tok
) {
1699 /* ROFF_am1 is remapped to ROFF_am in roff_block(). */
1702 /* ROFF_de1 is remapped to ROFF_de in roff_block(). */
1707 mandoc_msg(MANDOCERR_BLK_NOTOPEN
, r
->parse
,
1712 if (buf
->buf
[pos
] != '\0')
1713 mandoc_vmsg(MANDOCERR_ARG_SKIP
, r
->parse
, ln
, pos
,
1714 ".. %s", buf
->buf
+ pos
);
1717 roffnode_cleanscope(r
);
1723 roffnode_cleanscope(struct roff
*r
)
1727 if (--r
->last
->endspan
!= 0)
1734 roff_ccond(struct roff
*r
, int ln
, int ppos
)
1737 if (NULL
== r
->last
) {
1738 mandoc_msg(MANDOCERR_BLK_NOTOPEN
, r
->parse
,
1743 switch (r
->last
->tok
) {
1749 mandoc_msg(MANDOCERR_BLK_NOTOPEN
, r
->parse
,
1754 if (r
->last
->endspan
> -1) {
1755 mandoc_msg(MANDOCERR_BLK_NOTOPEN
, r
->parse
,
1761 roffnode_cleanscope(r
);
1766 roff_block(ROFF_ARGS
)
1772 /* Ignore groff compatibility mode for now. */
1774 if (tok
== ROFF_de1
)
1776 else if (tok
== ROFF_dei1
)
1778 else if (tok
== ROFF_am1
)
1780 else if (tok
== ROFF_ami1
)
1783 /* Parse the macro name argument. */
1785 cp
= buf
->buf
+ pos
;
1786 if (tok
== ROFF_ig
) {
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
);
1804 namesz
= strlen(name
);
1808 if (namesz
== 0 && tok
!= ROFF_ig
) {
1809 mandoc_msg(MANDOCERR_REQ_EMPTY
, r
->parse
,
1810 ln
, ppos
, roffs
[tok
].name
);
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);
1828 /* Get the custom end marker. */
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
);
1842 namesz
= strlen(name
);
1847 r
->last
->end
= mandoc_strndup(name
, namesz
);
1850 mandoc_vmsg(MANDOCERR_ARG_EXCESS
, r
->parse
,
1851 ln
, pos
, ".%s ... %s", roffs
[tok
].name
, cp
);
1857 roff_block_sub(ROFF_ARGS
)
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.
1872 for (i
= pos
, j
= 0; r
->last
->end
[j
]; j
++, i
++)
1873 if (buf
->buf
[i
] != r
->last
->end
[j
])
1876 if (r
->last
->end
[j
] == '\0' &&
1877 (buf
->buf
[i
] == '\0' ||
1878 buf
->buf
[i
] == ' ' ||
1879 buf
->buf
[i
] == '\t')) {
1881 roffnode_cleanscope(r
);
1883 while (buf
->buf
[i
] == ' ' || buf
->buf
[i
] == '\t')
1887 if (roff_parse(r
, buf
->buf
, &pos
, ln
, ppos
) !=
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
) {
1903 roff_setstr(r
, r
->last
->name
, buf
->buf
+ ppos
, 2);
1907 assert(roffs
[t
].proc
);
1908 return (*roffs
[t
].proc
)(r
, t
, buf
, ln
, ppos
, pos
, offs
);
1912 roff_block_text(ROFF_ARGS
)
1916 roff_setstr(r
, r
->last
->name
, buf
->buf
+ pos
, 2);
1922 roff_cond_sub(ROFF_ARGS
)
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] == '}')
1952 /* Always check for the closing delimiter `\}'. */
1954 while ((ep
= strchr(ep
, '\\')) != NULL
) {
1955 if (*(++ep
) == '}') {
1957 roff_ccond(r
, ln
, ep
- buf
->buf
- 1);
1962 return rr
? ROFF_CONT
: ROFF_IGN
;
1966 roff_cond_text(ROFF_ARGS
)
1972 roffnode_cleanscope(r
);
1974 ep
= buf
->buf
+ pos
;
1975 while ((ep
= strchr(ep
, '\\')) != NULL
) {
1976 if (*(++ep
) == '}') {
1978 roff_ccond(r
, ln
, ep
- buf
->buf
- 1);
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.
1995 roff_getnum(const char *v
, int *pos
, int *res
, int flags
)
1997 int myres
, scaled
, n
, p
;
2004 if (n
|| v
[p
] == '+')
2007 if (flags
& ROFFNUM_WHITE
)
2008 while (isspace((unsigned char)v
[p
]))
2011 for (*res
= 0; isdigit((unsigned char)v
[p
]); p
++)
2012 *res
= 10 * *res
+ v
[p
] - '0';
2019 /* Each number may be followed by one optional scaling unit. */
2023 scaled
= *res
* 65536;
2026 scaled
= *res
* 240;
2029 scaled
= *res
* 240 / 2.54;
2040 scaled
= *res
* 10 / 3;
2046 scaled
= *res
* 6 / 25;
2053 if (flags
& ROFFNUM_SCALE
)
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.
2069 roff_evalstrcond(const char *v
, int *pos
)
2071 const char *s1
, *s2
, *s3
;
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 */
2082 while ('\0' != *++s3
) {
2083 if (*s2
!= *s3
) { /* mismatch */
2084 s3
= strchr(s3
, *s1
);
2087 if (*s3
== *s1
) { /* found the final delimiter */
2096 s3
= strchr(s2
, '\0');
2097 else if (*s3
!= '\0')
2104 * Evaluate an optionally negated single character, numerical,
2105 * or string condition.
2108 roff_evalcond(struct roff
*r
, int ln
, char *v
, int *pos
)
2112 int number
, savepos
, wanttrue
;
2114 if ('!' == v
[*pos
]) {
2135 cp
= name
= v
+ ++*pos
;
2136 sz
= roff_getname(r
, &cp
, ln
, *pos
);
2138 return (sz
&& roff_hasregn(r
, name
, sz
)) == wanttrue
;
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
;
2153 roff_line_ignore(ROFF_ARGS
)
2160 roff_insec(ROFF_ARGS
)
2163 mandoc_msg(MANDOCERR_REQ_INSEC
, r
->parse
,
2164 ln
, ppos
, roffs
[tok
].name
);
2169 roff_unsupp(ROFF_ARGS
)
2172 mandoc_msg(MANDOCERR_REQ_UNSUPP
, r
->parse
,
2173 ln
, ppos
, roffs
[tok
].name
);
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
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
) {
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
)
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;
2225 while (buf
->buf
[pos
] == ' ')
2228 /* An opening brace requests multiline scope. */
2230 if (buf
->buf
[pos
] == '\\' && buf
->buf
[pos
+ 1] == '{') {
2231 r
->last
->endspan
= -1;
2233 while (buf
->buf
[pos
] == ' ')
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;
2262 /* Ignore groff compatibility mode for now. */
2264 if (tok
== ROFF_ds1
)
2266 else if (tok
== ROFF_as1
)
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
;
2279 namesz
= roff_getname(r
, &string
, ln
, pos
);
2280 if (name
[namesz
] == '\\')
2283 /* Read past the initial double-quote, if any. */
2287 /* The rest is the value. */
2288 roff_setstrn(&r
->strtab
, name
, namesz
, string
, strlen(string
),
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.
2299 roff_getop(const char *v
, int *pos
, char *res
)
2314 switch (v
[*pos
+ 1]) {
2332 switch (v
[*pos
+ 1]) {
2346 if ('=' == v
[*pos
+ 1])
2358 * Evaluate either a parenthesized numeric expression
2359 * or a single signed integer number.
2362 roff_evalpar(struct roff
*r
, int ln
,
2363 const char *v
, int *pos
, int *res
, int flags
)
2367 return roff_getnum(v
, pos
, res
, flags
);
2370 if ( ! roff_evalnum(r
, ln
, v
, pos
, res
, flags
| ROFFNUM_WHITE
))
2374 * Omission of the closing parenthesis
2375 * is an error in validation mode,
2376 * but ignored in evaluation mode.
2381 else if (NULL
== res
)
2388 * Evaluate a complete numeric expression.
2389 * Proceed left to right, there is no concept of precedence.
2392 roff_evalnum(struct roff
*r
, int ln
, const char *v
,
2393 int *pos
, int *res
, int flags
)
2395 int mypos
, operand2
;
2403 if (flags
& ROFFNUM_WHITE
)
2404 while (isspace((unsigned char)v
[*pos
]))
2407 if ( ! roff_evalpar(r
, ln
, v
, pos
, res
, flags
))
2411 if (flags
& ROFFNUM_WHITE
)
2412 while (isspace((unsigned char)v
[*pos
]))
2415 if ( ! roff_getop(v
, pos
, &operator))
2418 if (flags
& ROFFNUM_WHITE
)
2419 while (isspace((unsigned char)v
[*pos
]))
2422 if ( ! roff_evalpar(r
, ln
, v
, pos
, &operand2
, flags
))
2425 if (flags
& ROFFNUM_WHITE
)
2426 while (isspace((unsigned char)v
[*pos
]))
2443 if (operand2
== 0) {
2444 mandoc_msg(MANDOCERR_DIVZERO
,
2445 r
->parse
, ln
, *pos
, v
);
2452 if (operand2
== 0) {
2453 mandoc_msg(MANDOCERR_DIVZERO
,
2454 r
->parse
, ln
, *pos
, v
);
2461 *res
= *res
< operand2
;
2464 *res
= *res
> operand2
;
2467 *res
= *res
<= operand2
;
2470 *res
= *res
>= operand2
;
2473 *res
= *res
== operand2
;
2476 *res
= *res
!= operand2
;
2479 *res
= *res
&& operand2
;
2482 *res
= *res
|| operand2
;
2485 if (operand2
< *res
)
2489 if (operand2
> *res
)
2499 /* --- register management ------------------------------------------------ */
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. */
2509 while (reg
&& strcmp(name
, reg
->key
.p
))
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
);
2518 reg
->next
= r
->regtab
;
2524 else if ('-' == sign
)
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.
2537 roff_getregro(const struct roff
*r
, const char *name
)
2541 case '$': /* Number of arguments of the last macro evaluated. */
2543 case 'A': /* ASCII approximation mode is always off. */
2545 case 'g': /* Groff compatibility mode is always on. */
2547 case 'H': /* Fixed horizontal resolution. */
2549 case 'j': /* Always adjust left margin only. */
2551 case 'T': /* Some output device is always defined. */
2553 case 'V': /* Fixed vertical resolution. */
2561 roff_getreg(const struct roff
*r
, const char *name
)
2563 struct roffreg
*reg
;
2566 if ('.' == name
[0] && '\0' != name
[1] && '\0' == name
[2]) {
2567 val
= roff_getregro(r
, name
+ 1);
2572 for (reg
= r
->regtab
; reg
; reg
= reg
->next
)
2573 if (0 == strcmp(name
, reg
->key
.p
))
2580 roff_getregn(const struct roff
*r
, const char *name
, size_t len
)
2582 struct roffreg
*reg
;
2585 if ('.' == name
[0] && 2 == len
) {
2586 val
= roff_getregro(r
, name
+ 1);
2591 for (reg
= r
->regtab
; reg
; reg
= reg
->next
)
2592 if (len
== reg
->key
.sz
&&
2593 0 == strncmp(name
, reg
->key
.p
, len
))
2600 roff_hasregn(const struct roff
*r
, const char *name
, size_t len
)
2602 struct roffreg
*reg
;
2605 if ('.' == name
[0] && 2 == len
) {
2606 val
= roff_getregro(r
, name
+ 1);
2611 for (reg
= r
->regtab
; reg
; reg
= reg
->next
)
2612 if (len
== reg
->key
.sz
&&
2613 0 == strncmp(name
, reg
->key
.p
, len
))
2620 roff_freereg(struct roffreg
*reg
)
2622 struct roffreg
*old_reg
;
2624 while (NULL
!= reg
) {
2640 key
= val
= buf
->buf
+ pos
;
2644 keysz
= roff_getname(r
, &val
, ln
, pos
);
2645 if (key
[keysz
] == '\\')
2650 if (sign
== '+' || sign
== '-')
2653 if (roff_evalnum(r
, ln
, val
, NULL
, &iv
, ROFFNUM_SCALE
))
2654 roff_setreg(r
, key
, iv
, sign
);
2662 struct roffreg
*reg
, **prev
;
2666 name
= cp
= buf
->buf
+ pos
;
2669 namesz
= roff_getname(r
, &cp
, ln
, pos
);
2670 name
[namesz
] = '\0';
2675 if (reg
== NULL
|| !strcmp(name
, reg
->key
.p
))
2687 /* --- handler functions for roff requests -------------------------------- */
2696 cp
= buf
->buf
+ pos
;
2697 while (*cp
!= '\0') {
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
] == '\\')
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);
2720 while (isspace((unsigned char)buf
->buf
[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.
2730 roffit_macro
= mandoc_strdup(iv
!= 1 ||
2731 strcmp(buf
->buf
+ pos
, "an-trap") ?
2732 buf
->buf
+ pos
: "br");
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);
2746 r
->format
= MPARSE_MDOC
;
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);
2761 r
->format
= MPARSE_MAN
;
2771 mandoc_msg(MANDOCERR_BLK_NOTOPEN
, r
->parse
,
2773 else if ( ! tbl_end(&r
->tbl
)) {
2775 buf
->buf
= mandoc_strdup(".sp");
2777 return ROFF_REPARSE
;
2787 mandoc_msg(MANDOCERR_BLK_NOTOPEN
, r
->parse
,
2790 tbl_restart(ppos
, ln
, r
->tbl
);
2796 * Handle in-line equation delimiters.
2799 roff_eqndelim(struct roff
*r
, struct buf
*buf
, int pos
)
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
);
2818 bef_pr
= bef_nl
= aft_nl
= aft_pr
= "";
2820 /* Handle preceding text, protecting whitespace. */
2822 if (*buf
->buf
!= '\0') {
2829 * Prepare replacing the delimiter with an equation macro
2830 * and drop leading white space from the equation.
2833 if (r
->eqn
== NULL
) {
2840 /* Handle following text, protecting whitespace. */
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;
2855 /* Toggle the in-line state of the eqn subsystem. */
2857 r
->eqn_inline
= r
->eqn
== NULL
;
2858 return ROFF_REPARSE
;
2866 assert(r
->eqn
== NULL
);
2867 e
= eqn_alloc(ppos
, ln
, r
->parse
);
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
;
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
);
2890 mandoc_msg(MANDOCERR_BLK_NOTOPEN
, r
->parse
, ln
, ppos
, "EN");
2897 struct tbl_node
*tbl
;
2900 mandoc_msg(MANDOCERR_BLK_BROKEN
, r
->parse
,
2901 ln
, ppos
, "TS breaks TS");
2905 tbl
= tbl_alloc(ppos
, ln
, r
->parse
);
2908 r
->last_tbl
->next
= tbl
;
2910 r
->first_tbl
= r
->last_tbl
= tbl
;
2912 r
->tbl
= r
->last_tbl
= tbl
;
2920 buf
->buf
[pos
- 1] = '\0';
2931 if (*p
== '\0' || (r
->control
= *p
++) == '.')
2935 mandoc_vmsg(MANDOCERR_ARG_EXCESS
, r
->parse
,
2936 ln
, p
- buf
->buf
, "cc ... %s", p
);
2944 const char *p
, *first
, *second
;
2946 enum mandoc_esc esc
;
2951 mandoc_msg(MANDOCERR_REQ_EMPTY
, r
->parse
, ln
, ppos
, "tr");
2955 while (*p
!= '\0') {
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
);
2966 fsz
= (size_t)(p
- first
);
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
);
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
);
2986 roff_setstrn(&r
->xmbtab
, first
, fsz
,
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
;
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
,
3021 buf
->sz
= mandoc_asprintf(&cp
,
3022 ".sp\nSee the file %s.\n.sp", name
) + 1;
3026 return ROFF_REPARSE
;
3033 /* --- user defined strings and macros ------------------------------------ */
3036 roff_userdef(ROFF_ARGS
)
3038 const char *arg
[9], *ap
;
3044 * Collect pointers to macro argument strings
3045 * and NUL-terminate them.
3049 cp
= buf
->buf
+ pos
;
3050 for (i
= 0; i
< 9; i
++) {
3054 arg
[i
] = mandoc_getarg(r
->parse
, &cp
, ln
, &pos
);
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. */
3074 if (*cp
== '*') { /* \\$* inserts all arguments */
3077 } else { /* \\$1 .. \\$9 insert one argument */
3078 ib
= ie
= *cp
- '1';
3079 if (ib
< 0 || ib
> 8)
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
++) {
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.
3112 memmove(cp
+ asz
, cp
+ 3, rsz
);
3115 * Resize the storage for the macro
3116 * and readjust the parse pointer.
3120 n2
= mandoc_realloc(n1
, buf
->sz
);
3121 cp
= n2
+ (cp
- n1
);
3125 * When growing, make room
3126 * for the expanded argument.
3130 memmove(cp
+ asz
, cp
+ 3, rsz
);
3133 /* Copy the expanded argument, escaping quotes. */
3136 for (i
= ib
; i
<= ie
; i
++) {
3137 for (ap
= arg
[i
]; *ap
!= '\0'; ap
++) {
3139 memcpy(n2
, "\\(dq", 4);
3150 * Replace the macro invocation
3151 * by the expanded macro.
3158 return buf
->sz
> 1 && buf
->buf
[buf
->sz
- 2] == '\n' ?
3159 ROFF_REPARSE
: ROFF_APPEND
;
3163 roff_getname(struct roff
*r
, char **cpp
, int ln
, int pos
)
3172 /* Read until end of name and terminate it with NUL. */
3173 for (cp
= name
; 1; cp
++) {
3174 if ('\0' == *cp
|| ' ' == *cp
) {
3181 if ('{' == cp
[1] || '}' == cp
[1])
3186 mandoc_vmsg(MANDOCERR_NAMESC
, r
->parse
, ln
, pos
,
3187 "%.*s", (int)(cp
- name
+ 1), name
);
3188 mandoc_escape((const char **)&cp
, NULL
, NULL
);
3192 /* Read past spaces. */
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
3208 roff_setstr(struct roff
*r
, const char *name
, const char *string
,
3212 roff_setstrn(&r
->strtab
, name
, strlen(name
), string
,
3213 string
? strlen(string
) : 0, append
);
3217 roff_setstrn(struct roffkv
**r
, const char *name
, size_t namesz
,
3218 const char *string
, size_t stringsz
, int append
)
3223 size_t oldch
, newch
;
3225 /* Search for an existing string with the same name. */
3228 while (n
&& (namesz
!= n
->key
.sz
||
3229 strncmp(n
->key
.p
, name
, namesz
)))
3233 /* Create a new string table entry. */
3234 n
= mandoc_malloc(sizeof(struct roffkv
));
3235 n
->key
.p
= mandoc_strndup(name
, namesz
);
3241 } else if (0 == append
) {
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
);
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. */
3270 while (i
< (int)stringsz
) {
3272 * Rudimentary roff copy mode:
3273 * Handle escaped backslashes.
3275 if ('\\' == string
[i
] && '\\' == string
[i
+ 1])
3280 /* Append terminating bytes. */
3285 n
->val
.sz
= (int)(c
- n
->val
.p
);
3289 roff_getstrn(const struct roff
*r
, const char *name
, size_t len
)
3291 const struct roffkv
*n
;
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
])
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
;
3308 roff_freestr(struct roffkv
*r
)
3310 struct roffkv
*n
, *nn
;
3312 for (n
= r
; n
; n
= nn
) {
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
;
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.
3342 roff_strdup(const struct roff
*r
, const char *p
)
3344 const struct roffkv
*cp
;
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.
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
);
3374 } else if ('\\' != *p
) {
3375 res
= mandoc_realloc(res
, ssz
+ 2);
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
))
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
);
3395 p
+= (int)cp
->key
.sz
;
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.
3406 esc
= mandoc_escape(&p
, NULL
, NULL
);
3407 if (ESCAPE_ERROR
== esc
) {
3409 res
= mandoc_realloc(res
, ssz
+ sz
+ 1);
3410 memcpy(res
+ ssz
, pp
, sz
);
3414 * We bail out on bad escapes.
3415 * No need to warn: we already did so when
3416 * roff_res() was called.
3419 res
= mandoc_realloc(res
, ssz
+ sz
+ 1);
3420 memcpy(res
+ ssz
, pp
, sz
);
3424 res
[(int)ssz
] = '\0';
3429 roff_getformat(const struct roff
*r
)
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
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
)
3452 if (0 != r
->control
&& cp
[pos
] == r
->control
)
3454 else if (0 != r
->control
)
3456 else if ('\\' == cp
[pos
] && '.' == cp
[pos
+ 1])
3458 else if ('.' == cp
[pos
] || '\'' == cp
[pos
])
3463 while (' ' == cp
[pos
] || '\t' == cp
[pos
])