]> git.cameronkatri.com Git - mandoc.git/blobdiff - mdoc.c
If a column list starts with implicit rows (that is, rows without .It)
[mandoc.git] / mdoc.c
diff --git a/mdoc.c b/mdoc.c
index dc74a104172f346828d4f719e13d552e60b9f2fe..d9f0e4106bf33a3e5190a9724fe59e716c186f2f 100644 (file)
--- a/mdoc.c
+++ b/mdoc.c
@@ -1,7 +1,7 @@
-/*     $Id: mdoc.c,v 1.250 2015/04/19 14:57:38 schwarze Exp $ */
+/*     $Id: mdoc.c,v 1.257 2016/08/20 14:43:50 schwarze Exp $ */
 /*
  * Copyright (c) 2008, 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
- * Copyright (c) 2010, 2012-2015 Ingo Schwarze <schwarze@openbsd.org>
+ * Copyright (c) 2010, 2012-2016 Ingo Schwarze <schwarze@openbsd.org>
  *
  * Permission to use, copy, modify, and distribute this software for any
  * purpose with or without fee is hereby granted, provided that the above
@@ -89,13 +89,6 @@ static       int               mdoc_ptext(struct roff_man *, int, char *, int);
 static int               mdoc_pmacro(struct roff_man *, int, char *, int);
 
 
-void
-mdoc_endparse(struct roff_man *mdoc)
-{
-
-       mdoc_macroend(mdoc);
-}
-
 /*
  * Main parse routine.  Parses a single line -- really just hands off to
  * the macro (mdoc_pmacro()) or text parser (mdoc_ptext()).
@@ -118,9 +111,9 @@ mdoc_parseln(struct roff_man *mdoc, int ln, char *buf, int offs)
        else
                mdoc->flags &= ~MDOC_SYNOPSIS;
 
-       return(roff_getcontrol(mdoc->roff, buf, &offs) ?
+       return roff_getcontrol(mdoc->roff, buf, &offs) ?
            mdoc_pmacro(mdoc, ln, buf, offs) :
-           mdoc_ptext(mdoc, ln, buf, offs));
+           mdoc_ptext(mdoc, ln, buf, offs);
 }
 
 void
@@ -128,24 +121,6 @@ mdoc_macro(MACRO_PROT_ARGS)
 {
        assert(tok > TOKEN_NONE && tok < MDOC_MAX);
 
-       if (mdoc->flags & MDOC_PBODY) {
-               if (tok == MDOC_Dt) {
-                       mandoc_vmsg(MANDOCERR_DT_LATE,
-                           mdoc->parse, line, ppos,
-                           "Dt %s", buf + *pos);
-                       return;
-               }
-       } else if ( ! (mdoc_macros[tok].flags & MDOC_PROLOGUE)) {
-               if (mdoc->meta.title == NULL) {
-                       mandoc_vmsg(MANDOCERR_DT_NOTITLE,
-                           mdoc->parse, line, ppos, "%s %s",
-                           mdoc_macronames[tok], buf + *pos);
-                       mdoc->meta.title = mandoc_strdup("UNTITLED");
-               }
-               if (NULL == mdoc->meta.vol)
-                       mdoc->meta.vol = mandoc_strdup("LOCAL");
-               mdoc->flags |= MDOC_PBODY;
-       }
        (*mdoc_macros[tok].fp)(mdoc, tok, line, ppos, pos, buf);
 }
 
@@ -173,7 +148,7 @@ mdoc_endbody_alloc(struct roff_man *mdoc, int line, int pos, int tok,
        p->end = end;
        roff_node_append(mdoc, p);
        mdoc->next = ROFF_NEXT_SIBLING;
-       return(p);
+       return p;
 }
 
 struct roff_node *
@@ -189,13 +164,9 @@ mdoc_block_alloc(struct roff_man *mdoc, int line, int pos,
 
        switch (tok) {
        case MDOC_Bd:
-               /* FALLTHROUGH */
        case MDOC_Bf:
-               /* FALLTHROUGH */
        case MDOC_Bl:
-               /* FALLTHROUGH */
        case MDOC_En:
-               /* FALLTHROUGH */
        case MDOC_Rs:
                p->norm = mandoc_calloc(1, sizeof(union mdoc_data));
                break;
@@ -204,7 +175,7 @@ mdoc_block_alloc(struct roff_man *mdoc, int line, int pos,
        }
        roff_node_append(mdoc, p);
        mdoc->next = ROFF_NEXT_CHILD;
-       return(p);
+       return p;
 }
 
 void
@@ -234,6 +205,7 @@ mdoc_node_relink(struct roff_man *mdoc, struct roff_node *p)
 {
 
        roff_node_unlink(mdoc, p);
+       p->prev = p->next = NULL;
        roff_node_append(mdoc, p);
 }
 
@@ -247,32 +219,22 @@ mdoc_ptext(struct roff_man *mdoc, int line, char *buf, int offs)
        struct roff_node *n;
        char             *c, *ws, *end;
 
-       assert(mdoc->last);
        n = mdoc->last;
 
        /*
-        * Divert directly to list processing if we're encountering a
-        * columnar ROFFT_BLOCK with or without a prior ROFFT_BLOCK entry
-        * (a ROFFT_BODY means it's already open, in which case we should
-        * process within its context in the normal way).
+        * If a column list contains plain text, assume an implicit item
+        * macro.  This can happen one or more times at the beginning
+        * of such a list, intermixed with non-It mdoc macros and with
+        * nodes generated on the roff level, for example by tbl.
         */
 
-       if (n->tok == MDOC_Bl && n->type == ROFFT_BODY &&
-           n->end == ENDBODY_NOT && n->norm->Bl.type == LIST_column) {
-               /* `Bl' is open without any children. */
+       if ((n->tok == MDOC_Bl && n->type == ROFFT_BODY &&
+            n->end == ENDBODY_NOT && n->norm->Bl.type == LIST_column) ||
+           (n->parent != NULL && n->parent->tok == MDOC_Bl &&
+            n->parent->norm->Bl.type == LIST_column)) {
                mdoc->flags |= MDOC_FREECOL;
                mdoc_macro(mdoc, MDOC_It, line, offs, &offs, buf);
-               return(1);
-       }
-
-       if (n->tok == MDOC_It && n->type == ROFFT_BLOCK &&
-           NULL != n->parent &&
-           MDOC_Bl == n->parent->tok &&
-           LIST_column == n->parent->norm->Bl.type) {
-               /* `Bl' has block-level `It' children. */
-               mdoc->flags |= MDOC_FREECOL;
-               mdoc_macro(mdoc, MDOC_It, line, offs, &offs, buf);
-               return(1);
+               return 1;
        }
 
        /*
@@ -330,15 +292,15 @@ mdoc_ptext(struct roff_man *mdoc, int line, char *buf, int offs)
                 * behaviour that we want to work around it.
                 */
                roff_elem_alloc(mdoc, line, offs, MDOC_sp);
+               mdoc->last->flags |= MDOC_VALID | MDOC_ENDED;
                mdoc->next = ROFF_NEXT_SIBLING;
-               mdoc_valid_post(mdoc);
-               return(1);
+               return 1;
        }
 
        roff_word_alloc(mdoc, line, offs, buf+offs);
 
        if (mdoc->flags & MDOC_LITERAL)
-               return(1);
+               return 1;
 
        /*
         * End-of-sentence check.  If the last character is an unescaped
@@ -350,7 +312,7 @@ mdoc_ptext(struct roff_man *mdoc, int line, char *buf, int offs)
 
        if (mandoc_eos(buf+offs, (size_t)(end-buf-offs)))
                mdoc->last->flags |= MDOC_EOS;
-       return(1);
+       return 1;
 }
 
 /*
@@ -384,7 +346,7 @@ mdoc_pmacro(struct roff_man *mdoc, int ln, char *buf, int offs)
        if (tok == TOKEN_NONE) {
                mandoc_msg(MANDOCERR_MACRO, mdoc->parse,
                    ln, sv, buf + sv - 1);
-               return(1);
+               return 1;
        }
 
        /* Skip a leading escape sequence or tab. */
@@ -421,39 +383,26 @@ mdoc_pmacro(struct roff_man *mdoc, int ln, char *buf, int offs)
         * into macro processing.
         */
 
-       if (NULL == mdoc->last || MDOC_It == tok || MDOC_El == tok) {
-               mdoc_macro(mdoc, tok, ln, sv, &offs, buf);
-               return(1);
-       }
-
        n = mdoc->last;
-       assert(mdoc->last);
-
-       /*
-        * If the first macro of a `Bl -column', open an `It' block
-        * context around the parsed macro.
-        */
-
-       if (n->tok == MDOC_Bl && n->type == ROFFT_BODY &&
-           n->end == ENDBODY_NOT && n->norm->Bl.type == LIST_column) {
-               mdoc->flags |= MDOC_FREECOL;
-               mdoc_macro(mdoc, MDOC_It, ln, sv, &sv, buf);
-               return(1);
+       if (n == NULL || tok == MDOC_It || tok == MDOC_El) {
+               mdoc_macro(mdoc, tok, ln, sv, &offs, buf);
+               return 1;
        }
 
        /*
-        * If we're following a block-level `It' within a `Bl -column'
-        * context (perhaps opened in the above block or in ptext()),
-        * then open an `It' block context around the parsed macro.
+        * If a column list contains a non-It macro, assume an implicit
+        * item macro.  This can happen one or more times at the
+        * beginning of such a list, intermixed with text lines and
+        * with nodes generated on the roff level, for example by tbl.
         */
 
-       if (n->tok == MDOC_It && n->type == ROFFT_BLOCK &&
-           NULL != n->parent &&
-           MDOC_Bl == n->parent->tok &&
-           LIST_column == n->parent->norm->Bl.type) {
+       if ((n->tok == MDOC_Bl && n->type == ROFFT_BODY &&
+            n->end == ENDBODY_NOT && n->norm->Bl.type == LIST_column) ||
+           (n->parent != NULL && n->parent->tok == MDOC_Bl &&
+            n->parent->norm->Bl.type == LIST_column)) {
                mdoc->flags |= MDOC_FREECOL;
                mdoc_macro(mdoc, MDOC_It, ln, sv, &sv, buf);
-               return(1);
+               return 1;
        }
 
        /* Normal processing of a macro. */
@@ -464,9 +413,9 @@ mdoc_pmacro(struct roff_man *mdoc, int ln, char *buf, int offs)
 
        if (mdoc->quick && MDOC_Sh == tok &&
            SEC_NAME != mdoc->last->sec)
-               return(2);
+               return 2;
 
-       return(1);
+       return 1;
 }
 
 enum mdelim
@@ -474,82 +423,44 @@ mdoc_isdelim(const char *p)
 {
 
        if ('\0' == p[0])
-               return(DELIM_NONE);
+               return DELIM_NONE;
 
        if ('\0' == p[1])
                switch (p[0]) {
                case '(':
-                       /* FALLTHROUGH */
                case '[':
-                       return(DELIM_OPEN);
+                       return DELIM_OPEN;
                case '|':
-                       return(DELIM_MIDDLE);
+                       return DELIM_MIDDLE;
                case '.':
-                       /* FALLTHROUGH */
                case ',':
-                       /* FALLTHROUGH */
                case ';':
-                       /* FALLTHROUGH */
                case ':':
-                       /* FALLTHROUGH */
                case '?':
-                       /* FALLTHROUGH */
                case '!':
-                       /* FALLTHROUGH */
                case ')':
-                       /* FALLTHROUGH */
                case ']':
-                       return(DELIM_CLOSE);
+                       return DELIM_CLOSE;
                default:
-                       return(DELIM_NONE);
+                       return DELIM_NONE;
                }
 
        if ('\\' != p[0])
-               return(DELIM_NONE);
+               return DELIM_NONE;
 
        if (0 == strcmp(p + 1, "."))
-               return(DELIM_CLOSE);
+               return DELIM_CLOSE;
        if (0 == strcmp(p + 1, "fR|\\fP"))
-               return(DELIM_MIDDLE);
+               return DELIM_MIDDLE;
 
-       return(DELIM_NONE);
+       return DELIM_NONE;
 }
 
 void
-mdoc_deroff(char **dest, const struct roff_node *n)
+mdoc_validate(struct roff_man *mdoc)
 {
-       char    *cp;
-       size_t   sz;
-
-       if (n->type != ROFFT_TEXT) {
-               for (n = n->child; n; n = n->next)
-                       mdoc_deroff(dest, n);
-               return;
-       }
-
-       /* Skip leading whitespace. */
-
-       for (cp = n->string; '\0' != *cp; cp++)
-               if (0 == isspace((unsigned char)*cp))
-                       break;
-
-       /* Skip trailing whitespace. */
-
-       for (sz = strlen(cp); sz; sz--)
-               if (0 == isspace((unsigned char)cp[sz-1]))
-                       break;
-
-       /* Skip empty strings. */
-
-       if (0 == sz)
-               return;
-
-       if (NULL == *dest) {
-               *dest = mandoc_strndup(cp, sz);
-               return;
-       }
 
-       mandoc_asprintf(&cp, "%s %*s", *dest, (int)sz, cp);
-       free(*dest);
-       *dest = cp;
+       mdoc->last = mdoc->first;
+       mdoc_node_validate(mdoc);
+       mdoc_state_reset(mdoc);
 }