summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--mdoc.744
-rw-r--r--mdoc.h4
-rw-r--r--mdoc.template24
-rw-r--r--mdoc_action.c359
-rw-r--r--mdoc_argv.c2
-rw-r--r--mdoc_term.c70
-rw-r--r--mdoc_validate.c17
7 files changed, 276 insertions, 244 deletions
diff --git a/mdoc.7 b/mdoc.7
index 3c6168d1..b2748f89 100644
--- a/mdoc.7
+++ b/mdoc.7
@@ -67,7 +67,8 @@ Text following a
whether in a macro or free-form text line, is ignored to the end of
line. A macro line with only a control character and comment escape,
.Sq \&.\e" ,
-is also ignored.
+is also ignored. Macro lines with only a control charater and optionally
+whitespace are stripped from input.
.
.
.Ss Reserved Characters
@@ -224,9 +225,42 @@ followed by
\&.Dd $\&Mdocdate$
\&.Dt mdoc 7
\&.Os
+\&.
\&.Sh NAME
-\&.Nm mdoc
-\&.Nd mdoc language reference
+\&.Nm foo
+\&.Nd a description goes here
+\&.\e\*q The next is for sections 2 & 3 only.
+\&.\e\*q .Sh LIBRARY
+\&.
+\&.Sh SYNOPSIS
+\&.Nm foo
+\&.Op Fl options
+\&.Ar
+\&.
+\&.Sh DESCRIPTION
+The
+\&.Nm
+utility processes files ...
+\&.\e\*q The next is for sections 1 & 8 only.
+\&.\e\*q .Sh EXIT STATUS
+\&.\e\*q The next is for sections 2, 3, & 9 only.
+\&.\e\*q .Sh RETURN VALUES
+\&.\e\*q The next is for sections 1, 6, 7, & 8 only.
+\&.\e\*q .Sh ENVIRONMENT
+\&.\e\*q .Sh FILES
+\&.\e\*q .Sh EXAMPLES
+\&.\e\*q The next is for sections 1, 4, 6, 7, & 8 only.
+\&.\e\*q .Sh DIAGNOSTICS
+\&.\e\*q The next is for sections 2, 3, & 9 only.
+\&.\e\*q .Sh ERRORS
+\&.\e\*q .Sh SEE ALSO
+\&.\e\*q .Xr foobar 1
+\&.\e\*q .Sh STANDARDS
+\&.\e\*q .Sh HISTORY
+\&.\e\*q .Sh AUTHORS
+\&.\e\*q .Sh CAVEATS
+\&.\e\*q .Sh BUGS
+\&.\e\*q .Sh SECURITY CONSIDERATIONS
.Ed
.
.Pp
@@ -453,7 +487,7 @@ then the macro accepts an arbitrary number of arguments.
.It \&Er Ta Yes Ta Yes Ta >0
.It \&Es Ta \&No Ta \&No Ta 0
.It \&Ev Ta Yes Ta Yes Ta n
-.It \&Ex Ta \&No Ta \&No Ta 0
+.It \&Ex Ta \&No Ta \&No Ta n
.It \&Fa Ta Yes Ta Yes Ta n
.It \&Fd Ta \&No Ta \&No Ta >0
.It \&Fl Ta Yes Ta Yes Ta n
@@ -480,7 +514,7 @@ then the macro accepts an arbitrary number of arguments.
.It \&Pa Ta Yes Ta Yes Ta n
.It \&Pf Ta \&No Ta Yes Ta 1
.It \&Pp Ta \&No Ta \&No Ta 0
-.It \&Rv Ta \&No Ta \&No Ta 0
+.It \&Rv Ta \&No Ta \&No Ta n
.It \&Sm Ta \&No Ta \&No Ta 1
.It \&St Ta \&No Ta Yes Ta 1
.It \&Sx Ta Yes Ta Yes Ta >0
diff --git a/mdoc.h b/mdoc.h
index 7de9842d..3341f744 100644
--- a/mdoc.h
+++ b/mdoc.h
@@ -200,8 +200,9 @@ enum mdoc_sec {
SEC_SYNOPSIS,
SEC_DESCRIPTION,
SEC_IMPLEMENTATION,
+ /* FIXME: EXIT STATUS */
SEC_RETURN_VALUES,
- SEC_ENVIRONMENT,
+ SEC_ENVIRONMENT,
SEC_FILES,
SEC_EXAMPLES,
SEC_DIAGNOSTICS,
@@ -213,6 +214,7 @@ enum mdoc_sec {
SEC_AUTHORS,
SEC_CAVEATS,
SEC_BUGS,
+ /* FIXME: SECURITY CONSIDERATIONS */
SEC_CUSTOM /* User-defined. */
};
diff --git a/mdoc.template b/mdoc.template
index 6d2beb0d..9dcf5893 100644
--- a/mdoc.template
+++ b/mdoc.template
@@ -2,36 +2,36 @@
.\"
.\" Copyright notice goes here.
.\"
-.\" The uncommented requests are required for all man pages.
+.\" The uncommented requests are required for all manual pages.
.\" The commented requests should be uncommented and used where appropriate.
.\"
.\" See mdoc(7) for further reference.
.\"
.Dd $\&Mdocdate$
-.Dt <document_title> <section>
+.Dt title section
.Os
+.
.Sh NAME
-.Nm <name>
-.Nd <description>
-.\" The next request should be used for sections 2 and 3 only.
+.Nm name
+.Nd short description
+.\" The next is for sections 2 & 3 only.
.\" .Sh LIBRARY
.Sh SYNOPSIS
.Sh DESCRIPTION
-.\" This next request is for sections 1 and 8 exit statuses only.
+.\" The next is for sections 1 & 8 only.
.\" .Sh EXIT STATUS
-.\" This next request is for sections 2 and 3 function return values only.
+.\" The next is for sections 2, 3, & 9 only.
.\" .Sh RETURN VALUES
-.\" This next request is for sections 1, 6, 7 & 8 only.
+.\" The next is for sections 1, 6, 7 & 8 only.
.\" .Sh ENVIRONMENT
.\" .Sh FILES
.\" .Sh EXAMPLES
-.\" This next request is for sections 1, 6, 7 & 8 only
+.\" The next is for sections 1, 4, 6, 7, & 8 only
.\" .Sh DIAGNOSTICS
-.\" The next request is for sections 2 and 3 error and signal handling only.
+.\" The next is for sections 2, 3, & 9 only.
.\" .Sh ERRORS
.\" .Sh SEE ALSO
-.\" Cross-references should be ordered by section (low to high), then in
-.\" alphabetical order.
+.\" .Xr foobar 1
.\" .Sh STANDARDS
.\" .Sh HISTORY
.\" .Sh AUTHORS
diff --git a/mdoc_action.c b/mdoc_action.c
index 8971d000..dd8487ad 100644
--- a/mdoc_action.c
+++ b/mdoc_action.c
@@ -24,8 +24,8 @@
#include "libmdoc.h"
+#define POST_ARGS struct mdoc *m, struct mdoc_node *n
#define PRE_ARGS struct mdoc *m, const struct mdoc_node *n
-#define POST_ARGS struct mdoc *m
struct actions {
int (*pre)(PRE_ARGS);
@@ -71,7 +71,7 @@ const struct actions mdoc_actions[MDOC_MAX] = {
{ NULL, NULL }, /* Ad */
{ NULL, NULL }, /* An */
{ NULL, post_ar }, /* Ar */
- { NULL, NULL }, /* Cd */ /* FIXME: tabs are accepted! */
+ { NULL, NULL }, /* Cd */
{ NULL, NULL }, /* Cm */
{ NULL, NULL }, /* Dv */
{ NULL, NULL }, /* Er */
@@ -222,7 +222,7 @@ mdoc_action_post(struct mdoc *m)
if (NULL == mdoc_actions[m->last->tok].post)
return(1);
- return((*mdoc_actions[m->last->tok].post)(m));
+ return((*mdoc_actions[m->last->tok].post)(m, m->last));
}
@@ -248,27 +248,17 @@ concat(struct mdoc *m, const struct mdoc_node *n,
static int
post_std(POST_ARGS)
{
+ struct mdoc_node *nn;
- /*
- * If '-std' is invoked without an argument, fill it in with our
- * name (if it's been set).
- */
-
- if (NULL == m->last->args)
+ if (n->child)
return(1);
- if (m->last->args->argv[0].sz)
- return(1);
-
+
+ nn = n;
+ m->next = MDOC_NEXT_CHILD;
assert(m->meta.name);
-
- m->last->args->argv[0].value = calloc(1, sizeof(char *));
- if (NULL == m->last->args->argv[0].value)
- return(mdoc_nerr(m, m->last, EMALLOC));
-
- m->last->args->argv[0].sz = 1;
- m->last->args->argv[0].value[0] = strdup(m->meta.name);
- if (NULL == m->last->args->argv[0].value[0])
- return(mdoc_nerr(m, m->last, EMALLOC));
+ if ( ! mdoc_word_alloc(m, n->line, n->pos, m->meta.name))
+ return(0);
+ m->last = nn;
return(1);
}
@@ -283,11 +273,10 @@ post_nm(POST_ARGS)
return(1);
buf[0] = 0;
- if ( ! concat(m, m->last->child, buf, sizeof(buf)))
+ if ( ! concat(m, n->child, buf, sizeof(buf)))
return(0);
-
if (NULL == (m->meta.name = strdup(buf)))
- return(mdoc_nerr(m, m->last, EMALLOC));
+ return(mdoc_nerr(m, n, EMALLOC));
return(1);
}
@@ -300,25 +289,26 @@ post_lb(POST_ARGS)
char *buf;
size_t sz;
- assert(MDOC_TEXT == m->last->child->type);
- p = mdoc_a2lib(m->last->child->string);
+ assert(MDOC_TEXT == n->child->type);
+ p = mdoc_a2lib(n->child->string);
if (NULL == p) {
- sz = strlen(m->last->child->string) +
+ sz = strlen(n->child->string) +
2 + strlen("\\(lqlibrary\\(rq");
buf = malloc(sz);
if (NULL == buf)
- return(mdoc_nerr(m, m->last, EMALLOC));
+ return(mdoc_nerr(m, n, EMALLOC));
(void)snprintf(buf, sz, "library \\(lq%s\\(rq",
- m->last->child->string);
- free(m->last->child->string);
- m->last->child->string = buf;
+ n->child->string);
+ free(n->child->string);
+ n->child->string = buf;
return(1);
}
- free(m->last->child->string);
- m->last->child->string = strdup(p);
- if (NULL == m->last->child->string)
- return(mdoc_nerr(m, m->last, EMALLOC));
+ free(n->child->string);
+ n->child->string = strdup(p);
+ if (NULL == n->child->string)
+ return(mdoc_nerr(m, n, EMALLOC));
+
return(1);
}
@@ -328,13 +318,14 @@ post_st(POST_ARGS)
{
const char *p;
- assert(MDOC_TEXT == m->last->child->type);
- p = mdoc_a2st(m->last->child->string);
+ assert(MDOC_TEXT == n->child->type);
+ p = mdoc_a2st(n->child->string);
assert(p);
- free(m->last->child->string);
- m->last->child->string = strdup(p);
- if (NULL == m->last->child->string)
- return(mdoc_nerr(m, m->last, EMALLOC));
+ free(n->child->string);
+ n->child->string = strdup(p);
+ if (NULL == n->child->string)
+ return(mdoc_nerr(m, n, EMALLOC));
+
return(1);
}
@@ -342,28 +333,27 @@ post_st(POST_ARGS)
static int
post_at(POST_ARGS)
{
- struct mdoc_node *n;
- const char *p;
+ struct mdoc_node *nn;
+ const char *p;
- if (m->last->child) {
- assert(MDOC_TEXT == m->last->child->type);
- p = mdoc_a2att(m->last->child->string);
+ if (n->child) {
+ assert(MDOC_TEXT == n->child->type);
+ p = mdoc_a2att(n->child->string);
assert(p);
- free(m->last->child->string);
- m->last->child->string = strdup(p);
- if (NULL == m->last->child->string)
- return(mdoc_nerr(m, m->last, EMALLOC));
+ free(n->child->string);
+ n->child->string = strdup(p);
+ if (NULL == n->child->string)
+ return(mdoc_nerr(m, n, EMALLOC));
return(1);
}
- n = m->last;
+ nn = n;
m->next = MDOC_NEXT_CHILD;
- if ( ! mdoc_word_alloc(m, n->line, n->pos, "AT&T UNIX"))
+ if ( ! mdoc_word_alloc(m, nn->line, nn->pos, "AT&T UNIX"))
return(0);
+ m->last = nn;
- m->last = n;
- m->next = MDOC_NEXT_SIBLING;
return(1);
}
@@ -380,11 +370,11 @@ post_sh(POST_ARGS)
* check ordering.
*/
- if (MDOC_HEAD != m->last->type)
+ if (MDOC_HEAD != n->type)
return(1);
buf[0] = 0;
- if ( ! concat(m, m->last->child, buf, sizeof(buf)))
+ if ( ! concat(m, n->child, buf, sizeof(buf)))
return(0);
if (SEC_CUSTOM != (sec = mdoc_atosec(buf)))
m->lastnamed = sec;
@@ -401,7 +391,7 @@ post_sh(POST_ARGS)
case (9):
break;
default:
- return(mdoc_nwarn(m, m->last, EBADSEC));
+ return(mdoc_nwarn(m, n, EBADSEC));
}
break;
default:
@@ -414,7 +404,7 @@ post_sh(POST_ARGS)
static int
post_dt(POST_ARGS)
{
- struct mdoc_node *n;
+ struct mdoc_node *nn;
const char *cp;
char *ep;
long lval;
@@ -433,25 +423,25 @@ post_dt(POST_ARGS)
* --> title = unknown, volume = local, msec = 0, arch = NULL
*/
- if (NULL == (n = m->last->child)) {
+ if (NULL == (nn = n->child)) {
if (NULL == (m->meta.title = strdup("unknown")))
- return(mdoc_nerr(m, m->last, EMALLOC));
+ return(mdoc_nerr(m, n, EMALLOC));
if (NULL == (m->meta.vol = strdup("local")))
- return(mdoc_nerr(m, m->last, EMALLOC));
- return(post_prol(m));
+ return(mdoc_nerr(m, n, EMALLOC));
+ return(post_prol(m, n));
}
/* Handles: `.Dt TITLE'
* --> title = TITLE, volume = local, msec = 0, arch = NULL
*/
- if (NULL == (m->meta.title = strdup(n->string)))
- return(mdoc_nerr(m, m->last, EMALLOC));
+ if (NULL == (m->meta.title = strdup(nn->string)))
+ return(mdoc_nerr(m, n, EMALLOC));
- if (NULL == (n = n->next)) {
+ if (NULL == (nn = nn->next)) {
if (NULL == (m->meta.vol = strdup("local")))
- return(mdoc_nerr(m, m->last, EMALLOC));
- return(post_prol(m));
+ return(mdoc_nerr(m, n, EMALLOC));
+ return(post_prol(m, n));
}
/* Handles: `.Dt TITLE SEC'
@@ -461,19 +451,19 @@ post_dt(POST_ARGS)
* arch = NULL
*/
- cp = mdoc_a2msec(n->string);
+ cp = mdoc_a2msec(nn->string);
if (cp) {
if (NULL == (m->meta.vol = strdup(cp)))
- return(mdoc_nerr(m, m->last, EMALLOC));
+ return(mdoc_nerr(m, n, EMALLOC));
errno = 0;
- lval = strtol(n->string, &ep, 10);
- if (n->string[0] != '\0' && *ep == '\0')
+ lval = strtol(nn->string, &ep, 10);
+ if (nn->string[0] != '\0' && *ep == '\0')
m->meta.msec = (int)lval;
- } else if (NULL == (m->meta.vol = strdup(n->string)))
- return(mdoc_nerr(m, m->last, EMALLOC));
+ } else if (NULL == (m->meta.vol = strdup(nn->string)))
+ return(mdoc_nerr(m, n, EMALLOC));
- if (NULL == (n = n->next))
- return(post_prol(m));
+ if (NULL == (nn = nn->next))
+ return(post_prol(m, n));
/* Handles: `.Dt TITLE SEC VOL'
* --> title = TITLE, volume = VOL is vol ?
@@ -482,24 +472,24 @@ post_dt(POST_ARGS)
* VOL
*/
- cp = mdoc_a2vol(n->string);
+ cp = mdoc_a2vol(nn->string);
if (cp) {
free(m->meta.vol);
if (NULL == (m->meta.vol = strdup(cp)))
- return(mdoc_nerr(m, m->last, EMALLOC));
+ return(mdoc_nerr(m, n, EMALLOC));
} else {
- cp = mdoc_a2arch(n->string);
+ cp = mdoc_a2arch(nn->string);
if (NULL == cp) {
free(m->meta.vol);
- if (NULL == (m->meta.vol = strdup(n->string)))
- return(mdoc_nerr(m, m->last, EMALLOC));
+ if (NULL == (m->meta.vol = strdup(nn->string)))
+ return(mdoc_nerr(m, n, EMALLOC));
} else if (NULL == (m->meta.arch = strdup(cp)))
- return(mdoc_nerr(m, m->last, EMALLOC));
+ return(mdoc_nerr(m, n, EMALLOC));
}
/* Ignore any subsequent parameters... */
- return(post_prol(m));
+ return(post_prol(m, n));
}
@@ -513,24 +503,24 @@ post_os(POST_ARGS)
free(m->meta.os);
buf[0] = 0;
- if ( ! concat(m, m->last->child, buf, sizeof(buf)))
+ if ( ! concat(m, n->child, buf, sizeof(buf)))
return(0);
if (0 == buf[0]) {
if (-1 == uname(&utsname))
- return(mdoc_nerr(m, m->last, EUTSNAME));
+ return(mdoc_nerr(m, n, EUTSNAME));
if (strlcat(buf, utsname.sysname, 64) >= 64)
- return(mdoc_nerr(m, m->last, ETOOLONG));
+ return(mdoc_nerr(m, n, ETOOLONG));
if (strlcat(buf, " ", 64) >= 64)
- return(mdoc_nerr(m, m->last, ETOOLONG));
+ return(mdoc_nerr(m, n, ETOOLONG));
if (strlcat(buf, utsname.release, 64) >= 64)
- return(mdoc_nerr(m, m->last, ETOOLONG));
+ return(mdoc_nerr(m, n, ETOOLONG));
}
if (NULL == (m->meta.os = strdup(buf)))
- return(mdoc_nerr(m, m->last, EMALLOC));
+ return(mdoc_nerr(m, n, EMALLOC));
- return(post_prol(m));
+ return(post_prol(m, n));
}
@@ -539,9 +529,9 @@ post_os(POST_ARGS)
* Uses the first head macro.
*/
static int
-post_bl_tagwidth(struct mdoc *m)
+post_bl_tagwidth(POST_ARGS)
{
- struct mdoc_node *n;
+ struct mdoc_node *nn;
int sz;
char buf[32];
@@ -550,75 +540,75 @@ post_bl_tagwidth(struct mdoc *m)
* width if a macro.
*/
- n = m->last->body->child;
- if (n) {
- assert(MDOC_BLOCK == n->type);
- assert(MDOC_It == n->tok);
- n = n->head->child;
+ nn = n->body->child;
+ if (nn) {
+ assert(MDOC_BLOCK == nn->type);
+ assert(MDOC_It == nn->tok);
+ nn = nn->head->child;
}
sz = 10; /* Default size. */
- if (n) {
- if (MDOC_TEXT != n->type) {
- if (0 == (sz = (int)mdoc_macro2len(n->tok)))
- if ( ! mdoc_nwarn(m, m->last, ENOWIDTH))
+ if (nn) {
+ if (MDOC_TEXT != nn->type) {
+ if (0 == (sz = (int)mdoc_macro2len(nn->tok)))
+ if ( ! mdoc_nwarn(m, n, ENOWIDTH))
return(0);
} else
- sz = (int)strlen(n->string) + 1;
+ sz = (int)strlen(nn->string) + 1;
}
if (-1 == snprintf(buf, sizeof(buf), "%dn", sz))
- return(mdoc_nerr(m, m->last, ENUMFMT));
+ return(mdoc_nerr(m, n, ENUMFMT));
/*
* We have to dynamically add this to the macro's argument list.
* We're guaranteed that a MDOC_Width doesn't already exist.
*/
- n = m->last;
- assert(n->args);
- sz = (int)(n->args->argc)++;
+ nn = n;
+ assert(nn->args);
+ sz = (int)(nn->args->argc)++;
- n->args->argv = realloc(n->args->argv,
- n->args->argc * sizeof(struct mdoc_argv));
+ nn->args->argv = realloc(nn->args->argv,
+ nn->args->argc * sizeof(struct mdoc_argv));
- if (NULL == n->args->argv)
- return(mdoc_nerr(m, m->last, EMALLOC));
+ if (NULL == nn->args->argv)
+ return(mdoc_nerr(m, n, EMALLOC));
- n->args->argv[sz].arg = MDOC_Width;
- n->args->argv[sz].line = m->last->line;
- n->args->argv[sz].pos = m->last->pos;
- n->args->argv[sz].sz = 1;
- n->args->argv[sz].value = calloc(1, sizeof(char *));
+ nn->args->argv[sz].arg = MDOC_Width;
+ nn->args->argv[sz].line = n->line;
+ nn->args->argv[sz].pos = n->pos;
+ nn->args->argv[sz].sz = 1;
+ nn->args->argv[sz].value = calloc(1, sizeof(char *));
- if (NULL == n->args->argv[sz].value)
- return(mdoc_nerr(m, m->last, EMALLOC));
- if (NULL == (n->args->argv[sz].value[0] = strdup(buf)))
- return(mdoc_nerr(m, m->last, EMALLOC));
+ if (NULL == nn->args->argv[sz].value)
+ return(mdoc_nerr(m, n, EMALLOC));
+ if (NULL == (nn->args->argv[sz].value[0] = strdup(buf)))
+ return(mdoc_nerr(m, n, EMALLOC));
return(1);
}
static int
-post_bl_width(struct mdoc *m)
+post_bl_width(POST_ARGS)
{
size_t width;
int i, tok;
char buf[32];
char *p;
- if (NULL == m->last->args)
+ if (NULL == n->args)
return(1);
- for (i = 0; i < (int)m->last->args->argc; i++)
- if (MDOC_Width == m->last->args->argv[i].arg)
+ for (i = 0; i < (int)n->args->argc; i++)
+ if (MDOC_Width == n->args->argv[i].arg)
break;
- if (i == (int)m->last->args->argc)
+ if (i == (int)n->args->argc)
return(1);
- p = m->last->args->argv[i].value[0];
+ p = n->args->argv[i].value[0];
/*
* If the value to -width is a macro, then we re-write it to be
@@ -630,44 +620,45 @@ post_bl_width(struct mdoc *m)
else if (MDOC_MAX == (tok = mdoc_hash_find(m->htab, p)))
return(1);
else if (0 == (width = mdoc_macro2len(tok)))
- return(mdoc_nwarn(m, m->last, ENOWIDTH));
+ return(mdoc_nwarn(m, n, ENOWIDTH));
/* The value already exists: free and reallocate it. */
if (-1 == snprintf(buf, sizeof(buf), "%zun", width))
- return(mdoc_nerr(m, m->last, ENUMFMT));
+ return(mdoc_nerr(m, n, ENUMFMT));
- free(m->last->args->argv[i].value[0]);
- m->last->args->argv[i].value[0] = strdup(buf);
- if (NULL == m->last->args->argv[i].value[0])
- return(mdoc_nerr(m, m->last, EMALLOC));
+ free(n->args->argv[i].value[0]);
+ n->args->argv[i].value[0] = strdup(buf);
+ if (NULL == n->args->argv[i].value[0])
+ return(mdoc_nerr(m, n, EMALLOC));
return(1);
}
+/* ARGSUSED */
static int
post_bl_head(POST_ARGS)
{
int i, c;
- struct mdoc_node *n, *nn, *nnp;
+ struct mdoc_node *np, *nn, *nnp;
- if (NULL == m->last->child)
+ if (NULL == n->child)
return(1);
- n = m->last->parent;
- assert(n->args);
+ np = n->parent;
+ assert(np->args);
- for (c = 0; c < (int)n->args->argc; c++)
- if (MDOC_Column == n->args->argv[c].arg)
+ for (c = 0; c < (int)np->args->argc; c++)
+ if (MDOC_Column == np->args->argv[c].arg)
break;
/* Only process -column. */
- if (c == (int)n->args->argc)
+ if (c == (int)np->args->argc)
return(1);
- assert(0 == n->args->argv[c].sz);
+ assert(0 == np->args->argv[c].sz);
/*
* Accomodate for new-style groff column syntax. Shuffle the
@@ -675,20 +666,20 @@ post_bl_head(POST_ARGS)
* column field. Then, delete the head children.
*/
- n->args->argv[c].sz = (size_t)m->last->nchild;
- n->args->argv[c].value = malloc
- ((size_t)m->last->nchild * sizeof(char *));
+ np->args->argv[c].sz = (size_t)n->nchild;
+ np->args->argv[c].value = malloc
+ ((size_t)n->nchild * sizeof(char *));
- for (i = 0, nn = m->last->child; nn; i++) {
- n->args->argv[c].value[i] = nn->string;
+ for (i = 0, nn = n->child; nn; i++) {
+ np->args->argv[c].value[i] = nn->string;
nn->string = NULL;
nnp = nn;
nn = nn->next;
mdoc_node_free(nnp);
}
- m->last->nchild = 0;
- m->last->child = NULL;
+ n->nchild = 0;
+ n->child = NULL;
return(1);
}
@@ -699,9 +690,9 @@ post_bl(POST_ARGS)
{
int i, r, len;
- if (MDOC_HEAD == m->last->type)
- return(post_bl_head(m));
- if (MDOC_BLOCK != m->last->type)
+ if (MDOC_HEAD == n->type)
+ return(post_bl_head(m, n));
+ if (MDOC_BLOCK != n->type)
return(1);
/*
@@ -712,20 +703,20 @@ post_bl(POST_ARGS)
* rewritten into real lengths).
*/
- len = (int)(m->last->args ? m->last->args->argc : 0);
+ len = (int)(n->args ? n->args->argc : 0);
for (r = i = 0; i < len; i++) {
- if (MDOC_Tag == m->last->args->argv[i].arg)
+ if (MDOC_Tag == n->args->argv[i].arg)
r |= 1 << 0;
- if (MDOC_Width == m->last->args->argv[i].arg)
+ if (MDOC_Width == n->args->argv[i].arg)
r |= 1 << 1;
}
if (r & (1 << 0) && ! (r & (1 << 1))) {
- if ( ! post_bl_tagwidth(m))
+ if ( ! post_bl_tagwidth(m, n))
return(0);
} else if (r & (1 << 1))
- if ( ! post_bl_width(m))
+ if ( ! post_bl_width(m, n))
return(0);
return(1);
@@ -735,20 +726,19 @@ post_bl(POST_ARGS)
static int
post_tilde(POST_ARGS)
{
- struct mdoc_node *n;
+ struct mdoc_node *np;
- if (m->last->child)
+ if (n->child)
return(1);
- n = m->last;
+ np = n;
m->next = MDOC_NEXT_CHILD;
/* XXX: not documented for `Lk'. */
- if ( ! mdoc_word_alloc(m, m->last->line, m->last->pos, "~"))
+ if ( ! mdoc_word_alloc(m, n->line, n->pos, "~"))
return(0);
+ m->last = np;
- m->last = n;
- m->next = MDOC_NEXT_SIBLING;
return(1);
}
@@ -756,21 +746,19 @@ post_tilde(POST_ARGS)
static int
post_ar(POST_ARGS)
{
- struct mdoc_node *n;
+ struct mdoc_node *np;
- if (m->last->child)
+ if (n->child)
return(1);
- n = m->last;
+ np = n;
m->next = MDOC_NEXT_CHILD;
- if ( ! mdoc_word_alloc(m, m->last->line, m->last->pos, "file"))
+ if ( ! mdoc_word_alloc(m, n->line, n->pos, "file"))
return(0);
- m->next = MDOC_NEXT_SIBLING;
- if ( ! mdoc_word_alloc(m, m->last->line, m->last->pos, "..."))
+ if ( ! mdoc_word_alloc(m, n->line, n->pos, "..."))
return(0);
+ m->last = np;
- m->last = n;
- m->next = MDOC_NEXT_SIBLING;
return(1);
}
@@ -781,49 +769,47 @@ post_dd(POST_ARGS)
char buf[64];
buf[0] = 0;
- if ( ! concat(m, m->last->child, buf, sizeof(buf)))
+ if ( ! concat(m, n->child, buf, sizeof(buf)))
return(0);
if (0 == (m->meta.date = mdoc_atotime(buf))) {
- if ( ! mdoc_nwarn(m, m->last, EBADDATE))
+ if ( ! mdoc_nwarn(m, n, EBADDATE))
return(0);
m->meta.date = time(NULL);
}
- return(post_prol(m));
+ return(post_prol(m, n));
}
static int
post_prol(POST_ARGS)
{
- struct mdoc_node *n;
+ struct mdoc_node *np;
- /*
- * The end document shouldn't have the prologue macros as part
- * of the syntax tree (they encompass only meta-data).
- */
+ /* Remove prologue macros from AST. */
- if (m->last->parent->child == m->last)
- m->last->parent->child = m->last->prev;
- if (m->last->prev)
- m->last->prev->next = NULL;
+ if (n->parent->child == n)
+ n->parent->child = n->prev;
+ if (n->prev)
+ n->prev->next = NULL;
- n = m->last;
- assert(NULL == m->last->next);
+ np = n;
+ assert(NULL == n->next);
- if (m->last->prev) {
- m->last = m->last->prev;
+ if (n->prev) {
+ m->last = n->prev;
m->next = MDOC_NEXT_SIBLING;
} else {
- m->last = m->last->parent;
+ m->last = n->parent;
m->next = MDOC_NEXT_CHILD;
}
- mdoc_node_freelist(n);
+ mdoc_node_freelist(np);
if (m->meta.title && m->meta.date && m->meta.os)
m->flags |= MDOC_PBODY;
+
return(1);
}
@@ -834,7 +820,6 @@ pre_dl(PRE_ARGS)
if (MDOC_BODY == n->type)
m->flags |= MDOC_LITERAL;
-
return(1);
}
@@ -871,7 +856,7 @@ static int
post_display(POST_ARGS)
{
- if (MDOC_BODY == m->last->type)
+ if (MDOC_BODY == n->type)
m->flags &= ~MDOC_LITERAL;
return(1);
}
diff --git a/mdoc_argv.c b/mdoc_argv.c
index 447126ef..20a9dc5e 100644
--- a/mdoc_argv.c
+++ b/mdoc_argv.c
@@ -74,7 +74,7 @@ static int mdoc_argvflags[MDOC_ARG_MAX] = {
ARGV_MULTI, /* MDOC_Column */
ARGV_SINGLE, /* MDOC_Width */
ARGV_NONE, /* MDOC_Compact */
- ARGV_OPT_SINGLE, /* MDOC_Std */
+ ARGV_NONE, /* MDOC_Std */
ARGV_NONE, /* MDOC_Filled */
ARGV_NONE, /* MDOC_Words */
ARGV_NONE, /* MDOC_Emphasis */
diff --git a/mdoc_term.c b/mdoc_term.c
index 790920ae..99792503 100644
--- a/mdoc_term.c
+++ b/mdoc_term.c
@@ -1237,23 +1237,33 @@ termp_rs_pre(DECL_ARGS)
static int
termp_rv_pre(DECL_ARGS)
{
- int i;
-
- i = arg_getattr(MDOC_Std, node);
- assert(-1 != i);
- assert(node->args->argv[i].sz);
+ const struct mdoc_node *nn;
term_newln(p);
term_word(p, "The");
- p->flags |= ttypes[TTYPE_FUNC_NAME];
- term_word(p, *node->args->argv[i].value);
- p->flags &= ~ttypes[TTYPE_FUNC_NAME];
- p->flags |= TERMP_NOSPACE;
+ nn = node->child;
+ assert(nn);
+ for ( ; nn; nn = nn->next) {
+ p->flags |= ttypes[TTYPE_FUNC_NAME];
+ term_word(p, nn->string);
+ p->flags &= ~ttypes[TTYPE_FUNC_NAME];
+ p->flags |= TERMP_NOSPACE;
+ if (nn->next && NULL == nn->next->next)
+ term_word(p, "(), and");
+ else if (nn->next)
+ term_word(p, "(),");
+ else
+ term_word(p, "()");
+ }
+
+ if (node->child->next)
+ term_word(p, "functions return");
+ else
+ term_word(p, "function returns");
- term_word(p, "() function returns the value 0 if successful;");
- term_word(p, "otherwise the value -1 is returned and the");
- term_word(p, "global variable");
+ term_word(p, "the value 0 if successful; otherwise the value "
+ "-1 is returned and the global variable");
p->flags |= ttypes[TTYPE_VAR_DECL];
term_word(p, "errno");
@@ -1261,7 +1271,7 @@ termp_rv_pre(DECL_ARGS)
term_word(p, "is set to indicate the error.");
- return(1);
+ return(0);
}
@@ -1269,19 +1279,33 @@ termp_rv_pre(DECL_ARGS)
static int
termp_ex_pre(DECL_ARGS)
{
- int i;
-
- i = arg_getattr(MDOC_Std, node);
- assert(-1 != i);
- assert(node->args->argv[i].sz);
+ const struct mdoc_node *nn;
term_word(p, "The");
- p->flags |= ttypes[TTYPE_PROG];
- term_word(p, *node->args->argv[i].value);
- p->flags &= ~ttypes[TTYPE_PROG];
- term_word(p, "utility exits 0 on success, and >0 if an error occurs.");
- return(1);
+ nn = node->child;
+ assert(nn);
+ for ( ; nn; nn = nn->next) {
+ p->flags |= ttypes[TTYPE_PROG];
+ term_word(p, nn->string);
+ p->flags &= ~ttypes[TTYPE_PROG];
+ p->flags |= TERMP_NOSPACE;
+ if (nn->next && NULL == nn->next->next)
+ term_word(p, ", and");
+ else if (nn->next)
+ term_word(p, ",");
+ else
+ p->flags &= ~TERMP_NOSPACE;
+ }
+
+ if (node->child->next)
+ term_word(p, "utilities exit");
+ else
+ term_word(p, "utility exits");
+
+ term_word(p, "0 on success, and >0 if an error occurs.");
+
+ return(0);
}
diff --git a/mdoc_validate.c b/mdoc_validate.c
index 7e6dddf1..558dd931 100644
--- a/mdoc_validate.c
+++ b/mdoc_validate.c
@@ -81,7 +81,6 @@ static int hwarn_eq1(POST_ARGS);
static int hwarn_le1(POST_ARGS);
static int post_an(POST_ARGS);
-static int post_args(POST_ARGS);
static int post_at(POST_ARGS);
static int post_bf(POST_ARGS);
static int post_bl(POST_ARGS);
@@ -118,7 +117,6 @@ static v_post posts_bd[] = { herr_eq0, bwarn_ge1, NULL };
static v_post posts_bf[] = { hwarn_le1, post_bf, NULL };
static v_post posts_bl[] = { bwarn_ge1, post_bl, NULL };
static v_post posts_bool[] = { eerr_eq1, ebool, NULL };
-static v_post posts_ex[] = { eerr_eq0, post_args, NULL };
static v_post posts_fo[] = { hwarn_eq1, bwarn_ge1, NULL };
static v_post posts_in[] = { eerr_eq1, NULL };
static v_post posts_it[] = { post_it, NULL };
@@ -127,7 +125,6 @@ static v_post posts_nd[] = { berr_ge1, NULL };
static v_post posts_nm[] = { post_nm, NULL };
static v_post posts_notext[] = { eerr_eq0, NULL };
static v_post posts_pf[] = { eerr_eq1, NULL };
-static v_post posts_rv[] = { eerr_eq0, post_args, NULL };
static v_post posts_sh[] = { herr_ge1, bwarn_ge1, post_sh, NULL };
static v_post posts_sp[] = { post_sp, NULL };
static v_post posts_ss[] = { herr_ge1, NULL };
@@ -176,7 +173,7 @@ const struct valids mdoc_valids[MDOC_MAX] = {
{ NULL, NULL }, /* Dv */
{ pres_er, posts_text }, /* Er */
{ NULL, NULL }, /* Ev */
- { pres_ex, posts_ex }, /* Ex */
+ { pres_ex, NULL }, /* Ex */
{ NULL, NULL }, /* Fa */
{ pres_fd, posts_wtext }, /* Fd */
{ NULL, NULL }, /* Fl */
@@ -190,7 +187,7 @@ const struct valids mdoc_valids[MDOC_MAX] = {
{ NULL, posts_wline }, /* Op */
{ NULL, NULL }, /* Ot */
{ NULL, NULL }, /* Pa */
- { pres_rv, posts_rv }, /* Rv */
+ { pres_rv, NULL }, /* Rv */
{ NULL, posts_st }, /* St */
{ NULL, NULL }, /* Va */
{ NULL, posts_text }, /* Vt */
@@ -922,16 +919,6 @@ post_an(POST_ARGS)
static int
-post_args(POST_ARGS)
-{
-
- if (mdoc->last->args)
- return(1);
- return(mdoc_nerr(mdoc, mdoc->last, ELINE));
-}
-
-
-static int
post_it(POST_ARGS)
{
int type, i, cols;