]>
git.cameronkatri.com Git - mandoc.git/blob - roff.c
1 /* $Id: roff.c,v 1.278 2015/10/12 00:08:16 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 nested if-else conditionals. */
37 #define RSTACK_MAX 128
39 /* Maximum number of string expansions per line, to break infinite loops. */
40 #define EXPAND_LIMIT 1000
42 /* --- data types --------------------------------------------------------- */
125 /* MAN_fi; ignored in mdoc(7) */
134 /* MAN_ft; ignored in mdoc(7) */
156 /* MAN_in; ignored in mdoc(7) */
174 /* MAN_ll, MDOC_ll */
188 /* MAN_nf; ignored in mdoc(7) */
239 /* MAN_sp, MDOC_sp */
292 * An incredibly-simple string buffer.
295 char *p
; /* nil-terminated buffer */
296 size_t sz
; /* saved strlen(p) */
300 * A key-value roffstr pair as part of a singly-linked list.
305 struct roffkv
*next
; /* next in list */
309 * A single number register as part of a singly-linked list.
314 struct roffreg
*next
;
318 struct mparse
*parse
; /* parse point */
319 const struct mchars
*mchars
; /* character table */
320 struct roffnode
*last
; /* leaf of stack */
321 int *rstack
; /* stack of inverted `ie' values */
322 struct roffreg
*regtab
; /* number registers */
323 struct roffkv
*strtab
; /* user-defined strings & macros */
324 struct roffkv
*xmbtab
; /* multi-byte trans table (`tr') */
325 struct roffstr
*xtab
; /* single-byte trans table (`tr') */
326 const char *current_string
; /* value of last called user macro */
327 struct tbl_node
*first_tbl
; /* first table parsed */
328 struct tbl_node
*last_tbl
; /* last table parsed */
329 struct tbl_node
*tbl
; /* current table being parsed */
330 struct eqn_node
*last_eqn
; /* last equation parsed */
331 struct eqn_node
*first_eqn
; /* first equation parsed */
332 struct eqn_node
*eqn
; /* current equation being parsed */
333 int eqn_inline
; /* current equation is inline */
334 int options
; /* parse options */
335 int rstacksz
; /* current size limit of rstack */
336 int rstackpos
; /* position in rstack */
337 int format
; /* current file in mdoc or man format */
338 int argc
; /* number of args of the last macro */
339 char control
; /* control character */
343 enum rofft tok
; /* type of node */
344 struct roffnode
*parent
; /* up one in stack */
345 int line
; /* parse line */
346 int col
; /* parse col */
347 char *name
; /* node name, e.g. macro name */
348 char *end
; /* end-rules: custom token */
349 int endspan
; /* end-rules: next-line or infty */
350 int rule
; /* current evaluation rule */
353 #define ROFF_ARGS struct roff *r, /* parse ctx */ \
354 enum rofft tok, /* tok of macro */ \
355 struct buf *buf, /* input buffer */ \
356 int ln, /* parse line */ \
357 int ppos, /* original pos in buffer */ \
358 int pos, /* current pos in buffer */ \
359 int *offs /* reset offset of buffer data */
361 typedef enum rofferr (*roffproc
)(ROFF_ARGS
);
364 const char *name
; /* macro name */
365 roffproc proc
; /* process new macro */
366 roffproc text
; /* process as child text of macro */
367 roffproc sub
; /* process as child of macro */
369 #define ROFFMAC_STRUCT (1 << 0) /* always interpret */
370 struct roffmac
*next
;
374 const char *name
; /* predefined input name */
375 const char *str
; /* replacement symbol */
378 #define PREDEF(__name, __str) \
379 { (__name), (__str) },
381 /* --- function prototypes ------------------------------------------------ */
383 static enum rofft
roffhash_find(const char *, size_t);
384 static void roffhash_init(void);
385 static void roffnode_cleanscope(struct roff
*);
386 static void roffnode_pop(struct roff
*);
387 static void roffnode_push(struct roff
*, enum rofft
,
388 const char *, int, int);
389 static enum rofferr
roff_block(ROFF_ARGS
);
390 static enum rofferr
roff_block_text(ROFF_ARGS
);
391 static enum rofferr
roff_block_sub(ROFF_ARGS
);
392 static enum rofferr
roff_brp(ROFF_ARGS
);
393 static enum rofferr
roff_cblock(ROFF_ARGS
);
394 static enum rofferr
roff_cc(ROFF_ARGS
);
395 static void roff_ccond(struct roff
*, int, int);
396 static enum rofferr
roff_cond(ROFF_ARGS
);
397 static enum rofferr
roff_cond_text(ROFF_ARGS
);
398 static enum rofferr
roff_cond_sub(ROFF_ARGS
);
399 static enum rofferr
roff_ds(ROFF_ARGS
);
400 static enum rofferr
roff_eqndelim(struct roff
*, struct buf
*, int);
401 static int roff_evalcond(struct roff
*r
, int, char *, int *);
402 static int roff_evalnum(struct roff
*, int,
403 const char *, int *, int *, int);
404 static int roff_evalpar(struct roff
*, int,
405 const char *, int *, int *, int);
406 static int roff_evalstrcond(const char *, int *);
407 static void roff_free1(struct roff
*);
408 static void roff_freereg(struct roffreg
*);
409 static void roff_freestr(struct roffkv
*);
410 static size_t roff_getname(struct roff
*, char **, int, int);
411 static int roff_getnum(const char *, int *, int *, int);
412 static int roff_getop(const char *, int *, char *);
413 static int roff_getregn(const struct roff
*,
414 const char *, size_t);
415 static int roff_getregro(const struct roff
*,
417 static const char *roff_getstrn(const struct roff
*,
418 const char *, size_t);
419 static int roff_hasregn(const struct roff
*,
420 const char *, size_t);
421 static enum rofferr
roff_insec(ROFF_ARGS
);
422 static enum rofferr
roff_it(ROFF_ARGS
);
423 static enum rofferr
roff_line_ignore(ROFF_ARGS
);
424 static void roff_man_alloc1(struct roff_man
*);
425 static void roff_man_free1(struct roff_man
*);
426 static enum rofferr
roff_nr(ROFF_ARGS
);
427 static enum rofft
roff_parse(struct roff
*, char *, int *,
429 static enum rofferr
roff_parsetext(struct buf
*, int, int *);
430 static enum rofferr
roff_res(struct roff
*, struct buf
*, int, int);
431 static enum rofferr
roff_rm(ROFF_ARGS
);
432 static enum rofferr
roff_rr(ROFF_ARGS
);
433 static void roff_setstr(struct roff
*,
434 const char *, const char *, int);
435 static void roff_setstrn(struct roffkv
**, const char *,
436 size_t, const char *, size_t, int);
437 static enum rofferr
roff_so(ROFF_ARGS
);
438 static enum rofferr
roff_tr(ROFF_ARGS
);
439 static enum rofferr
roff_Dd(ROFF_ARGS
);
440 static enum rofferr
roff_TH(ROFF_ARGS
);
441 static enum rofferr
roff_TE(ROFF_ARGS
);
442 static enum rofferr
roff_TS(ROFF_ARGS
);
443 static enum rofferr
roff_EQ(ROFF_ARGS
);
444 static enum rofferr
roff_EN(ROFF_ARGS
);
445 static enum rofferr
roff_T_(ROFF_ARGS
);
446 static enum rofferr
roff_unsupp(ROFF_ARGS
);
447 static enum rofferr
roff_userdef(ROFF_ARGS
);
449 /* --- constant data ------------------------------------------------------ */
451 /* See roffhash_find() */
455 #define HASHWIDTH (ASCII_HI - ASCII_LO + 1)
457 #define ROFFNUM_SCALE (1 << 0) /* Honour scaling in roff_getnum(). */
458 #define ROFFNUM_WHITE (1 << 1) /* Skip whitespace in roff_evalnum(). */
460 static struct roffmac
*hash
[HASHWIDTH
];
462 static struct roffmac roffs
[ROFF_MAX
] = {
463 { "ab", roff_unsupp
, NULL
, NULL
, 0, NULL
},
464 { "ad", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
465 { "af", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
466 { "aln", roff_unsupp
, NULL
, NULL
, 0, NULL
},
467 { "als", roff_unsupp
, NULL
, NULL
, 0, NULL
},
468 { "am", roff_block
, roff_block_text
, roff_block_sub
, 0, NULL
},
469 { "am1", roff_block
, roff_block_text
, roff_block_sub
, 0, NULL
},
470 { "ami", roff_block
, roff_block_text
, roff_block_sub
, 0, NULL
},
471 { "ami1", roff_block
, roff_block_text
, roff_block_sub
, 0, NULL
},
472 { "as", roff_ds
, NULL
, NULL
, 0, NULL
},
473 { "as1", roff_ds
, NULL
, NULL
, 0, NULL
},
474 { "asciify", roff_unsupp
, NULL
, NULL
, 0, NULL
},
475 { "backtrace", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
476 { "bd", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
477 { "bleedat", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
478 { "blm", roff_unsupp
, NULL
, NULL
, 0, NULL
},
479 { "box", roff_unsupp
, NULL
, NULL
, 0, NULL
},
480 { "boxa", roff_unsupp
, NULL
, NULL
, 0, NULL
},
481 { "bp", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
482 { "BP", roff_unsupp
, NULL
, NULL
, 0, NULL
},
483 { "break", roff_unsupp
, NULL
, NULL
, 0, NULL
},
484 { "breakchar", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
485 { "brnl", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
486 { "brp", roff_brp
, NULL
, NULL
, 0, NULL
},
487 { "brpnl", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
488 { "c2", roff_unsupp
, NULL
, NULL
, 0, NULL
},
489 { "cc", roff_cc
, NULL
, NULL
, 0, NULL
},
490 { "ce", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
491 { "cf", roff_insec
, NULL
, NULL
, 0, NULL
},
492 { "cflags", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
493 { "ch", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
494 { "char", roff_unsupp
, NULL
, NULL
, 0, NULL
},
495 { "chop", roff_unsupp
, NULL
, NULL
, 0, NULL
},
496 { "class", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
497 { "close", roff_insec
, NULL
, NULL
, 0, NULL
},
498 { "CL", roff_unsupp
, NULL
, NULL
, 0, NULL
},
499 { "color", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
500 { "composite", roff_unsupp
, NULL
, NULL
, 0, NULL
},
501 { "continue", roff_unsupp
, NULL
, NULL
, 0, NULL
},
502 { "cp", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
503 { "cropat", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
504 { "cs", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
505 { "cu", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
506 { "da", roff_unsupp
, NULL
, NULL
, 0, NULL
},
507 { "dch", roff_unsupp
, NULL
, NULL
, 0, NULL
},
508 { "Dd", roff_Dd
, NULL
, NULL
, 0, NULL
},
509 { "de", roff_block
, roff_block_text
, roff_block_sub
, 0, NULL
},
510 { "de1", roff_block
, roff_block_text
, roff_block_sub
, 0, NULL
},
511 { "defcolor", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
512 { "dei", roff_block
, roff_block_text
, roff_block_sub
, 0, NULL
},
513 { "dei1", roff_block
, roff_block_text
, roff_block_sub
, 0, NULL
},
514 { "device", roff_unsupp
, NULL
, NULL
, 0, NULL
},
515 { "devicem", roff_unsupp
, NULL
, NULL
, 0, NULL
},
516 { "di", roff_unsupp
, NULL
, NULL
, 0, NULL
},
517 { "do", roff_unsupp
, NULL
, NULL
, 0, NULL
},
518 { "ds", roff_ds
, NULL
, NULL
, 0, NULL
},
519 { "ds1", roff_ds
, NULL
, NULL
, 0, NULL
},
520 { "dwh", roff_unsupp
, NULL
, NULL
, 0, NULL
},
521 { "dt", roff_unsupp
, NULL
, NULL
, 0, NULL
},
522 { "ec", roff_unsupp
, NULL
, NULL
, 0, NULL
},
523 { "ecr", roff_unsupp
, NULL
, NULL
, 0, NULL
},
524 { "ecs", roff_unsupp
, NULL
, NULL
, 0, NULL
},
525 { "el", roff_cond
, roff_cond_text
, roff_cond_sub
, ROFFMAC_STRUCT
, NULL
},
526 { "em", roff_unsupp
, NULL
, NULL
, 0, NULL
},
527 { "EN", roff_EN
, NULL
, NULL
, 0, NULL
},
528 { "eo", roff_unsupp
, NULL
, NULL
, 0, NULL
},
529 { "EP", roff_unsupp
, NULL
, NULL
, 0, NULL
},
530 { "EQ", roff_EQ
, NULL
, NULL
, 0, NULL
},
531 { "errprint", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
532 { "ev", roff_unsupp
, NULL
, NULL
, 0, NULL
},
533 { "evc", roff_unsupp
, NULL
, NULL
, 0, NULL
},
534 { "ex", roff_unsupp
, NULL
, NULL
, 0, NULL
},
535 { "fallback", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
536 { "fam", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
537 { "fc", roff_unsupp
, NULL
, NULL
, 0, NULL
},
538 { "fchar", roff_unsupp
, NULL
, NULL
, 0, NULL
},
539 { "fcolor", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
540 { "fdeferlig", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
541 { "feature", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
542 { "fkern", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
543 { "fl", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
544 { "flig", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
545 { "fp", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
546 { "fps", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
547 { "fschar", roff_unsupp
, NULL
, NULL
, 0, NULL
},
548 { "fspacewidth", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
549 { "fspecial", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
550 { "ftr", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
551 { "fzoom", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
552 { "gcolor", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
553 { "hc", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
554 { "hcode", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
555 { "hidechar", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
556 { "hla", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
557 { "hlm", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
558 { "hpf", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
559 { "hpfa", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
560 { "hpfcode", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
561 { "hw", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
562 { "hy", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
563 { "hylang", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
564 { "hylen", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
565 { "hym", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
566 { "hypp", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
567 { "hys", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
568 { "ie", roff_cond
, roff_cond_text
, roff_cond_sub
, ROFFMAC_STRUCT
, NULL
},
569 { "if", roff_cond
, roff_cond_text
, roff_cond_sub
, ROFFMAC_STRUCT
, NULL
},
570 { "ig", roff_block
, roff_block_text
, roff_block_sub
, 0, NULL
},
571 { "index", roff_unsupp
, NULL
, NULL
, 0, NULL
},
572 { "it", roff_it
, NULL
, NULL
, 0, NULL
},
573 { "itc", roff_unsupp
, NULL
, NULL
, 0, NULL
},
574 { "IX", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
575 { "kern", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
576 { "kernafter", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
577 { "kernbefore", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
578 { "kernpair", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
579 { "lc", roff_unsupp
, NULL
, NULL
, 0, NULL
},
580 { "lc_ctype", roff_unsupp
, NULL
, NULL
, 0, NULL
},
581 { "lds", roff_unsupp
, NULL
, NULL
, 0, NULL
},
582 { "length", roff_unsupp
, NULL
, NULL
, 0, NULL
},
583 { "letadj", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
584 { "lf", roff_insec
, NULL
, NULL
, 0, NULL
},
585 { "lg", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
586 { "lhang", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
587 { "linetabs", roff_unsupp
, NULL
, NULL
, 0, NULL
},
588 { "lnr", roff_unsupp
, NULL
, NULL
, 0, NULL
},
589 { "lnrf", roff_unsupp
, NULL
, NULL
, 0, NULL
},
590 { "lpfx", roff_unsupp
, NULL
, NULL
, 0, NULL
},
591 { "ls", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
592 { "lsm", roff_unsupp
, NULL
, NULL
, 0, NULL
},
593 { "lt", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
594 { "mc", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
595 { "mediasize", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
596 { "minss", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
597 { "mk", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
598 { "mso", roff_insec
, NULL
, NULL
, 0, NULL
},
599 { "na", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
600 { "ne", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
601 { "nh", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
602 { "nhychar", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
603 { "nm", roff_unsupp
, NULL
, NULL
, 0, NULL
},
604 { "nn", roff_unsupp
, NULL
, NULL
, 0, NULL
},
605 { "nop", roff_unsupp
, NULL
, NULL
, 0, NULL
},
606 { "nr", roff_nr
, NULL
, NULL
, 0, NULL
},
607 { "nrf", roff_unsupp
, NULL
, NULL
, 0, NULL
},
608 { "nroff", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
609 { "ns", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
610 { "nx", roff_insec
, NULL
, NULL
, 0, NULL
},
611 { "open", roff_insec
, NULL
, NULL
, 0, NULL
},
612 { "opena", roff_insec
, NULL
, NULL
, 0, NULL
},
613 { "os", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
614 { "output", roff_unsupp
, NULL
, NULL
, 0, NULL
},
615 { "padj", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
616 { "papersize", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
617 { "pc", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
618 { "pev", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
619 { "pi", roff_insec
, NULL
, NULL
, 0, NULL
},
620 { "PI", roff_unsupp
, NULL
, NULL
, 0, NULL
},
621 { "pl", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
622 { "pm", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
623 { "pn", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
624 { "pnr", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
625 { "po", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
626 { "ps", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
627 { "psbb", roff_unsupp
, NULL
, NULL
, 0, NULL
},
628 { "pshape", roff_unsupp
, NULL
, NULL
, 0, NULL
},
629 { "pso", roff_insec
, NULL
, NULL
, 0, NULL
},
630 { "ptr", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
631 { "pvs", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
632 { "rchar", roff_unsupp
, NULL
, NULL
, 0, NULL
},
633 { "rd", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
634 { "recursionlimit", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
635 { "return", roff_unsupp
, NULL
, NULL
, 0, NULL
},
636 { "rfschar", roff_unsupp
, NULL
, NULL
, 0, NULL
},
637 { "rhang", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
638 { "rj", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
639 { "rm", roff_rm
, NULL
, NULL
, 0, NULL
},
640 { "rn", roff_unsupp
, NULL
, NULL
, 0, NULL
},
641 { "rnn", roff_unsupp
, NULL
, NULL
, 0, NULL
},
642 { "rr", roff_rr
, NULL
, NULL
, 0, NULL
},
643 { "rs", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
644 { "rt", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
645 { "schar", roff_unsupp
, NULL
, NULL
, 0, NULL
},
646 { "sentchar", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
647 { "shc", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
648 { "shift", roff_unsupp
, NULL
, NULL
, 0, NULL
},
649 { "sizes", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
650 { "so", roff_so
, NULL
, NULL
, 0, NULL
},
651 { "spacewidth", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
652 { "special", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
653 { "spreadwarn", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
654 { "ss", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
655 { "sty", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
656 { "substring", roff_unsupp
, NULL
, NULL
, 0, NULL
},
657 { "sv", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
658 { "sy", roff_insec
, NULL
, NULL
, 0, NULL
},
659 { "T&", roff_T_
, NULL
, NULL
, 0, NULL
},
660 { "ta", roff_unsupp
, NULL
, NULL
, 0, NULL
},
661 { "tc", roff_unsupp
, NULL
, NULL
, 0, NULL
},
662 { "TE", roff_TE
, NULL
, NULL
, 0, NULL
},
663 { "TH", roff_TH
, NULL
, NULL
, 0, NULL
},
664 { "ti", roff_unsupp
, NULL
, NULL
, 0, NULL
},
665 { "tkf", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
666 { "tl", roff_unsupp
, NULL
, NULL
, 0, NULL
},
667 { "tm", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
668 { "tm1", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
669 { "tmc", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
670 { "tr", roff_tr
, NULL
, NULL
, 0, NULL
},
671 { "track", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
672 { "transchar", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
673 { "trf", roff_insec
, NULL
, NULL
, 0, NULL
},
674 { "trimat", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
675 { "trin", roff_unsupp
, NULL
, NULL
, 0, NULL
},
676 { "trnt", roff_unsupp
, NULL
, NULL
, 0, NULL
},
677 { "troff", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
678 { "TS", roff_TS
, NULL
, NULL
, 0, NULL
},
679 { "uf", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
680 { "ul", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
681 { "unformat", roff_unsupp
, NULL
, NULL
, 0, NULL
},
682 { "unwatch", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
683 { "unwatchn", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
684 { "vpt", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
685 { "vs", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
686 { "warn", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
687 { "warnscale", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
688 { "watch", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
689 { "watchlength", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
690 { "watchn", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
691 { "wh", roff_unsupp
, NULL
, NULL
, 0, NULL
},
692 { "while", roff_unsupp
, NULL
, NULL
, 0, NULL
},
693 { "write", roff_insec
, NULL
, NULL
, 0, NULL
},
694 { "writec", roff_insec
, NULL
, NULL
, 0, NULL
},
695 { "writem", roff_insec
, NULL
, NULL
, 0, NULL
},
696 { "xflag", roff_line_ignore
, NULL
, NULL
, 0, NULL
},
697 { ".", roff_cblock
, NULL
, NULL
, 0, NULL
},
698 { NULL
, roff_userdef
, NULL
, NULL
, 0, NULL
},
701 /* not currently implemented: Ds em Eq LP Me PP pp Or Rd Sf SH */
702 const char *const __mdoc_reserved
[] = {
703 "Ac", "Ad", "An", "Ao", "Ap", "Aq", "Ar", "At",
704 "Bc", "Bd", "Bf", "Bk", "Bl", "Bo", "Bq",
705 "Brc", "Bro", "Brq", "Bsx", "Bt", "Bx",
706 "Cd", "Cm", "Db", "Dc", "Dd", "Dl", "Do", "Dq",
707 "Dt", "Dv", "Dx", "D1",
708 "Ec", "Ed", "Ef", "Ek", "El", "Em",
709 "En", "Eo", "Er", "Es", "Ev", "Ex",
710 "Fa", "Fc", "Fd", "Fl", "Fn", "Fo", "Fr", "Ft", "Fx",
711 "Hf", "Ic", "In", "It", "Lb", "Li", "Lk", "Lp",
712 "Ms", "Mt", "Nd", "Nm", "No", "Ns", "Nx",
713 "Oc", "Oo", "Op", "Os", "Ot", "Ox",
714 "Pa", "Pc", "Pf", "Po", "Pp", "Pq",
715 "Qc", "Ql", "Qo", "Qq", "Re", "Rs", "Rv",
716 "Sc", "Sh", "Sm", "So", "Sq",
717 "Ss", "St", "Sx", "Sy",
718 "Ta", "Tn", "Ud", "Ux", "Va", "Vt", "Xc", "Xo", "Xr",
719 "%A", "%B", "%C", "%D", "%I", "%J", "%N", "%O",
720 "%P", "%Q", "%R", "%T", "%U", "%V",
724 /* not currently implemented: BT DE DS ME MT PT SY TQ YS */
725 const char *const __man_reserved
[] = {
726 "AT", "B", "BI", "BR", "DT",
727 "EE", "EN", "EQ", "EX", "HP", "I", "IB", "IP", "IR",
728 "LP", "OP", "P", "PD", "PP",
729 "R", "RB", "RE", "RI", "RS", "SB", "SH", "SM", "SS",
730 "TE", "TH", "TP", "TS", "T&", "UC", "UE", "UR",
734 /* Array of injected predefined strings. */
735 #define PREDEFS_MAX 38
736 static const struct predef predefs
[PREDEFS_MAX
] = {
737 #include "predefs.in"
740 /* See roffhash_find() */
741 #define ROFF_HASH(p) (p[0] - ASCII_LO)
743 static int roffit_lines
; /* number of lines to delay */
744 static char *roffit_macro
; /* nil-terminated macro line */
747 /* --- request table ------------------------------------------------------ */
755 for (i
= 0; i
< (int)ROFF_USERDEF
; i
++) {
756 assert(roffs
[i
].name
[0] >= ASCII_LO
);
757 assert(roffs
[i
].name
[0] <= ASCII_HI
);
759 buc
= ROFF_HASH(roffs
[i
].name
);
761 if (NULL
!= (n
= hash
[buc
])) {
762 for ( ; n
->next
; n
= n
->next
)
766 hash
[buc
] = &roffs
[i
];
771 * Look up a roff token by its name. Returns ROFF_MAX if no macro by
772 * the nil-terminated string name could be found.
775 roffhash_find(const char *p
, size_t s
)
781 * libroff has an extremely simple hashtable, for the time
782 * being, which simply keys on the first character, which must
783 * be printable, then walks a chain. It works well enough until
787 if (p
[0] < ASCII_LO
|| p
[0] > ASCII_HI
)
792 if (NULL
== (n
= hash
[buc
]))
794 for ( ; n
; n
= n
->next
)
795 if (0 == strncmp(n
->name
, p
, s
) && '\0' == n
->name
[(int)s
])
796 return (enum rofft
)(n
- roffs
);
801 /* --- stack of request blocks -------------------------------------------- */
804 * Pop the current node off of the stack of roff instructions currently
808 roffnode_pop(struct roff
*r
)
815 r
->last
= r
->last
->parent
;
822 * Push a roff node onto the instruction stack. This must later be
823 * removed with roffnode_pop().
826 roffnode_push(struct roff
*r
, enum rofft tok
, const char *name
,
831 p
= mandoc_calloc(1, sizeof(struct roffnode
));
834 p
->name
= mandoc_strdup(name
);
838 p
->rule
= p
->parent
? p
->parent
->rule
: 0;
843 /* --- roff parser state data management ---------------------------------- */
846 roff_free1(struct roff
*r
)
848 struct tbl_node
*tbl
;
852 while (NULL
!= (tbl
= r
->first_tbl
)) {
853 r
->first_tbl
= tbl
->next
;
856 r
->first_tbl
= r
->last_tbl
= r
->tbl
= NULL
;
858 while (NULL
!= (e
= r
->first_eqn
)) {
859 r
->first_eqn
= e
->next
;
862 r
->first_eqn
= r
->last_eqn
= r
->eqn
= NULL
;
872 roff_freereg(r
->regtab
);
875 roff_freestr(r
->strtab
);
876 roff_freestr(r
->xmbtab
);
877 r
->strtab
= r
->xmbtab
= NULL
;
880 for (i
= 0; i
< 128; i
++)
887 roff_reset(struct roff
*r
)
891 r
->format
= r
->options
& (MPARSE_MDOC
| MPARSE_MAN
);
896 roff_free(struct roff
*r
)
904 roff_alloc(struct mparse
*parse
, const struct mchars
*mchars
, int options
)
908 r
= mandoc_calloc(1, sizeof(struct roff
));
911 r
->options
= options
;
912 r
->format
= options
& (MPARSE_MDOC
| MPARSE_MAN
);
920 /* --- syntax tree state data management ---------------------------------- */
923 roff_man_free1(struct roff_man
*man
)
926 if (man
->first
!= NULL
)
927 roff_node_delete(man
, man
->first
);
928 free(man
->meta
.msec
);
931 free(man
->meta
.arch
);
932 free(man
->meta
.title
);
933 free(man
->meta
.name
);
934 free(man
->meta
.date
);
938 roff_man_alloc1(struct roff_man
*man
)
941 memset(&man
->meta
, 0, sizeof(man
->meta
));
942 man
->first
= mandoc_calloc(1, sizeof(*man
->first
));
943 man
->first
->type
= ROFFT_ROOT
;
944 man
->last
= man
->first
;
947 man
->macroset
= MACROSET_NONE
;
948 man
->lastsec
= man
->lastnamed
= SEC_NONE
;
949 man
->next
= ROFF_NEXT_CHILD
;
953 roff_man_reset(struct roff_man
*man
)
957 roff_man_alloc1(man
);
961 roff_man_free(struct roff_man
*man
)
969 roff_man_alloc(struct roff
*roff
, struct mparse
*parse
,
970 const char *defos
, int quick
)
972 struct roff_man
*man
;
974 man
= mandoc_calloc(1, sizeof(*man
));
979 roff_man_alloc1(man
);
983 /* --- syntax tree handling ----------------------------------------------- */
986 roff_node_alloc(struct roff_man
*man
, int line
, int pos
,
987 enum roff_type type
, int tok
)
991 n
= mandoc_calloc(1, sizeof(*n
));
996 n
->sec
= man
->lastsec
;
998 if (man
->flags
& MDOC_SYNOPSIS
)
999 n
->flags
|= MDOC_SYNPRETTY
;
1001 n
->flags
&= ~MDOC_SYNPRETTY
;
1002 if (man
->flags
& MDOC_NEWLINE
)
1003 n
->flags
|= MDOC_LINE
;
1004 man
->flags
&= ~MDOC_NEWLINE
;
1010 roff_node_append(struct roff_man
*man
, struct roff_node
*n
)
1013 switch (man
->next
) {
1014 case ROFF_NEXT_SIBLING
:
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
;
1026 n
->parent
->nchild
++;
1027 n
->parent
->last
= n
;
1030 * Copy over the normalised-data pointer of our parent. Not
1031 * everybody has one, but copying a null pointer is fine.
1036 if (n
->end
!= ENDBODY_NOT
)
1041 n
->norm
= n
->parent
->norm
;
1047 if (man
->macroset
== MACROSET_MDOC
)
1048 mdoc_valid_pre(man
, n
);
1052 assert(n
->parent
->type
== ROFFT_BLOCK
);
1053 n
->parent
->head
= n
;
1058 assert(n
->parent
->type
== ROFFT_BLOCK
);
1059 n
->parent
->body
= n
;
1062 assert(n
->parent
->type
== ROFFT_BLOCK
);
1063 n
->parent
->tail
= n
;
1072 roff_word_alloc(struct roff_man
*man
, int line
, int pos
, const char *word
)
1074 struct roff_node
*n
;
1076 n
= roff_node_alloc(man
, line
, pos
, ROFFT_TEXT
, TOKEN_NONE
);
1077 n
->string
= roff_strdup(man
->roff
, word
);
1078 roff_node_append(man
, n
);
1079 if (man
->macroset
== MACROSET_MDOC
)
1080 mdoc_valid_post(man
);
1082 man_valid_post(man
);
1083 man
->next
= ROFF_NEXT_SIBLING
;
1087 roff_word_append(struct roff_man
*man
, const char *word
)
1089 struct roff_node
*n
;
1090 char *addstr
, *newstr
;
1093 addstr
= roff_strdup(man
->roff
, word
);
1094 mandoc_asprintf(&newstr
, "%s %s", n
->string
, addstr
);
1098 man
->next
= ROFF_NEXT_SIBLING
;
1102 roff_elem_alloc(struct roff_man
*man
, int line
, int pos
, int tok
)
1104 struct roff_node
*n
;
1106 n
= roff_node_alloc(man
, line
, pos
, ROFFT_ELEM
, tok
);
1107 roff_node_append(man
, n
);
1108 man
->next
= ROFF_NEXT_CHILD
;
1112 roff_block_alloc(struct roff_man
*man
, int line
, int pos
, int tok
)
1114 struct roff_node
*n
;
1116 n
= roff_node_alloc(man
, line
, pos
, ROFFT_BLOCK
, tok
);
1117 roff_node_append(man
, n
);
1118 man
->next
= ROFF_NEXT_CHILD
;
1123 roff_head_alloc(struct roff_man
*man
, int line
, int pos
, int tok
)
1125 struct roff_node
*n
;
1127 n
= roff_node_alloc(man
, line
, pos
, ROFFT_HEAD
, tok
);
1128 roff_node_append(man
, n
);
1129 man
->next
= ROFF_NEXT_CHILD
;
1134 roff_body_alloc(struct roff_man
*man
, int line
, int pos
, int tok
)
1136 struct roff_node
*n
;
1138 n
= roff_node_alloc(man
, line
, pos
, ROFFT_BODY
, tok
);
1139 roff_node_append(man
, n
);
1140 man
->next
= ROFF_NEXT_CHILD
;
1145 roff_addeqn(struct roff_man
*man
, const struct eqn
*eqn
)
1147 struct roff_node
*n
;
1149 n
= roff_node_alloc(man
, eqn
->ln
, eqn
->pos
, ROFFT_EQN
, TOKEN_NONE
);
1151 if (eqn
->ln
> man
->last
->line
)
1152 n
->flags
|= MDOC_LINE
;
1153 roff_node_append(man
, n
);
1154 man
->next
= ROFF_NEXT_SIBLING
;
1158 roff_addtbl(struct roff_man
*man
, const struct tbl_span
*tbl
)
1160 struct roff_node
*n
;
1162 if (man
->macroset
== MACROSET_MAN
)
1163 man_breakscope(man
, TOKEN_NONE
);
1164 n
= roff_node_alloc(man
, tbl
->line
, 0, ROFFT_TBL
, TOKEN_NONE
);
1166 roff_node_append(man
, n
);
1167 if (man
->macroset
== MACROSET_MDOC
)
1168 mdoc_valid_post(man
);
1170 man_valid_post(man
);
1171 man
->next
= ROFF_NEXT_SIBLING
;
1175 roff_node_unlink(struct roff_man
*man
, struct roff_node
*n
)
1178 /* Adjust siblings. */
1181 n
->prev
->next
= n
->next
;
1183 n
->next
->prev
= n
->prev
;
1185 /* Adjust parent. */
1187 if (n
->parent
!= NULL
) {
1188 n
->parent
->nchild
--;
1189 if (n
->parent
->child
== n
)
1190 n
->parent
->child
= n
->next
;
1191 if (n
->parent
->last
== n
)
1192 n
->parent
->last
= n
->prev
;
1195 /* Adjust parse point. */
1199 if (man
->last
== n
) {
1200 if (n
->prev
== NULL
) {
1201 man
->last
= n
->parent
;
1202 man
->next
= ROFF_NEXT_CHILD
;
1204 man
->last
= n
->prev
;
1205 man
->next
= ROFF_NEXT_SIBLING
;
1208 if (man
->first
== n
)
1213 roff_node_free(struct roff_node
*n
)
1216 if (n
->args
!= NULL
)
1217 mdoc_argv_free(n
->args
);
1218 if (n
->type
== ROFFT_BLOCK
|| n
->type
== ROFFT_ELEM
)
1225 roff_node_delete(struct roff_man
*man
, struct roff_node
*n
)
1228 while (n
->child
!= NULL
)
1229 roff_node_delete(man
, n
->child
);
1230 assert(n
->nchild
== 0);
1231 roff_node_unlink(man
, n
);
1236 deroff(char **dest
, const struct roff_node
*n
)
1241 if (n
->type
!= ROFFT_TEXT
) {
1242 for (n
= n
->child
; n
!= NULL
; n
= n
->next
)
1247 /* Skip leading whitespace and escape sequences. */
1250 while (*cp
!= '\0') {
1253 mandoc_escape((const char **)&cp
, NULL
, NULL
);
1254 } else if (isspace((unsigned char)*cp
))
1260 /* Skip trailing whitespace. */
1262 for (sz
= strlen(cp
); sz
; sz
--)
1263 if ( ! isspace((unsigned char)cp
[sz
-1]))
1266 /* Skip empty strings. */
1271 if (*dest
== NULL
) {
1272 *dest
= mandoc_strndup(cp
, sz
);
1276 mandoc_asprintf(&cp
, "%s %*s", *dest
, (int)sz
, cp
);
1281 /* --- main functions of the roff parser ---------------------------------- */
1284 * In the current line, expand escape sequences that tend to get
1285 * used in numerical expressions and conditional requests.
1286 * Also check the syntax of the remaining escape sequences.
1289 roff_res(struct roff
*r
, struct buf
*buf
, int ln
, int pos
)
1291 char ubuf
[24]; /* buffer to print the number */
1292 const char *start
; /* start of the string to process */
1293 char *stesc
; /* start of an escape sequence ('\\') */
1294 const char *stnam
; /* start of the name, after "[(*" */
1295 const char *cp
; /* end of the name, e.g. before ']' */
1296 const char *res
; /* the string to be substituted */
1297 char *nbuf
; /* new buffer to copy buf->buf to */
1298 size_t maxl
; /* expected length of the escape name */
1299 size_t naml
; /* actual length of the escape name */
1300 enum mandoc_esc esc
; /* type of the escape sequence */
1301 int inaml
; /* length returned from mandoc_escape() */
1302 int expand_count
; /* to avoid infinite loops */
1303 int npos
; /* position in numeric expression */
1304 int arg_complete
; /* argument not interrupted by eol */
1305 char term
; /* character terminating the escape */
1308 start
= buf
->buf
+ pos
;
1309 stesc
= strchr(start
, '\0') - 1;
1310 while (stesc
-- > start
) {
1312 /* Search backwards for the next backslash. */
1317 /* If it is escaped, skip it. */
1319 for (cp
= stesc
- 1; cp
>= start
; cp
--)
1323 if ((stesc
- cp
) % 2 == 0) {
1328 /* Decide whether to expand or to check only. */
1344 esc
= mandoc_escape(&cp
, &stnam
, &inaml
);
1345 if (esc
== ESCAPE_ERROR
||
1346 (esc
== ESCAPE_SPECIAL
&&
1347 mchars_spec2cp(r
->mchars
, stnam
, inaml
) < 0))
1348 mandoc_vmsg(MANDOCERR_ESC_BAD
,
1349 r
->parse
, ln
, (int)(stesc
- buf
->buf
),
1350 "%.*s", (int)(cp
- stesc
), stesc
);
1354 if (EXPAND_LIMIT
< ++expand_count
) {
1355 mandoc_msg(MANDOCERR_ROFFLOOP
, r
->parse
,
1356 ln
, (int)(stesc
- buf
->buf
), NULL
);
1361 * The third character decides the length
1362 * of the name of the string or register.
1363 * Save a pointer to the name.
1390 /* Advance to the end of the name. */
1394 while (maxl
== 0 || naml
< maxl
) {
1396 mandoc_msg(MANDOCERR_ESC_BAD
, r
->parse
,
1397 ln
, (int)(stesc
- buf
->buf
), stesc
);
1401 if (maxl
== 0 && *cp
== term
) {
1405 if (*cp
++ != '\\' || stesc
[1] != 'w') {
1409 switch (mandoc_escape(&cp
, NULL
, NULL
)) {
1410 case ESCAPE_SPECIAL
:
1411 case ESCAPE_UNICODE
:
1412 case ESCAPE_NUMBERED
:
1413 case ESCAPE_OVERSTRIKE
:
1422 * Retrieve the replacement string; if it is
1423 * undefined, resume searching for escapes.
1429 res
= roff_getstrn(r
, stnam
, naml
);
1433 ubuf
[0] = arg_complete
&&
1434 roff_evalnum(r
, ln
, stnam
, &npos
,
1435 NULL
, ROFFNUM_SCALE
) &&
1436 stnam
+ npos
+ 1 == cp
? '1' : '0';
1441 (void)snprintf(ubuf
, sizeof(ubuf
), "%d",
1442 roff_getregn(r
, stnam
, naml
));
1447 /* use even incomplete args */
1448 (void)snprintf(ubuf
, sizeof(ubuf
), "%d",
1454 mandoc_vmsg(MANDOCERR_STR_UNDEF
,
1455 r
->parse
, ln
, (int)(stesc
- buf
->buf
),
1456 "%.*s", (int)naml
, stnam
);
1458 } else if (buf
->sz
+ strlen(res
) > SHRT_MAX
) {
1459 mandoc_msg(MANDOCERR_ROFFLOOP
, r
->parse
,
1460 ln
, (int)(stesc
- buf
->buf
), NULL
);
1464 /* Replace the escape sequence by the string. */
1467 buf
->sz
= mandoc_asprintf(&nbuf
, "%s%s%s",
1468 buf
->buf
, res
, cp
) + 1;
1470 /* Prepare for the next replacement. */
1473 stesc
= nbuf
+ (stesc
- buf
->buf
) + strlen(res
);
1481 * Process text streams.
1484 roff_parsetext(struct buf
*buf
, int pos
, int *offs
)
1490 enum mandoc_esc esc
;
1492 /* Spring the input line trap. */
1494 if (roffit_lines
== 1) {
1495 isz
= mandoc_asprintf(&p
, "%s\n.%s", buf
->buf
, roffit_macro
);
1502 return ROFF_REPARSE
;
1503 } else if (roffit_lines
> 1)
1506 /* Convert all breakable hyphens into ASCII_HYPH. */
1508 start
= p
= buf
->buf
+ pos
;
1510 while (*p
!= '\0') {
1511 sz
= strcspn(p
, "-\\");
1518 /* Skip over escapes. */
1520 esc
= mandoc_escape((const char **)&p
, NULL
, NULL
);
1521 if (esc
== ESCAPE_ERROR
)
1526 } else if (p
== start
) {
1531 if (isalpha((unsigned char)p
[-1]) &&
1532 isalpha((unsigned char)p
[1]))
1540 roff_parseln(struct roff
*r
, int ln
, struct buf
*buf
, int *offs
)
1544 int pos
; /* parse point */
1545 int spos
; /* saved parse point for messages */
1546 int ppos
; /* original offset in buf->buf */
1547 int ctl
; /* macro line (boolean) */
1551 /* Handle in-line equation delimiters. */
1553 if (r
->tbl
== NULL
&&
1554 r
->last_eqn
!= NULL
&& r
->last_eqn
->delim
&&
1555 (r
->eqn
== NULL
|| r
->eqn_inline
)) {
1556 e
= roff_eqndelim(r
, buf
, pos
);
1557 if (e
== ROFF_REPARSE
)
1559 assert(e
== ROFF_CONT
);
1562 /* Expand some escape sequences. */
1564 e
= roff_res(r
, buf
, ln
, pos
);
1567 assert(e
== ROFF_CONT
);
1569 ctl
= roff_getcontrol(r
, buf
->buf
, &pos
);
1572 * First, if a scope is open and we're not a macro, pass the
1573 * text through the macro's filter.
1574 * Equations process all content themselves.
1575 * Tables process almost all content themselves, but we want
1576 * to warn about macros before passing it there.
1579 if (r
->last
!= NULL
&& ! ctl
) {
1581 assert(roffs
[t
].text
);
1582 e
= (*roffs
[t
].text
)(r
, t
, buf
, ln
, pos
, pos
, offs
);
1583 assert(e
== ROFF_IGN
|| e
== ROFF_CONT
);
1588 return eqn_read(&r
->eqn
, ln
, buf
->buf
, ppos
, offs
);
1589 if (r
->tbl
!= NULL
&& ( ! ctl
|| buf
->buf
[pos
] == '\0'))
1590 return tbl_read(r
->tbl
, ln
, buf
->buf
, ppos
);
1592 return roff_parsetext(buf
, pos
, offs
);
1594 /* Skip empty request lines. */
1596 if (buf
->buf
[pos
] == '"') {
1597 mandoc_msg(MANDOCERR_COMMENT_BAD
, r
->parse
,
1600 } else if (buf
->buf
[pos
] == '\0')
1604 * If a scope is open, go to the child handler for that macro,
1605 * as it may want to preprocess before doing anything with it.
1606 * Don't do so if an equation is open.
1611 assert(roffs
[t
].sub
);
1612 return (*roffs
[t
].sub
)(r
, t
, buf
, ln
, ppos
, pos
, offs
);
1615 /* No scope is open. This is a new request or macro. */
1618 t
= roff_parse(r
, buf
->buf
, &pos
, ln
, ppos
);
1620 /* Tables ignore most macros. */
1622 if (r
->tbl
!= NULL
&& (t
== ROFF_MAX
|| t
== ROFF_TS
)) {
1623 mandoc_msg(MANDOCERR_TBLMACRO
, r
->parse
,
1624 ln
, pos
, buf
->buf
+ spos
);
1627 while (buf
->buf
[pos
] != '\0' && buf
->buf
[pos
] != ' ')
1629 while (buf
->buf
[pos
] != '\0' && buf
->buf
[pos
] == ' ')
1631 return tbl_read(r
->tbl
, ln
, buf
->buf
, pos
);
1635 * This is neither a roff request nor a user-defined macro.
1636 * Let the standard macro set parsers handle it.
1642 /* Execute a roff request or a user defined macro. */
1644 assert(roffs
[t
].proc
);
1645 return (*roffs
[t
].proc
)(r
, t
, buf
, ln
, ppos
, pos
, offs
);
1649 roff_endparse(struct roff
*r
)
1653 mandoc_msg(MANDOCERR_BLK_NOEND
, r
->parse
,
1654 r
->last
->line
, r
->last
->col
,
1655 roffs
[r
->last
->tok
].name
);
1658 mandoc_msg(MANDOCERR_BLK_NOEND
, r
->parse
,
1659 r
->eqn
->eqn
.ln
, r
->eqn
->eqn
.pos
, "EQ");
1664 mandoc_msg(MANDOCERR_BLK_NOEND
, r
->parse
,
1665 r
->tbl
->line
, r
->tbl
->pos
, "TS");
1671 * Parse a roff node's type from the input buffer. This must be in the
1672 * form of ".foo xxx" in the usual way.
1675 roff_parse(struct roff
*r
, char *buf
, int *pos
, int ln
, int ppos
)
1684 if ('\0' == *cp
|| '"' == *cp
|| '\t' == *cp
|| ' ' == *cp
)
1688 maclen
= roff_getname(r
, &cp
, ln
, ppos
);
1690 t
= (r
->current_string
= roff_getstrn(r
, mac
, maclen
))
1691 ? ROFF_USERDEF
: roffhash_find(mac
, maclen
);
1699 /* --- handling of request blocks ----------------------------------------- */
1702 roff_cblock(ROFF_ARGS
)
1706 * A block-close `..' should only be invoked as a child of an
1707 * ignore macro, otherwise raise a warning and just ignore it.
1710 if (r
->last
== NULL
) {
1711 mandoc_msg(MANDOCERR_BLK_NOTOPEN
, r
->parse
,
1716 switch (r
->last
->tok
) {
1718 /* ROFF_am1 is remapped to ROFF_am in roff_block(). */
1721 /* ROFF_de1 is remapped to ROFF_de in roff_block(). */
1726 mandoc_msg(MANDOCERR_BLK_NOTOPEN
, r
->parse
,
1731 if (buf
->buf
[pos
] != '\0')
1732 mandoc_vmsg(MANDOCERR_ARG_SKIP
, r
->parse
, ln
, pos
,
1733 ".. %s", buf
->buf
+ pos
);
1736 roffnode_cleanscope(r
);
1742 roffnode_cleanscope(struct roff
*r
)
1746 if (--r
->last
->endspan
!= 0)
1753 roff_ccond(struct roff
*r
, int ln
, int ppos
)
1756 if (NULL
== r
->last
) {
1757 mandoc_msg(MANDOCERR_BLK_NOTOPEN
, r
->parse
,
1762 switch (r
->last
->tok
) {
1768 mandoc_msg(MANDOCERR_BLK_NOTOPEN
, r
->parse
,
1773 if (r
->last
->endspan
> -1) {
1774 mandoc_msg(MANDOCERR_BLK_NOTOPEN
, r
->parse
,
1780 roffnode_cleanscope(r
);
1785 roff_block(ROFF_ARGS
)
1791 /* Ignore groff compatibility mode for now. */
1793 if (tok
== ROFF_de1
)
1795 else if (tok
== ROFF_dei1
)
1797 else if (tok
== ROFF_am1
)
1799 else if (tok
== ROFF_ami1
)
1802 /* Parse the macro name argument. */
1804 cp
= buf
->buf
+ pos
;
1805 if (tok
== ROFF_ig
) {
1810 namesz
= roff_getname(r
, &cp
, ln
, ppos
);
1811 iname
[namesz
] = '\0';
1814 /* Resolve the macro name argument if it is indirect. */
1816 if (namesz
&& (tok
== ROFF_dei
|| tok
== ROFF_ami
)) {
1817 if ((name
= roff_getstrn(r
, iname
, namesz
)) == NULL
) {
1818 mandoc_vmsg(MANDOCERR_STR_UNDEF
,
1819 r
->parse
, ln
, (int)(iname
- buf
->buf
),
1820 "%.*s", (int)namesz
, iname
);
1823 namesz
= strlen(name
);
1827 if (namesz
== 0 && tok
!= ROFF_ig
) {
1828 mandoc_msg(MANDOCERR_REQ_EMPTY
, r
->parse
,
1829 ln
, ppos
, roffs
[tok
].name
);
1833 roffnode_push(r
, tok
, name
, ln
, ppos
);
1836 * At the beginning of a `de' macro, clear the existing string
1837 * with the same name, if there is one. New content will be
1838 * appended from roff_block_text() in multiline mode.
1841 if (tok
== ROFF_de
|| tok
== ROFF_dei
)
1842 roff_setstrn(&r
->strtab
, name
, namesz
, "", 0, 0);
1847 /* Get the custom end marker. */
1850 namesz
= roff_getname(r
, &cp
, ln
, ppos
);
1852 /* Resolve the end marker if it is indirect. */
1854 if (namesz
&& (tok
== ROFF_dei
|| tok
== ROFF_ami
)) {
1855 if ((name
= roff_getstrn(r
, iname
, namesz
)) == NULL
) {
1856 mandoc_vmsg(MANDOCERR_STR_UNDEF
,
1857 r
->parse
, ln
, (int)(iname
- buf
->buf
),
1858 "%.*s", (int)namesz
, iname
);
1861 namesz
= strlen(name
);
1866 r
->last
->end
= mandoc_strndup(name
, namesz
);
1869 mandoc_vmsg(MANDOCERR_ARG_EXCESS
, r
->parse
,
1870 ln
, pos
, ".%s ... %s", roffs
[tok
].name
, cp
);
1876 roff_block_sub(ROFF_ARGS
)
1882 * First check whether a custom macro exists at this level. If
1883 * it does, then check against it. This is some of groff's
1884 * stranger behaviours. If we encountered a custom end-scope
1885 * tag and that tag also happens to be a "real" macro, then we
1886 * need to try interpreting it again as a real macro. If it's
1887 * not, then return ignore. Else continue.
1891 for (i
= pos
, j
= 0; r
->last
->end
[j
]; j
++, i
++)
1892 if (buf
->buf
[i
] != r
->last
->end
[j
])
1895 if (r
->last
->end
[j
] == '\0' &&
1896 (buf
->buf
[i
] == '\0' ||
1897 buf
->buf
[i
] == ' ' ||
1898 buf
->buf
[i
] == '\t')) {
1900 roffnode_cleanscope(r
);
1902 while (buf
->buf
[i
] == ' ' || buf
->buf
[i
] == '\t')
1906 if (roff_parse(r
, buf
->buf
, &pos
, ln
, ppos
) !=
1914 * If we have no custom end-query or lookup failed, then try
1915 * pulling it out of the hashtable.
1918 t
= roff_parse(r
, buf
->buf
, &pos
, ln
, ppos
);
1920 if (t
!= ROFF_cblock
) {
1922 roff_setstr(r
, r
->last
->name
, buf
->buf
+ ppos
, 2);
1926 assert(roffs
[t
].proc
);
1927 return (*roffs
[t
].proc
)(r
, t
, buf
, ln
, ppos
, pos
, offs
);
1931 roff_block_text(ROFF_ARGS
)
1935 roff_setstr(r
, r
->last
->name
, buf
->buf
+ pos
, 2);
1941 roff_cond_sub(ROFF_ARGS
)
1948 roffnode_cleanscope(r
);
1949 t
= roff_parse(r
, buf
->buf
, &pos
, ln
, ppos
);
1952 * Fully handle known macros when they are structurally
1953 * required or when the conditional evaluated to true.
1956 if ((t
!= ROFF_MAX
) &&
1957 (rr
|| roffs
[t
].flags
& ROFFMAC_STRUCT
)) {
1958 assert(roffs
[t
].proc
);
1959 return (*roffs
[t
].proc
)(r
, t
, buf
, ln
, ppos
, pos
, offs
);
1963 * If `\}' occurs on a macro line without a preceding macro,
1964 * drop the line completely.
1967 ep
= buf
->buf
+ pos
;
1968 if (ep
[0] == '\\' && ep
[1] == '}')
1971 /* Always check for the closing delimiter `\}'. */
1973 while ((ep
= strchr(ep
, '\\')) != NULL
) {
1974 if (*(++ep
) == '}') {
1976 roff_ccond(r
, ln
, ep
- buf
->buf
- 1);
1981 return rr
? ROFF_CONT
: ROFF_IGN
;
1985 roff_cond_text(ROFF_ARGS
)
1991 roffnode_cleanscope(r
);
1993 ep
= buf
->buf
+ pos
;
1994 while ((ep
= strchr(ep
, '\\')) != NULL
) {
1995 if (*(++ep
) == '}') {
1997 roff_ccond(r
, ln
, ep
- buf
->buf
- 1);
2002 return rr
? ROFF_CONT
: ROFF_IGN
;
2005 /* --- handling of numeric and conditional expressions -------------------- */
2008 * Parse a single signed integer number. Stop at the first non-digit.
2009 * If there is at least one digit, return success and advance the
2010 * parse point, else return failure and let the parse point unchanged.
2011 * Ignore overflows, treat them just like the C language.
2014 roff_getnum(const char *v
, int *pos
, int *res
, int flags
)
2016 int myres
, scaled
, n
, p
;
2023 if (n
|| v
[p
] == '+')
2026 if (flags
& ROFFNUM_WHITE
)
2027 while (isspace((unsigned char)v
[p
]))
2030 for (*res
= 0; isdigit((unsigned char)v
[p
]); p
++)
2031 *res
= 10 * *res
+ v
[p
] - '0';
2038 /* Each number may be followed by one optional scaling unit. */
2042 scaled
= *res
* 65536;
2045 scaled
= *res
* 240;
2048 scaled
= *res
* 240 / 2.54;
2059 scaled
= *res
* 10 / 3;
2065 scaled
= *res
* 6 / 25;
2072 if (flags
& ROFFNUM_SCALE
)
2080 * Evaluate a string comparison condition.
2081 * The first character is the delimiter.
2082 * Succeed if the string up to its second occurrence
2083 * matches the string up to its third occurence.
2084 * Advance the cursor after the third occurrence
2085 * or lacking that, to the end of the line.
2088 roff_evalstrcond(const char *v
, int *pos
)
2090 const char *s1
, *s2
, *s3
;
2094 s1
= v
+ *pos
; /* initial delimiter */
2095 s2
= s1
+ 1; /* for scanning the first string */
2096 s3
= strchr(s2
, *s1
); /* for scanning the second string */
2098 if (NULL
== s3
) /* found no middle delimiter */
2101 while ('\0' != *++s3
) {
2102 if (*s2
!= *s3
) { /* mismatch */
2103 s3
= strchr(s3
, *s1
);
2106 if (*s3
== *s1
) { /* found the final delimiter */
2115 s3
= strchr(s2
, '\0');
2116 else if (*s3
!= '\0')
2123 * Evaluate an optionally negated single character, numerical,
2124 * or string condition.
2127 roff_evalcond(struct roff
*r
, int ln
, char *v
, int *pos
)
2131 int number
, savepos
, wanttrue
;
2133 if ('!' == v
[*pos
]) {
2154 cp
= name
= v
+ ++*pos
;
2155 sz
= roff_getname(r
, &cp
, ln
, *pos
);
2157 return (sz
&& roff_hasregn(r
, name
, sz
)) == wanttrue
;
2163 if (roff_evalnum(r
, ln
, v
, pos
, &number
, ROFFNUM_SCALE
))
2164 return (number
> 0) == wanttrue
;
2165 else if (*pos
== savepos
)
2166 return roff_evalstrcond(v
, pos
) == wanttrue
;
2172 roff_line_ignore(ROFF_ARGS
)
2179 roff_insec(ROFF_ARGS
)
2182 mandoc_msg(MANDOCERR_REQ_INSEC
, r
->parse
,
2183 ln
, ppos
, roffs
[tok
].name
);
2188 roff_unsupp(ROFF_ARGS
)
2191 mandoc_msg(MANDOCERR_REQ_UNSUPP
, r
->parse
,
2192 ln
, ppos
, roffs
[tok
].name
);
2197 roff_cond(ROFF_ARGS
)
2200 roffnode_push(r
, tok
, NULL
, ln
, ppos
);
2203 * An `.el' has no conditional body: it will consume the value
2204 * of the current rstack entry set in prior `ie' calls or
2207 * If we're not an `el', however, then evaluate the conditional.
2210 r
->last
->rule
= tok
== ROFF_el
?
2211 (r
->rstackpos
< 0 ? 0 : r
->rstack
[r
->rstackpos
--]) :
2212 roff_evalcond(r
, ln
, buf
->buf
, &pos
);
2215 * An if-else will put the NEGATION of the current evaluated
2216 * conditional into the stack of rules.
2219 if (tok
== ROFF_ie
) {
2220 if (r
->rstackpos
+ 1 == r
->rstacksz
) {
2222 r
->rstack
= mandoc_reallocarray(r
->rstack
,
2223 r
->rstacksz
, sizeof(int));
2225 r
->rstack
[++r
->rstackpos
] = !r
->last
->rule
;
2228 /* If the parent has false as its rule, then so do we. */
2230 if (r
->last
->parent
&& !r
->last
->parent
->rule
)
2235 * If there is nothing on the line after the conditional,
2236 * not even whitespace, use next-line scope.
2239 if (buf
->buf
[pos
] == '\0') {
2240 r
->last
->endspan
= 2;
2244 while (buf
->buf
[pos
] == ' ')
2247 /* An opening brace requests multiline scope. */
2249 if (buf
->buf
[pos
] == '\\' && buf
->buf
[pos
+ 1] == '{') {
2250 r
->last
->endspan
= -1;
2252 while (buf
->buf
[pos
] == ' ')
2258 * Anything else following the conditional causes
2259 * single-line scope. Warn if the scope contains
2260 * nothing but trailing whitespace.
2263 if (buf
->buf
[pos
] == '\0')
2264 mandoc_msg(MANDOCERR_COND_EMPTY
, r
->parse
,
2265 ln
, ppos
, roffs
[tok
].name
);
2267 r
->last
->endspan
= 1;
2281 /* Ignore groff compatibility mode for now. */
2283 if (tok
== ROFF_ds1
)
2285 else if (tok
== ROFF_as1
)
2289 * The first word is the name of the string.
2290 * If it is empty or terminated by an escape sequence,
2291 * abort the `ds' request without defining anything.
2294 name
= string
= buf
->buf
+ pos
;
2298 namesz
= roff_getname(r
, &string
, ln
, pos
);
2299 if (name
[namesz
] == '\\')
2302 /* Read past the initial double-quote, if any. */
2306 /* The rest is the value. */
2307 roff_setstrn(&r
->strtab
, name
, namesz
, string
, strlen(string
),
2313 * Parse a single operator, one or two characters long.
2314 * If the operator is recognized, return success and advance the
2315 * parse point, else return failure and let the parse point unchanged.
2318 roff_getop(const char *v
, int *pos
, char *res
)
2333 switch (v
[*pos
+ 1]) {
2351 switch (v
[*pos
+ 1]) {
2365 if ('=' == v
[*pos
+ 1])
2377 * Evaluate either a parenthesized numeric expression
2378 * or a single signed integer number.
2381 roff_evalpar(struct roff
*r
, int ln
,
2382 const char *v
, int *pos
, int *res
, int flags
)
2386 return roff_getnum(v
, pos
, res
, flags
);
2389 if ( ! roff_evalnum(r
, ln
, v
, pos
, res
, flags
| ROFFNUM_WHITE
))
2393 * Omission of the closing parenthesis
2394 * is an error in validation mode,
2395 * but ignored in evaluation mode.
2400 else if (NULL
== res
)
2407 * Evaluate a complete numeric expression.
2408 * Proceed left to right, there is no concept of precedence.
2411 roff_evalnum(struct roff
*r
, int ln
, const char *v
,
2412 int *pos
, int *res
, int flags
)
2414 int mypos
, operand2
;
2422 if (flags
& ROFFNUM_WHITE
)
2423 while (isspace((unsigned char)v
[*pos
]))
2426 if ( ! roff_evalpar(r
, ln
, v
, pos
, res
, flags
))
2430 if (flags
& ROFFNUM_WHITE
)
2431 while (isspace((unsigned char)v
[*pos
]))
2434 if ( ! roff_getop(v
, pos
, &operator))
2437 if (flags
& ROFFNUM_WHITE
)
2438 while (isspace((unsigned char)v
[*pos
]))
2441 if ( ! roff_evalpar(r
, ln
, v
, pos
, &operand2
, flags
))
2444 if (flags
& ROFFNUM_WHITE
)
2445 while (isspace((unsigned char)v
[*pos
]))
2462 if (operand2
== 0) {
2463 mandoc_msg(MANDOCERR_DIVZERO
,
2464 r
->parse
, ln
, *pos
, v
);
2471 if (operand2
== 0) {
2472 mandoc_msg(MANDOCERR_DIVZERO
,
2473 r
->parse
, ln
, *pos
, v
);
2480 *res
= *res
< operand2
;
2483 *res
= *res
> operand2
;
2486 *res
= *res
<= operand2
;
2489 *res
= *res
>= operand2
;
2492 *res
= *res
== operand2
;
2495 *res
= *res
!= operand2
;
2498 *res
= *res
&& operand2
;
2501 *res
= *res
|| operand2
;
2504 if (operand2
< *res
)
2508 if (operand2
> *res
)
2518 /* --- register management ------------------------------------------------ */
2521 roff_setreg(struct roff
*r
, const char *name
, int val
, char sign
)
2523 struct roffreg
*reg
;
2525 /* Search for an existing register with the same name. */
2528 while (reg
&& strcmp(name
, reg
->key
.p
))
2532 /* Create a new register. */
2533 reg
= mandoc_malloc(sizeof(struct roffreg
));
2534 reg
->key
.p
= mandoc_strdup(name
);
2535 reg
->key
.sz
= strlen(name
);
2537 reg
->next
= r
->regtab
;
2543 else if ('-' == sign
)
2550 * Handle some predefined read-only number registers.
2551 * For now, return -1 if the requested register is not predefined;
2552 * in case a predefined read-only register having the value -1
2553 * were to turn up, another special value would have to be chosen.
2556 roff_getregro(const struct roff
*r
, const char *name
)
2560 case '$': /* Number of arguments of the last macro evaluated. */
2562 case 'A': /* ASCII approximation mode is always off. */
2564 case 'g': /* Groff compatibility mode is always on. */
2566 case 'H': /* Fixed horizontal resolution. */
2568 case 'j': /* Always adjust left margin only. */
2570 case 'T': /* Some output device is always defined. */
2572 case 'V': /* Fixed vertical resolution. */
2580 roff_getreg(const struct roff
*r
, const char *name
)
2582 struct roffreg
*reg
;
2585 if ('.' == name
[0] && '\0' != name
[1] && '\0' == name
[2]) {
2586 val
= roff_getregro(r
, name
+ 1);
2591 for (reg
= r
->regtab
; reg
; reg
= reg
->next
)
2592 if (0 == strcmp(name
, reg
->key
.p
))
2599 roff_getregn(const struct roff
*r
, const char *name
, size_t len
)
2601 struct roffreg
*reg
;
2604 if ('.' == name
[0] && 2 == len
) {
2605 val
= roff_getregro(r
, name
+ 1);
2610 for (reg
= r
->regtab
; reg
; reg
= reg
->next
)
2611 if (len
== reg
->key
.sz
&&
2612 0 == strncmp(name
, reg
->key
.p
, len
))
2619 roff_hasregn(const struct roff
*r
, const char *name
, size_t len
)
2621 struct roffreg
*reg
;
2624 if ('.' == name
[0] && 2 == len
) {
2625 val
= roff_getregro(r
, name
+ 1);
2630 for (reg
= r
->regtab
; reg
; reg
= reg
->next
)
2631 if (len
== reg
->key
.sz
&&
2632 0 == strncmp(name
, reg
->key
.p
, len
))
2639 roff_freereg(struct roffreg
*reg
)
2641 struct roffreg
*old_reg
;
2643 while (NULL
!= reg
) {
2659 key
= val
= buf
->buf
+ pos
;
2663 keysz
= roff_getname(r
, &val
, ln
, pos
);
2664 if (key
[keysz
] == '\\')
2669 if (sign
== '+' || sign
== '-')
2672 if (roff_evalnum(r
, ln
, val
, NULL
, &iv
, ROFFNUM_SCALE
))
2673 roff_setreg(r
, key
, iv
, sign
);
2681 struct roffreg
*reg
, **prev
;
2685 name
= cp
= buf
->buf
+ pos
;
2688 namesz
= roff_getname(r
, &cp
, ln
, pos
);
2689 name
[namesz
] = '\0';
2694 if (reg
== NULL
|| !strcmp(name
, reg
->key
.p
))
2706 /* --- handler functions for roff requests -------------------------------- */
2715 cp
= buf
->buf
+ pos
;
2716 while (*cp
!= '\0') {
2718 namesz
= roff_getname(r
, &cp
, ln
, (int)(cp
- buf
->buf
));
2719 roff_setstrn(&r
->strtab
, name
, namesz
, NULL
, 0, 0);
2720 if (name
[namesz
] == '\\')
2731 /* Parse the number of lines. */
2733 if ( ! roff_evalnum(r
, ln
, buf
->buf
, &pos
, &iv
, 0)) {
2734 mandoc_msg(MANDOCERR_IT_NONUM
, r
->parse
,
2735 ln
, ppos
, buf
->buf
+ 1);
2739 while (isspace((unsigned char)buf
->buf
[pos
]))
2743 * Arm the input line trap.
2744 * Special-casing "an-trap" is an ugly workaround to cope
2745 * with DocBook stupidly fiddling with man(7) internals.
2749 roffit_macro
= mandoc_strdup(iv
!= 1 ||
2750 strcmp(buf
->buf
+ pos
, "an-trap") ?
2751 buf
->buf
+ pos
: "br");
2758 const char *const *cp
;
2760 if ((r
->options
& (MPARSE_MDOC
| MPARSE_QUICK
)) == 0)
2761 for (cp
= __mdoc_reserved
; *cp
; cp
++)
2762 roff_setstr(r
, *cp
, NULL
, 0);
2765 r
->format
= MPARSE_MDOC
;
2773 const char *const *cp
;
2775 if ((r
->options
& MPARSE_QUICK
) == 0)
2776 for (cp
= __man_reserved
; *cp
; cp
++)
2777 roff_setstr(r
, *cp
, NULL
, 0);
2780 r
->format
= MPARSE_MAN
;
2790 mandoc_msg(MANDOCERR_BLK_NOTOPEN
, r
->parse
,
2792 else if ( ! tbl_end(&r
->tbl
)) {
2794 buf
->buf
= mandoc_strdup(".sp");
2796 return ROFF_REPARSE
;
2806 mandoc_msg(MANDOCERR_BLK_NOTOPEN
, r
->parse
,
2809 tbl_restart(ppos
, ln
, r
->tbl
);
2815 * Handle in-line equation delimiters.
2818 roff_eqndelim(struct roff
*r
, struct buf
*buf
, int pos
)
2821 const char *bef_pr
, *bef_nl
, *mac
, *aft_nl
, *aft_pr
;
2824 * Outside equations, look for an opening delimiter.
2825 * If we are inside an equation, we already know it is
2826 * in-line, or this function wouldn't have been called;
2827 * so look for a closing delimiter.
2830 cp1
= buf
->buf
+ pos
;
2831 cp2
= strchr(cp1
, r
->eqn
== NULL
?
2832 r
->last_eqn
->odelim
: r
->last_eqn
->cdelim
);
2837 bef_pr
= bef_nl
= aft_nl
= aft_pr
= "";
2839 /* Handle preceding text, protecting whitespace. */
2841 if (*buf
->buf
!= '\0') {
2848 * Prepare replacing the delimiter with an equation macro
2849 * and drop leading white space from the equation.
2852 if (r
->eqn
== NULL
) {
2859 /* Handle following text, protecting whitespace. */
2867 /* Do the actual replacement. */
2869 buf
->sz
= mandoc_asprintf(&cp1
, "%s%s%s%s%s%s%s", buf
->buf
,
2870 bef_pr
, bef_nl
, mac
, aft_nl
, aft_pr
, cp2
) + 1;
2874 /* Toggle the in-line state of the eqn subsystem. */
2876 r
->eqn_inline
= r
->eqn
== NULL
;
2877 return ROFF_REPARSE
;
2885 assert(r
->eqn
== NULL
);
2886 e
= eqn_alloc(ppos
, ln
, r
->parse
);
2889 r
->last_eqn
->next
= e
;
2890 e
->delim
= r
->last_eqn
->delim
;
2891 e
->odelim
= r
->last_eqn
->odelim
;
2892 e
->cdelim
= r
->last_eqn
->cdelim
;
2894 r
->first_eqn
= r
->last_eqn
= e
;
2896 r
->eqn
= r
->last_eqn
= e
;
2898 if (buf
->buf
[pos
] != '\0')
2899 mandoc_vmsg(MANDOCERR_ARG_SKIP
, r
->parse
, ln
, pos
,
2900 ".EQ %s", buf
->buf
+ pos
);
2909 mandoc_msg(MANDOCERR_BLK_NOTOPEN
, r
->parse
, ln
, ppos
, "EN");
2916 struct tbl_node
*tbl
;
2919 mandoc_msg(MANDOCERR_BLK_BROKEN
, r
->parse
,
2920 ln
, ppos
, "TS breaks TS");
2924 tbl
= tbl_alloc(ppos
, ln
, r
->parse
);
2927 r
->last_tbl
->next
= tbl
;
2929 r
->first_tbl
= r
->last_tbl
= tbl
;
2931 r
->tbl
= r
->last_tbl
= tbl
;
2939 buf
->buf
[pos
- 1] = '\0';
2950 if (*p
== '\0' || (r
->control
= *p
++) == '.')
2954 mandoc_vmsg(MANDOCERR_ARG_EXCESS
, r
->parse
,
2955 ln
, p
- buf
->buf
, "cc ... %s", p
);
2963 const char *p
, *first
, *second
;
2965 enum mandoc_esc esc
;
2970 mandoc_msg(MANDOCERR_REQ_EMPTY
, r
->parse
, ln
, ppos
, "tr");
2974 while (*p
!= '\0') {
2978 if (*first
== '\\') {
2979 esc
= mandoc_escape(&p
, NULL
, NULL
);
2980 if (esc
== ESCAPE_ERROR
) {
2981 mandoc_msg(MANDOCERR_ESC_BAD
, r
->parse
,
2982 ln
, (int)(p
- buf
->buf
), first
);
2985 fsz
= (size_t)(p
- first
);
2989 if (*second
== '\\') {
2990 esc
= mandoc_escape(&p
, NULL
, NULL
);
2991 if (esc
== ESCAPE_ERROR
) {
2992 mandoc_msg(MANDOCERR_ESC_BAD
, r
->parse
,
2993 ln
, (int)(p
- buf
->buf
), second
);
2996 ssz
= (size_t)(p
- second
);
2997 } else if (*second
== '\0') {
2998 mandoc_vmsg(MANDOCERR_TR_ODD
, r
->parse
,
2999 ln
, first
- buf
->buf
, "tr %s", first
);
3005 roff_setstrn(&r
->xmbtab
, first
, fsz
,
3010 if (r
->xtab
== NULL
)
3011 r
->xtab
= mandoc_calloc(128,
3012 sizeof(struct roffstr
));
3014 free(r
->xtab
[(int)*first
].p
);
3015 r
->xtab
[(int)*first
].p
= mandoc_strndup(second
, ssz
);
3016 r
->xtab
[(int)*first
].sz
= ssz
;
3027 name
= buf
->buf
+ pos
;
3028 mandoc_vmsg(MANDOCERR_SO
, r
->parse
, ln
, ppos
, "so %s", name
);
3031 * Handle `so'. Be EXTREMELY careful, as we shouldn't be
3032 * opening anything that's not in our cwd or anything beneath
3033 * it. Thus, explicitly disallow traversing up the file-system
3034 * or using absolute paths.
3037 if (*name
== '/' || strstr(name
, "../") || strstr(name
, "/..")) {
3038 mandoc_vmsg(MANDOCERR_SO_PATH
, r
->parse
, ln
, ppos
,
3040 buf
->sz
= mandoc_asprintf(&cp
,
3041 ".sp\nSee the file %s.\n.sp", name
) + 1;
3045 return ROFF_REPARSE
;
3052 /* --- user defined strings and macros ------------------------------------ */
3055 roff_userdef(ROFF_ARGS
)
3057 const char *arg
[9], *ap
;
3063 * Collect pointers to macro argument strings
3064 * and NUL-terminate them.
3068 cp
= buf
->buf
+ pos
;
3069 for (i
= 0; i
< 9; i
++) {
3073 arg
[i
] = mandoc_getarg(r
->parse
, &cp
, ln
, &pos
);
3079 * Expand macro arguments.
3082 buf
->sz
= strlen(r
->current_string
) + 1;
3083 n1
= cp
= mandoc_malloc(buf
->sz
);
3084 memcpy(n1
, r
->current_string
, buf
->sz
);
3085 while (*cp
!= '\0') {
3087 /* Scan ahead for the next argument invocation. */
3093 if (*cp
== '*') { /* \\$* inserts all arguments */
3096 } else { /* \\$1 .. \\$9 insert one argument */
3097 ib
= ie
= *cp
- '1';
3098 if (ib
< 0 || ib
> 8)
3104 * Determine the size of the expanded argument,
3105 * taking escaping of quotes into account.
3108 asz
= ie
> ib
? ie
- ib
: 0; /* for blanks */
3109 for (i
= ib
; i
<= ie
; i
++) {
3110 for (ap
= arg
[i
]; *ap
!= '\0'; ap
++) {
3119 * Determine the size of the rest of the
3120 * unexpanded macro, including the NUL.
3123 rsz
= buf
->sz
- (cp
- n1
) - 3;
3126 * When shrinking, move before
3127 * releasing the storage.
3131 memmove(cp
+ asz
, cp
+ 3, rsz
);
3134 * Resize the storage for the macro
3135 * and readjust the parse pointer.
3139 n2
= mandoc_realloc(n1
, buf
->sz
);
3140 cp
= n2
+ (cp
- n1
);
3144 * When growing, make room
3145 * for the expanded argument.
3149 memmove(cp
+ asz
, cp
+ 3, rsz
);
3152 /* Copy the expanded argument, escaping quotes. */
3155 for (i
= ib
; i
<= ie
; i
++) {
3156 for (ap
= arg
[i
]; *ap
!= '\0'; ap
++) {
3158 memcpy(n2
, "\\(dq", 4);
3169 * Replace the macro invocation
3170 * by the expanded macro.
3177 return buf
->sz
> 1 && buf
->buf
[buf
->sz
- 2] == '\n' ?
3178 ROFF_REPARSE
: ROFF_APPEND
;
3182 roff_getname(struct roff
*r
, char **cpp
, int ln
, int pos
)
3191 /* Read until end of name and terminate it with NUL. */
3192 for (cp
= name
; 1; cp
++) {
3193 if ('\0' == *cp
|| ' ' == *cp
) {
3200 if ('{' == cp
[1] || '}' == cp
[1])
3205 mandoc_vmsg(MANDOCERR_NAMESC
, r
->parse
, ln
, pos
,
3206 "%.*s", (int)(cp
- name
+ 1), name
);
3207 mandoc_escape((const char **)&cp
, NULL
, NULL
);
3211 /* Read past spaces. */
3220 * Store *string into the user-defined string called *name.
3221 * To clear an existing entry, call with (*r, *name, NULL, 0).
3222 * append == 0: replace mode
3223 * append == 1: single-line append mode
3224 * append == 2: multiline append mode, append '\n' after each call
3227 roff_setstr(struct roff
*r
, const char *name
, const char *string
,
3231 roff_setstrn(&r
->strtab
, name
, strlen(name
), string
,
3232 string
? strlen(string
) : 0, append
);
3236 roff_setstrn(struct roffkv
**r
, const char *name
, size_t namesz
,
3237 const char *string
, size_t stringsz
, int append
)
3242 size_t oldch
, newch
;
3244 /* Search for an existing string with the same name. */
3247 while (n
&& (namesz
!= n
->key
.sz
||
3248 strncmp(n
->key
.p
, name
, namesz
)))
3252 /* Create a new string table entry. */
3253 n
= mandoc_malloc(sizeof(struct roffkv
));
3254 n
->key
.p
= mandoc_strndup(name
, namesz
);
3260 } else if (0 == append
) {
3270 * One additional byte for the '\n' in multiline mode,
3271 * and one for the terminating '\0'.
3273 newch
= stringsz
+ (1 < append
? 2u : 1u);
3275 if (NULL
== n
->val
.p
) {
3276 n
->val
.p
= mandoc_malloc(newch
);
3281 n
->val
.p
= mandoc_realloc(n
->val
.p
, oldch
+ newch
);
3284 /* Skip existing content in the destination buffer. */
3285 c
= n
->val
.p
+ (int)oldch
;
3287 /* Append new content to the destination buffer. */
3289 while (i
< (int)stringsz
) {
3291 * Rudimentary roff copy mode:
3292 * Handle escaped backslashes.
3294 if ('\\' == string
[i
] && '\\' == string
[i
+ 1])
3299 /* Append terminating bytes. */
3304 n
->val
.sz
= (int)(c
- n
->val
.p
);
3308 roff_getstrn(const struct roff
*r
, const char *name
, size_t len
)
3310 const struct roffkv
*n
;
3313 for (n
= r
->strtab
; n
; n
= n
->next
)
3314 if (0 == strncmp(name
, n
->key
.p
, len
) &&
3315 '\0' == n
->key
.p
[(int)len
])
3318 for (i
= 0; i
< PREDEFS_MAX
; i
++)
3319 if (0 == strncmp(name
, predefs
[i
].name
, len
) &&
3320 '\0' == predefs
[i
].name
[(int)len
])
3321 return predefs
[i
].str
;
3327 roff_freestr(struct roffkv
*r
)
3329 struct roffkv
*n
, *nn
;
3331 for (n
= r
; n
; n
= nn
) {
3339 /* --- accessors and utility functions ------------------------------------ */
3341 const struct tbl_span
*
3342 roff_span(const struct roff
*r
)
3345 return r
->tbl
? tbl_span(r
->tbl
) : NULL
;
3349 roff_eqn(const struct roff
*r
)
3352 return r
->last_eqn
? &r
->last_eqn
->eqn
: NULL
;
3356 * Duplicate an input string, making the appropriate character
3357 * conversations (as stipulated by `tr') along the way.
3358 * Returns a heap-allocated string with all the replacements made.
3361 roff_strdup(const struct roff
*r
, const char *p
)
3363 const struct roffkv
*cp
;
3367 enum mandoc_esc esc
;
3369 if (NULL
== r
->xmbtab
&& NULL
== r
->xtab
)
3370 return mandoc_strdup(p
);
3371 else if ('\0' == *p
)
3372 return mandoc_strdup("");
3375 * Step through each character looking for term matches
3376 * (remember that a `tr' can be invoked with an escape, which is
3377 * a glyph but the escape is multi-character).
3378 * We only do this if the character hash has been initialised
3379 * and the string is >0 length.
3385 while ('\0' != *p
) {
3386 if ('\\' != *p
&& r
->xtab
&& r
->xtab
[(int)*p
].p
) {
3387 sz
= r
->xtab
[(int)*p
].sz
;
3388 res
= mandoc_realloc(res
, ssz
+ sz
+ 1);
3389 memcpy(res
+ ssz
, r
->xtab
[(int)*p
].p
, sz
);
3393 } else if ('\\' != *p
) {
3394 res
= mandoc_realloc(res
, ssz
+ 2);
3399 /* Search for term matches. */
3400 for (cp
= r
->xmbtab
; cp
; cp
= cp
->next
)
3401 if (0 == strncmp(p
, cp
->key
.p
, cp
->key
.sz
))
3406 * A match has been found.
3407 * Append the match to the array and move
3408 * forward by its keysize.
3410 res
= mandoc_realloc(res
,
3411 ssz
+ cp
->val
.sz
+ 1);
3412 memcpy(res
+ ssz
, cp
->val
.p
, cp
->val
.sz
);
3414 p
+= (int)cp
->key
.sz
;
3419 * Handle escapes carefully: we need to copy
3420 * over just the escape itself, or else we might
3421 * do replacements within the escape itself.
3422 * Make sure to pass along the bogus string.
3425 esc
= mandoc_escape(&p
, NULL
, NULL
);
3426 if (ESCAPE_ERROR
== esc
) {
3428 res
= mandoc_realloc(res
, ssz
+ sz
+ 1);
3429 memcpy(res
+ ssz
, pp
, sz
);
3433 * We bail out on bad escapes.
3434 * No need to warn: we already did so when
3435 * roff_res() was called.
3438 res
= mandoc_realloc(res
, ssz
+ sz
+ 1);
3439 memcpy(res
+ ssz
, pp
, sz
);
3443 res
[(int)ssz
] = '\0';
3448 roff_getformat(const struct roff
*r
)
3455 * Find out whether a line is a macro line or not.
3456 * If it is, adjust the current position and return one; if it isn't,
3457 * return zero and don't change the current position.
3458 * If the control character has been set with `.cc', then let that grain
3460 * This is slighly contrary to groff, where using the non-breaking
3461 * control character when `cc' has been invoked will cause the
3462 * non-breaking macro contents to be printed verbatim.
3465 roff_getcontrol(const struct roff
*r
, const char *cp
, int *ppos
)
3471 if (0 != r
->control
&& cp
[pos
] == r
->control
)
3473 else if (0 != r
->control
)
3475 else if ('\\' == cp
[pos
] && '.' == cp
[pos
+ 1])
3477 else if ('.' == cp
[pos
] || '\'' == cp
[pos
])
3482 while (' ' == cp
[pos
] || '\t' == cp
[pos
])