Annotation of mandoc/libmandoc.h, Revision 1.56
1.56 ! schwarze 1: /* $Id: libmandoc.h,v 1.55 2015/01/15 04:26:39 schwarze Exp $ */
1.1 kristaps 2: /*
1.32 schwarze 3: * Copyright (c) 2009, 2010, 2011, 2012 Kristaps Dzonsons <kristaps@bsd.lv>
1.56 ! schwarze 4: * Copyright (c) 2013, 2014, 2015 Ingo Schwarze <schwarze@openbsd.org>
1.1 kristaps 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: *
1.56 ! schwarze 10: * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHORS DISCLAIM ALL WARRANTIES
1.1 kristaps 11: * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
1.56 ! schwarze 12: * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR
1.1 kristaps 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:
1.14 kristaps 19: enum rofferr {
20: ROFF_CONT, /* continue processing line */
21: ROFF_RERUN, /* re-run roff interpreter with offset */
22: ROFF_APPEND, /* re-run main parser, appending next line */
23: ROFF_REPARSE, /* re-run main parser on the result */
24: ROFF_SO, /* include another file */
25: ROFF_IGN, /* ignore current line */
26: ROFF_TBL, /* a table row was successfully parsed */
1.54 schwarze 27: ROFF_EQN /* an equation was successfully parsed */
1.14 kristaps 28: };
29:
1.45 schwarze 30: struct buf {
31: char *buf;
32: size_t sz;
33: };
34:
1.1 kristaps 35: __BEGIN_DECLS
36:
1.51 schwarze 37: struct mparse;
38: struct mchars;
39: struct tbl_span;
40: struct eqn;
1.14 kristaps 41: struct roff;
1.56 ! schwarze 42: struct roff_man;
1.14 kristaps 43:
1.41 schwarze 44: void mandoc_msg(enum mandocerr, struct mparse *,
1.14 kristaps 45: int, int, const char *);
1.37 joerg 46: #if __GNUC__ - 0 >= 4
47: __attribute__((__format__ (__printf__, 5, 6)))
48: #endif
1.41 schwarze 49: void mandoc_vmsg(enum mandocerr, struct mparse *,
1.14 kristaps 50: int, int, const char *, ...);
1.20 kristaps 51: char *mandoc_getarg(struct mparse *, char **, int, int *);
1.16 kristaps 52: char *mandoc_normdate(struct mparse *, char *, int, int);
1.36 schwarze 53: int mandoc_eos(const char *, size_t);
1.24 kristaps 54: int mandoc_strntoi(const char *, size_t, int);
1.29 schwarze 55: const char *mandoc_a2msec(const char*);
1.14 kristaps 56:
1.56 ! schwarze 57: void mdoc_free(struct roff_man *);
! 58: struct roff_man *mdoc_alloc(struct roff *, struct mparse *,
1.42 schwarze 59: const char *, int);
1.56 ! schwarze 60: void mdoc_reset(struct roff_man *);
! 61: int mdoc_parseln(struct roff_man *, int, char *, int);
! 62: void mdoc_endparse(struct roff_man *);
! 63: void mdoc_addspan(struct roff_man *, const struct tbl_span *);
! 64: void mdoc_addeqn(struct roff_man *, const struct eqn *);
1.14 kristaps 65:
1.56 ! schwarze 66: void man_free(struct roff_man *);
! 67: struct roff_man *man_alloc(struct roff *, struct mparse *,
1.53 schwarze 68: const char *, int);
1.56 ! schwarze 69: void man_reset(struct roff_man *);
! 70: int man_parseln(struct roff_man *, int, char *, int);
! 71: void man_endparse(struct roff_man *);
! 72: void man_addspan(struct roff_man *, const struct tbl_span *);
! 73: void man_addeqn(struct roff_man *, const struct eqn *);
1.45 schwarze 74:
1.47 schwarze 75: int preconv_cue(const struct buf *, size_t);
76: int preconv_encode(struct buf *, size_t *,
77: struct buf *, size_t *, int *);
1.14 kristaps 78:
1.41 schwarze 79: void roff_free(struct roff *);
1.46 schwarze 80: struct roff *roff_alloc(struct mparse *, const struct mchars *, int);
1.14 kristaps 81: void roff_reset(struct roff *);
1.48 schwarze 82: enum rofferr roff_parseln(struct roff *, int, struct buf *, int *);
1.16 kristaps 83: void roff_endparse(struct roff *);
1.35 schwarze 84: void roff_setreg(struct roff *, const char *, int, char sign);
1.34 schwarze 85: int roff_getreg(const struct roff *, const char *);
1.28 kristaps 86: char *roff_strdup(const struct roff *, const char *);
1.41 schwarze 87: int roff_getcontrol(const struct roff *,
1.31 kristaps 88: const char *, int *);
1.43 schwarze 89: int roff_getformat(const struct roff *);
1.14 kristaps 90:
1.16 kristaps 91: const struct tbl_span *roff_span(const struct roff *);
92: const struct eqn *roff_eqn(const struct roff *);
1.1 kristaps 93:
94: __END_DECLS
CVSweb