[BACK]Return to mdoc_macro.c CVS log [TXT][DIR] Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/mdoc_macro.c between version 1.132 and 1.205

version 1.132, 2014/07/02 03:48:07 version 1.205, 2015/10/17 00:21:07
Line 1 
Line 1 
 /*      $Id$ */  /*      $Id$ */
 /*  /*
  * Copyright (c) 2008-2012 Kristaps Dzonsons <kristaps@bsd.lv>   * Copyright (c) 2008-2012 Kristaps Dzonsons <kristaps@bsd.lv>
  * Copyright (c) 2010, 2012, 2013 Ingo Schwarze <schwarze@openbsd.org>   * Copyright (c) 2010, 2012-2015 Ingo Schwarze <schwarze@openbsd.org>
  *   *
  * Permission to use, copy, modify, and distribute this software for any   * Permission to use, copy, modify, and distribute this software for any
  * purpose with or without fee is hereby granted, provided that the above   * purpose with or without fee is hereby granted, provided that the above
  * copyright notice and this permission notice appear in all copies.   * copyright notice and this permission notice appear in all copies.
  *   *
  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES   * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHORS DISCLAIM ALL WARRANTIES
  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF   * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR   * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR
  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES   * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN   * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF   * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.   * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */   */
 #ifdef HAVE_CONFIG_H  
 #include "config.h"  #include "config.h"
 #endif  
   
   #include <sys/types.h>
   
 #include <assert.h>  #include <assert.h>
 #include <ctype.h>  #include <ctype.h>
 #include <stdlib.h>  #include <stdlib.h>
Line 26 
Line 26 
 #include <string.h>  #include <string.h>
 #include <time.h>  #include <time.h>
   
 #include "mdoc.h"  
 #include "mandoc.h"  #include "mandoc.h"
 #include "libmdoc.h"  #include "roff.h"
   #include "mdoc.h"
 #include "libmandoc.h"  #include "libmandoc.h"
   #include "roff_int.h"
   #include "libmdoc.h"
   
 enum    rew {   /* see rew_dohalt() */  static  void            blk_full(MACRO_PROT_ARGS);
         REWIND_NONE,  static  void            blk_exp_close(MACRO_PROT_ARGS);
         REWIND_THIS,  static  void            blk_part_exp(MACRO_PROT_ARGS);
         REWIND_MORE,  static  void            blk_part_imp(MACRO_PROT_ARGS);
         REWIND_FORCE,  static  void            ctx_synopsis(MACRO_PROT_ARGS);
         REWIND_LATER,  static  void            in_line_eoln(MACRO_PROT_ARGS);
         REWIND_ERROR  static  void            in_line_argn(MACRO_PROT_ARGS);
 };  static  void            in_line(MACRO_PROT_ARGS);
   static  void            phrase_ta(MACRO_PROT_ARGS);
   
 static  int             blk_full(MACRO_PROT_ARGS);  static  void            append_delims(struct roff_man *, int, int *, char *);
 static  int             blk_exp_close(MACRO_PROT_ARGS);  static  void            dword(struct roff_man *, int, int, const char *,
 static  int             blk_part_exp(MACRO_PROT_ARGS);                                  enum mdelim, int);
 static  int             blk_part_imp(MACRO_PROT_ARGS);  static  int             find_pending(struct roff_man *, int, int, int,
 static  int             ctx_synopsis(MACRO_PROT_ARGS);                                  struct roff_node *);
 static  int             in_line_eoln(MACRO_PROT_ARGS);  static  int             lookup(struct roff_man *, int, int, int, const char *);
 static  int             in_line_argn(MACRO_PROT_ARGS);  static  int             macro_or_word(MACRO_PROT_ARGS, int);
 static  int             in_line(MACRO_PROT_ARGS);  static  int             parse_rest(struct roff_man *, int, int, int *, char *);
 static  int             phrase_ta(MACRO_PROT_ARGS);  static  int             rew_alt(int);
   static  void            rew_elem(struct roff_man *, int);
   static  void            rew_last(struct roff_man *, const struct roff_node *);
   static  void            rew_pending(struct roff_man *,
                                   const struct roff_node *);
   
 static  int             dword(struct mdoc *, int, int, const char *,  
                                  enum mdelim, int);  
 static  int             append_delims(struct mdoc *,  
                                 int, int *, char *);  
 static  enum mdoct      lookup(enum mdoct, const char *);  
 static  enum mdoct      lookup_raw(const char *);  
 static  int             make_pending(struct mdoc_node *, enum mdoct,  
                                 struct mdoc *, int, int);  
 static  int             phrase(struct mdoc *, int, int, char *);  
 static  enum mdoct      rew_alt(enum mdoct);  
 static  enum rew        rew_dohalt(enum mdoct, enum mdoc_type,  
                                 const struct mdoc_node *);  
 static  int             rew_elem(struct mdoc *, enum mdoct);  
 static  int             rew_last(struct mdoc *,  
                                 const struct mdoc_node *);  
 static  int             rew_sub(enum mdoc_type, struct mdoc *,  
                                 enum mdoct, int, int);  
   
 const   struct mdoc_macro __mdoc_macros[MDOC_MAX] = {  const   struct mdoc_macro __mdoc_macros[MDOC_MAX] = {
         { in_line_argn, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Ap */          { in_line_argn, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Ap */
         { in_line_eoln, MDOC_PROLOGUE }, /* Dd */          { in_line_eoln, MDOC_PROLOGUE }, /* Dd */
Line 147  const struct mdoc_macro __mdoc_macros[MDOC_MAX] = {
Line 136  const struct mdoc_macro __mdoc_macros[MDOC_MAX] = {
         { blk_part_exp, MDOC_CALLABLE | MDOC_PARSED | MDOC_EXPLICIT }, /* Eo */          { blk_part_exp, MDOC_CALLABLE | MDOC_PARSED | MDOC_EXPLICIT }, /* Eo */
         { in_line_argn, MDOC_CALLABLE | MDOC_PARSED }, /* Fx */          { in_line_argn, MDOC_CALLABLE | MDOC_PARSED }, /* Fx */
         { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Ms */          { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Ms */
           { in_line, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* No */
         { in_line_argn, MDOC_CALLABLE | MDOC_PARSED |          { in_line_argn, MDOC_CALLABLE | MDOC_PARSED |
                         MDOC_IGNDELIM | MDOC_JOIN }, /* No */  
         { in_line_argn, MDOC_CALLABLE | MDOC_PARSED |  
                         MDOC_IGNDELIM | MDOC_JOIN }, /* Ns */                          MDOC_IGNDELIM | MDOC_JOIN }, /* Ns */
         { in_line_argn, MDOC_CALLABLE | MDOC_PARSED }, /* Nx */          { in_line_argn, MDOC_CALLABLE | MDOC_PARSED }, /* Nx */
         { in_line_argn, MDOC_CALLABLE | MDOC_PARSED }, /* Ox */          { in_line_argn, MDOC_CALLABLE | MDOC_PARSED }, /* Ox */
Line 172  const struct mdoc_macro __mdoc_macros[MDOC_MAX] = {
Line 160  const struct mdoc_macro __mdoc_macros[MDOC_MAX] = {
         { blk_part_exp, MDOC_CALLABLE | MDOC_PARSED |          { blk_part_exp, MDOC_CALLABLE | MDOC_PARSED |
                         MDOC_EXPLICIT | MDOC_JOIN }, /* So */                          MDOC_EXPLICIT | MDOC_JOIN }, /* So */
         { blk_part_imp, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Sq */          { blk_part_imp, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Sq */
         { in_line_eoln, 0 }, /* Sm */          { in_line_argn, 0 }, /* Sm */
         { in_line, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Sx */          { in_line, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Sx */
         { in_line, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Sy */          { in_line, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Sy */
         { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Tn */          { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Tn */
Line 210  const struct mdoc_macro __mdoc_macros[MDOC_MAX] = {
Line 198  const struct mdoc_macro __mdoc_macros[MDOC_MAX] = {
         { in_line_eoln, 0 }, /* sp */          { in_line_eoln, 0 }, /* sp */
         { in_line_eoln, 0 }, /* %U */          { in_line_eoln, 0 }, /* %U */
         { phrase_ta, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Ta */          { phrase_ta, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Ta */
         { in_line_eoln, 0 }, /* ll */          { in_line_eoln, MDOC_PROLOGUE }, /* ll */
 };  };
   
 const   struct mdoc_macro * const mdoc_macros = __mdoc_macros;  const   struct mdoc_macro * const mdoc_macros = __mdoc_macros;
Line 221  const struct mdoc_macro * const mdoc_macros = __mdoc_m
Line 209  const struct mdoc_macro * const mdoc_macros = __mdoc_m
  * closing out open [implicit] scopes.  Obviously, open explicit scopes   * closing out open [implicit] scopes.  Obviously, open explicit scopes
  * are errors.   * are errors.
  */   */
 int  void
 mdoc_macroend(struct mdoc *mdoc)  mdoc_endparse(struct roff_man *mdoc)
 {  {
         struct mdoc_node *n;          struct roff_node *n;
   
         /* Scan for open explicit scopes. */          /* Scan for open explicit scopes. */
   
         n = MDOC_VALID & mdoc->last->flags ?          n = mdoc->last->flags & MDOC_VALID ?
             mdoc->last->parent : mdoc->last;              mdoc->last->parent : mdoc->last;
   
         for ( ; n; n = n->parent)          for ( ; n; n = n->parent)
                 if (MDOC_BLOCK == n->type &&                  if (n->type == ROFFT_BLOCK &&
                     MDOC_EXPLICIT & mdoc_macros[n->tok].flags)                      mdoc_macros[n->tok].flags & MDOC_EXPLICIT)
                         mdoc_nmsg(mdoc, n, MANDOCERR_SCOPEEXIT);                          mandoc_msg(MANDOCERR_BLK_NOEND, mdoc->parse,
                               n->line, n->pos, mdoc_macronames[n->tok]);
   
         /* Rewind to the first. */          /* Rewind to the first. */
   
         return(rew_last(mdoc, mdoc->first));          rew_last(mdoc, mdoc->first);
 }  }
   
 /*  /*
  * Look up a macro from within a subsequent context.   * Look up the macro at *p called by "from",
    * or as a line macro if from == TOKEN_NONE.
  */   */
 static enum mdoct  static int
 lookup(enum mdoct from, const char *p)  lookup(struct roff_man *mdoc, int from, int line, int ppos, const char *p)
 {  {
           int      res;
   
         if ( ! (MDOC_PARSED & mdoc_macros[from].flags))          if (mdoc->flags & MDOC_PHRASEQF) {
                 return(MDOC_MAX);                  mdoc->flags &= ~MDOC_PHRASEQF;
         return(lookup_raw(p));                  return TOKEN_NONE;
           }
           if (from == TOKEN_NONE || mdoc_macros[from].flags & MDOC_PARSED) {
                   res = mdoc_hash_find(p);
                   if (res != TOKEN_NONE) {
                           if (mdoc_macros[res].flags & MDOC_CALLABLE)
                                   return res;
                           if (res != MDOC_br && res != MDOC_sp && res != MDOC_ll)
                                   mandoc_msg(MANDOCERR_MACRO_CALL,
                                       mdoc->parse, line, ppos, p);
                   }
           }
           return TOKEN_NONE;
 }  }
   
 /*  /*
  * Lookup a macro following the initial line macro.   * Rewind up to and including a specific node.
  */   */
 static enum mdoct  static void
 lookup_raw(const char *p)  rew_last(struct roff_man *mdoc, const struct roff_node *to)
 {  {
         enum mdoct       res;          struct roff_node        *np;
   
         if (MDOC_MAX == (res = mdoc_hash_find(p)))          if (to->flags & MDOC_VALID)
                 return(MDOC_MAX);                  return;
         if (MDOC_CALLABLE & mdoc_macros[res].flags)  
                 return(res);  
         return(MDOC_MAX);  
 }  
   
 static int  
 rew_last(struct mdoc *mdoc, const struct mdoc_node *to)  
 {  
         struct mdoc_node *n, *np;  
   
         assert(to);  
         mdoc->next = MDOC_NEXT_SIBLING;  
   
   
         while (mdoc->last != to) {          while (mdoc->last != to) {
                 /*                  /*
                  * Save the parent here, because we may delete the                   * Save the parent here, because we may delete the
Line 285  rew_last(struct mdoc *mdoc, const struct mdoc_node *to
Line 275  rew_last(struct mdoc *mdoc, const struct mdoc_node *to
                  * out to be lost.                   * out to be lost.
                  */                   */
                 np = mdoc->last->parent;                  np = mdoc->last->parent;
                 if ( ! mdoc_valid_post(mdoc))                  mdoc_valid_post(mdoc);
                         return(0);  
                 n = mdoc->last;  
                 mdoc->last = np;                  mdoc->last = np;
                 assert(mdoc->last);                  assert(mdoc->last);
                 mdoc->last->last = n;  
         }          }
           mdoc->next = ROFF_NEXT_SIBLING;
           mdoc_valid_post(mdoc);
   }
   
         return(mdoc_valid_post(mdoc));  /*
    * Rewind up to a specific block, including all blocks that broke it.
    */
   static void
   rew_pending(struct roff_man *mdoc, const struct roff_node *n)
   {
   
           for (;;) {
                   rew_last(mdoc, n);
   
                   if (mdoc->last == n) {
                           switch (n->type) {
                           case ROFFT_HEAD:
                                   roff_body_alloc(mdoc, n->line, n->pos,
                                       n->tok);
                                   return;
                           case ROFFT_BLOCK:
                                   break;
                           default:
                                   return;
                           }
                           if ( ! (n->flags & MDOC_BROKEN))
                                   return;
                   } else
                           n = mdoc->last;
   
                   for (;;) {
                           if ((n = n->parent) == NULL)
                                   return;
   
                           if (n->type == ROFFT_BLOCK ||
                               n->type == ROFFT_HEAD) {
                                   if (n->flags & MDOC_ENDED)
                                           break;
                                   else
                                           return;
                           }
                   }
           }
 }  }
   
 /*  /*
  * For a block closing macro, return the corresponding opening one.   * For a block closing macro, return the corresponding opening one.
  * Otherwise, return the macro itself.   * Otherwise, return the macro itself.
  */   */
 static enum mdoct  static int
 rew_alt(enum mdoct tok)  rew_alt(int tok)
 {  {
         switch (tok) {          switch (tok) {
         case MDOC_Ac:          case MDOC_Ac:
                 return(MDOC_Ao);                  return MDOC_Ao;
         case MDOC_Bc:          case MDOC_Bc:
                 return(MDOC_Bo);                  return MDOC_Bo;
         case MDOC_Brc:          case MDOC_Brc:
                 return(MDOC_Bro);                  return MDOC_Bro;
         case MDOC_Dc:          case MDOC_Dc:
                 return(MDOC_Do);                  return MDOC_Do;
         case MDOC_Ec:          case MDOC_Ec:
                 return(MDOC_Eo);                  return MDOC_Eo;
         case MDOC_Ed:          case MDOC_Ed:
                 return(MDOC_Bd);                  return MDOC_Bd;
         case MDOC_Ef:          case MDOC_Ef:
                 return(MDOC_Bf);                  return MDOC_Bf;
         case MDOC_Ek:          case MDOC_Ek:
                 return(MDOC_Bk);                  return MDOC_Bk;
         case MDOC_El:          case MDOC_El:
                 return(MDOC_Bl);                  return MDOC_Bl;
         case MDOC_Fc:          case MDOC_Fc:
                 return(MDOC_Fo);                  return MDOC_Fo;
         case MDOC_Oc:          case MDOC_Oc:
                 return(MDOC_Oo);                  return MDOC_Oo;
         case MDOC_Pc:          case MDOC_Pc:
                 return(MDOC_Po);                  return MDOC_Po;
         case MDOC_Qc:          case MDOC_Qc:
                 return(MDOC_Qo);                  return MDOC_Qo;
         case MDOC_Re:          case MDOC_Re:
                 return(MDOC_Rs);                  return MDOC_Rs;
         case MDOC_Sc:          case MDOC_Sc:
                 return(MDOC_So);                  return MDOC_So;
         case MDOC_Xc:          case MDOC_Xc:
                 return(MDOC_Xo);                  return MDOC_Xo;
         default:          default:
                 return(tok);                  return tok;
         }          }
         /* NOTREACHED */  
 }  }
   
 /*  static void
  * Rewinding to tok, how do we have to handle *p?  rew_elem(struct roff_man *mdoc, int tok)
  * REWIND_NONE: *p would delimit tok, but no tok scope is open  
  *   inside *p, so there is no need to rewind anything at all.  
  * REWIND_THIS: *p matches tok, so rewind *p and nothing else.  
  * REWIND_MORE: *p is implicit, rewind it and keep searching for tok.  
  * REWIND_FORCE: *p is explicit, but tok is full, force rewinding *p.  
  * REWIND_LATER: *p is explicit and still open, postpone rewinding.  
  * REWIND_ERROR: No tok block is open at all.  
  */  
 static enum rew  
 rew_dohalt(enum mdoct tok, enum mdoc_type type,  
                 const struct mdoc_node *p)  
 {  {
           struct roff_node *n;
   
         /*  
          * No matching token, no delimiting block, no broken block.  
          * This can happen when full implicit macros are called for  
          * the first time but try to rewind their previous  
          * instance anyway.  
          */  
         if (MDOC_ROOT == p->type)  
                 return(MDOC_BLOCK == type &&  
                     MDOC_EXPLICIT & mdoc_macros[tok].flags ?  
                     REWIND_ERROR : REWIND_NONE);  
   
         /*  
          * When starting to rewind, skip plain text  
          * and nodes that have already been rewound.  
          */  
         if (MDOC_TEXT == p->type || MDOC_VALID & p->flags)  
                 return(REWIND_MORE);  
   
         /*  
          * The easiest case:  Found a matching token.  
          * This applies to both blocks and elements.  
          */  
         tok = rew_alt(tok);  
         if (tok == p->tok)  
                 return(p->end ? REWIND_NONE :  
                     type == p->type ? REWIND_THIS : REWIND_MORE);  
   
         /*  
          * While elements do require rewinding for themselves,  
          * they never affect rewinding of other nodes.  
          */  
         if (MDOC_ELEM == p->type)  
                 return(REWIND_MORE);  
   
         /*  
          * Blocks delimited by our target token get REWIND_MORE.  
          * Blocks delimiting our target token get REWIND_NONE.  
          */  
         switch (tok) {  
         case MDOC_Bl:  
                 if (MDOC_It == p->tok)  
                         return(REWIND_MORE);  
                 break;  
         case MDOC_It:  
                 if (MDOC_BODY == p->type && MDOC_Bl == p->tok)  
                         return(REWIND_NONE);  
                 break;  
         /*  
          * XXX Badly nested block handling still fails badly  
          * when one block is breaking two blocks of the same type.  
          * This is an incomplete and extremely ugly workaround,  
          * required to let the OpenBSD tree build.  
          */  
         case MDOC_Oo:  
                 if (MDOC_Op == p->tok)  
                         return(REWIND_MORE);  
                 break;  
         case MDOC_Nm:  
                 return(REWIND_NONE);  
         case MDOC_Nd:  
                 /* FALLTHROUGH */  
         case MDOC_Ss:  
                 if (MDOC_BODY == p->type && MDOC_Sh == p->tok)  
                         return(REWIND_NONE);  
                 /* FALLTHROUGH */  
         case MDOC_Sh:  
                 if (MDOC_Nd == p->tok || MDOC_Ss == p->tok ||  
                     MDOC_Sh == p->tok)  
                         return(REWIND_MORE);  
                 break;  
         default:  
                 break;  
         }  
   
         /*  
          * Default block rewinding rules.  
          * In particular, always skip block end markers,  
          * and let all blocks rewind Nm children.  
          */  
         if (ENDBODY_NOT != p->end || MDOC_Nm == p->tok ||  
             (MDOC_BLOCK == p->type &&  
             ! (MDOC_EXPLICIT & mdoc_macros[tok].flags)))  
                 return(REWIND_MORE);  
   
         /*  
          * By default, closing out full blocks  
          * forces closing of broken explicit blocks,  
          * while closing out partial blocks  
          * allows delayed rewinding by default.  
          */  
         return (&blk_full == mdoc_macros[tok].fp ?  
             REWIND_FORCE : REWIND_LATER);  
 }  
   
 static int  
 rew_elem(struct mdoc *mdoc, enum mdoct tok)  
 {  
         struct mdoc_node *n;  
   
         n = mdoc->last;          n = mdoc->last;
         if (MDOC_ELEM != n->type)          if (n->type != ROFFT_ELEM)
                 n = n->parent;                  n = n->parent;
         assert(MDOC_ELEM == n->type);          assert(n->type == ROFFT_ELEM);
         assert(tok == n->tok);          assert(tok == n->tok);
           rew_last(mdoc, n);
         return(rew_last(mdoc, n));  
 }  }
   
 /*  /*
  * We are trying to close a block identified by tok,   * If there is an open sub-block of the target requiring
  * but the child block *broken is still open.   * explicit close-out, postpone closing out the target until
  * Thus, postpone closing the tok block   * the rew_pending() call closing out the sub-block.
  * until the rew_sub call closing *broken.  
  */   */
 static int  static int
 make_pending(struct mdoc_node *broken, enum mdoct tok,  find_pending(struct roff_man *mdoc, int tok, int line, int ppos,
                 struct mdoc *mdoc, int line, int ppos)          struct roff_node *target)
 {  {
         struct mdoc_node *breaker;          struct roff_node        *n;
           int                      irc;
   
         /*          irc = 0;
          * Iterate backwards, searching for the block matching tok,          for (n = mdoc->last; n != NULL && n != target; n = n->parent) {
          * that is, the block breaking the *broken block.                  if (n->flags & MDOC_ENDED) {
          */                          if ( ! (n->flags & MDOC_VALID))
         for (breaker = broken->parent; breaker; breaker = breaker->parent) {                                  n->flags |= MDOC_BROKEN;
   
                 /*  
                  * If the *broken block had already been broken before  
                  * and we encounter its breaker, make the tok block  
                  * pending on the inner breaker.  
                  * Graphically, "[A breaker=[B broken=[C->B B] tok=A] C]"  
                  * becomes "[A broken=[B [C->B B] tok=A] C]"  
                  * and finally "[A [B->A [C->B B] A] C]".  
                  */  
                 if (breaker == broken->pending) {  
                         broken = breaker;  
                         continue;                          continue;
                 }                  }
                   if (n->type == ROFFT_BLOCK &&
                 if (REWIND_THIS != rew_dohalt(tok, MDOC_BLOCK, breaker))                      mdoc_macros[n->tok].flags & MDOC_EXPLICIT) {
                         continue;                          irc = 1;
                 if (MDOC_BODY == broken->type)                          n->flags = MDOC_BROKEN;
                         broken = broken->parent;                          if (target->type == ROFFT_HEAD)
                                   target->flags = MDOC_ENDED;
                 /*                          else if ( ! (target->flags & MDOC_ENDED)) {
                  * Found the breaker.                                  mandoc_vmsg(MANDOCERR_BLK_NEST,
                  * If another, outer breaker is already pending on                                      mdoc->parse, line, ppos,
                  * the *broken block, we must not clobber the link                                      "%s breaks %s", mdoc_macronames[tok],
                  * to the outer breaker, but make it pending on the                                      mdoc_macronames[n->tok]);
                  * new, now inner breaker.                                  mdoc_endbody_alloc(mdoc, line, ppos,
                  * Graphically, "[A breaker=[B broken=[C->A A] tok=B] C]"                                      tok, target, ENDBODY_NOSPACE);
                  * becomes "[A breaker=[B->A broken=[C A] tok=B] C]"                          }
                  * and finally "[A [B->A [C->B A] B] C]".  
                  */  
                 if (broken->pending) {  
                         struct mdoc_node *taker;  
   
                         /*  
                          * If the breaker had also been broken before,  
                          * it cannot take on the outer breaker itself,  
                          * but must hand it on to its own breakers.  
                          * Graphically, this is the following situation:  
                          * "[A [B breaker=[C->B B] broken=[D->A A] tok=C] D]"  
                          * "[A taker=[B->A breaker=[C->B B] [D->C A] C] D]"  
                          */  
                         taker = breaker;  
                         while (taker->pending)  
                                 taker = taker->pending;  
                         taker->pending = broken->pending;  
                 }                  }
                 broken->pending = breaker;  
                 mandoc_vmsg(MANDOCERR_SCOPENEST, mdoc->parse, line, ppos,  
                     "%s breaks %s", mdoc_macronames[tok],  
                     mdoc_macronames[broken->tok]);  
                 return(1);  
         }          }
           return irc;
         /*  
          * Found no matching block for tok.  
          * Are you trying to close a block that is not open?  
          */  
         return(0);  
 }  }
   
 static int  
 rew_sub(enum mdoc_type t, struct mdoc *mdoc,  
                 enum mdoct tok, int line, int ppos)  
 {  
         struct mdoc_node *n;  
   
         n = mdoc->last;  
         while (n) {  
                 switch (rew_dohalt(tok, t, n)) {  
                 case REWIND_NONE:  
                         return(1);  
                 case REWIND_THIS:  
                         n->lastline = line -  
                             (MDOC_NEWLINE & mdoc->flags &&  
                              ! (MDOC_EXPLICIT & mdoc_macros[tok].flags));  
                         break;  
                 case REWIND_FORCE:  
                         mandoc_vmsg(MANDOCERR_SCOPEBROKEN, mdoc->parse,  
                             line, ppos, "%s breaks %s",  
                             mdoc_macronames[tok],  
                             mdoc_macronames[n->tok]);  
                         /* FALLTHROUGH */  
                 case REWIND_MORE:  
                         n->lastline = line -  
                             (MDOC_NEWLINE & mdoc->flags ? 1 : 0);  
                         n = n->parent;  
                         continue;  
                 case REWIND_LATER:  
                         if (make_pending(n, tok, mdoc, line, ppos) ||  
                             MDOC_BLOCK != t)  
                                 return(1);  
                         /* FALLTHROUGH */  
                 case REWIND_ERROR:  
                         mdoc_pmsg(mdoc, line, ppos, MANDOCERR_NOSCOPE);  
                         return(1);  
                 }  
                 break;  
         }  
   
         assert(n);  
         if ( ! rew_last(mdoc, n))  
                 return(0);  
   
         /*  
          * The current block extends an enclosing block.  
          * Now that the current block ends, close the enclosing block, too.  
          */  
         while (NULL != (n = n->pending)) {  
                 if ( ! rew_last(mdoc, n))  
                         return(0);  
                 if (MDOC_HEAD == n->type &&  
                     ! mdoc_body_alloc(mdoc, n->line, n->pos, n->tok))  
                         return(0);  
         }  
   
         return(1);  
 }  
   
 /*  /*
  * Allocate a word and check whether it's punctuation or not.   * Allocate a word and check whether it's punctuation or not.
  * Punctuation consists of those tokens found in mdoc_isdelim().   * Punctuation consists of those tokens found in mdoc_isdelim().
  */   */
 static int  static void
 dword(struct mdoc *mdoc, int line, int col, const char *p,  dword(struct roff_man *mdoc, int line, int col, const char *p,
                 enum mdelim d, int may_append)                  enum mdelim d, int may_append)
 {  {
   
         if (DELIM_MAX == d)          if (d == DELIM_MAX)
                 d = mdoc_isdelim(p);                  d = mdoc_isdelim(p);
   
         if (may_append &&          if (may_append &&
             ! ((MDOC_SYNOPSIS | MDOC_KEEP | MDOC_SMOFF) & mdoc->flags) &&              ! (mdoc->flags & (MDOC_SYNOPSIS | MDOC_KEEP | MDOC_SMOFF)) &&
             DELIM_NONE == d && MDOC_TEXT == mdoc->last->type &&              d == DELIM_NONE && mdoc->last->type == ROFFT_TEXT &&
             DELIM_NONE == mdoc_isdelim(mdoc->last->string)) {              mdoc_isdelim(mdoc->last->string) == DELIM_NONE) {
                 mdoc_word_append(mdoc, p);                  roff_word_append(mdoc, p);
                 return(1);                  return;
         }          }
   
         if ( ! mdoc_word_alloc(mdoc, line, col, p))          roff_word_alloc(mdoc, line, col, p);
                 return(0);  
   
         if (DELIM_OPEN == d)  
                 mdoc->last->flags |= MDOC_DELIMO;  
   
         /*          /*
          * Closing delimiters only suppress the preceding space           * If the word consists of a bare delimiter,
          * when they follow something, not when they start a new           * flag the new node accordingly,
          * block or element, and not when they follow `No'.           * unless doing so was vetoed by the invoking macro.
          *           * Always clear the veto, it is only valid for one word.
          * XXX  Explicitly special-casing MDOC_No here feels  
          *      like a layering violation.  Find a better way  
          *      and solve this in the code related to `No'!  
          */           */
   
         else if (DELIM_CLOSE == d && mdoc->last->prev &&          if (d == DELIM_OPEN)
             mdoc->last->prev->tok != MDOC_No &&                  mdoc->last->flags |= MDOC_DELIMO;
           else if (d == DELIM_CLOSE &&
               ! (mdoc->flags & MDOC_NODELIMC) &&
             mdoc->last->parent->tok != MDOC_Fd)              mdoc->last->parent->tok != MDOC_Fd)
                 mdoc->last->flags |= MDOC_DELIMC;                  mdoc->last->flags |= MDOC_DELIMC;
           mdoc->flags &= ~MDOC_NODELIMC;
         return(1);  
 }  }
   
 static int  static void
 append_delims(struct mdoc *mdoc, int line, int *pos, char *buf)  append_delims(struct roff_man *mdoc, int line, int *pos, char *buf)
 {  {
         int              la;  
         enum margserr    ac;  
         char            *p;          char            *p;
           int              la;
   
         if ('\0' == buf[*pos])          if (buf[*pos] == '\0')
                 return(1);                  return;
   
         for (;;) {          for (;;) {
                 la = *pos;                  la = *pos;
                 ac = mdoc_zargs(mdoc, line, pos, buf, &p);                  if (mdoc_args(mdoc, line, pos, buf, TOKEN_NONE, &p) ==
                       ARGS_EOLN)
                 if (ARGS_ERROR == ac)  
                         return(0);  
                 else if (ARGS_EOLN == ac)  
                         break;                          break;
   
                 dword(mdoc, line, la, p, DELIM_MAX, 1);                  dword(mdoc, line, la, p, DELIM_MAX, 1);
   
                 /*                  /*
Line 675  append_delims(struct mdoc *mdoc, int line, int *pos, c
Line 485  append_delims(struct mdoc *mdoc, int line, int *pos, c
                  * knowing which symbols break this behaviour, for                   * knowing which symbols break this behaviour, for
                  * example, `.  ;' shouldn't propagate the double-space.                   * example, `.  ;' shouldn't propagate the double-space.
                  */                   */
   
                 if (mandoc_eos(p, strlen(p)))                  if (mandoc_eos(p, strlen(p)))
                         mdoc->last->flags |= MDOC_EOS;                          mdoc->last->flags |= MDOC_EOS;
         }          }
   }
   
         return(1);  /*
    * Parse one word.
    * If it is a macro, call it and return 1.
    * Otherwise, allocate it and return 0.
    */
   static int
   macro_or_word(MACRO_PROT_ARGS, int parsed)
   {
           char            *p;
           int              ntok;
   
           p = buf + ppos;
           ntok = TOKEN_NONE;
           if (*p == '"')
                   p++;
           else if (parsed && ! (mdoc->flags & MDOC_PHRASELIT))
                   ntok = lookup(mdoc, tok, line, ppos, p);
   
           if (ntok == TOKEN_NONE) {
                   dword(mdoc, line, ppos, p, DELIM_MAX, tok == TOKEN_NONE ||
                       mdoc_macros[tok].flags & MDOC_JOIN);
                   return 0;
           } else {
                   if (mdoc_macros[tok].fp == in_line_eoln)
                           rew_elem(mdoc, tok);
                   mdoc_macro(mdoc, ntok, line, ppos, pos, buf);
                   if (tok == TOKEN_NONE)
                           append_delims(mdoc, line, pos, buf);
                   return 1;
           }
 }  }
   
 /*  /*
  * Close out block partial/full explicit.   * Close out block partial/full explicit.
  */   */
 static int  static void
 blk_exp_close(MACRO_PROT_ARGS)  blk_exp_close(MACRO_PROT_ARGS)
 {  {
         struct mdoc_node *body;         /* Our own body. */          struct roff_node *body;         /* Our own body. */
         struct mdoc_node *later;        /* A sub-block starting later. */          struct roff_node *endbody;      /* Our own end marker. */
         struct mdoc_node *n;            /* For searching backwards. */          struct roff_node *itblk;        /* An It block starting later. */
           struct roff_node *later;        /* A sub-block starting later. */
           struct roff_node *n;            /* Search back to our block. */
           struct roff_node *target;       /* For find_pending(). */
   
         int              j, lastarg, maxargs, flushed, nl;          int              j, lastarg, maxargs, nl, pending;
         enum margserr    ac;          enum margserr    ac;
         enum mdoct       atok, ntok;          int              atok, ntok;
         char            *p;          char            *p;
   
         nl = MDOC_NEWLINE & mdoc->flags;          nl = MDOC_NEWLINE & mdoc->flags;
Line 705  blk_exp_close(MACRO_PROT_ARGS)
Line 549  blk_exp_close(MACRO_PROT_ARGS)
                 break;                  break;
         case MDOC_Ek:          case MDOC_Ek:
                 mdoc->flags &= ~MDOC_KEEP;                  mdoc->flags &= ~MDOC_KEEP;
                   /* FALLTHROUGH */
         default:          default:
                 maxargs = 0;                  maxargs = 0;
                 break;                  break;
Line 714  blk_exp_close(MACRO_PROT_ARGS)
Line 559  blk_exp_close(MACRO_PROT_ARGS)
          * Search backwards for beginnings of blocks,           * Search backwards for beginnings of blocks,
          * both of our own and of pending sub-blocks.           * both of our own and of pending sub-blocks.
          */           */
   
         atok = rew_alt(tok);          atok = rew_alt(tok);
         body = later = NULL;          body = endbody = itblk = later = NULL;
         for (n = mdoc->last; n; n = n->parent) {          for (n = mdoc->last; n; n = n->parent) {
                 if (MDOC_VALID & n->flags)                  if (n->flags & MDOC_ENDED) {
                           if ( ! (n->flags & MDOC_VALID))
                                   n->flags |= MDOC_BROKEN;
                         continue;                          continue;
                   }
   
                 /* Remember the start of our own body. */                  /* Remember the start of our own body. */
                 if (MDOC_BODY == n->type && atok == n->tok) {  
                         if (ENDBODY_NOT == n->end)                  if (n->type == ROFFT_BODY && atok == n->tok) {
                           if (n->end == ENDBODY_NOT)
                                 body = n;                                  body = n;
                         continue;                          continue;
                 }                  }
   
                 if (MDOC_BLOCK != n->type || MDOC_Nm == n->tok)                  if (n->type != ROFFT_BLOCK || n->tok == MDOC_Nm)
                         continue;                          continue;
   
                   if (n->tok == MDOC_It) {
                           itblk = n;
                           continue;
                   }
   
                 if (atok == n->tok) {                  if (atok == n->tok) {
                         assert(body);                          assert(body);
   
Line 737  blk_exp_close(MACRO_PROT_ARGS)
Line 593  blk_exp_close(MACRO_PROT_ARGS)
                          * When there is no pending sub block,                           * When there is no pending sub block,
                          * just proceed to closing out.                           * just proceed to closing out.
                          */                           */
                         if (NULL == later)  
                           if (later == NULL ||
                               (tok == MDOC_El && itblk == NULL))
                                 break;                                  break;
   
                         /*                          /*
                          * When there is a pending sub block,                           * When there is a pending sub block, postpone
                          * postpone closing out the current block                           * closing out the current block until the
                          * until the rew_sub() closing out the sub-block.                           * rew_pending() closing out the sub-block.
                            * Mark the place where the formatting - but not
                            * the scope - of the current block ends.
                          */                           */
                         make_pending(later, tok, mdoc, line, ppos);  
   
                           mandoc_vmsg(MANDOCERR_BLK_NEST, mdoc->parse,
                               line, ppos, "%s breaks %s",
                               mdoc_macronames[atok],
                               mdoc_macronames[later->tok]);
   
                           endbody = mdoc_endbody_alloc(mdoc, line, ppos,
                               atok, body, ENDBODY_SPACE);
   
                           if (tok == MDOC_El)
                                   itblk->flags |= MDOC_ENDED | MDOC_BROKEN;
   
                         /*                          /*
                          * Mark the place where the formatting - but not                           * If a block closing macro taking arguments
                          * the scope - of the current block ends.                           * breaks another block, put the arguments
                            * into the end marker.
                          */                           */
                         if ( ! mdoc_endbody_alloc(mdoc, line, ppos,  
                             atok, body, ENDBODY_SPACE))                          if (maxargs)
                                 return(0);                                  mdoc->next = ROFF_NEXT_CHILD;
                         break;                          break;
                 }                  }
   
                 /*                  /* Explicit blocks close out description lines. */
                  * When finding an open sub block, remember the last  
                  * open explicit block, or, in case there are only                  if (n->tok == MDOC_Nd) {
                  * implicit ones, the first open implicit block.                          rew_last(mdoc, n);
                  */  
                 if (later &&  
                     MDOC_EXPLICIT & mdoc_macros[later->tok].flags)  
                         continue;                          continue;
                 if (MDOC_It != n->tok)                  }
   
                   /* Breaking an open sub block. */
   
                   n->flags |= MDOC_BROKEN;
                   if (later == NULL)
                         later = n;                          later = n;
         }          }
   
         if ( ! (MDOC_CALLABLE & mdoc_macros[tok].flags)) {          if (body == NULL) {
                 /* FIXME: do this in validate */                  mandoc_msg(MANDOCERR_BLK_NOTOPEN, mdoc->parse,
                 if (buf[*pos])                      line, ppos, mdoc_macronames[tok]);
                         mdoc_pmsg(mdoc, line, ppos, MANDOCERR_ARGSLOST);                  if (later != NULL)
                           later->flags &= ~MDOC_BROKEN;
                   if (maxargs && endbody == NULL) {
                           /*
                            * Stray .Ec without previous .Eo:
                            * Break the output line, keep the arguments.
                            */
                           roff_elem_alloc(mdoc, line, ppos, MDOC_br);
                           rew_elem(mdoc, MDOC_br);
                   }
           } else if (endbody == NULL) {
                   rew_last(mdoc, body);
                   if (maxargs)
                           mdoc_tail_alloc(mdoc, line, ppos, atok);
           }
   
                 if ( ! rew_sub(MDOC_BODY, mdoc, tok, line, ppos))          if ( ! (mdoc_macros[tok].flags & MDOC_PARSED)) {
                         return(0);                  if (buf[*pos] != '\0')
                 return(rew_sub(MDOC_BLOCK, mdoc, tok, line, ppos));                          mandoc_vmsg(MANDOCERR_ARG_SKIP,
                               mdoc->parse, line, ppos,
                               "%s %s", mdoc_macronames[tok],
                               buf + *pos);
                   if (endbody == NULL && n != NULL)
                           rew_pending(mdoc, n);
                   return;
         }          }
   
         if ( ! rew_sub(MDOC_BODY, mdoc, tok, line, ppos))          if (endbody != NULL)
                 return(0);                  n = endbody;
   
         if (NULL == later && maxargs > 0)          ntok = TOKEN_NONE;
                 if ( ! mdoc_tail_alloc(mdoc, line, ppos, rew_alt(tok)))          for (j = 0; ; j++) {
                         return(0);  
   
         for (flushed = j = 0; ; j++) {  
                 lastarg = *pos;                  lastarg = *pos;
   
                 if (j == maxargs && ! flushed) {                  if (j == maxargs && n != NULL)
                         if ( ! rew_sub(MDOC_BLOCK, mdoc, tok, line, ppos))                          rew_last(mdoc, n);
                                 return(0);  
                         flushed = 1;  
                 }  
   
                 ac = mdoc_args(mdoc, line, pos, buf, tok, &p);                  ac = mdoc_args(mdoc, line, pos, buf, tok, &p);
                   if (ac == ARGS_PUNCT || ac == ARGS_EOLN)
                 if (ARGS_ERROR == ac)  
                         return(0);  
                 if (ARGS_PUNCT == ac)  
                         break;                          break;
                 if (ARGS_EOLN == ac)  
                         break;  
   
                 ntok = ARGS_QWORD == ac ? MDOC_MAX : lookup(tok, p);                  ntok = ac == ARGS_QWORD ? TOKEN_NONE :
                       lookup(mdoc, tok, line, lastarg, p);
   
                 if (MDOC_MAX == ntok) {                  if (ntok == TOKEN_NONE) {
                         if ( ! dword(mdoc, line, lastarg, p, DELIM_MAX,                          dword(mdoc, line, lastarg, p, DELIM_MAX,
                             MDOC_JOIN & mdoc_macros[tok].flags))                              MDOC_JOIN & mdoc_macros[tok].flags);
                                 return(0);  
                         continue;                          continue;
                 }                  }
   
                 if ( ! flushed) {                  if (n != NULL)
                         if ( ! rew_sub(MDOC_BLOCK, mdoc, tok, line, ppos))                          rew_last(mdoc, n);
                                 return(0);  
                         flushed = 1;  
                 }  
   
                 mdoc->flags &= ~MDOC_NEWLINE;                  mdoc->flags &= ~MDOC_NEWLINE;
                   mdoc_macro(mdoc, ntok, line, lastarg, pos, buf);
                 if ( ! mdoc_macro(mdoc, ntok, line, lastarg, pos, buf))  
                         return(0);  
                 break;                  break;
         }          }
   
         if ( ! flushed && ! rew_sub(MDOC_BLOCK, mdoc, tok, line, ppos))          if (n != NULL) {
                 return(0);                  if (ntok != TOKEN_NONE && n->flags & MDOC_BROKEN) {
                           target = n;
         if ( ! nl)                          do
                 return(1);                                  target = target->parent;
         return(append_delims(mdoc, line, pos, buf));                          while ( ! (target->flags & MDOC_ENDED));
                           pending = find_pending(mdoc, ntok, line, ppos,
                               target);
                   } else
                           pending = 0;
                   if ( ! pending)
                           rew_pending(mdoc, n);
           }
           if (nl)
                   append_delims(mdoc, line, pos, buf);
 }  }
   
 static int  static void
 in_line(MACRO_PROT_ARGS)  in_line(MACRO_PROT_ARGS)
 {  {
         int              la, scope, cnt, nc, nl;          int              la, scope, cnt, firstarg, mayopen, nc, nl;
         enum margverr    av;          int              ntok;
         enum mdoct       ntok;  
         enum margserr    ac;          enum margserr    ac;
         enum mdelim      d;          enum mdelim      d;
         struct mdoc_arg *arg;          struct mdoc_arg *arg;
Line 854  in_line(MACRO_PROT_ARGS)
Line 738  in_line(MACRO_PROT_ARGS)
   
         switch (tok) {          switch (tok) {
         case MDOC_An:          case MDOC_An:
                 /* FALLTHROUGH */  
         case MDOC_Ar:          case MDOC_Ar:
                 /* FALLTHROUGH */  
         case MDOC_Fl:          case MDOC_Fl:
                 /* FALLTHROUGH */  
         case MDOC_Mt:          case MDOC_Mt:
                 /* FALLTHROUGH */  
         case MDOC_Nm:          case MDOC_Nm:
                 /* FALLTHROUGH */  
         case MDOC_Pa:          case MDOC_Pa:
                 nc = 1;                  nc = 1;
                 break;                  break;
Line 871  in_line(MACRO_PROT_ARGS)
Line 750  in_line(MACRO_PROT_ARGS)
                 break;                  break;
         }          }
   
         for (arg = NULL;; ) {          mdoc_argv(mdoc, line, tok, &arg, pos, buf);
   
           d = DELIM_NONE;
           firstarg = 1;
           mayopen = 1;
           for (cnt = scope = 0;; ) {
                 la = *pos;                  la = *pos;
                 av = mdoc_argv(mdoc, line, tok, &arg, pos, buf);                  ac = mdoc_args(mdoc, line, pos, buf, tok, &p);
   
                 if (ARGV_WORD == av) {                  /*
                         *pos = la;                   * At the end of a macro line,
                    * opening delimiters do not suppress spacing.
                    */
   
                   if (ac == ARGS_EOLN) {
                           if (d == DELIM_OPEN)
                                   mdoc->last->flags &= ~MDOC_DELIMO;
                         break;                          break;
                 }                  }
                 if (ARGV_EOLN == av)  
                         break;  
                 if (ARGV_ARG == av)  
                         continue;  
   
                 mdoc_argv_free(arg);                  /*
                 return(0);                   * The rest of the macro line is only punctuation,
         }                   * to be handled by append_delims().
                    * If there were no other arguments,
                    * do not allow the first one to suppress spacing,
                    * even if it turns out to be a closing one.
                    */
   
         for (cnt = scope = 0;; ) {                  if (ac == ARGS_PUNCT) {
                 la = *pos;                          if (cnt == 0 && (nc == 0 || tok == MDOC_An))
                 ac = mdoc_args(mdoc, line, pos, buf, tok, &p);                                  mdoc->flags |= MDOC_NODELIMC;
   
                 if (ARGS_ERROR == ac)  
                         return(0);  
                 if (ARGS_EOLN == ac)  
                         break;                          break;
                 if (ARGS_PUNCT == ac)                  }
                         break;  
   
                 ntok = ARGS_QWORD == ac ? MDOC_MAX : lookup(tok, p);                  ntok = (ac == ARGS_QWORD || (tok == MDOC_Fn && !cnt)) ?
                       TOKEN_NONE : lookup(mdoc, tok, line, la, p);
   
                 /*                  /*
                  * In this case, we've located a submacro and must                   * In this case, we've located a submacro and must
Line 908  in_line(MACRO_PROT_ARGS)
Line 794  in_line(MACRO_PROT_ARGS)
                  * or raise a warning.                   * or raise a warning.
                  */                   */
   
                 if (MDOC_MAX != ntok) {                  if (ntok != TOKEN_NONE) {
                         if (scope && ! rew_elem(mdoc, tok))                          if (scope)
                                 return(0);                                  rew_elem(mdoc, tok);
                         if (nc && 0 == cnt) {                          if (nc && ! cnt) {
                                 if ( ! mdoc_elem_alloc(mdoc,                                  mdoc_elem_alloc(mdoc, line, ppos, tok, arg);
                                     line, ppos, tok, arg))                                  rew_last(mdoc, mdoc->last);
                                         return(0);                          } else if ( ! nc && ! cnt) {
                                 if ( ! rew_last(mdoc, mdoc->last))  
                                         return(0);  
                         } else if ( ! nc && 0 == cnt) {  
                                 mdoc_argv_free(arg);                                  mdoc_argv_free(arg);
                                 mdoc_pmsg(mdoc, line, ppos,                                  mandoc_msg(MANDOCERR_MACRO_EMPTY,
                                     MANDOCERR_MACROEMPTY);                                      mdoc->parse, line, ppos,
                                       mdoc_macronames[tok]);
                         }                          }
                           mdoc_macro(mdoc, ntok, line, la, pos, buf);
                         if ( ! mdoc_macro(mdoc, ntok, line, la, pos, buf))                          if (nl)
                                 return(0);                                  append_delims(mdoc, line, pos, buf);
                         if ( ! nl)                          return;
                                 return(1);  
                         return(append_delims(mdoc, line, pos, buf));  
                 }                  }
   
                 /*                  /*
Line 936  in_line(MACRO_PROT_ARGS)
Line 818  in_line(MACRO_PROT_ARGS)
                  * the word.                   * the word.
                  */                   */
   
                 d = ARGS_QWORD == ac ? DELIM_NONE : mdoc_isdelim(p);                  d = ac == ARGS_QWORD ? DELIM_NONE : mdoc_isdelim(p);
   
                 if (DELIM_NONE != d) {                  if (DELIM_NONE != d) {
                         /*                          /*
                          * If we encounter closing punctuation, no word                           * If we encounter closing punctuation, no word
                          * has been omitted, no scope is open, and we're                           * has been emitted, no scope is open, and we're
                          * allowed to have an empty element, then start                           * allowed to have an empty element, then start
                          * a new scope.  `Ar', `Fl', and `Li', only do                           * a new scope.
                          * this once per invocation.  There may be more  
                          * of these (all of them?).  
                          */                           */
                         if (0 == cnt && (nc || MDOC_Li == tok) &&                          if ((d == DELIM_CLOSE ||
                             DELIM_CLOSE == d && ! scope) {                               (d == DELIM_MIDDLE && tok == MDOC_Fl)) &&
                                 if ( ! mdoc_elem_alloc(mdoc,                              !cnt && !scope && nc && mayopen) {
                                     line, ppos, tok, arg))                                  mdoc_elem_alloc(mdoc, line, ppos, tok, arg);
                                         return(0);  
                                 if (MDOC_Ar == tok || MDOC_Li == tok ||  
                                     MDOC_Fl == tok)  
                                         cnt++;  
                                 scope = 1;                                  scope = 1;
                                   cnt++;
                                   if (tok == MDOC_Nm)
                                           mayopen = 0;
                         }                          }
                         /*                          /*
                          * Close out our scope, if one is open, before                           * Close out our scope, if one is open, before
                          * any punctuation.                           * any punctuation.
                          */                           */
                         if (scope && ! rew_elem(mdoc, tok))                          if (scope)
                                 return(0);                                  rew_elem(mdoc, tok);
                         scope = 0;                          scope = 0;
                 } else if ( ! scope) {                          if (tok == MDOC_Fn)
                         if ( ! mdoc_elem_alloc(mdoc, line, ppos, tok, arg))                                  mayopen = 0;
                                 return(0);                  } else if (mayopen && !scope) {
                           mdoc_elem_alloc(mdoc, line, ppos, tok, arg);
                         scope = 1;                          scope = 1;
                           cnt++;
                 }                  }
   
                 if (DELIM_NONE == d)                  dword(mdoc, line, la, p, d,
                         cnt++;                      MDOC_JOIN & mdoc_macros[tok].flags);
   
                 if ( ! dword(mdoc, line, la, p, d,                  /*
                     MDOC_JOIN & mdoc_macros[tok].flags))                   * If the first argument is a closing delimiter,
                         return(0);                   * do not suppress spacing before it.
                    */
   
                   if (firstarg && d == DELIM_CLOSE && !nc)
                           mdoc->last->flags &= ~MDOC_DELIMC;
                   firstarg = 0;
   
                 /*                  /*
                  * `Fl' macros have their scope re-opened with each new                   * `Fl' macros have their scope re-opened with each new
                  * word so that the `-' can be added to each one without                   * word so that the `-' can be added to each one without
                  * having to parse out spaces.                   * having to parse out spaces.
                  */                   */
                 if (scope && MDOC_Fl == tok) {                  if (scope && tok == MDOC_Fl) {
                         if ( ! rew_elem(mdoc, tok))                          rew_elem(mdoc, tok);
                                 return(0);  
                         scope = 0;                          scope = 0;
                 }                  }
         }          }
   
         if (scope && ! rew_elem(mdoc, tok))          if (scope)
                 return(0);                  rew_elem(mdoc, tok);
   
         /*          /*
          * If no elements have been collected and we're allowed to have           * If no elements have been collected and we're allowed to have
Line 998  in_line(MACRO_PROT_ARGS)
Line 883  in_line(MACRO_PROT_ARGS)
          * raise a warning.           * raise a warning.
          */           */
   
         if (nc && 0 == cnt) {          if ( ! cnt) {
                 if ( ! mdoc_elem_alloc(mdoc, line, ppos, tok, arg))                  if (nc) {
                         return(0);                          mdoc_elem_alloc(mdoc, line, ppos, tok, arg);
                 if ( ! rew_last(mdoc, mdoc->last))                          rew_last(mdoc, mdoc->last);
                         return(0);                  } else {
         } else if ( ! nc && 0 == cnt) {                          mdoc_argv_free(arg);
                 mdoc_argv_free(arg);                          mandoc_msg(MANDOCERR_MACRO_EMPTY, mdoc->parse,
                 mdoc_pmsg(mdoc, line, ppos, MANDOCERR_MACROEMPTY);                              line, ppos, mdoc_macronames[tok]);
                   }
         }          }
           if (nl)
         if ( ! nl)                  append_delims(mdoc, line, pos, buf);
                 return(1);  
         return(append_delims(mdoc, line, pos, buf));  
 }  }
   
 static int  static void
 blk_full(MACRO_PROT_ARGS)  blk_full(MACRO_PROT_ARGS)
 {  {
         int               la, nl, nparsed;          int               la, nl, parsed;
         struct mdoc_arg  *arg;          struct mdoc_arg  *arg;
         struct mdoc_node *head; /* save of head macro */          struct roff_node *blk; /* Our own or a broken block. */
         struct mdoc_node *body; /* save of body macro */          struct roff_node *head; /* Our own head. */
         struct mdoc_node *n;          struct roff_node *body; /* Our own body. */
         enum mdoc_type    mtt;          struct roff_node *n;
         enum mdoct        ntok;  
         enum margserr     ac, lac;          enum margserr     ac, lac;
         enum margverr     av;  
         char             *p;          char             *p;
   
         nl = MDOC_NEWLINE & mdoc->flags;          nl = MDOC_NEWLINE & mdoc->flags;
   
         /* Close out prior implicit scope. */          if (buf[*pos] == '\0' && (tok == MDOC_Sh || tok == MDOC_Ss)) {
                   mandoc_msg(MANDOCERR_MACRO_EMPTY, mdoc->parse,
                       line, ppos, mdoc_macronames[tok]);
                   return;
           }
   
         if ( ! (MDOC_EXPLICIT & mdoc_macros[tok].flags)) {          if ( ! (mdoc_macros[tok].flags & MDOC_EXPLICIT)) {
                 if ( ! rew_sub(MDOC_BODY, mdoc, tok, line, ppos))  
                         return(0);                  /* Here, tok is one of Sh Ss Nm Nd It. */
                 if ( ! rew_sub(MDOC_BLOCK, mdoc, tok, line, ppos))  
                         return(0);                  blk = NULL;
                   for (n = mdoc->last; n != NULL; n = n->parent) {
                           if (n->flags & MDOC_ENDED) {
                                   if ( ! (n->flags & MDOC_VALID))
                                           n->flags |= MDOC_BROKEN;
                                   continue;
                           }
                           if (n->type != ROFFT_BLOCK)
                                   continue;
   
                           if (tok == MDOC_It && n->tok == MDOC_Bl) {
                                   if (blk != NULL) {
                                           mandoc_vmsg(MANDOCERR_BLK_BROKEN,
                                               mdoc->parse, line, ppos,
                                               "It breaks %s",
                                               mdoc_macronames[blk->tok]);
                                           rew_pending(mdoc, blk);
                                   }
                                   break;
                           }
   
                           if (mdoc_macros[n->tok].flags & MDOC_EXPLICIT) {
                                   switch (tok) {
                                   case MDOC_Sh:
                                   case MDOC_Ss:
                                           mandoc_vmsg(MANDOCERR_BLK_BROKEN,
                                               mdoc->parse, line, ppos,
                                               "%s breaks %s",
                                               mdoc_macronames[tok],
                                               mdoc_macronames[n->tok]);
                                           rew_pending(mdoc, n);
                                           n = mdoc->last;
                                           continue;
                                   case MDOC_It:
                                           /* Delay in case it's astray. */
                                           blk = n;
                                           continue;
                                   default:
                                           break;
                                   }
                                   break;
                           }
   
                           /* Here, n is one of Sh Ss Nm Nd It. */
   
                           if (tok != MDOC_Sh && (n->tok == MDOC_Sh ||
                               (tok != MDOC_Ss && (n->tok == MDOC_Ss ||
                                (tok != MDOC_It && n->tok == MDOC_It)))))
                                   break;
   
                           /* Item breaking an explicit block. */
   
                           if (blk != NULL) {
                                   mandoc_vmsg(MANDOCERR_BLK_BROKEN,
                                       mdoc->parse, line, ppos,
                                       "It breaks %s",
                                       mdoc_macronames[blk->tok]);
                                   rew_pending(mdoc, blk);
                                   blk = NULL;
                           }
   
                           /* Close out prior implicit scopes. */
   
                           rew_last(mdoc, n);
                   }
   
                   /* Skip items outside lists. */
   
                   if (tok == MDOC_It && (n == NULL || n->tok != MDOC_Bl)) {
                           mandoc_vmsg(MANDOCERR_IT_STRAY, mdoc->parse,
                               line, ppos, "It %s", buf + *pos);
                           roff_elem_alloc(mdoc, line, ppos, MDOC_br);
                           rew_elem(mdoc, MDOC_br);
                           return;
                   }
         }          }
   
         /*          /*
Line 1047  blk_full(MACRO_PROT_ARGS)
Line 1007  blk_full(MACRO_PROT_ARGS)
          * regular child nodes.           * regular child nodes.
          */           */
   
         for (arg = NULL;; ) {          mdoc_argv(mdoc, line, tok, &arg, pos, buf);
                 la = *pos;          blk = mdoc_block_alloc(mdoc, line, ppos, tok, arg);
                 av = mdoc_argv(mdoc, line, tok, &arg, pos, buf);  
   
                 if (ARGV_WORD == av) {  
                         *pos = la;  
                         break;  
                 }  
   
                 if (ARGV_EOLN == av)  
                         break;  
                 if (ARGV_ARG == av)  
                         continue;  
   
                 mdoc_argv_free(arg);  
                 return(0);  
         }  
   
         if ( ! mdoc_block_alloc(mdoc, line, ppos, tok, arg))  
                 return(0);  
   
         head = body = NULL;          head = body = NULL;
   
         /*          /*
          * Exception: Heads of `It' macros in `-diag' lists are not           * Exception: Heads of `It' macros in `-diag' lists are not
          * parsed, even though `It' macros in general are parsed.           * parsed, even though `It' macros in general are parsed.
          */           */
         nparsed = MDOC_It == tok &&  
             MDOC_Bl == mdoc->last->parent->tok &&  
             LIST_diag == mdoc->last->parent->norm->Bl.type;  
   
           parsed = tok != MDOC_It ||
               mdoc->last->parent->tok != MDOC_Bl ||
               mdoc->last->parent->norm->Bl.type != LIST_diag;
   
         /*          /*
          * The `Nd' macro has all arguments in its body: it's a hybrid           * The `Nd' macro has all arguments in its body: it's a hybrid
          * of block partial-explicit and full-implicit.  Stupid.           * of block partial-explicit and full-implicit.  Stupid.
          */           */
   
         if (MDOC_Nd == tok) {          if (tok == MDOC_Nd) {
                 if ( ! mdoc_head_alloc(mdoc, line, ppos, tok))                  head = roff_head_alloc(mdoc, line, ppos, tok);
                         return(0);                  rew_last(mdoc, head);
                 head = mdoc->last;                  body = roff_body_alloc(mdoc, line, ppos, tok);
                 if ( ! rew_sub(MDOC_HEAD, mdoc, tok, line, ppos))  
                         return(0);  
                 if ( ! mdoc_body_alloc(mdoc, line, ppos, tok))  
                         return(0);  
                 body = mdoc->last;  
         }          }
   
         if (MDOC_Bk == tok)          if (tok == MDOC_Bk)
                 mdoc->flags |= MDOC_KEEP;                  mdoc->flags |= MDOC_KEEP;
   
         ac = ARGS_ERROR;          ac = ARGS_EOLN;
           for (;;) {
   
         for ( ; ; ) {                  /*
                 la = *pos;                   * If we are right after a tab character,
                 /* Initialise last-phrase-type with ARGS_PEND. */                   * do not parse the first word for macros.
                 lac = ARGS_ERROR == ac ? ARGS_PEND : ac;                   */
                 ac = mdoc_args(mdoc, line, pos, buf, tok, &p);  
   
                 if (ARGS_PUNCT == ac)                  if (mdoc->flags & MDOC_PHRASEQN) {
                         break;                          mdoc->flags &= ~MDOC_PHRASEQN;
                           mdoc->flags |= MDOC_PHRASEQF;
                   }
   
                 if (ARGS_ERROR == ac)                  la = *pos;
                         return(0);                  lac = ac;
                   ac = mdoc_args(mdoc, line, pos, buf, tok, &p);
                 if (ARGS_EOLN == ac) {                  if (ac == ARGS_EOLN) {
                         if (ARGS_PPHRASE != lac && ARGS_PHRASE != lac)                          if (lac != ARGS_PHRASE ||
                               ! (mdoc->flags & MDOC_PHRASEQF))
                                 break;                                  break;
   
                         /*                          /*
                          * This is necessary: if the last token on a                           * This line ends in a tab; start the next
                          * line is a `Ta' or tab, then we'll get                           * column now, with a leading blank.
                          * ARGS_EOLN, so we must be smart enough to  
                          * reopen our scope if the last parse was a  
                          * phrase or partial phrase.  
                          */                           */
                         if ( ! rew_sub(MDOC_BODY, mdoc, tok, line, ppos))  
                                 return(0);                          if (body != NULL)
                         if ( ! mdoc_body_alloc(mdoc, line, ppos, tok))                                  rew_last(mdoc, body);
                                 return(0);                          body = roff_body_alloc(mdoc, line, ppos, tok);
                         body = mdoc->last;                          roff_word_alloc(mdoc, line, ppos, "\\&");
                         break;                          break;
                 }                  }
   
                   if (tok == MDOC_Bd || tok == MDOC_Bk) {
                           mandoc_vmsg(MANDOCERR_ARG_EXCESS,
                               mdoc->parse, line, la, "%s ... %s",
                               mdoc_macronames[tok], buf + la);
                           break;
                   }
                   if (tok == MDOC_Rs) {
                           mandoc_vmsg(MANDOCERR_ARG_SKIP, mdoc->parse,
                               line, la, "Rs %s", buf + la);
                           break;
                   }
                   if (ac == ARGS_PUNCT)
                           break;
   
                 /*                  /*
                  * Emit leading punctuation (i.e., punctuation before                   * Emit leading punctuation (i.e., punctuation before
                  * the MDOC_HEAD) for non-phrase types.                   * the ROFFT_HEAD) for non-phrase types.
                  */                   */
   
                 if (NULL == head &&                  if (head == NULL &&
                     ARGS_PEND != ac &&                      ac != ARGS_PHRASE &&
                     ARGS_PHRASE != ac &&                      ac != ARGS_QWORD &&
                     ARGS_PPHRASE != ac &&                      mdoc_isdelim(p) == DELIM_OPEN) {
                     ARGS_QWORD != ac &&                          dword(mdoc, line, la, p, DELIM_OPEN, 0);
                     DELIM_OPEN == mdoc_isdelim(p)) {  
                         if ( ! dword(mdoc, line, la, p, DELIM_OPEN, 0))  
                                 return(0);  
                         continue;                          continue;
                 }                  }
   
                 /* Open a head if one hasn't been opened. */                  /* Open a head if one hasn't been opened. */
   
                 if (NULL == head) {                  if (head == NULL)
                         if ( ! mdoc_head_alloc(mdoc, line, ppos, tok))                          head = roff_head_alloc(mdoc, line, ppos, tok);
                                 return(0);  
                         head = mdoc->last;  
                 }  
   
                 if (ARGS_PHRASE == ac ||                  if (ac == ARGS_PHRASE) {
                     ARGS_PEND == ac ||  
                     ARGS_PPHRASE == ac) {  
                         /*                          /*
                          * If we haven't opened a body yet, rewind the                           * If we haven't opened a body yet, rewind the
                          * head; if we have, rewind that instead.                           * head; if we have, rewind that instead.
                          */                           */
   
                         mtt = body ? MDOC_BODY : MDOC_HEAD;                          rew_last(mdoc, body == NULL ? head : body);
                         if ( ! rew_sub(mtt, mdoc, tok, line, ppos))                          body = roff_body_alloc(mdoc, line, ppos, tok);
                                 return(0);  
   
                         /* Then allocate our body context. */                          /* Process to the tab or to the end of the line. */
   
                         if ( ! mdoc_body_alloc(mdoc, line, ppos, tok))                          mdoc->flags |= MDOC_PHRASE;
                                 return(0);                          parse_rest(mdoc, TOKEN_NONE, line, &la, buf);
                         body = mdoc->last;                          mdoc->flags &= ~MDOC_PHRASE;
   
                         /*                          /* There may have been `Ta' macros. */
                          * Process phrases: set whether we're in a  
                          * partial-phrase (this effects line handling)  
                          * then call down into the phrase parser.  
                          */  
   
                         if (ARGS_PPHRASE == ac)                          while (body->next != NULL)
                                 mdoc->flags |= MDOC_PPHRASE;                                  body = body->next;
                         if (ARGS_PEND == ac && ARGS_PPHRASE == lac)  
                                 mdoc->flags |= MDOC_PPHRASE;  
   
                         if ( ! phrase(mdoc, line, la, buf))  
                                 return(0);  
   
                         mdoc->flags &= ~MDOC_PPHRASE;  
                         continue;                          continue;
                 }                  }
   
                 ntok = nparsed || ARGS_QWORD == ac ?                  if (macro_or_word(mdoc, tok, line, la, pos, buf, parsed))
                     MDOC_MAX : lookup(tok, p);                          break;
   
                 if (MDOC_MAX == ntok) {  
                         if ( ! dword(mdoc, line, la, p, DELIM_MAX,  
                             MDOC_JOIN & mdoc_macros[tok].flags))  
                                 return(0);  
                         continue;  
                 }  
   
                 if ( ! mdoc_macro(mdoc, ntok, line, la, pos, buf))  
                         return(0);  
                 break;  
         }          }
   
         if (NULL == head) {          if (blk->flags & MDOC_VALID)
                 if ( ! mdoc_head_alloc(mdoc, line, ppos, tok))                  return;
                         return(0);          if (head == NULL)
                 head = mdoc->last;                  head = roff_head_alloc(mdoc, line, ppos, tok);
         }          if (nl && tok != MDOC_Bd && tok != MDOC_Bl && tok != MDOC_Rs)
                   append_delims(mdoc, line, pos, buf);
         if (nl && ! append_delims(mdoc, line, pos, buf))          if (body != NULL)
                 return(0);  
   
         /* If we've already opened our body, exit now. */  
   
         if (NULL != body)  
                 goto out;                  goto out;
           if (find_pending(mdoc, tok, line, ppos, head))
                   return;
   
         /*  
          * If there is an open (i.e., unvalidated) sub-block requiring  
          * explicit close-out, postpone switching the current block from  
          * head to body until the rew_sub() call closing out that  
          * sub-block.  
          */  
         for (n = mdoc->last; n && n != head; n = n->parent) {  
                 if (MDOC_BLOCK == n->type &&  
                     MDOC_EXPLICIT & mdoc_macros[n->tok].flags &&  
                     ! (MDOC_VALID & n->flags)) {  
                         n->pending = head;  
                         return(1);  
                 }  
         }  
   
         /* Close out scopes to remain in a consistent state. */          /* Close out scopes to remain in a consistent state. */
   
         if ( ! rew_sub(MDOC_HEAD, mdoc, tok, line, ppos))          rew_last(mdoc, head);
                 return(0);          body = roff_body_alloc(mdoc, line, ppos, tok);
         if ( ! mdoc_body_alloc(mdoc, line, ppos, tok))  
                 return(0);  
   
 out:  out:
         if ( ! (MDOC_FREECOL & mdoc->flags))          if (mdoc->flags & MDOC_FREECOL) {
                 return(1);                  rew_last(mdoc, body);
                   rew_last(mdoc, blk);
         if ( ! rew_sub(MDOC_BODY, mdoc, tok, line, ppos))                  mdoc->flags &= ~MDOC_FREECOL;
                 return(0);          }
         if ( ! rew_sub(MDOC_BLOCK, mdoc, tok, line, ppos))  
                 return(0);  
   
         mdoc->flags &= ~MDOC_FREECOL;  
         return(1);  
 }  }
   
 static int  static void
 blk_part_imp(MACRO_PROT_ARGS)  blk_part_imp(MACRO_PROT_ARGS)
 {  {
         int               la, nl;          int               la, nl;
         enum mdoct        ntok;  
         enum margserr     ac;          enum margserr     ac;
         char             *p;          char             *p;
         struct mdoc_node *blk; /* saved block context */          struct roff_node *blk; /* saved block context */
         struct mdoc_node *body; /* saved body context */          struct roff_node *body; /* saved body context */
         struct mdoc_node *n;          struct roff_node *n;
   
         nl = MDOC_NEWLINE & mdoc->flags;          nl = MDOC_NEWLINE & mdoc->flags;
   
Line 1275  blk_part_imp(MACRO_PROT_ARGS)
Line 1170  blk_part_imp(MACRO_PROT_ARGS)
          * or more closing punctuation nodes.           * or more closing punctuation nodes.
          */           */
   
         if ( ! mdoc_block_alloc(mdoc, line, ppos, tok, NULL))          blk = mdoc_block_alloc(mdoc, line, ppos, tok, NULL);
                 return(0);          rew_last(mdoc, roff_head_alloc(mdoc, line, ppos, tok));
   
         blk = mdoc->last;  
   
         if ( ! mdoc_head_alloc(mdoc, line, ppos, tok))  
                 return(0);  
         if ( ! rew_sub(MDOC_HEAD, mdoc, tok, line, ppos))  
                 return(0);  
   
         /*          /*
          * Open the body scope "on-demand", that is, after we've           * Open the body scope "on-demand", that is, after we've
          * processed all our the leading delimiters (open parenthesis,           * processed all our the leading delimiters (open parenthesis,
Line 1294  blk_part_imp(MACRO_PROT_ARGS)
Line 1182  blk_part_imp(MACRO_PROT_ARGS)
         for (body = NULL; ; ) {          for (body = NULL; ; ) {
                 la = *pos;                  la = *pos;
                 ac = mdoc_args(mdoc, line, pos, buf, tok, &p);                  ac = mdoc_args(mdoc, line, pos, buf, tok, &p);
                   if (ac == ARGS_EOLN || ac == ARGS_PUNCT)
                 if (ARGS_ERROR == ac)  
                         return(0);  
                 if (ARGS_EOLN == ac)  
                         break;                          break;
                 if (ARGS_PUNCT == ac)  
                         break;  
   
                 if (NULL == body && ARGS_QWORD != ac &&                  if (body == NULL && ac != ARGS_QWORD &&
                     DELIM_OPEN == mdoc_isdelim(p)) {                      mdoc_isdelim(p) == DELIM_OPEN) {
                         if ( ! dword(mdoc, line, la, p, DELIM_OPEN, 0))                          dword(mdoc, line, la, p, DELIM_OPEN, 0);
                                 return(0);  
                         continue;                          continue;
                 }                  }
   
                 if (NULL == body) {                  if (body == NULL)
                        if ( ! mdoc_body_alloc(mdoc, line, ppos, tok))                          body = roff_body_alloc(mdoc, line, ppos, tok);
                                return(0);  
                         body = mdoc->last;  
                 }  
   
                 ntok = ARGS_QWORD == ac ? MDOC_MAX : lookup(tok, p);                  if (macro_or_word(mdoc, tok, line, la, pos, buf, 1))
                           break;
                 if (MDOC_MAX == ntok) {  
                         if ( ! dword(mdoc, line, la, p, DELIM_MAX,  
                             MDOC_JOIN & mdoc_macros[tok].flags))  
                                 return(0);  
                         continue;  
                 }  
   
                 if ( ! mdoc_macro(mdoc, ntok, line, la, pos, buf))  
                         return(0);  
                 break;  
         }          }
           if (body == NULL)
                   body = roff_body_alloc(mdoc, line, ppos, tok);
   
         /* Clean-ups to leave in a consistent state. */          if (find_pending(mdoc, tok, line, ppos, body))
                   return;
   
         if (NULL == body) {          rew_last(mdoc, body);
                 if ( ! mdoc_body_alloc(mdoc, line, ppos, tok))          if (nl)
                         return(0);                  append_delims(mdoc, line, pos, buf);
                 body = mdoc->last;          rew_pending(mdoc, blk);
         }  
   
         /*  
          * If there is an open sub-block requiring explicit close-out,  
          * postpone closing out the current block  
          * until the rew_sub() call closing out the sub-block.  
          */  
         for (n = mdoc->last; n && n != body && n != blk->parent;  
              n = n->parent) {  
                 if (MDOC_BLOCK == n->type &&  
                     MDOC_EXPLICIT & mdoc_macros[n->tok].flags &&  
                     ! (MDOC_VALID & n->flags)) {  
                         make_pending(n, tok, mdoc, line, ppos);  
                         if ( ! mdoc_endbody_alloc(mdoc, line, ppos,  
                             tok, body, ENDBODY_NOSPACE))  
                                 return(0);  
                         return(1);  
                 }  
         }  
   
         /*  
          * If we can't rewind to our body, then our scope has already  
          * been closed by another macro (like `Oc' closing `Op').  This  
          * is ugly behaviour nodding its head to OpenBSD's overwhelming  
          * crufty use of `Op' breakage.  
          */  
         if (n != body)  
                 mandoc_vmsg(MANDOCERR_SCOPENEST, mdoc->parse, line,  
                     ppos, "%s broken", mdoc_macronames[tok]);  
   
         if (n && ! rew_sub(MDOC_BODY, mdoc, tok, line, ppos))  
                 return(0);  
   
         /* Standard appending of delimiters. */  
   
         if (nl && ! append_delims(mdoc, line, pos, buf))  
                 return(0);  
   
         /* Rewind scope, if applicable. */  
   
         if (n && ! rew_sub(MDOC_BLOCK, mdoc, tok, line, ppos))  
                 return(0);  
   
         /* Move trailing .Ns out of scope. */          /* Move trailing .Ns out of scope. */
   
         for (n = body->child; n && n->next; n = n->next)          for (n = body->child; n && n->next; n = n->next)
                 /* Do nothing. */ ;                  /* Do nothing. */ ;
         if (n && MDOC_Ns == n->tok)          if (n && n->tok == MDOC_Ns)
                 mdoc_node_relink(mdoc, n);                  mdoc_node_relink(mdoc, n);
   
         return(1);  
 }  }
   
 static int  static void
 blk_part_exp(MACRO_PROT_ARGS)  blk_part_exp(MACRO_PROT_ARGS)
 {  {
         int               la, nl;          int               la, nl;
         enum margserr     ac;          enum margserr     ac;
         struct mdoc_node *head; /* keep track of head */          struct roff_node *head; /* keep track of head */
         struct mdoc_node *body; /* keep track of body */  
         char             *p;          char             *p;
         enum mdoct        ntok;  
   
         nl = MDOC_NEWLINE & mdoc->flags;          nl = MDOC_NEWLINE & mdoc->flags;
   
Line 1406  blk_part_exp(MACRO_PROT_ARGS)
Line 1232  blk_part_exp(MACRO_PROT_ARGS)
          * case of `Eo'); and a body that may be empty.           * case of `Eo'); and a body that may be empty.
          */           */
   
         if ( ! mdoc_block_alloc(mdoc, line, ppos, tok, NULL))          roff_block_alloc(mdoc, line, ppos, tok);
                 return(0);          head = NULL;
           for (;;) {
         for (head = body = NULL; ; ) {  
                 la = *pos;                  la = *pos;
                 ac = mdoc_args(mdoc, line, pos, buf, tok, &p);                  ac = mdoc_args(mdoc, line, pos, buf, tok, &p);
                   if (ac == ARGS_PUNCT || ac == ARGS_EOLN)
                 if (ARGS_ERROR == ac)  
                         return(0);  
                 if (ARGS_PUNCT == ac)  
                         break;                          break;
                 if (ARGS_EOLN == ac)  
                         break;  
   
                 /* Flush out leading punctuation. */                  /* Flush out leading punctuation. */
   
                 if (NULL == head && ARGS_QWORD != ac &&                  if (head == NULL && ac != ARGS_QWORD &&
                     DELIM_OPEN == mdoc_isdelim(p)) {                      mdoc_isdelim(p) == DELIM_OPEN) {
                         assert(NULL == body);                          dword(mdoc, line, la, p, DELIM_OPEN, 0);
                         if ( ! dword(mdoc, line, la, p, DELIM_OPEN, 0))  
                                 return(0);  
                         continue;                          continue;
                 }                  }
   
                 if (NULL == head) {                  if (head == NULL) {
                         assert(NULL == body);                          head = roff_head_alloc(mdoc, line, ppos, tok);
                         if ( ! mdoc_head_alloc(mdoc, line, ppos, tok))                          if (tok == MDOC_Eo)  /* Not parsed. */
                                 return(0);                                  dword(mdoc, line, la, p, DELIM_MAX, 0);
                         head = mdoc->last;                          rew_last(mdoc, head);
                 }                          roff_body_alloc(mdoc, line, ppos, tok);
                           if (tok == MDOC_Eo)
                 /*  
                  * `Eo' gobbles any data into the head, but most other  
                  * macros just immediately close out and begin the body.  
                  */  
   
                 if (NULL == body) {  
                         assert(head);  
                         /* No check whether it's a macro! */  
                         if (MDOC_Eo == tok)  
                                 if ( ! dword(mdoc, line, la, p, DELIM_MAX, 0))  
                                         return(0);  
   
                         if ( ! rew_sub(MDOC_HEAD, mdoc, tok, line, ppos))  
                                 return(0);  
                         if ( ! mdoc_body_alloc(mdoc, line, ppos, tok))  
                                 return(0);  
                         body = mdoc->last;  
   
                         if (MDOC_Eo == tok)  
                                 continue;                                  continue;
                 }                  }
   
                 assert(NULL != head && NULL != body);                  if (macro_or_word(mdoc, tok, line, la, pos, buf, 1))
                           break;
                 ntok = ARGS_QWORD == ac ? MDOC_MAX : lookup(tok, p);  
   
                 if (MDOC_MAX == ntok) {  
                         if ( ! dword(mdoc, line, la, p, DELIM_MAX,  
                             MDOC_JOIN & mdoc_macros[tok].flags))  
                                 return(0);  
                         continue;  
                 }  
   
                 if ( ! mdoc_macro(mdoc, ntok, line, la, pos, buf))  
                         return(0);  
                 break;  
         }          }
   
         /* Clean-up to leave in a consistent state. */          /* Clean-up to leave in a consistent state. */
   
         if (NULL == head)          if (head == NULL) {
                 if ( ! mdoc_head_alloc(mdoc, line, ppos, tok))                  rew_last(mdoc, roff_head_alloc(mdoc, line, ppos, tok));
                         return(0);                  roff_body_alloc(mdoc, line, ppos, tok);
   
         if (NULL == body) {  
                 if ( ! rew_sub(MDOC_HEAD, mdoc, tok, line, ppos))  
                         return(0);  
                 if ( ! mdoc_body_alloc(mdoc, line, ppos, tok))  
                         return(0);  
         }          }
           if (nl)
         /* Standard appending of delimiters. */                  append_delims(mdoc, line, pos, buf);
   
         if ( ! nl)  
                 return(1);  
         return(append_delims(mdoc, line, pos, buf));  
 }  }
   
 static int  static void
 in_line_argn(MACRO_PROT_ARGS)  in_line_argn(MACRO_PROT_ARGS)
 {  {
         int              la, flushed, j, maxargs, nl;  
         enum margserr    ac;  
         enum margverr    av;  
         struct mdoc_arg *arg;          struct mdoc_arg *arg;
         char            *p;          char            *p;
         enum mdoct       ntok;          enum margserr    ac;
           int              ntok;
           int              state; /* arg#; -1: not yet open; -2: closed */
           int              la, maxargs, nl;
   
         nl = MDOC_NEWLINE & mdoc->flags;          nl = mdoc->flags & MDOC_NEWLINE;
   
         /*          /*
          * A line macro that has a fixed number of arguments (maxargs).           * A line macro that has a fixed number of arguments (maxargs).
Line 1517  in_line_argn(MACRO_PROT_ARGS)
Line 1294  in_line_argn(MACRO_PROT_ARGS)
   
         switch (tok) {          switch (tok) {
         case MDOC_Ap:          case MDOC_Ap:
                 /* FALLTHROUGH */  
         case MDOC_No:  
                 /* FALLTHROUGH */  
         case MDOC_Ns:          case MDOC_Ns:
                 /* FALLTHROUGH */  
         case MDOC_Ux:          case MDOC_Ux:
                 maxargs = 0;                  maxargs = 0;
                 break;                  break;
         case MDOC_Bx:          case MDOC_Bx:
                 /* FALLTHROUGH */  
         case MDOC_Es:          case MDOC_Es:
                 /* FALLTHROUGH */  
         case MDOC_Xr:          case MDOC_Xr:
                 maxargs = 2;                  maxargs = 2;
                 break;                  break;
Line 1537  in_line_argn(MACRO_PROT_ARGS)
Line 1308  in_line_argn(MACRO_PROT_ARGS)
                 break;                  break;
         }          }
   
         for (arg = NULL; ; ) {          mdoc_argv(mdoc, line, tok, &arg, pos, buf);
   
           state = -1;
           p = NULL;
           for (;;) {
                 la = *pos;                  la = *pos;
                 av = mdoc_argv(mdoc, line, tok, &arg, pos, buf);                  ac = mdoc_args(mdoc, line, pos, buf, tok, &p);
   
                 if (ARGV_WORD == av) {                  if (ac == ARGS_WORD && state == -1 &&
                         *pos = la;                      ! (mdoc_macros[tok].flags & MDOC_IGNDELIM) &&
                         break;                      mdoc_isdelim(p) == DELIM_OPEN) {
                           dword(mdoc, line, la, p, DELIM_OPEN, 0);
                           continue;
                 }                  }
   
                 if (ARGV_EOLN == av)                  if (state == -1 && tok != MDOC_In &&
                         break;                      tok != MDOC_St && tok != MDOC_Xr) {
                 if (ARGV_ARG == av)                          mdoc_elem_alloc(mdoc, line, ppos, tok, arg);
                         continue;                          state = 0;
                   }
   
                 mdoc_argv_free(arg);                  if (ac == ARGS_PUNCT || ac == ARGS_EOLN) {
                 return(0);                          if (abs(state) < 2 && tok == MDOC_Pf)
         }                                  mandoc_vmsg(MANDOCERR_PF_SKIP,
                                       mdoc->parse, line, ppos, "Pf %s",
         for (flushed = j = 0; ; ) {                                      p == NULL ? "at eol" : p);
                 la = *pos;  
                 ac = mdoc_args(mdoc, line, pos, buf, tok, &p);  
   
                 if (ARGS_ERROR == ac)  
                         return(0);  
                 if (ARGS_PUNCT == ac)  
                         break;                          break;
                 if (ARGS_EOLN == ac)                  }
                         break;  
   
                 if ( ! (MDOC_IGNDELIM & mdoc_macros[tok].flags) &&                  if (state == maxargs) {
                     ARGS_QWORD != ac && 0 == j &&                          rew_elem(mdoc, tok);
                     DELIM_OPEN == mdoc_isdelim(p)) {                          state = -2;
                         if ( ! dword(mdoc, line, la, p, DELIM_OPEN, 0))  
                                 return(0);  
                         continue;  
                 } else if (0 == j)  
                        if ( ! mdoc_elem_alloc(mdoc, line, la, tok, arg))  
                                return(0);  
   
                 if (j == maxargs && ! flushed) {  
                         if ( ! rew_elem(mdoc, tok))  
                                 return(0);  
                         flushed = 1;  
                 }                  }
   
                 ntok = ARGS_QWORD == ac ? MDOC_MAX : lookup(tok, p);                  ntok = (ac == ARGS_QWORD || (tok == MDOC_Pf && state == 0)) ?
                       TOKEN_NONE : lookup(mdoc, tok, line, la, p);
   
                 if (MDOC_MAX != ntok) {                  if (ntok != TOKEN_NONE) {
                         if ( ! flushed && ! rew_elem(mdoc, tok))                          if (state >= 0) {
                                 return(0);                                  rew_elem(mdoc, tok);
                         flushed = 1;                                  state = -2;
                         if ( ! mdoc_macro(mdoc, ntok, line, la, pos, buf))                          }
                                 return(0);                          mdoc_macro(mdoc, ntok, line, la, pos, buf);
                         j++;  
                         break;                          break;
                 }                  }
   
                 if ( ! (MDOC_IGNDELIM & mdoc_macros[tok].flags) &&                  if (ac == ARGS_QWORD ||
                     ARGS_QWORD != ac &&                      mdoc_macros[tok].flags & MDOC_IGNDELIM ||
                     ! flushed &&                      mdoc_isdelim(p) == DELIM_NONE) {
                     DELIM_NONE != mdoc_isdelim(p)) {                          if (state == -1) {
                         if ( ! rew_elem(mdoc, tok))                                  mdoc_elem_alloc(mdoc, line, ppos, tok, arg);
                                 return(0);                                  state = 1;
                         flushed = 1;                          } else if (state >= 0)
                                   state++;
                   } else if (state >= 0) {
                           rew_elem(mdoc, tok);
                           state = -2;
                 }                  }
   
                 if ( ! dword(mdoc, line, la, p, DELIM_MAX,                  dword(mdoc, line, la, p, DELIM_MAX,
                     MDOC_JOIN & mdoc_macros[tok].flags))                      MDOC_JOIN & mdoc_macros[tok].flags);
                         return(0);  
                 j++;  
         }          }
   
         if (0 == j && ! mdoc_elem_alloc(mdoc, line, la, tok, arg))          if (state == -1) {
                return(0);                  mandoc_msg(MANDOCERR_MACRO_EMPTY, mdoc->parse,
                       line, ppos, mdoc_macronames[tok]);
                   return;
           }
   
         /* Close out in a consistent state. */          if (state == 0 && tok == MDOC_Pf)
                   append_delims(mdoc, line, pos, buf);
         if ( ! flushed && ! rew_elem(mdoc, tok))          if (state >= 0)
                 return(0);                  rew_elem(mdoc, tok);
         if ( ! nl)          if (nl)
                 return(1);                  append_delims(mdoc, line, pos, buf);
         return(append_delims(mdoc, line, pos, buf));  
 }  }
   
 static int  static void
 in_line_eoln(MACRO_PROT_ARGS)  in_line_eoln(MACRO_PROT_ARGS)
 {  {
         int              la;          struct roff_node        *n;
         enum margserr    ac;          struct mdoc_arg         *arg;
         enum margverr    av;  
         struct mdoc_arg *arg;  
         char            *p;  
         enum mdoct       ntok;  
   
         assert( ! (MDOC_PARSED & mdoc_macros[tok].flags));          if ((tok == MDOC_Pp || tok == MDOC_Lp) &&
               ! (mdoc->flags & MDOC_SYNOPSIS)) {
                   n = mdoc->last;
                   if (mdoc->next == ROFF_NEXT_SIBLING)
                           n = n->parent;
                   if (n->tok == MDOC_Nm)
                           rew_last(mdoc, n->parent);
           }
   
         if (tok == MDOC_Pp)          if (buf[*pos] == '\0' &&
                 rew_sub(MDOC_BLOCK, mdoc, MDOC_Nm, line, ppos);              (tok == MDOC_Fd || mdoc_macronames[tok][0] == '%')) {
                   mandoc_msg(MANDOCERR_MACRO_EMPTY, mdoc->parse,
         /* Parse macro arguments. */                      line, ppos, mdoc_macronames[tok]);
                   return;
         for (arg = NULL; ; ) {  
                 la = *pos;  
                 av = mdoc_argv(mdoc, line, tok, &arg, pos, buf);  
   
                 if (ARGV_WORD == av) {  
                         *pos = la;  
                         break;  
                 }  
                 if (ARGV_EOLN == av)  
                         break;  
                 if (ARGV_ARG == av)  
                         continue;  
   
                 mdoc_argv_free(arg);  
                 return(0);  
         }          }
   
         /* Open element scope. */          mdoc_argv(mdoc, line, tok, &arg, pos, buf);
           mdoc_elem_alloc(mdoc, line, ppos, tok, arg);
           if (parse_rest(mdoc, tok, line, pos, buf))
                   return;
           rew_elem(mdoc, tok);
   }
   
         if ( ! mdoc_elem_alloc(mdoc, line, ppos, tok, arg))  /*
                 return(0);   * The simplest argument parser available: Parse the remaining
    * words until the end of the phrase or line and return 0
    * or until the next macro, call that macro, and return 1.
    */
   static int
   parse_rest(struct roff_man *mdoc, int tok, int line, int *pos, char *buf)
   {
           int              la;
   
         /* Parse argument terms. */  
   
         for (;;) {          for (;;) {
                 la = *pos;                  la = *pos;
                 ac = mdoc_args(mdoc, line, pos, buf, tok, &p);                  if (mdoc_args(mdoc, line, pos, buf, tok, NULL) == ARGS_EOLN)
                           return 0;
                 if (ARGS_ERROR == ac)                  if (macro_or_word(mdoc, tok, line, la, pos, buf, 1))
                         return(0);                          return 1;
                 if (ARGS_EOLN == ac)  
                         break;  
   
                 ntok = ARGS_QWORD == ac ? MDOC_MAX : lookup(tok, p);  
   
                 if (MDOC_MAX == ntok) {  
                         if ( ! dword(mdoc, line, la, p, DELIM_MAX,  
                             MDOC_JOIN & mdoc_macros[tok].flags))  
                                 return(0);  
                         continue;  
                 }  
   
                 if ( ! rew_elem(mdoc, tok))  
                         return(0);  
                 return(mdoc_macro(mdoc, ntok, line, la, pos, buf));  
         }          }
   
         /* Close out (no delimiters). */  
   
         return(rew_elem(mdoc, tok));  
 }  }
   
 static int  static void
 ctx_synopsis(MACRO_PROT_ARGS)  ctx_synopsis(MACRO_PROT_ARGS)
 {  {
         int              nl;  
   
         nl = MDOC_NEWLINE & mdoc->flags;          if (~mdoc->flags & (MDOC_SYNOPSIS | MDOC_NEWLINE))
                   in_line(mdoc, tok, line, ppos, pos, buf);
         /* If we're not in the SYNOPSIS, go straight to in-line. */          else if (tok == MDOC_Nm)
         if ( ! (MDOC_SYNOPSIS & mdoc->flags))                  blk_full(mdoc, tok, line, ppos, pos, buf);
                 return(in_line(mdoc, tok, line, ppos, pos, buf));          else {
                   assert(tok == MDOC_Vt);
         /* If we're a nested call, same place. */                  blk_part_imp(mdoc, tok, line, ppos, pos, buf);
         if ( ! nl)          }
                 return(in_line(mdoc, tok, line, ppos, pos, buf));  
   
         /*  
          * XXX: this will open a block scope; however, if later we end  
          * up formatting the block scope, then child nodes will inherit  
          * the formatting.  Be careful.  
          */  
         if (MDOC_Nm == tok)  
                 return(blk_full(mdoc, tok, line, ppos, pos, buf));  
         assert(MDOC_Vt == tok);  
         return(blk_part_imp(mdoc, tok, line, ppos, pos, buf));  
 }  }
   
 /*  /*
Line 1721  ctx_synopsis(MACRO_PROT_ARGS)
Line 1452  ctx_synopsis(MACRO_PROT_ARGS)
  * They're unusual because they're basically free-form text until a   * They're unusual because they're basically free-form text until a
  * macro is encountered.   * macro is encountered.
  */   */
 static int  static void
 phrase(struct mdoc *mdoc, int line, int ppos, char *buf)  phrase_ta(MACRO_PROT_ARGS)
 {  {
         int              la, pos;          struct roff_node *body, *n;
         enum margserr    ac;  
         enum mdoct       ntok;  
         char            *p;  
   
         for (pos = ppos; ; ) {          /* Make sure we are in a column list or ignore this macro. */
                 la = pos;  
   
                 ac = mdoc_zargs(mdoc, line, &pos, buf, &p);          body = NULL;
           for (n = mdoc->last; n != NULL; n = n->parent) {
                 if (ARGS_ERROR == ac)                  if (n->flags & MDOC_ENDED)
                         return(0);  
                 if (ARGS_EOLN == ac)  
                         break;  
   
                 ntok = ARGS_QWORD == ac ? MDOC_MAX : lookup_raw(p);  
   
                 if (MDOC_MAX == ntok) {  
                         if ( ! dword(mdoc, line, la, p, DELIM_MAX, 1))  
                                 return(0);  
                         continue;                          continue;
                 }                  if (n->tok == MDOC_It && n->type == ROFFT_BODY)
                           body = n;
                 if ( ! mdoc_macro(mdoc, ntok, line, la, &pos, buf))                  if (n->tok == MDOC_Bl)
                         return(0);                          break;
                 return(append_delims(mdoc, line, &pos, buf));  
         }          }
   
         return(1);          if (n == NULL || n->norm->Bl.type != LIST_column) {
 }                  mandoc_msg(MANDOCERR_TA_STRAY, mdoc->parse,
                       line, ppos, "Ta");
 static int                  return;
 phrase_ta(MACRO_PROT_ARGS)  
 {  
         struct mdoc_node *n;  
         int               la;  
         enum mdoct        ntok;  
         enum margserr     ac;  
         char             *p;  
   
         /* Make sure we are in a column list or ignore this macro. */  
         n = mdoc->last;  
         while (NULL != n && MDOC_Bl != n->tok)  
                 n = n->parent;  
         if (NULL == n || LIST_column != n->norm->Bl.type) {  
                 mdoc_pmsg(mdoc, line, ppos, MANDOCERR_STRAYTA);  
                 return(1);  
         }          }
   
         /* Advance to the next column. */          /* Advance to the next column. */
         if ( ! rew_sub(MDOC_BODY, mdoc, MDOC_It, line, ppos))  
                 return(0);  
         if ( ! mdoc_body_alloc(mdoc, line, ppos, MDOC_It))  
                 return(0);  
   
         for (;;) {          rew_last(mdoc, body);
                 la = *pos;          roff_body_alloc(mdoc, line, ppos, MDOC_It);
                 ac = mdoc_zargs(mdoc, line, pos, buf, &p);          parse_rest(mdoc, TOKEN_NONE, line, pos, buf);
   
                 if (ARGS_ERROR == ac)  
                         return(0);  
                 if (ARGS_EOLN == ac)  
                         break;  
   
                 ntok = ARGS_QWORD == ac ? MDOC_MAX : lookup_raw(p);  
   
                 if (MDOC_MAX == ntok) {  
                         if ( ! dword(mdoc, line, la, p, DELIM_MAX,  
                             MDOC_JOIN & mdoc_macros[tok].flags))  
                                 return(0);  
                         continue;  
                 }  
   
                 if ( ! mdoc_macro(mdoc, ntok, line, la, pos, buf))  
                         return(0);  
                 return(append_delims(mdoc, line, pos, buf));  
         }  
   
         return(1);  
 }  }
Legend:
Removed from v.1.132  
changed lines
  Added in v.1.205
CVSweb