Home | History | Annotate | Line # | Download | only in dist
libmdoc.h revision 1.1.1.17.10.1 
      1 /*	Id: libmdoc.h,v 1.112 2017/05/30 16:22:03 schwarze Exp  */
      2 /*
      3  * Copyright (c) 2008, 2009, 2010, 2011 Kristaps Dzonsons <kristaps (at) bsd.lv>
      4  * Copyright (c) 2013, 2014, 2015, 2017 Ingo Schwarze <schwarze (at) 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 			enum roff_tok 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_PHRASE /* Bl -column phrase */
     43 };
     44 
     45 /*
     46  * A punctuation delimiter is opening, closing, or "middle mark"
     47  * punctuation.  These govern spacing.
     48  * Opening punctuation (e.g., the opening parenthesis) suppresses the
     49  * following space; closing punctuation (e.g., the closing parenthesis)
     50  * suppresses the leading space; middle punctuation (e.g., the vertical
     51  * bar) can do either.  The middle punctuation delimiter bends the rules
     52  * depending on usage.
     53  */
     54 enum	mdelim {
     55 	DELIM_NONE = 0,
     56 	DELIM_OPEN,
     57 	DELIM_MIDDLE,
     58 	DELIM_CLOSE,
     59 	DELIM_MAX
     60 };
     61 
     62 extern	const struct mdoc_macro *const mdoc_macros;
     63 
     64 
     65 void		  mdoc_macro(MACRO_PROT_ARGS);
     66 void		  mdoc_elem_alloc(struct roff_man *, int, int,
     67 			enum roff_tok, struct mdoc_arg *);
     68 struct roff_node *mdoc_block_alloc(struct roff_man *, int, int,
     69 			enum roff_tok, struct mdoc_arg *);
     70 void		  mdoc_tail_alloc(struct roff_man *, int, int,
     71 			enum roff_tok);
     72 struct roff_node *mdoc_endbody_alloc(struct roff_man *, int, int,
     73 			enum roff_tok, struct roff_node *);
     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 const char	 *mdoc_a2arch(const char *);
     79 const char	 *mdoc_a2att(const char *);
     80 const char	 *mdoc_a2lib(const char *);
     81 enum roff_sec	  mdoc_a2sec(const char *);
     82 const char	 *mdoc_a2st(const char *);
     83 void		  mdoc_argv(struct roff_man *, int, enum roff_tok,
     84 			struct mdoc_arg **, int *, char *);
     85 enum margserr	  mdoc_args(struct roff_man *, int,
     86 			int *, char *, enum roff_tok, char **);
     87 enum mdelim	  mdoc_isdelim(const char *);
     88