version 1.2, 2008/12/15 03:13:01 |
version 1.27, 2009/01/19 17:51:33 |
|
|
#ifndef MDOC_H |
#ifndef MDOC_H |
#define MDOC_H |
#define MDOC_H |
|
|
#define MDOC_LINEARG_MAX 9 |
/* What follows is a list of ALL possible macros. */ |
|
|
#define MDOC___ 0 |
#define MDOC___ 0 |
#define MDOC_Dd 1 |
#define MDOC_Dd 1 |
|
|
#define MDOC_Ud 105 |
#define MDOC_Ud 105 |
#define MDOC_MAX 106 |
#define MDOC_MAX 106 |
|
|
|
/* What follows is a list of ALL possible macro arguments. */ |
|
|
#define MDOC_Split 0 |
#define MDOC_Split 0 |
#define MDOC_Nosplit 1 |
#define MDOC_Nosplit 1 |
#define MDOC_Ragged 2 |
#define MDOC_Ragged 2 |
|
|
#define MDOC_svid4 57 |
#define MDOC_svid4 57 |
#define MDOC_Filled 58 |
#define MDOC_Filled 58 |
#define MDOC_Words 59 |
#define MDOC_Words 59 |
#define MDOC_ARG_MAX 60 |
#define MDOC_Emphasis 60 |
|
#define MDOC_Symbolic 61 |
|
#define MDOC_ARG_MAX 62 |
|
|
enum mdoc_err { |
enum mdoc_warn { |
ERR_SYNTAX_QUOTE, |
WARN_SYNTAX, /* Syntax warn (at line/col). */ |
ERR_SYNTAX_WS, |
WARN_COMPAT /* Groff compat warn (at line/col). */ |
ERR_MACRO_NOTSUP, |
|
ERR_MACRO_NOTCALL, |
|
ERR_SCOPE_BREAK, |
|
ERR_ARGS_GE1 |
|
}; |
}; |
|
|
enum mdoc_warn { |
/* Possible values for the `At' macro. */ |
WARN_SYNTAX_WS_EOLN, |
enum mdoc_att { |
WARN_SYNTAX_MACLIKE, |
ATT_DEFAULT = 0, |
WARN_ARGS_GE1 |
ATT_v1, |
|
ATT_v2, |
|
ATT_v3, |
|
ATT_v4, |
|
ATT_v5, |
|
ATT_v6, |
|
ATT_v7, |
|
ATT_32v, |
|
ATT_V1, |
|
ATT_V2, |
|
ATT_V3, |
|
ATT_V4 |
}; |
}; |
|
|
|
/* An argument to a macro (multiple values = `It -column'). */ |
struct mdoc_arg { |
struct mdoc_arg { |
int arg; |
int arg; |
|
int line; |
|
int pos; |
size_t sz; |
size_t sz; |
char **value; |
char **value; |
}; |
}; |
|
|
|
/* |
|
* Simplified grammar of syntax tree: |
|
* |
|
* MDOC_ROOT: root of tree |
|
* MDOC_TEXT: free-form text |
|
* MDOC_ELEM: elem [args] MDOC_TEXT... |
|
* MDOC_BLOCK, MDOC_HEAD, MDOC_BODY, MDOC_TAIL: |
|
* MDOC_BLOCK: |
|
* MDOC_HEAD [args] (MDOC_TEXT|MDOC_ELEM|MDOC_BLOCK)... |
|
* MDOC_BODY (MDOC_TEXT|MDOC_ELEM|MDOC_BLOCK)... |
|
* MDOC_TAIL (optional) (MDOC_TEXT|MDOC_ELEM|MDOC_BLOCK)... |
|
*/ |
|
|
|
/* Type of a syntax node. */ |
enum mdoc_type { |
enum mdoc_type { |
MDOC_TEXT, |
MDOC_TEXT, |
MDOC_ELEM, |
MDOC_ELEM, |
MDOC_HEAD, |
MDOC_HEAD, |
|
MDOC_TAIL, |
MDOC_BODY, |
MDOC_BODY, |
MDOC_BLOCK |
MDOC_BLOCK, |
|
MDOC_ROOT |
}; |
}; |
|
|
|
/* Manual section. */ |
enum mdoc_msec { |
enum mdoc_msec { |
|
MSEC_DEFAULT = 0, |
MSEC_1, |
MSEC_1, |
MSEC_2, |
MSEC_2, |
MSEC_3, |
MSEC_3, |
Line 238 enum mdoc_msec { |
|
Line 270 enum mdoc_msec { |
|
MSEC_n, |
MSEC_n, |
MSEC_unass, |
MSEC_unass, |
MSEC_draft, |
MSEC_draft, |
MSEC_paper, |
MSEC_paper |
MSEC_NONE |
|
}; |
}; |
|
|
|
/* Section (named/unnamed) of `Ss'. */ |
enum mdoc_sec { |
enum mdoc_sec { |
SEC_PROLOGUE, |
SEC_PROLOGUE = 0, |
|
SEC_BODY, |
SEC_NAME, |
SEC_NAME, |
SEC_SYNOPSIS, |
SEC_SYNOPSIS, |
SEC_DESCRIPTION, |
SEC_DESCRIPTION, |
|
|
SEC_CUSTOM |
SEC_CUSTOM |
}; |
}; |
|
|
|
/* Volume of `Dt'. */ |
enum mdoc_vol { |
enum mdoc_vol { |
|
VOL_DEFAULT = 0, |
VOL_AMD, |
VOL_AMD, |
VOL_IND, |
VOL_IND, |
VOL_KM, |
VOL_KM, |
|
|
VOL_PS1, |
VOL_PS1, |
VOL_SMM, |
VOL_SMM, |
VOL_URM, |
VOL_URM, |
VOL_USD, |
VOL_USD |
VOL_DEFAULT |
|
}; |
}; |
|
|
|
/* Architecture of `Dt'. */ |
enum mdoc_arch { |
enum mdoc_arch { |
|
ARCH_DEFAULT = 0, |
ARCH_alpha, |
ARCH_alpha, |
ARCH_amd64, |
ARCH_amd64, |
ARCH_amiga, |
ARCH_amiga, |
ARCH_arc, |
ARCH_arc, |
|
ARCH_arm, |
ARCH_armish, |
ARCH_armish, |
ARCH_aviion, |
ARCH_aviion, |
ARCH_hp300, |
ARCH_hp300, |
Line 300 enum mdoc_arch { |
|
Line 337 enum mdoc_arch { |
|
ARCH_sparc64, |
ARCH_sparc64, |
ARCH_sun3, |
ARCH_sun3, |
ARCH_vax, |
ARCH_vax, |
ARCH_zaurus, |
ARCH_zaurus |
ARCH_DEFAULT |
|
}; |
}; |
|
|
|
/* Meta-information from prologue. */ |
struct mdoc_meta { |
struct mdoc_meta { |
enum mdoc_msec msec; |
enum mdoc_msec msec; |
enum mdoc_vol vol; |
enum mdoc_vol vol; |
enum mdoc_arch arch; |
enum mdoc_arch arch; |
struct tm tm; |
time_t date; |
|
char *title; |
|
char *os; |
|
char *name; |
}; |
}; |
|
|
struct mdoc_text { |
struct mdoc_text { |
Line 316 struct mdoc_text { |
|
Line 356 struct mdoc_text { |
|
}; |
}; |
|
|
struct mdoc_block { |
struct mdoc_block { |
int tok; |
|
size_t argc; |
size_t argc; |
struct mdoc_arg *argv; |
struct mdoc_arg *argv; |
|
struct mdoc_node *head; |
|
struct mdoc_node *body; |
|
struct mdoc_node *tail; |
}; |
}; |
|
|
struct mdoc_head { |
|
size_t sz; |
|
char **args; |
|
int tok; |
|
}; |
|
|
|
struct mdoc_body { |
|
int tok; |
|
}; |
|
|
|
struct mdoc_elem { |
struct mdoc_elem { |
size_t sz; |
size_t sz; |
char **args; |
char **args; |
int tok; |
|
size_t argc; |
size_t argc; |
struct mdoc_arg *argv; |
struct mdoc_arg *argv; |
}; |
}; |
Line 342 struct mdoc_elem { |
|
Line 373 struct mdoc_elem { |
|
union mdoc_data { |
union mdoc_data { |
struct mdoc_text text; |
struct mdoc_text text; |
struct mdoc_elem elem; |
struct mdoc_elem elem; |
struct mdoc_body body; |
|
struct mdoc_head head; |
|
struct mdoc_block block; |
struct mdoc_block block; |
}; |
}; |
|
|
|
/* Syntax node in parse tree. */ |
struct mdoc_node { |
struct mdoc_node { |
struct mdoc_node *parent; |
struct mdoc_node *parent; |
struct mdoc_node *child; |
struct mdoc_node *child; |
struct mdoc_node *next; |
struct mdoc_node *next; |
|
struct mdoc_node *prev; |
|
int line; |
|
int pos; |
|
int tok; |
|
int flags; |
|
#define MDOC_VALID (1 << 0) |
|
#define MDOC_ACTED (1 << 1) |
enum mdoc_type type; |
enum mdoc_type type; |
union mdoc_data data; |
union mdoc_data data; |
}; |
}; |
|
|
|
/* Call-backs for parse messages. */ |
struct mdoc_cb { |
struct mdoc_cb { |
int (*mdoc_err)(void *, int, int, enum mdoc_err); |
void (*mdoc_msg)(void *, int, int, const char *); |
int (*mdoc_warn)(void *, int, int, enum mdoc_warn); |
int (*mdoc_err)(void *, int, int, const char *); |
void (*mdoc_msg)(void *, int, const char *); |
int (*mdoc_warn)(void *, int, int, |
|
enum mdoc_warn, const char *); |
}; |
}; |
|
|
extern const char *const *mdoc_macronames; |
extern const char *const *mdoc_macronames; |
|
|
|
|
struct mdoc; |
struct mdoc; |
|
|
|
/* Free memory allocated with mdoc_alloc. */ |
void mdoc_free(struct mdoc *); |
void mdoc_free(struct mdoc *); |
|
|
|
/* Allocate a new parser instance. */ |
struct mdoc *mdoc_alloc(void *data, const struct mdoc_cb *); |
struct mdoc *mdoc_alloc(void *data, const struct mdoc_cb *); |
int mdoc_parseln(struct mdoc *, char *buf); |
|
const struct mdoc_node |
/* Parse a single line (boolean retval). */ |
*mdoc_result(struct mdoc *); |
int mdoc_parseln(struct mdoc *, int, char *buf); |
|
|
|
/* Get result first node. */ |
|
const struct mdoc_node *mdoc_node(struct mdoc *); |
|
|
|
/* Get result meta-information. */ |
|
const struct mdoc_meta *mdoc_meta(struct mdoc *); |
|
|
|
/* Signal end of parse sequence (boolean retval). */ |
|
int mdoc_endparse(struct mdoc *); |
|
|
__END_DECLS |
__END_DECLS |
|
|