[BACK]Return to man.c CVS log [TXT][DIR] Up to [local] / src / usr.bin / mandoc

Annotation of src/usr.bin/mandoc/man.c, Revision 1.70

1.70    ! schwarze    1: /*     $Id: man.c,v 1.69 2012/11/17 00:25:20 schwarze Exp $ */
1.1       kristaps    2: /*
1.52      schwarze    3:  * Copyright (c) 2008, 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
1.1       kristaps    4:  *
                      5:  * Permission to use, copy, modify, and distribute this software for any
1.2       schwarze    6:  * purpose with or without fee is hereby granted, provided that the above
                      7:  * copyright notice and this permission notice appear in all copies.
1.1       kristaps    8:  *
1.2       schwarze    9:  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
                     10:  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
                     11:  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
                     12:  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
                     13:  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
                     14:  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
                     15:  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
1.1       kristaps   16:  */
1.14      schwarze   17: #include <sys/types.h>
                     18:
1.1       kristaps   19: #include <assert.h>
                     20: #include <stdarg.h>
                     21: #include <stdlib.h>
                     22: #include <stdio.h>
                     23: #include <string.h>
                     24:
1.59      schwarze   25: #include "man.h"
1.33      schwarze   26: #include "mandoc.h"
1.1       kristaps   27: #include "libman.h"
1.16      schwarze   28: #include "libmandoc.h"
1.1       kristaps   29:
                     30: const  char *const __man_macronames[MAN_MAX] = {
1.3       schwarze   31:        "br",           "TH",           "SH",           "SS",
1.1       kristaps   32:        "TP",           "LP",           "PP",           "P",
                     33:        "IP",           "HP",           "SM",           "SB",
                     34:        "BI",           "IB",           "BR",           "RB",
                     35:        "R",            "B",            "I",            "IR",
1.50      schwarze   36:        "RI",           "na",           "sp",           "nf",
                     37:        "fi",           "RE",           "RS",           "DT",
                     38:        "UC",           "PD",           "AT",           "in",
1.70    ! schwarze   39:        "ft",           "OP",           "EX",           "EE",
        !            40:        "UR",           "UE"
1.1       kristaps   41:        };
                     42:
                     43: const  char * const *man_macronames = __man_macronames;
                     44:
1.54      schwarze   45: static struct man_node *man_node_alloc(struct man *, int, int,
1.22      schwarze   46:                                enum man_type, enum mant);
1.1       kristaps   47: static int              man_node_append(struct man *,
                     48:                                struct man_node *);
1.22      schwarze   49: static void             man_node_free(struct man_node *);
                     50: static void             man_node_unlink(struct man *,
                     51:                                struct man_node *);
1.31      schwarze   52: static int              man_ptext(struct man *, int, char *, int);
                     53: static int              man_pmacro(struct man *, int, char *, int);
1.1       kristaps   54: static void             man_free1(struct man *);
1.16      schwarze   55: static void             man_alloc1(struct man *);
1.52      schwarze   56: static int              man_descope(struct man *, int, int);
1.1       kristaps   57:
                     58:
                     59: const struct man_node *
1.69      schwarze   60: man_node(const struct man *man)
1.1       kristaps   61: {
                     62:
1.69      schwarze   63:        assert( ! (MAN_HALT & man->flags));
                     64:        return(man->first);
1.1       kristaps   65: }
                     66:
                     67:
                     68: const struct man_meta *
1.69      schwarze   69: man_meta(const struct man *man)
1.1       kristaps   70: {
                     71:
1.69      schwarze   72:        assert( ! (MAN_HALT & man->flags));
                     73:        return(&man->meta);
1.1       kristaps   74: }
                     75:
                     76:
1.16      schwarze   77: void
1.1       kristaps   78: man_reset(struct man *man)
                     79: {
                     80:
                     81:        man_free1(man);
1.16      schwarze   82:        man_alloc1(man);
1.1       kristaps   83: }
                     84:
                     85:
                     86: void
                     87: man_free(struct man *man)
                     88: {
                     89:
                     90:        man_free1(man);
                     91:        free(man);
                     92: }
                     93:
                     94:
                     95: struct man *
1.60      schwarze   96: man_alloc(struct roff *roff, struct mparse *parse)
1.1       kristaps   97: {
                     98:        struct man      *p;
                     99:
1.16      schwarze  100:        p = mandoc_calloc(1, sizeof(struct man));
1.1       kristaps  101:
1.13      schwarze  102:        man_hash_init();
1.59      schwarze  103:        p->parse = parse;
1.60      schwarze  104:        p->roff = roff;
1.16      schwarze  105:
                    106:        man_alloc1(p);
1.1       kristaps  107:        return(p);
                    108: }
                    109:
                    110:
                    111: int
1.69      schwarze  112: man_endparse(struct man *man)
1.1       kristaps  113: {
                    114:
1.69      schwarze  115:        assert( ! (MAN_HALT & man->flags));
                    116:        if (man_macroend(man))
1.1       kristaps  117:                return(1);
1.69      schwarze  118:        man->flags |= MAN_HALT;
1.1       kristaps  119:        return(0);
                    120: }
                    121:
                    122:
                    123: int
1.69      schwarze  124: man_parseln(struct man *man, int ln, char *buf, int offs)
1.1       kristaps  125: {
1.25      schwarze  126:
1.69      schwarze  127:        man->flags |= MAN_NEWLINE;
1.54      schwarze  128:
1.69      schwarze  129:        assert( ! (MAN_HALT & man->flags));
1.59      schwarze  130:
1.69      schwarze  131:        return (roff_getcontrol(man->roff, buf, &offs) ?
                    132:                        man_pmacro(man, ln, buf, offs) :
                    133:                        man_ptext(man, ln, buf, offs));
1.1       kristaps  134: }
                    135:
                    136:
                    137: static void
                    138: man_free1(struct man *man)
                    139: {
                    140:
                    141:        if (man->first)
1.22      schwarze  142:                man_node_delete(man, man->first);
1.1       kristaps  143:        if (man->meta.title)
                    144:                free(man->meta.title);
                    145:        if (man->meta.source)
                    146:                free(man->meta.source);
1.56      schwarze  147:        if (man->meta.date)
                    148:                free(man->meta.date);
1.1       kristaps  149:        if (man->meta.vol)
                    150:                free(man->meta.vol);
1.29      schwarze  151:        if (man->meta.msec)
                    152:                free(man->meta.msec);
1.1       kristaps  153: }
                    154:
                    155:
1.16      schwarze  156: static void
1.69      schwarze  157: man_alloc1(struct man *man)
1.1       kristaps  158: {
                    159:
1.69      schwarze  160:        memset(&man->meta, 0, sizeof(struct man_meta));
                    161:        man->flags = 0;
                    162:        man->last = mandoc_calloc(1, sizeof(struct man_node));
                    163:        man->first = man->last;
                    164:        man->last->type = MAN_ROOT;
                    165:        man->last->tok = MAN_MAX;
                    166:        man->next = MAN_NEXT_CHILD;
1.1       kristaps  167: }
                    168:
                    169:
                    170: static int
                    171: man_node_append(struct man *man, struct man_node *p)
                    172: {
                    173:
                    174:        assert(man->last);
                    175:        assert(man->first);
                    176:        assert(MAN_ROOT != p->type);
                    177:
                    178:        switch (man->next) {
                    179:        case (MAN_NEXT_SIBLING):
                    180:                man->last->next = p;
                    181:                p->prev = man->last;
                    182:                p->parent = man->last->parent;
                    183:                break;
                    184:        case (MAN_NEXT_CHILD):
                    185:                man->last->child = p;
                    186:                p->parent = man->last;
                    187:                break;
                    188:        default:
                    189:                abort();
                    190:                /* NOTREACHED */
                    191:        }
1.5       schwarze  192:
1.22      schwarze  193:        assert(p->parent);
1.5       schwarze  194:        p->parent->nchild++;
1.1       kristaps  195:
1.9       schwarze  196:        if ( ! man_valid_pre(man, p))
                    197:                return(0);
                    198:
                    199:        switch (p->type) {
                    200:        case (MAN_HEAD):
                    201:                assert(MAN_BLOCK == p->parent->type);
                    202:                p->parent->head = p;
                    203:                break;
1.59      schwarze  204:        case (MAN_TAIL):
                    205:                assert(MAN_BLOCK == p->parent->type);
                    206:                p->parent->tail = p;
                    207:                break;
1.9       schwarze  208:        case (MAN_BODY):
                    209:                assert(MAN_BLOCK == p->parent->type);
                    210:                p->parent->body = p;
                    211:                break;
                    212:        default:
                    213:                break;
                    214:        }
                    215:
1.1       kristaps  216:        man->last = p;
                    217:
                    218:        switch (p->type) {
1.52      schwarze  219:        case (MAN_TBL):
                    220:                /* FALLTHROUGH */
1.1       kristaps  221:        case (MAN_TEXT):
                    222:                if ( ! man_valid_post(man))
                    223:                        return(0);
                    224:                break;
                    225:        default:
                    226:                break;
                    227:        }
                    228:
                    229:        return(1);
                    230: }
                    231:
                    232:
                    233: static struct man_node *
1.69      schwarze  234: man_node_alloc(struct man *man, int line, int pos,
1.54      schwarze  235:                enum man_type type, enum mant tok)
1.1       kristaps  236: {
                    237:        struct man_node *p;
                    238:
1.16      schwarze  239:        p = mandoc_calloc(1, sizeof(struct man_node));
1.1       kristaps  240:        p->line = line;
                    241:        p->pos = pos;
                    242:        p->type = type;
                    243:        p->tok = tok;
1.54      schwarze  244:
1.69      schwarze  245:        if (MAN_NEWLINE & man->flags)
1.54      schwarze  246:                p->flags |= MAN_LINE;
1.69      schwarze  247:        man->flags &= ~MAN_NEWLINE;
1.1       kristaps  248:        return(p);
                    249: }
                    250:
                    251:
                    252: int
1.69      schwarze  253: man_elem_alloc(struct man *man, int line, int pos, enum mant tok)
1.1       kristaps  254: {
                    255:        struct man_node *p;
                    256:
1.69      schwarze  257:        p = man_node_alloc(man, line, pos, MAN_ELEM, tok);
                    258:        if ( ! man_node_append(man, p))
1.10      schwarze  259:                return(0);
1.69      schwarze  260:        man->next = MAN_NEXT_CHILD;
1.10      schwarze  261:        return(1);
1.1       kristaps  262: }
                    263:
                    264:
                    265: int
1.69      schwarze  266: man_tail_alloc(struct man *man, int line, int pos, enum mant tok)
1.59      schwarze  267: {
                    268:        struct man_node *p;
                    269:
1.69      schwarze  270:        p = man_node_alloc(man, line, pos, MAN_TAIL, tok);
                    271:        if ( ! man_node_append(man, p))
1.59      schwarze  272:                return(0);
1.69      schwarze  273:        man->next = MAN_NEXT_CHILD;
1.59      schwarze  274:        return(1);
                    275: }
                    276:
                    277:
                    278: int
1.69      schwarze  279: man_head_alloc(struct man *man, int line, int pos, enum mant tok)
1.9       schwarze  280: {
                    281:        struct man_node *p;
                    282:
1.69      schwarze  283:        p = man_node_alloc(man, line, pos, MAN_HEAD, tok);
                    284:        if ( ! man_node_append(man, p))
1.9       schwarze  285:                return(0);
1.69      schwarze  286:        man->next = MAN_NEXT_CHILD;
1.9       schwarze  287:        return(1);
                    288: }
                    289:
                    290:
                    291: int
1.69      schwarze  292: man_body_alloc(struct man *man, int line, int pos, enum mant tok)
1.9       schwarze  293: {
                    294:        struct man_node *p;
                    295:
1.69      schwarze  296:        p = man_node_alloc(man, line, pos, MAN_BODY, tok);
                    297:        if ( ! man_node_append(man, p))
1.9       schwarze  298:                return(0);
1.69      schwarze  299:        man->next = MAN_NEXT_CHILD;
1.9       schwarze  300:        return(1);
                    301: }
                    302:
                    303:
                    304: int
1.69      schwarze  305: man_block_alloc(struct man *man, int line, int pos, enum mant tok)
1.9       schwarze  306: {
                    307:        struct man_node *p;
                    308:
1.69      schwarze  309:        p = man_node_alloc(man, line, pos, MAN_BLOCK, tok);
                    310:        if ( ! man_node_append(man, p))
1.9       schwarze  311:                return(0);
1.69      schwarze  312:        man->next = MAN_NEXT_CHILD;
1.9       schwarze  313:        return(1);
                    314: }
                    315:
1.27      schwarze  316: int
1.69      schwarze  317: man_word_alloc(struct man *man, int line, int pos, const char *word)
1.1       kristaps  318: {
1.10      schwarze  319:        struct man_node *n;
1.1       kristaps  320:
1.69      schwarze  321:        n = man_node_alloc(man, line, pos, MAN_TEXT, MAN_MAX);
                    322:        n->string = roff_strdup(man->roff, word);
1.10      schwarze  323:
1.69      schwarze  324:        if ( ! man_node_append(man, n))
1.1       kristaps  325:                return(0);
1.27      schwarze  326:
1.69      schwarze  327:        man->next = MAN_NEXT_SIBLING;
1.10      schwarze  328:        return(1);
                    329: }
                    330:
                    331:
1.22      schwarze  332: /*
                    333:  * Free all of the resources held by a node.  This does NOT unlink a
                    334:  * node from its context; for that, see man_node_unlink().
                    335:  */
                    336: static void
1.1       kristaps  337: man_node_free(struct man_node *p)
                    338: {
                    339:
                    340:        if (p->string)
                    341:                free(p->string);
                    342:        free(p);
                    343: }
                    344:
                    345:
                    346: void
1.69      schwarze  347: man_node_delete(struct man *man, struct man_node *p)
1.1       kristaps  348: {
                    349:
1.22      schwarze  350:        while (p->child)
1.69      schwarze  351:                man_node_delete(man, p->child);
1.22      schwarze  352:
1.69      schwarze  353:        man_node_unlink(man, p);
1.1       kristaps  354:        man_node_free(p);
                    355: }
                    356:
1.57      schwarze  357: int
1.69      schwarze  358: man_addeqn(struct man *man, const struct eqn *ep)
1.57      schwarze  359: {
                    360:        struct man_node *n;
                    361:
1.69      schwarze  362:        assert( ! (MAN_HALT & man->flags));
1.57      schwarze  363:
1.69      schwarze  364:        n = man_node_alloc(man, ep->ln, ep->pos, MAN_EQN, MAN_MAX);
1.57      schwarze  365:        n->eqn = ep;
                    366:
1.69      schwarze  367:        if ( ! man_node_append(man, n))
1.57      schwarze  368:                return(0);
                    369:
1.69      schwarze  370:        man->next = MAN_NEXT_SIBLING;
                    371:        return(man_descope(man, ep->ln, ep->pos));
1.57      schwarze  372: }
1.1       kristaps  373:
1.52      schwarze  374: int
1.69      schwarze  375: man_addspan(struct man *man, const struct tbl_span *sp)
1.52      schwarze  376: {
1.55      schwarze  377:        struct man_node *n;
1.52      schwarze  378:
1.69      schwarze  379:        assert( ! (MAN_HALT & man->flags));
1.55      schwarze  380:
1.69      schwarze  381:        n = man_node_alloc(man, sp->line, 0, MAN_TBL, MAN_MAX);
1.55      schwarze  382:        n->span = sp;
                    383:
1.69      schwarze  384:        if ( ! man_node_append(man, n))
1.52      schwarze  385:                return(0);
1.55      schwarze  386:
1.69      schwarze  387:        man->next = MAN_NEXT_SIBLING;
                    388:        return(man_descope(man, sp->line, 0));
1.52      schwarze  389: }
                    390:
                    391: static int
1.69      schwarze  392: man_descope(struct man *man, int line, int offs)
1.52      schwarze  393: {
                    394:        /*
                    395:         * Co-ordinate what happens with having a next-line scope open:
                    396:         * first close out the element scope (if applicable), then close
                    397:         * out the block scope (also if applicable).
                    398:         */
                    399:
1.69      schwarze  400:        if (MAN_ELINE & man->flags) {
                    401:                man->flags &= ~MAN_ELINE;
                    402:                if ( ! man_unscope(man, man->last->parent, MANDOCERR_MAX))
1.52      schwarze  403:                        return(0);
                    404:        }
                    405:
1.69      schwarze  406:        if ( ! (MAN_BLINE & man->flags))
1.52      schwarze  407:                return(1);
1.69      schwarze  408:        man->flags &= ~MAN_BLINE;
1.52      schwarze  409:
1.69      schwarze  410:        if ( ! man_unscope(man, man->last->parent, MANDOCERR_MAX))
1.52      schwarze  411:                return(0);
1.69      schwarze  412:        return(man_body_alloc(man, line, offs, man->last->tok));
1.52      schwarze  413: }
                    414:
1.1       kristaps  415: static int
1.69      schwarze  416: man_ptext(struct man *man, int line, char *buf, int offs)
1.1       kristaps  417: {
1.27      schwarze  418:        int              i;
1.26      schwarze  419:
1.10      schwarze  420:        /* Literal free-form text whitespace is preserved. */
                    421:
1.69      schwarze  422:        if (MAN_LITERAL & man->flags) {
                    423:                if ( ! man_word_alloc(man, line, offs, buf + offs))
1.10      schwarze  424:                        return(0);
1.69      schwarze  425:                return(man_descope(man, line, offs));
1.10      schwarze  426:        }
                    427:
1.27      schwarze  428:        /* Pump blank lines directly into the backend. */
1.10      schwarze  429:
1.31      schwarze  430:        for (i = offs; ' ' == buf[i]; i++)
1.10      schwarze  431:                /* Skip leading whitespace. */ ;
1.18      schwarze  432:
                    433:        if ('\0' == buf[i]) {
1.27      schwarze  434:                /* Allocate a blank entry. */
1.69      schwarze  435:                if ( ! man_elem_alloc(man, line, offs, MAN_sp))
1.10      schwarze  436:                        return(0);
1.69      schwarze  437:                man->next = MAN_NEXT_SIBLING;
1.68      schwarze  438:                return(1);
1.10      schwarze  439:        }
1.1       kristaps  440:
1.27      schwarze  441:        /*
                    442:         * Warn if the last un-escaped character is whitespace. Then
                    443:         * strip away the remaining spaces (tabs stay!).
                    444:         */
1.18      schwarze  445:
1.27      schwarze  446:        i = (int)strlen(buf);
                    447:        assert(i);
1.18      schwarze  448:
1.27      schwarze  449:        if (' ' == buf[i - 1] || '\t' == buf[i - 1]) {
                    450:                if (i > 1 && '\\' != buf[i - 2])
1.69      schwarze  451:                        man_pmsg(man, line, i - 1, MANDOCERR_EOLNSPACE);
1.18      schwarze  452:
1.27      schwarze  453:                for (--i; i && ' ' == buf[i]; i--)
                    454:                        /* Spin back to non-space. */ ;
1.10      schwarze  455:
1.27      schwarze  456:                /* Jump ahead of escaped whitespace. */
                    457:                i += '\\' == buf[i] ? 2 : 1;
1.18      schwarze  458:
1.27      schwarze  459:                buf[i] = '\0';
1.10      schwarze  460:        }
1.9       schwarze  461:
1.69      schwarze  462:        if ( ! man_word_alloc(man, line, offs, buf + offs))
1.1       kristaps  463:                return(0);
1.28      schwarze  464:
                    465:        /*
                    466:         * End-of-sentence check.  If the last character is an unescaped
                    467:         * EOS character, then flag the node as being the end of a
                    468:         * sentence.  The front-end will know how to interpret this.
                    469:         */
                    470:
                    471:        assert(i);
1.37      schwarze  472:        if (mandoc_eos(buf, (size_t)i, 0))
1.69      schwarze  473:                man->last->flags |= MAN_EOS;
1.10      schwarze  474:
1.69      schwarze  475:        return(man_descope(man, line, offs));
1.1       kristaps  476: }
                    477:
1.53      schwarze  478: static int
1.69      schwarze  479: man_pmacro(struct man *man, int ln, char *buf, int offs)
1.1       kristaps  480: {
1.59      schwarze  481:        int              i, ppos;
1.22      schwarze  482:        enum mant        tok;
1.10      schwarze  483:        char             mac[5];
                    484:        struct man_node *n;
1.1       kristaps  485:
1.59      schwarze  486:        if ('"' == buf[offs]) {
1.69      schwarze  487:                man_pmsg(man, ln, offs, MANDOCERR_BADCOMMENT);
1.59      schwarze  488:                return(1);
                    489:        } else if ('\0' == buf[offs])
1.17      schwarze  490:                return(1);
1.1       kristaps  491:
1.59      schwarze  492:        ppos = offs;
1.1       kristaps  493:
1.23      schwarze  494:        /*
1.59      schwarze  495:         * Copy the first word into a nil-terminated buffer.
                    496:         * Stop copying when a tab, space, or eoln is encountered.
1.23      schwarze  497:         */
1.27      schwarze  498:
1.59      schwarze  499:        i = 0;
                    500:        while (i < 4 && '\0' != buf[offs] &&
                    501:                        ' ' != buf[offs] && '\t' != buf[offs])
                    502:                mac[i++] = buf[offs++];
1.1       kristaps  503:
1.59      schwarze  504:        mac[i] = '\0';
1.1       kristaps  505:
1.59      schwarze  506:        tok = (i > 0 && i < 4) ? man_hash_find(mac) : MAN_MAX;
1.1       kristaps  507:
1.40      schwarze  508:        if (MAN_MAX == tok) {
1.69      schwarze  509:                mandoc_vmsg(MANDOCERR_MACRO, man->parse, ln,
1.59      schwarze  510:                                ppos, "%s", buf + ppos - 1);
1.1       kristaps  511:                return(1);
                    512:        }
                    513:
                    514:        /* The macro is sane.  Jump to the next word. */
                    515:
1.59      schwarze  516:        while (buf[offs] && ' ' == buf[offs])
                    517:                offs++;
1.18      schwarze  518:
1.27      schwarze  519:        /*
                    520:         * Trailing whitespace.  Note that tabs are allowed to be passed
                    521:         * into the parser as "text", so we only warn about spaces here.
                    522:         */
1.18      schwarze  523:
1.59      schwarze  524:        if ('\0' == buf[offs] && ' ' == buf[offs - 1])
1.69      schwarze  525:                man_pmsg(man, ln, offs - 1, MANDOCERR_EOLNSPACE);
1.1       kristaps  526:
1.21      schwarze  527:        /*
1.46      schwarze  528:         * Remove prior ELINE macro, as it's being clobbered by a new
1.21      schwarze  529:         * macro.  Note that NSCOPED macros do not close out ELINE
                    530:         * macros---they don't print text---so we let those slip by.
                    531:         */
                    532:
1.22      schwarze  533:        if ( ! (MAN_NSCOPED & man_macros[tok].flags) &&
1.69      schwarze  534:                        man->flags & MAN_ELINE) {
                    535:                n = man->last;
1.46      schwarze  536:                assert(MAN_TEXT != n->type);
1.21      schwarze  537:
1.49      schwarze  538:                /* Remove repeated NSCOPED macros causing ELINE. */
                    539:
1.46      schwarze  540:                if (MAN_NSCOPED & man_macros[n->tok].flags)
                    541:                        n = n->parent;
1.21      schwarze  542:
1.69      schwarze  543:                mandoc_vmsg(MANDOCERR_LINESCOPE, man->parse, n->line,
1.63      schwarze  544:                    n->pos, "%s breaks %s", man_macronames[tok],
                    545:                    man_macronames[n->tok]);
1.10      schwarze  546:
1.69      schwarze  547:                man_node_delete(man, n);
                    548:                man->flags &= ~MAN_ELINE;
1.63      schwarze  549:        }
                    550:
                    551:        /*
                    552:         * Remove prior BLINE macro that is being clobbered.
                    553:         */
1.69      schwarze  554:        if ((man->flags & MAN_BLINE) &&
1.63      schwarze  555:            (MAN_BSCOPE & man_macros[tok].flags)) {
1.69      schwarze  556:                n = man->last;
1.64      schwarze  557:
                    558:                /* Might be a text node like 8 in
                    559:                 * .TP 8
                    560:                 * .SH foo
                    561:                 */
                    562:                if (MAN_TEXT == n->type)
                    563:                        n = n->parent;
1.63      schwarze  564:
                    565:                /* Remove element that didn't end BLINE, if any. */
                    566:                if ( ! (MAN_BSCOPE & man_macros[n->tok].flags))
                    567:                        n = n->parent;
                    568:
                    569:                assert(MAN_HEAD == n->type);
                    570:                n = n->parent;
                    571:                assert(MAN_BLOCK == n->type);
                    572:                assert(MAN_SCOPED & man_macros[n->tok].flags);
                    573:
1.69      schwarze  574:                mandoc_vmsg(MANDOCERR_LINESCOPE, man->parse, n->line,
1.63      schwarze  575:                    n->pos, "%s breaks %s", man_macronames[tok],
                    576:                    man_macronames[n->tok]);
                    577:
1.69      schwarze  578:                man_node_delete(man, n);
                    579:                man->flags &= ~MAN_BLINE;
1.10      schwarze  580:        }
                    581:
1.24      schwarze  582:        /*
                    583:         * Save the fact that we're in the next-line for a block.  In
                    584:         * this way, embedded roff instructions can "remember" state
                    585:         * when they exit.
                    586:         */
                    587:
1.69      schwarze  588:        if (MAN_BLINE & man->flags)
                    589:                man->flags |= MAN_BPLINE;
1.24      schwarze  590:
                    591:        /* Call to handler... */
1.1       kristaps  592:
1.22      schwarze  593:        assert(man_macros[tok].fp);
1.69      schwarze  594:        if ( ! (*man_macros[tok].fp)(man, tok, ln, ppos, &offs, buf))
1.1       kristaps  595:                goto err;
                    596:
1.21      schwarze  597:        /*
                    598:         * We weren't in a block-line scope when entering the
                    599:         * above-parsed macro, so return.
                    600:         */
                    601:
1.69      schwarze  602:        if ( ! (MAN_BPLINE & man->flags)) {
                    603:                man->flags &= ~MAN_ILINE;
1.9       schwarze  604:                return(1);
1.21      schwarze  605:        }
1.69      schwarze  606:        man->flags &= ~MAN_BPLINE;
1.21      schwarze  607:
                    608:        /*
                    609:         * If we're in a block scope, then allow this macro to slip by
                    610:         * without closing scope around it.
                    611:         */
                    612:
1.69      schwarze  613:        if (MAN_ILINE & man->flags) {
                    614:                man->flags &= ~MAN_ILINE;
1.21      schwarze  615:                return(1);
                    616:        }
1.9       schwarze  617:
                    618:        /*
                    619:         * If we've opened a new next-line element scope, then return
                    620:         * now, as the next line will close out the block scope.
                    621:         */
                    622:
1.69      schwarze  623:        if (MAN_ELINE & man->flags)
1.9       schwarze  624:                return(1);
                    625:
                    626:        /* Close out the block scope opened in the prior line.  */
1.1       kristaps  627:
1.69      schwarze  628:        assert(MAN_BLINE & man->flags);
                    629:        man->flags &= ~MAN_BLINE;
1.1       kristaps  630:
1.69      schwarze  631:        if ( ! man_unscope(man, man->last->parent, MANDOCERR_MAX))
1.9       schwarze  632:                return(0);
1.69      schwarze  633:        return(man_body_alloc(man, ln, ppos, man->last->tok));
1.1       kristaps  634:
                    635: err:   /* Error out. */
                    636:
1.69      schwarze  637:        man->flags |= MAN_HALT;
1.1       kristaps  638:        return(0);
                    639: }
1.21      schwarze  640:
1.22      schwarze  641: /*
1.69      schwarze  642:  * Unlink a node from its context.  If "man" is provided, the last parse
1.22      schwarze  643:  * point will also be adjusted accordingly.
                    644:  */
                    645: static void
1.69      schwarze  646: man_node_unlink(struct man *man, struct man_node *n)
1.21      schwarze  647: {
                    648:
1.22      schwarze  649:        /* Adjust siblings. */
                    650:
                    651:        if (n->prev)
1.21      schwarze  652:                n->prev->next = n->next;
1.22      schwarze  653:        if (n->next)
                    654:                n->next->prev = n->prev;
                    655:
                    656:        /* Adjust parent. */
                    657:
                    658:        if (n->parent) {
                    659:                n->parent->nchild--;
                    660:                if (n->parent->child == n)
                    661:                        n->parent->child = n->prev ? n->prev : n->next;
                    662:        }
                    663:
                    664:        /* Adjust parse point, if applicable. */
                    665:
1.69      schwarze  666:        if (man && man->last == n) {
1.22      schwarze  667:                /*XXX: this can occur when bailing from validation. */
                    668:                /*assert(NULL == n->next);*/
                    669:                if (n->prev) {
1.69      schwarze  670:                        man->last = n->prev;
                    671:                        man->next = MAN_NEXT_SIBLING;
1.22      schwarze  672:                } else {
1.69      schwarze  673:                        man->last = n->parent;
                    674:                        man->next = MAN_NEXT_CHILD;
1.21      schwarze  675:                }
                    676:        }
                    677:
1.69      schwarze  678:        if (man && man->first == n)
                    679:                man->first = NULL;
1.62      schwarze  680: }
                    681:
                    682: const struct mparse *
1.69      schwarze  683: man_mparse(const struct man *man)
1.62      schwarze  684: {
                    685:
1.69      schwarze  686:        assert(man && man->parse);
                    687:        return(man->parse);
1.4       schwarze  688: }