version 1.26, 2009/01/22 14:56:21 |
version 1.36, 2009/03/05 12:08:53 |
|
|
#include "private.h" |
#include "private.h" |
|
|
/* |
/* |
* Parse arguments and parameters of macros. Arguments follow the |
* Routines to parse arguments of macros. Arguments follow the syntax |
* syntax of `-arg [val [valN...]]', while parameters are free-form text |
* of `-arg [val [valN...]]'. Arguments come in all types: quoted |
* following arguments (if any). This file must correctly handle the |
* arguments, multiple arguments per value, no-value arguments, etc. |
* strange punctuation rules dictated by groff. |
|
*/ |
*/ |
|
|
#define ARGS_QUOTED (1 << 0) |
#define ARGS_QUOTED (1 << 0) |
#define ARGS_DELIM (1 << 1) |
#define ARGS_DELIM (1 << 1) |
#define ARGS_TABSEP (1 << 2) |
#define ARGS_TABSEP (1 << 2) |
|
|
static int lookup(int, const char *); |
#define ARGV_NONE (1 << 0) |
|
#define ARGV_SINGLE (1 << 1) |
|
#define ARGV_MULTI (1 << 2) |
|
#define ARGV_OPT_SINGLE (1 << 3) |
|
|
|
static int argv_a2arg(int, const char *); |
static int args(struct mdoc *, int, int *, |
static int args(struct mdoc *, int, int *, |
char *, int, char **); |
char *, int, char **); |
static int argv(struct mdoc *, int, |
static int argv(struct mdoc *, int, |
struct mdoc_arg *, int *, char *); |
struct mdoc_arg *, int *, char *); |
static int argv_single(struct mdoc *, int, |
static int argv_single(struct mdoc *, int, |
struct mdoc_arg *, int *, char *); |
struct mdoc_arg *, int *, char *); |
|
static int argv_opt_single(struct mdoc *, int, |
|
struct mdoc_arg *, int *, char *); |
static int argv_multi(struct mdoc *, int, |
static int argv_multi(struct mdoc *, int, |
struct mdoc_arg *, int *, char *); |
struct mdoc_arg *, int *, char *); |
static int postargv(struct mdoc *, int, |
|
const struct mdoc_arg *, int); |
|
static int pwarn(struct mdoc *, int, int, int); |
static int pwarn(struct mdoc *, int, int, int); |
static int perr(struct mdoc *, int, int, int); |
static int perr(struct mdoc *, int, int, int); |
|
|
Line 60 static int perr(struct mdoc *, int, int, int); |
|
Line 64 static int perr(struct mdoc *, int, int, int); |
|
/* Error messages. */ |
/* Error messages. */ |
|
|
#define EQUOTTERM (0) |
#define EQUOTTERM (0) |
#define EOFFSET (1) |
#define EARGVAL (1) |
#define EARGVAL (2) |
#define EARGMANY (2) |
#define EARGMANY (3) |
|
|
|
|
/* Per-argument flags. */ |
|
|
|
static int mdoc_argvflags[MDOC_ARG_MAX] = { |
|
ARGV_NONE, /* MDOC_Split */ |
|
ARGV_NONE, /* MDOC_Nosplit */ |
|
ARGV_NONE, /* MDOC_Ragged */ |
|
ARGV_NONE, /* MDOC_Unfilled */ |
|
ARGV_NONE, /* MDOC_Literal */ |
|
ARGV_NONE, /* MDOC_File */ |
|
ARGV_SINGLE, /* MDOC_Offset */ |
|
ARGV_NONE, /* MDOC_Bullet */ |
|
ARGV_NONE, /* MDOC_Dash */ |
|
ARGV_NONE, /* MDOC_Hyphen */ |
|
ARGV_NONE, /* MDOC_Item */ |
|
ARGV_NONE, /* MDOC_Enum */ |
|
ARGV_NONE, /* MDOC_Tag */ |
|
ARGV_NONE, /* MDOC_Diag */ |
|
ARGV_NONE, /* MDOC_Hang */ |
|
ARGV_NONE, /* MDOC_Ohang */ |
|
ARGV_NONE, /* MDOC_Inset */ |
|
ARGV_MULTI, /* MDOC_Column */ |
|
ARGV_SINGLE, /* MDOC_Width */ |
|
ARGV_NONE, /* MDOC_Compact */ |
|
ARGV_OPT_SINGLE, /* MDOC_Std */ |
|
ARGV_NONE, /* MDOC_p1003_1_88 */ |
|
ARGV_NONE, /* MDOC_p1003_1_90 */ |
|
ARGV_NONE, /* MDOC_p1003_1_96 */ |
|
ARGV_NONE, /* MDOC_p1003_1_2001 */ |
|
ARGV_NONE, /* MDOC_p1003_1_2004 */ |
|
ARGV_NONE, /* MDOC_p1003_1 */ |
|
ARGV_NONE, /* MDOC_p1003_1b */ |
|
ARGV_NONE, /* MDOC_p1003_1b_93 */ |
|
ARGV_NONE, /* MDOC_p1003_1c_95 */ |
|
ARGV_NONE, /* MDOC_p1003_1g_2000 */ |
|
ARGV_NONE, /* MDOC_p1003_2_92 */ |
|
ARGV_NONE, /* MDOC_p1387_2_95 */ |
|
ARGV_NONE, /* MDOC_p1003_2 */ |
|
ARGV_NONE, /* MDOC_p1387_2 */ |
|
ARGV_NONE, /* MDOC_isoC_90 */ |
|
ARGV_NONE, /* MDOC_isoC_amd1 */ |
|
ARGV_NONE, /* MDOC_isoC_tcor1 */ |
|
ARGV_NONE, /* MDOC_isoC_tcor2 */ |
|
ARGV_NONE, /* MDOC_isoC_99 */ |
|
ARGV_NONE, /* MDOC_ansiC */ |
|
ARGV_NONE, /* MDOC_ansiC_89 */ |
|
ARGV_NONE, /* MDOC_ansiC_99 */ |
|
ARGV_NONE, /* MDOC_ieee754 */ |
|
ARGV_NONE, /* MDOC_iso8802_3 */ |
|
ARGV_NONE, /* MDOC_xpg3 */ |
|
ARGV_NONE, /* MDOC_xpg4 */ |
|
ARGV_NONE, /* MDOC_xpg4_2 */ |
|
ARGV_NONE, /* MDOC_xpg4_3 */ |
|
ARGV_NONE, /* MDOC_xbd5 */ |
|
ARGV_NONE, /* MDOC_xcu5 */ |
|
ARGV_NONE, /* MDOC_xsh5 */ |
|
ARGV_NONE, /* MDOC_xns5 */ |
|
ARGV_NONE, /* MDOC_xns5_2d2_0 */ |
|
ARGV_NONE, /* MDOC_xcurses4_2 */ |
|
ARGV_NONE, /* MDOC_susv2 */ |
|
ARGV_NONE, /* MDOC_susv3 */ |
|
ARGV_NONE, /* MDOC_svid4 */ |
|
ARGV_NONE, /* MDOC_Filled */ |
|
ARGV_NONE, /* MDOC_Words */ |
|
ARGV_NONE, /* MDOC_Emphasis */ |
|
ARGV_NONE /* MDOC_Symbolic */ |
|
}; |
|
|
static int mdoc_argflags[MDOC_MAX] = { |
static int mdoc_argflags[MDOC_MAX] = { |
0, /* \" */ |
0, /* \" */ |
0, /* Dd */ |
0, /* Dd */ |
Line 78 static int mdoc_argflags[MDOC_MAX] = { |
|
Line 148 static int mdoc_argflags[MDOC_MAX] = { |
|
0, /* Ed */ |
0, /* Ed */ |
0, /* Bl */ |
0, /* Bl */ |
0, /* El */ |
0, /* El */ |
ARGS_DELIM, /* It */ |
0, /* It */ |
ARGS_DELIM, /* Ad */ |
ARGS_DELIM, /* Ad */ |
ARGS_DELIM, /* An */ |
ARGS_DELIM, /* An */ |
ARGS_DELIM, /* Ar */ |
ARGS_DELIM, /* Ar */ |
Line 184 perr(struct mdoc *mdoc, int line, int pos, int code) |
|
Line 254 perr(struct mdoc *mdoc, int line, int pos, int code) |
|
c = mdoc_perr(mdoc, line, pos, |
c = mdoc_perr(mdoc, line, pos, |
"unterminated quoted parameter"); |
"unterminated quoted parameter"); |
break; |
break; |
case (EOFFSET): |
|
c = mdoc_perr(mdoc, line, pos, |
|
"invalid value for offset argument"); |
|
break; |
|
case (EARGVAL): |
case (EARGVAL): |
c = mdoc_perr(mdoc, line, pos, |
c = mdoc_perr(mdoc, line, pos, |
"argument requires a value"); |
"argument requires a value"); |
Line 244 mdoc_args(struct mdoc *mdoc, int line, |
|
Line 310 mdoc_args(struct mdoc *mdoc, int line, |
|
fl = (0 == tok) ? 0 : mdoc_argflags[tok]; |
fl = (0 == tok) ? 0 : mdoc_argflags[tok]; |
|
|
/* |
/* |
* First see if we should use TABSEP (Bl -column). This |
* Override per-macro argument flags with context-specific ones. |
* invalidates the use of ARGS_DELIM. |
* As of now, this is only valid for `It' depending on its list |
|
* context. |
*/ |
*/ |
|
|
if (MDOC_It == tok) { |
switch (tok) { |
|
case (MDOC_It): |
for (n = mdoc->last; n; n = n->parent) |
for (n = mdoc->last; n; n = n->parent) |
if (MDOC_BLOCK == n->type) |
if (MDOC_BLOCK == n->type && MDOC_Bl == n->tok) |
if (MDOC_Bl == n->tok) |
break; |
break; |
|
assert(n); |
assert(n); |
c = (int)n->data.block.argc; |
c = (int)n->data.block.argc; |
assert(c > 0); |
assert(c > 0); |
|
|
|
/* |
|
* Using `Bl -column' adds ARGS_TABSEP to the arguments |
|
* and invalidates ARGS_DELIM. Using `Bl -diag' allows |
|
* for quoted arguments. |
|
*/ |
|
|
/* LINTED */ |
/* LINTED */ |
for (i = 0; i < c; i++) { |
for (i = 0; i < c; i++) { |
if (MDOC_Column != n->data.block.argv[i].arg) |
switch (n->data.block.argv[i].arg) { |
continue; |
case (MDOC_Column): |
fl |= ARGS_TABSEP; |
fl |= ARGS_TABSEP; |
fl &= ~ARGS_DELIM; |
fl &= ~ARGS_DELIM; |
break; |
i = c; |
|
break; |
|
case (MDOC_Diag): |
|
fl |= ARGS_QUOTED; |
|
i = c; |
|
break; |
|
default: |
|
break; |
|
} |
} |
} |
|
default: |
|
break; |
} |
} |
|
|
|
/* Continue parsing the arguments themselves... */ |
|
|
return(args(mdoc, line, pos, buf, fl, v)); |
return(args(mdoc, line, pos, buf, fl, v)); |
} |
} |
|
|
|
|
args(struct mdoc *mdoc, int line, |
args(struct mdoc *mdoc, int line, |
int *pos, char *buf, int fl, char **v) |
int *pos, char *buf, int fl, char **v) |
{ |
{ |
int i, c; |
int i; |
char *p, *pp; |
char *p, *pp; |
|
|
assert(*pos > 0); |
assert(*pos > 0); |
Line 298 args(struct mdoc *mdoc, int line, |
|
Line 384 args(struct mdoc *mdoc, int line, |
|
*/ |
*/ |
|
|
if ((fl & ARGS_DELIM) && mdoc_iscdelim(buf[*pos])) { |
if ((fl & ARGS_DELIM) && mdoc_iscdelim(buf[*pos])) { |
for (i = *pos; (c = buf[i]); ) { |
for (i = *pos; buf[i]; ) { |
if ( ! mdoc_iscdelim(c)) |
if ( ! mdoc_iscdelim(buf[i])) |
break; |
break; |
i++; |
i++; |
if (0 == buf[i] || ! isspace(c)) |
/* There must be at least one space... */ |
|
if (0 == buf[i] || ! isspace((int)buf[i])) |
break; |
break; |
i++; |
i++; |
while (buf[i] && isspace(c)) |
while (buf[i] && isspace((int)buf[i])) |
i++; |
i++; |
} |
} |
if (0 == buf[i]) { |
if (0 == buf[i]) { |
Line 383 args(struct mdoc *mdoc, int line, |
|
Line 470 args(struct mdoc *mdoc, int line, |
|
p++; |
p++; |
if (0 != *p) |
if (0 != *p) |
*(p - 1) = 0; |
*(p - 1) = 0; |
*pos += p - *v; |
*pos += (int)(p - *v); |
} |
} |
|
|
if (p && 0 == *p) |
if (p && 0 == *p) |
Line 404 args(struct mdoc *mdoc, int line, |
|
Line 491 args(struct mdoc *mdoc, int line, |
|
if (p > *v && ' ' == *(p - 1)) |
if (p > *v && ' ' == *(p - 1)) |
if ( ! pwarn(mdoc, line, *pos, WTAILWS)) |
if ( ! pwarn(mdoc, line, *pos, WTAILWS)) |
return(0); |
return(0); |
*pos += p - *v; |
*pos += (int)(p - *v); |
|
|
return(ARGS_WORD); |
return(ARGS_WORD); |
} |
} |
Line 412 args(struct mdoc *mdoc, int line, |
|
Line 499 args(struct mdoc *mdoc, int line, |
|
/* Do non-tabsep look-ahead here. */ |
/* Do non-tabsep look-ahead here. */ |
|
|
if ( ! (ARGS_TABSEP & fl)) |
if ( ! (ARGS_TABSEP & fl)) |
while ((c = buf[*pos])) { |
while (buf[*pos]) { |
if (isspace(c)) |
if (isspace((int)buf[*pos])) |
if ('\\' != buf[*pos - 1]) |
if ('\\' != buf[*pos - 1]) |
break; |
break; |
(*pos)++; |
(*pos)++; |
Line 474 args(struct mdoc *mdoc, int line, |
|
Line 561 args(struct mdoc *mdoc, int line, |
|
|
|
|
|
static int |
static int |
lookup(int tok, const char *argv) |
argv_a2arg(int tok, const char *argv) |
{ |
{ |
|
|
|
/* |
|
* Parse an argument identifier from its text. XXX - this |
|
* should really be table-driven to clarify the code. |
|
* |
|
* If you add an argument to the list, make sure that you |
|
* register it here with its one or more macros! |
|
*/ |
|
|
switch (tok) { |
switch (tok) { |
case (MDOC_An): |
case (MDOC_An): |
if (xstrcmp(argv, "split")) |
if (xstrcmp(argv, "split")) |
Line 638 lookup(int tok, const char *argv) |
|
Line 733 lookup(int tok, const char *argv) |
|
|
|
|
|
static int |
static int |
postargv(struct mdoc *mdoc, int line, const struct mdoc_arg *v, int pos) |
|
{ |
|
|
|
switch (v->arg) { |
|
case (MDOC_Offset): |
|
assert(v->value); |
|
assert(v->value[0]); |
|
if (xstrcmp(v->value[0], "left")) |
|
break; |
|
if (xstrcmp(v->value[0], "right")) |
|
break; |
|
if (xstrcmp(v->value[0], "center")) |
|
break; |
|
if (xstrcmp(v->value[0], "indent")) |
|
break; |
|
if (xstrcmp(v->value[0], "indent-two")) |
|
break; |
|
return(perr(mdoc, line, pos, EOFFSET)); |
|
default: |
|
break; |
|
} |
|
|
|
return(1); |
|
} |
|
|
|
|
|
static int |
|
argv_multi(struct mdoc *mdoc, int line, |
argv_multi(struct mdoc *mdoc, int line, |
struct mdoc_arg *v, int *pos, char *buf) |
struct mdoc_arg *v, int *pos, char *buf) |
{ |
{ |
Line 685 argv_multi(struct mdoc *mdoc, int line, |
|
Line 753 argv_multi(struct mdoc *mdoc, int line, |
|
return(0); |
return(0); |
} else if (ARGS_EOLN == c) |
} else if (ARGS_EOLN == c) |
break; |
break; |
v->value[v->sz] = p; |
v->value[(int)v->sz] = p; |
} |
} |
|
|
if (0 < v->sz && v->sz < MDOC_LINEARG_MAX) |
if (0 < v->sz && v->sz < MDOC_LINEARG_MAX) |
Line 700 argv_multi(struct mdoc *mdoc, int line, |
|
Line 768 argv_multi(struct mdoc *mdoc, int line, |
|
|
|
|
|
static int |
static int |
|
argv_opt_single(struct mdoc *mdoc, int line, |
|
struct mdoc_arg *v, int *pos, char *buf) |
|
{ |
|
int c, ppos; |
|
char *p; |
|
|
|
ppos = *pos; |
|
|
|
if ('-' == buf[*pos]) |
|
return(1); |
|
|
|
c = args(mdoc, line, pos, buf, ARGS_QUOTED, &p); |
|
if (ARGS_ERROR == c) |
|
return(0); |
|
if (ARGS_EOLN == c) |
|
return(1); |
|
|
|
v->sz = 1; |
|
v->value = xcalloc(1, sizeof(char *)); |
|
v->value[0] = p; |
|
return(1); |
|
} |
|
|
|
|
|
/* |
|
* Parse a single, mandatory value from the stream. |
|
*/ |
|
static int |
argv_single(struct mdoc *mdoc, int line, |
argv_single(struct mdoc *mdoc, int line, |
struct mdoc_arg *v, int *pos, char *buf) |
struct mdoc_arg *v, int *pos, char *buf) |
{ |
{ |
Line 712 argv_single(struct mdoc *mdoc, int line, |
|
Line 808 argv_single(struct mdoc *mdoc, int line, |
|
if (ARGS_ERROR == c) |
if (ARGS_ERROR == c) |
return(0); |
return(0); |
if (ARGS_EOLN == c) |
if (ARGS_EOLN == c) |
return(perr(mdoc, line, ppos, EARGVAL)); |
return(perr(mdoc, line, ppos, EARGVAL)); |
|
|
v->sz = 1; |
v->sz = 1; |
v->value = xcalloc(1, sizeof(char *)); |
v->value = xcalloc(1, sizeof(char *)); |
Line 721 argv_single(struct mdoc *mdoc, int line, |
|
Line 817 argv_single(struct mdoc *mdoc, int line, |
|
} |
} |
|
|
|
|
|
/* |
|
* Determine rules for parsing arguments. Arguments can either accept |
|
* no parameters, an optional single parameter, one parameter, or |
|
* multiple parameters. |
|
*/ |
static int |
static int |
argv(struct mdoc *mdoc, int line, |
argv(struct mdoc *mdoc, int line, |
struct mdoc_arg *v, int *pos, char *buf) |
struct mdoc_arg *v, int *pos, char *buf) |
Line 729 argv(struct mdoc *mdoc, int line, |
|
Line 830 argv(struct mdoc *mdoc, int line, |
|
v->sz = 0; |
v->sz = 0; |
v->value = NULL; |
v->value = NULL; |
|
|
switch (v->arg) { |
switch (mdoc_argvflags[v->arg]) { |
case(MDOC_Std): |
case (ARGV_SINGLE): |
/* FALLTHROUGH */ |
|
case(MDOC_Width): |
|
/* FALLTHROUGH */ |
|
case(MDOC_Offset): |
|
return(argv_single(mdoc, line, v, pos, buf)); |
return(argv_single(mdoc, line, v, pos, buf)); |
case(MDOC_Column): |
case (ARGV_MULTI): |
return(argv_multi(mdoc, line, v, pos, buf)); |
return(argv_multi(mdoc, line, v, pos, buf)); |
|
case (ARGV_OPT_SINGLE): |
|
return(argv_opt_single(mdoc, line, v, pos, buf)); |
default: |
default: |
|
/* ARGV_NONE */ |
break; |
break; |
} |
} |
|
|
Line 746 argv(struct mdoc *mdoc, int line, |
|
Line 846 argv(struct mdoc *mdoc, int line, |
|
} |
} |
|
|
|
|
|
/* |
|
* Parse an argument from line text. This comes in the form of -key |
|
* [value0...], which may either have a single mandatory value, at least |
|
* one mandatory value, an optional single value, or no value. |
|
*/ |
int |
int |
mdoc_argv(struct mdoc *mdoc, int line, int tok, |
mdoc_argv(struct mdoc *mdoc, int line, int tok, |
struct mdoc_arg *v, int *pos, char *buf) |
struct mdoc_arg *v, int *pos, char *buf) |
{ |
{ |
int i, ppos; |
int i; |
char *p; |
char *p; |
|
|
(void)memset(v, 0, sizeof(struct mdoc_arg)); |
(void)memset(v, 0, sizeof(struct mdoc_arg)); |
Line 782 mdoc_argv(struct mdoc *mdoc, int line, int tok, |
|
Line 887 mdoc_argv(struct mdoc *mdoc, int line, int tok, |
|
if (buf[*pos]) |
if (buf[*pos]) |
buf[(*pos)++] = 0; |
buf[(*pos)++] = 0; |
|
|
if (MDOC_ARG_MAX == (v->arg = lookup(tok, p))) { |
/* |
|
* We now parse out the per-macro arguments. XXX - this can be |
|
* made much cleaner using per-argument tables. See argv_a2arg |
|
* for details. |
|
*/ |
|
|
|
if (MDOC_ARG_MAX == (v->arg = argv_a2arg(tok, p))) { |
if ( ! pwarn(mdoc, line, i, WARGVPARM)) |
if ( ! pwarn(mdoc, line, i, WARGVPARM)) |
return(ARGV_ERROR); |
return(ARGV_ERROR); |
return(ARGV_WORD); |
return(ARGV_WORD); |
Line 793 mdoc_argv(struct mdoc *mdoc, int line, int tok, |
|
Line 904 mdoc_argv(struct mdoc *mdoc, int line, int tok, |
|
|
|
/* FIXME: whitespace if no value. */ |
/* FIXME: whitespace if no value. */ |
|
|
ppos = *pos; |
|
if ( ! argv(mdoc, line, v, pos, buf)) |
if ( ! argv(mdoc, line, v, pos, buf)) |
return(ARGV_ERROR); |
|
if ( ! postargv(mdoc, line, v, ppos)) |
|
return(ARGV_ERROR); |
return(ARGV_ERROR); |
|
|
return(ARGV_ARG); |
return(ARGV_ARG); |