=================================================================== RCS file: /cvs/mandoc/Attic/macro.c,v retrieving revision 1.3 retrieving revision 1.20 diff -u -p -r1.3 -r1.20 --- mandoc/Attic/macro.c 2008/12/15 02:23:12 1.3 +++ mandoc/Attic/macro.c 2009/01/05 12:23:17 1.20 @@ -1,4 +1,4 @@ -/* $Id: macro.c,v 1.3 2008/12/15 02:23:12 kristaps Exp $ */ +/* $Id: macro.c,v 1.20 2009/01/05 12:23:17 kristaps Exp $ */ /* * Copyright (c) 2008 Kristaps Dzonsons * @@ -20,301 +20,542 @@ #include #include #include +#include +#ifdef __linux__ +#include +#endif #include "private.h" -#define _CC(p) ((const char **)p) +/* FIXME: maxlineargs should be per LINE, no per TOKEN. */ -static int append_text(struct mdoc *, int, - int, int, char *[]); -static int append_scoped(struct mdoc *, int, - int, int, char *[]); -static int isdelim(const char *); -static int args_next(struct mdoc *, int, - int *, char *, char **); +static int rewind_elem(struct mdoc *, int, int); +static int rewind_imp(struct mdoc *, int, int); +static int rewind_exp(struct mdoc *, int, int, int); +static int rewind_line(struct mdoc *, int, int); +static int append_delims(struct mdoc *, int, int *, char *); static int -isdelim(const char *p) +rewind_elem(struct mdoc *mdoc, int ppos, int tok) { + struct mdoc_node *n; - if (0 == *p) - return(0); - if (0 != *(p + 1)) - return(0); + n = mdoc->last; + if (MDOC_ELEM != n->type) + n = n->parent; + assert(MDOC_ELEM == n->type); + assert(tok == n->data.elem.tok); - switch (*p) { - case('{'): - /* FALLTHROUGH */ - case('.'): - /* FALLTHROUGH */ - case(','): - /* FALLTHROUGH */ - case(';'): - /* FALLTHROUGH */ - case(':'): - /* FALLTHROUGH */ - case('?'): - /* FALLTHROUGH */ - case('!'): - /* FALLTHROUGH */ - case('('): - /* FALLTHROUGH */ - case(')'): - /* FALLTHROUGH */ - case('['): - /* FALLTHROUGH */ - case(']'): - /* FALLTHROUGH */ - case('}'): - return(1); - default: - break; + mdoc->last = n; + mdoc->next = MDOC_NEXT_SIBLING; + return(mdoc_valid_post(mdoc, tok, ppos)); +} + + +static int +rewind_line(struct mdoc *mdoc, int ppos, int tok) +{ + struct mdoc_node *n; + int t; + + /* LINTED */ + for (n = mdoc->last; n; n = n->parent) { + if (MDOC_HEAD != n->type) + continue; + if (tok == (t = n->data.head.tok)) + break; + if ( ! (MDOC_EXPLICIT & mdoc_macros[t].flags)) + continue; + return(mdoc_err(mdoc, tok, ppos, ERR_SCOPE_BREAK)); } - return(0); + mdoc->last = n ? n : mdoc->last; + mdoc->next = MDOC_NEXT_SIBLING; + return(1); } static int -args_next(struct mdoc *mdoc, int tok, - int *pos, char *buf, char **v) +rewind_exp(struct mdoc *mdoc, int ppos, int tok, int tt) { + struct mdoc_node *n; - if (0 == buf[*pos]) - return(0); + assert(mdoc->last); - assert( ! isspace(buf[*pos])); - - if ('\"' == buf[*pos]) { - (void)mdoc_err(mdoc, tok, *pos, ERR_SYNTAX_QUOTE); - return(-1); + /* LINTED */ + for (n = mdoc->last->parent; n; n = n->parent) { + if (MDOC_BLOCK != n->type) + continue; + if (tt == n->data.block.tok) + break; + return(mdoc_err(mdoc, tok, ppos, ERR_SCOPE_BREAK)); } - *v = &buf[*pos]; + if (NULL == (mdoc->last = n)) + return(mdoc_err(mdoc, tok, ppos, ERR_SCOPE_NOCTX)); - /* Scan ahead to end of token. */ + mdoc->next = MDOC_NEXT_SIBLING; + return(mdoc_valid_post(mdoc, tok, ppos)); +} - while (buf[*pos] && ! isspace(buf[*pos])) - (*pos)++; - if (buf[*pos] && buf[*pos + 1] && '\\' == buf[*pos]) { - (void)mdoc_err(mdoc, tok, *pos, ERR_SYNTAX_WS); - return(-1); +/* ARGSUSED */ +int +macro_close_explicit(MACRO_PROT_ARGS) +{ + int tt; + + switch (tok) { + case (MDOC_El): + tt = MDOC_Bl; + break; + case (MDOC_Ed): + tt = MDOC_Bd; + break; + case (MDOC_Re): + tt = MDOC_Rs; + break; + case (MDOC_Ef): + tt = MDOC_Bf; + break; + default: + abort(); + /* NOTREACHED */ } - if (0 == buf[*pos]) - return(1); + if (0 != buf[*pos]) + return(mdoc_err(mdoc, tok, ppos, ERR_ARGS_EQ0)); + return(rewind_exp(mdoc, ppos, tok, tt)); +} - /* Scan ahead over trailing whitespace. */ - buf[(*pos)++] = 0; - while (buf[*pos] && isspace(buf[*pos])) - (*pos)++; +static int +rewind_imp(struct mdoc *mdoc, int ppos, int tok) +{ + struct mdoc_node *n; + int t; - if (0 == buf[*pos]) - if ( ! mdoc_warn(mdoc, tok, *pos, WARN_SYNTAX_WS_EOLN)) - return(-1); + n = mdoc->last ? mdoc->last->parent : NULL; + /* LINTED */ + for ( ; n; n = n->parent) { + if (MDOC_BLOCK != n->type) + continue; + if (tok == (t = n->data.block.tok)) + break; + if ( ! (MDOC_EXPLICIT & mdoc_macros[t].flags)) + continue; + return(mdoc_err(mdoc, tok, ppos, ERR_SCOPE_BREAK)); + } + + mdoc->last = n ? n : mdoc->last; + mdoc->next = MDOC_NEXT_SIBLING; return(1); + /*return(mdoc_valid_post(mdoc, tok, ppos));*/ } static int -append_scoped(struct mdoc *mdoc, int tok, - int pos, int sz, char *args[]) +append_delims(struct mdoc *mdoc, int tok, int *pos, char *buf) { + int c, lastarg; + char *p; - assert(sz >= 0); - args[sz] = NULL; - mdoc_block_alloc(mdoc, pos, tok, 0, NULL); - mdoc_head_alloc(mdoc, pos, tok, (size_t)sz, _CC(args)); - mdoc_body_alloc(mdoc, pos, tok); + if (0 == buf[*pos]) + return(1); + + for (;;) { + lastarg = *pos; + c = mdoc_args(mdoc, tok, pos, buf, 0, &p); + if (ARGS_ERROR == c) + return(0); + else if (ARGS_EOLN == c) + break; + assert(mdoc_isdelim(p)); + mdoc_word_alloc(mdoc, lastarg, p); + mdoc->next = MDOC_NEXT_SIBLING; + } + return(1); } -static int -append_text(struct mdoc *mdoc, int tok, - int pos, int sz, char *args[]) +/* + * A general text domain macro. When invoked, this opens a scope that + * accepts words until either end-of-line, only-punctuation, or a + * callable macro. If the word is punctuation (not only-punctuation), + * then the scope is closed out, the punctuation appended, then the + * scope opened again. If any terminating conditions are met, the scope + * is closed out. If this is the first macro in the line and + * only-punctuation remains, this punctuation is flushed. + */ +int +macro_text(MACRO_PROT_ARGS) { + int lastarg, lastpunct, c, sz, fl, argc; + struct mdoc_arg argv[MDOC_LINEARG_MAX]; + char *p; - assert(sz >= 0); - args[sz] = NULL; + lastarg = ppos; + lastpunct = 0; - switch (tok) { - /* ======= ADD MORE MACRO ARGUMENT-LIMITS BELOW. ======= */ + for (argc = 0; argc < MDOC_LINEARG_MAX; argc++) { + lastarg = *pos; - case (MDOC_Ft): - /* FALLTHROUGH */ - case (MDOC_Li): - /* FALLTHROUGH */ - case (MDOC_Ms): - /* FALLTHROUGH */ - case (MDOC_Pa): - /* FALLTHROUGH */ - case (MDOC_Tn): - if (0 == sz && ! mdoc_warn(mdoc, tok, pos, WARN_ARGS_GE1)) + c = mdoc_argv(mdoc, tok, &argv[argc], pos, buf); + if (ARGV_EOLN == c || ARGV_WORD == c) + break; + else if (ARGV_ARG == c) + continue; + mdoc_argv_free(argc, argv); + return(0); + } + + if ( ! mdoc_valid_pre(mdoc, tok, ppos, argc, argv)) { + mdoc_argv_free(argc, argv); + return(0); + } + + fl = ARGS_DELIM; + if (MDOC_QUOTABLE & mdoc_macros[tok].flags) + fl |= ARGS_QUOTED; + + mdoc_elem_alloc(mdoc, lastarg, tok, argc, argv); + mdoc->next = MDOC_NEXT_CHILD; + + for (lastpunct = sz = 0; sz + argc < MDOC_LINEARG_MAX; sz++) { + lastarg = *pos; + + if (lastpunct) { + mdoc_elem_alloc(mdoc, lastarg, tok, argc, argv); + mdoc->next = MDOC_NEXT_CHILD; + lastpunct = 0; + } + + c = mdoc_args(mdoc, tok, pos, buf, fl, &p); + if (ARGS_ERROR == c) { + mdoc_argv_free(argc, argv); return(0); - mdoc_elem_alloc(mdoc, pos, tok, 0, - NULL, (size_t)sz, _CC(args)); - return(1); + } - case (MDOC_Ar): - /* FALLTHROUGH */ - case (MDOC_Cm): - /* FALLTHROUGH */ - case (MDOC_Fl): - mdoc_elem_alloc(mdoc, pos, tok, 0, - NULL, (size_t)sz, _CC(args)); - return(1); + if (ARGS_EOLN == c) + break; + if (ARGS_PUNCT == c) + break; - case (MDOC_Ad): - /* FALLTHROUGH */ - case (MDOC_Em): - /* FALLTHROUGH */ - case (MDOC_Er): - /* FALLTHROUGH */ - case (MDOC_Ev): - /* FALLTHROUGH */ - case (MDOC_Fa): - /* FALLTHROUGH */ - case (MDOC_Dv): - /* FALLTHROUGH */ - case (MDOC_Ic): - /* FALLTHROUGH */ - case (MDOC_Va): - /* FALLTHROUGH */ - case (MDOC_Vt): - if (0 == sz) - return(mdoc_err(mdoc, tok, pos, ERR_ARGS_GE1)); - mdoc_elem_alloc(mdoc, pos, tok, 0, - NULL, (size_t)sz, _CC(args)); + if (MDOC_MAX != (c = mdoc_find(mdoc, p))) { + if ( ! rewind_elem(mdoc, ppos, tok)) { + mdoc_argv_free(argc, argv); + return(0); + } + mdoc_argv_free(argc, argv); + if ( ! mdoc_macro(mdoc, c, lastarg, pos, buf)) + return(0); + if (ppos > 1) + return(1); + return(append_delims(mdoc, tok, pos, buf)); + } + + if (mdoc_isdelim(p)) { + if ( ! rewind_elem(mdoc, ppos, tok)) { + mdoc_argv_free(argc, argv); + return(0); + } + lastpunct = 1; + } + mdoc_word_alloc(mdoc, lastarg, p); + mdoc->next = MDOC_NEXT_SIBLING; + } + + mdoc_argv_free(argc, argv); + + if (sz == MDOC_LINEARG_MAX) + return(mdoc_err(mdoc, tok, lastarg, ERR_ARGS_MANY)); + + if ( ! rewind_elem(mdoc, ppos, tok)) + return(0); + if (ppos > 1) return(1); + return(append_delims(mdoc, tok, pos, buf)); +} - /* ======= ADD MORE MACRO ARGUMENT-LIMITS ABOVE. ======= */ + +/* + * Multi-line-scoped macro. + */ +int +macro_scoped(MACRO_PROT_ARGS) +{ + int c, lastarg, argc; + struct mdoc_arg argv[MDOC_LINEARG_MAX]; + + assert ( ! (MDOC_CALLABLE & mdoc_macros[tok].flags)); + + if ( ! (MDOC_EXPLICIT & mdoc_macros[tok].flags)) + if ( ! rewind_imp(mdoc, ppos, tok)) + return(0); + + lastarg = ppos; + + for (argc = 0; argc < MDOC_LINEARG_MAX; argc++) { + lastarg = *pos; + c = mdoc_argv(mdoc, tok, &argv[argc], pos, buf); + if (ARGV_EOLN == c || ARGV_WORD == c) + break; + else if (ARGV_ARG == c) + continue; + mdoc_argv_free(argc, argv); + return(0); + } + + if ( ! mdoc_valid_pre(mdoc, tok, ppos, argc, argv)) { + mdoc_argv_free(argc, argv); + return(0); + } + + mdoc_block_alloc(mdoc, ppos, tok, (size_t)argc, argv); + mdoc->next = MDOC_NEXT_CHILD; + + mdoc_argv_free(argc, argv); + + /* XXX - Assumes header isn't parsed! */ + + if (0 != buf[*pos]) { + mdoc_head_alloc(mdoc, ppos, tok); + mdoc->next = MDOC_NEXT_CHILD; + + mdoc_word_alloc(mdoc, lastarg, &buf[*pos]); + mdoc->next = MDOC_NEXT_SIBLING; + + if ( ! rewind_line(mdoc, ppos, tok)) + return(0); + + while (buf[*pos]) + (*pos)++; + } + +#if 0 + /* Post-processing. */ + switch (tok) { + case (MDOC_Sh): + sec = mdoc_atosec((size_t)sz, _CC(args)); + if (SEC_CUSTOM != sec) + mdoc->sec_lastn = sec; + mdoc->sec_last = sec; + break; default: break; } +#endif - abort(); - /* NOTREACHED */ + mdoc_body_alloc(mdoc, ppos, tok); + mdoc->next = MDOC_NEXT_CHILD; + + return(1); } +/* + * When scoped to a line, a macro encompasses all of the contents. This + * differs from constants or text macros, where a new macro will + * terminate the existing context. + */ int -macro_text(struct mdoc *mdoc, int tok, int ppos, int *pos, char *buf) +macro_scoped_line(MACRO_PROT_ARGS) { - int lastarg, c, lasttok, lastpunct, j; - char *args[MDOC_LINEARG_MAX], *p; + int lastarg, c, j; + char *p; - lasttok = ppos; - lastpunct = 0; - j = 0; + mdoc_block_alloc(mdoc, ppos, tok, 0, NULL); + mdoc->next = MDOC_NEXT_CHILD; -again: + mdoc_head_alloc(mdoc, ppos, tok); + mdoc->next = MDOC_NEXT_CHILD; - lastarg = *pos; - c = args_next(mdoc, tok, pos, buf, &args[j]); - - if (-1 == c) + /* XXX - no known argument macros. */ + + if ( ! mdoc_valid_pre(mdoc, tok, ppos, 0, NULL)) return(0); - if (0 == c && ! lastpunct) - return(append_text(mdoc, tok, lasttok, j, args)); - else if (0 == c) - return(1); - /* Command found. */ + /* Process line parameters. */ - if (MDOC_MAX != (c = mdoc_find(mdoc, args[j]))) { - if ( ! lastpunct) - if ( ! append_text(mdoc, tok, lasttok, j, args)) - return(0); - return(mdoc_macro(mdoc, c, lastarg, pos, buf)); + for (lastarg = ppos, j = 0; j < MDOC_LINEARG_MAX; j++) { + lastarg = *pos; + c = mdoc_args(mdoc, tok, pos, buf, ARGS_DELIM, &p); + + if (ARGS_ERROR == c) + return(0); + if (ARGS_PUNCT == c) + break; + if (ARGS_EOLN == c) + break; + + if (MDOC_MAX == (c = mdoc_find(mdoc, p))) { + mdoc_word_alloc(mdoc, lastarg, p); + mdoc->next = MDOC_NEXT_SIBLING; + continue; + } + + if ( ! mdoc_macro(mdoc, c, lastarg, pos, buf)) + return(0); + break; } - /* Word found. */ + if (j == MDOC_LINEARG_MAX) + return(mdoc_err(mdoc, tok, lastarg, ERR_ARGS_MANY)); - if ( ! isdelim(args[j])) { - j++; - goto again; + if (1 == ppos) { + if ( ! rewind_line(mdoc, ppos, tok)) + return(0); + if ( ! append_delims(mdoc, tok, pos, buf)) + return(0); } + return(rewind_imp(mdoc, ppos, tok)); +} - /* Punctuation found. */ - p = args[j]; /* Save argument (NULL-ified in append). */ +/* + * Delimited macros are like text macros except that, should punctuation + * be encountered, the macro isn't re-started with remaining tokens + * (it's only emitted once). Delimited macros can have a maximum number + * of arguments. + */ +int +macro_constant_delimited(MACRO_PROT_ARGS) +{ + int lastarg, flushed, j, c, maxargs; + char *p; - if ( ! lastpunct) - if ( ! append_text(mdoc, tok, lasttok, j, args)) + lastarg = ppos; + flushed = 0; + + switch (tok) { + case (MDOC_No): + /* FALLTHROUGH */ + case (MDOC_Ns): + /* FALLTHROUGH */ + case (MDOC_Ux): + maxargs = 0; + break; + default: + maxargs = 1; + break; + } + + mdoc_elem_alloc(mdoc, lastarg, tok, 0, NULL); + mdoc->next = MDOC_NEXT_CHILD; + + for (j = 0; j < MDOC_LINEARG_MAX; j++) { + lastarg = *pos; + + if (j == maxargs && ! flushed) { + if ( ! rewind_elem(mdoc, ppos, tok)) + return(0); + flushed = 1; + } + + c = mdoc_args(mdoc, tok, pos, buf, ARGS_DELIM, &p); + if (ARGS_ERROR == c) return(0); + if (ARGS_PUNCT == c) + break; + if (ARGS_EOLN == c) + break; - args[j] = p; + if (MDOC_MAX != (c = mdoc_find(mdoc, p))) { + if ( ! flushed && ! rewind_elem(mdoc, ppos, tok)) + return(0); + flushed = 1; + if ( ! mdoc_macro(mdoc, c, lastarg, pos, buf)) + return(0); + break; + } - mdoc_word_alloc(mdoc, lastarg, args[j]); - lastpunct = 1; - j = 0; + if (mdoc_isdelim(p)) { + if ( ! rewind_elem(mdoc, ppos, tok)) + return(0); + flushed = 1; + } + + mdoc_word_alloc(mdoc, lastarg, p); + mdoc->next = MDOC_NEXT_SIBLING; + } - goto again; + if ( ! flushed && rewind_elem(mdoc, ppos, tok)) + return(0); - /* NOTREACHED */ + if (MDOC_LINEARG_MAX == j) + return(mdoc_err(mdoc, tok, lastarg, ERR_ARGS_MANY)); + + if (ppos > 1) + return(1); + return(append_delims(mdoc, tok, pos, buf)); } +/* + * Constant macros span an entire line: they constitute a macro and all + * of its arguments and child data. + */ int -macro_scoped_implicit(struct mdoc *mdoc, - int tok, int ppos, int *pos, char *buf) +macro_constant(MACRO_PROT_ARGS) { - int t, c, lastarg, j; - char *args[MDOC_LINEARG_MAX]; - struct mdoc_node *n; + int c, lastarg, argc, sz, fl; + struct mdoc_arg argv[MDOC_LINEARG_MAX]; + char *p; - /* - * Look for an implicit parent. - */ + fl = 0; + if (MDOC_QUOTABLE & mdoc_macros[tok].flags) + fl = ARGS_QUOTED; - assert( ! (MDOC_EXPLICIT & mdoc_macros[tok].flags)); - - /* LINTED */ - for (n = mdoc->last; n; n = n->parent) { - if (MDOC_BLOCK != n->type) - continue; - if (tok == (t = n->data.block.tok)) + for (argc = 0; argc < MDOC_LINEARG_MAX; argc++) { + lastarg = *pos; + c = mdoc_argv(mdoc, tok, &argv[argc], pos, buf); + if (ARGV_EOLN == c) break; - if ( ! (MDOC_EXPLICIT & mdoc_macros[t].flags)) + else if (ARGV_ARG == c) continue; - return(mdoc_err(mdoc, tok, ppos, ERR_SCOPE_BREAK)); + else if (ARGV_WORD == c) + break; + + mdoc_argv_free(argc, argv); + return(0); } - if (n) { - mdoc->last = n; - mdoc_msg(mdoc, ppos, "scope: rewound `%s'", - mdoc_macronames[tok]); - } else - mdoc_msg(mdoc, ppos, "scope: new `%s'", - mdoc_macronames[tok]); + if (MDOC_LINEARG_MAX == argc) { + mdoc_argv_free(argc, argv); + return(mdoc_err(mdoc, tok, lastarg, ERR_ARGS_MANY)); + } - j = 0; + mdoc_elem_alloc(mdoc, ppos, tok, argc, argv); + mdoc->next = MDOC_NEXT_CHILD; -again: + mdoc_argv_free(argc, argv); - lastarg = *pos; - c = args_next(mdoc, tok, pos, buf, &args[j]); - - if (-1 == c) - return(0); - if (0 == c) - return(append_scoped(mdoc, tok, ppos, j, args)); + for (sz = 0; sz + argc < MDOC_LINEARG_MAX; sz++) { + lastarg = *pos; + c = mdoc_args(mdoc, tok, pos, buf, fl, &p); + if (ARGS_ERROR == c) + return(0); + if (ARGS_EOLN == c) + break; - /* Command found. */ + mdoc_word_alloc(mdoc, lastarg, p); + mdoc->next = MDOC_NEXT_CHILD; + } - if (MDOC_MAX != (c = mdoc_find(mdoc, args[j]))) - if ( ! mdoc_warn(mdoc, tok, lastarg, WARN_SYNTAX_MACLIKE)) - return(0); + if (MDOC_LINEARG_MAX == sz + argc) + return(mdoc_err(mdoc, tok, lastarg, ERR_ARGS_MANY)); - /* Word found. */ + return(rewind_elem(mdoc, ppos, tok)); +} - j++; - goto again; - /* NOTREACHED */ +/* ARGSUSED */ +int +macro_obsolete(MACRO_PROT_ARGS) +{ + + return(mdoc_warn(mdoc, tok, ppos, WARN_IGN_OBSOLETE)); }