Annotation of mandoc/roff_int.h, Revision 1.14
1.14 ! schwarze 1: /* $Id: roff_int.h,v 1.13 2018/12/31 04:55:47 schwarze Exp $ */
1.1 schwarze 2: /*
3: * Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
1.11 schwarze 4: * Copyright (c) 2013,2014,2015,2017,2018 Ingo Schwarze <schwarze@openbsd.org>
1.1 schwarze 5: *
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.
9: *
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.
1.11 schwarze 17: *
18: * Parser internals shared by multiple parsers.
1.1 schwarze 19: */
20:
1.12 schwarze 21: struct ohash;
22: struct roff_node;
23: struct roff_meta;
24: struct roff;
25: struct mdoc_arg;
26:
27: enum roff_next {
28: ROFF_NEXT_SIBLING = 0,
29: ROFF_NEXT_CHILD
30: };
31:
32: struct roff_man {
33: struct roff_meta meta; /* Public parse results. */
34: struct roff *roff; /* Roff parser state data. */
35: struct ohash *mdocmac; /* Mdoc macro lookup table. */
36: struct ohash *manmac; /* Man macro lookup table. */
37: const char *os_s; /* Default operating system. */
38: struct roff_node *last; /* The last node parsed. */
39: struct roff_node *last_es; /* The most recent Es node. */
40: int quick; /* Abort parse early. */
41: int flags; /* Parse flags. */
1.14 ! schwarze 42: #define ROFF_NOFILL (1 << 1) /* Fill mode switched off. */
1.12 schwarze 43: #define MDOC_PBODY (1 << 2) /* In the document body. */
44: #define MDOC_NEWLINE (1 << 3) /* First macro/text in a line. */
45: #define MDOC_PHRASE (1 << 4) /* In a Bl -column phrase. */
46: #define MDOC_PHRASELIT (1 << 5) /* Literal within a phrase. */
47: #define MDOC_FREECOL (1 << 6) /* `It' invocation should close. */
48: #define MDOC_SYNOPSIS (1 << 7) /* SYNOPSIS-style formatting. */
49: #define MDOC_KEEP (1 << 8) /* In a word keep. */
50: #define MDOC_SMOFF (1 << 9) /* Spacing is off. */
51: #define MDOC_NODELIMC (1 << 10) /* Disable closing delimiter handling. */
52: #define MAN_ELINE (1 << 11) /* Next-line element scope. */
53: #define MAN_BLINE (1 << 12) /* Next-line block scope. */
54: #define MDOC_PHRASEQF (1 << 13) /* Quote first word encountered. */
55: #define MDOC_PHRASEQL (1 << 14) /* Quote last word of this phrase. */
56: #define MDOC_PHRASEQN (1 << 15) /* Quote first word of the next phrase. */
1.14 ! schwarze 57: #define MDOC_LITERAL ROFF_NOFILL
1.12 schwarze 58: #define MAN_NEWLINE MDOC_NEWLINE
59: enum roff_sec lastsec; /* Last section seen. */
60: enum roff_sec lastnamed; /* Last standard section seen. */
61: enum roff_next next; /* Where to put the next node. */
62: };
63:
64:
1.1 schwarze 65: struct roff_node *roff_node_alloc(struct roff_man *, int, int,
66: enum roff_type, int);
67: void roff_node_append(struct roff_man *, struct roff_node *);
1.2 schwarze 68: void roff_word_alloc(struct roff_man *, int, int, const char *);
69: void roff_word_append(struct roff_man *, const char *);
1.3 schwarze 70: void roff_elem_alloc(struct roff_man *, int, int, int);
71: struct roff_node *roff_block_alloc(struct roff_man *, int, int, int);
1.1 schwarze 72: struct roff_node *roff_head_alloc(struct roff_man *, int, int, int);
73: struct roff_node *roff_body_alloc(struct roff_man *, int, int, int);
74: void roff_node_unlink(struct roff_man *, struct roff_node *);
1.10 schwarze 75: void roff_node_relink(struct roff_man *, struct roff_node *);
1.1 schwarze 76: void roff_node_free(struct roff_node *);
77: void roff_node_delete(struct roff_man *, struct roff_node *);
1.11 schwarze 78:
79: struct ohash *roffhash_alloc(enum roff_tok, enum roff_tok);
80: enum roff_tok roffhash_find(struct ohash *, const char *, size_t);
81: void roffhash_free(struct ohash *);
1.12 schwarze 82:
1.13 schwarze 83: void roff_state_reset(struct roff_man *);
1.12 schwarze 84: void roff_validate(struct roff_man *);
1.2 schwarze 85:
86: /*
87: * Functions called from roff.c need to be declared here,
88: * not in libmdoc.h or libman.h, even if they are specific
89: * to either the mdoc(7) or the man(7) parser.
90: */
91:
92: void man_breakscope(struct roff_man *, int);
93: void mdoc_argv_free(struct mdoc_arg *);
CVSweb