1 /* $Id: libmdoc.h,v 1.108 2015/11/07 14:01:16 schwarze Exp $ */ 2 /* 3 * Copyright (c) 2008, 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv> 4 * Copyright (c) 2013, 2014, 2015 Ingo Schwarze <schwarze@openbsd.org> 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. 17 */ 18 19 #define MACRO_PROT_ARGS struct roff_man *mdoc, \ 20 int tok, \ 21 int line, \ 22 int ppos, \ 23 int *pos, \ 24 char *buf 25 26 struct mdoc_macro { 27 void (*fp)(MACRO_PROT_ARGS); 28 int flags; 29 #define MDOC_CALLABLE (1 << 0) 30 #define MDOC_PARSED (1 << 1) 31 #define MDOC_EXPLICIT (1 << 2) 32 #define MDOC_PROLOGUE (1 << 3) 33 #define MDOC_IGNDELIM (1 << 4) 34 #define MDOC_JOIN (1 << 5) 35 }; 36 37 enum margserr { 38 ARGS_ERROR, 39 ARGS_EOLN, /* end-of-line */ 40 ARGS_WORD, /* normal word */ 41 ARGS_PUNCT, /* series of punctuation */ 42 ARGS_QWORD, /* quoted word */ 43 ARGS_PHRASE /* Bl -column phrase */ 44 }; 45 46 /* 47 * A punctuation delimiter is opening, closing, or "middle mark" 48 * punctuation. These govern spacing. 49 * Opening punctuation (e.g., the opening parenthesis) suppresses the 50 * following space; closing punctuation (e.g., the closing parenthesis) 51 * suppresses the leading space; middle punctuation (e.g., the vertical 52 * bar) can do either. The middle punctuation delimiter bends the rules 53 * depending on usage. 54 */ 55 enum mdelim { 56 DELIM_NONE = 0, 57 DELIM_OPEN, 58 DELIM_MIDDLE, 59 DELIM_CLOSE, 60 DELIM_MAX 61 }; 62 63 extern const struct mdoc_macro *const mdoc_macros; 64 65 66 void mdoc_macro(MACRO_PROT_ARGS); 67 void mdoc_elem_alloc(struct roff_man *, int, int, 68 int, struct mdoc_arg *); 69 struct roff_node *mdoc_block_alloc(struct roff_man *, int, int, 70 int, struct mdoc_arg *); 71 void mdoc_tail_alloc(struct roff_man *, int, int, int); 72 struct roff_node *mdoc_endbody_alloc(struct roff_man *, int, int, int, 73 struct roff_node *, enum mdoc_endbody); 74 void mdoc_node_relink(struct roff_man *, struct roff_node *); 75 void mdoc_node_validate(struct roff_man *); 76 void mdoc_state(struct roff_man *, struct roff_node *); 77 void mdoc_state_reset(struct roff_man *); 78 int mdoc_hash_find(const char *); 79 const char *mdoc_a2arch(const char *); 80 const char *mdoc_a2att(const char *); 81 const char *mdoc_a2lib(const char *); 82 enum roff_sec mdoc_a2sec(const char *); 83 const char *mdoc_a2st(const char *); 84 void mdoc_argv(struct roff_man *, int, int, 85 struct mdoc_arg **, int *, char *); 86 enum margserr mdoc_args(struct roff_man *, int, 87 int *, char *, int, char **); 88 enum mdelim mdoc_isdelim(const char *); 89