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