[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.73 and 1.98

version 1.73, 2010/05/30 21:50:23 version 1.98, 2010/12/06 11:01:19
Line 1 
Line 1 
 /*      $Id$ */  /*      $Id$ */
 /*  /*
  * Copyright (c) 2008, 2009 Kristaps Dzonsons <kristaps@kth.se>   * Copyright (c) 2008, 2009, 2010 Kristaps Dzonsons <kristaps@bsd.lv>
    * Copyright (c) 2010 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
Line 29 
Line 30 
 #include "libmdoc.h"  #include "libmdoc.h"
 #include "libmandoc.h"  #include "libmandoc.h"
   
 enum    rew {  enum    rew {   /* see rew_dohalt() */
         REWIND_REWIND,          REWIND_NONE,
         REWIND_NOHALT,          REWIND_THIS,
         REWIND_HALT          REWIND_MORE,
           REWIND_FORCE,
           REWIND_LATER,
           REWIND_ERROR
 };  };
   
 static  int             blk_full(MACRO_PROT_ARGS);  static  int             blk_full(MACRO_PROT_ARGS);
Line 44  static int    in_line_eoln(MACRO_PROT_ARGS);
Line 48  static int    in_line_eoln(MACRO_PROT_ARGS);
 static  int             in_line_argn(MACRO_PROT_ARGS);  static  int             in_line_argn(MACRO_PROT_ARGS);
 static  int             in_line(MACRO_PROT_ARGS);  static  int             in_line(MACRO_PROT_ARGS);
 static  int             obsolete(MACRO_PROT_ARGS);  static  int             obsolete(MACRO_PROT_ARGS);
   static  int             phrase_ta(MACRO_PROT_ARGS);
   
 static  int             append_delims(struct mdoc *,  static  int             append_delims(struct mdoc *,
                                 int, int *, char *);                                  int, int *, char *);
 static  enum mdoct      lookup(enum mdoct, const char *);  static  enum mdoct      lookup(enum mdoct, const char *);
 static  enum mdoct      lookup_raw(const char *);  static  enum mdoct      lookup_raw(const char *);
 static  int             phrase(struct mdoc *, int, int,  static  int             make_pending(struct mdoc_node *, enum mdoct,
                                 char *, enum margserr);                                  struct mdoc *, int, int);
   static  int             phrase(struct mdoc *, int, int, char *);
 static  enum mdoct      rew_alt(enum mdoct);  static  enum mdoct      rew_alt(enum mdoct);
 static  int             rew_dobreak(enum mdoct,  
                                 const struct mdoc_node *);  
 static  enum rew        rew_dohalt(enum mdoct, enum mdoc_type,  static  enum rew        rew_dohalt(enum mdoct, enum mdoc_type,
                                 const struct mdoc_node *);                                  const struct mdoc_node *);
 static  int             rew_elem(struct mdoc *, enum mdoct);  static  int             rew_elem(struct mdoc *, enum mdoct);
Line 61  static int    rew_last(struct mdoc *, 
Line 65  static int    rew_last(struct mdoc *, 
                                 const struct mdoc_node *);                                  const struct mdoc_node *);
 static  int             rew_sub(enum mdoc_type, struct mdoc *,  static  int             rew_sub(enum mdoc_type, struct mdoc *,
                                 enum mdoct, int, int);                                  enum mdoct, int, int);
 static  int             swarn(struct mdoc *, enum mdoc_type, int,  
                                 int, const struct mdoc_node *);  
   
 const   struct mdoc_macro __mdoc_macros[MDOC_MAX] = {  const   struct mdoc_macro __mdoc_macros[MDOC_MAX] = {
         { in_line_argn, MDOC_CALLABLE | MDOC_PARSED }, /* Ap */          { in_line_argn, MDOC_CALLABLE | MDOC_PARSED }, /* Ap */
Line 97  const struct mdoc_macro __mdoc_macros[MDOC_MAX] = {
Line 99  const struct mdoc_macro __mdoc_macros[MDOC_MAX] = {
         { in_line_argn, MDOC_CALLABLE | MDOC_PARSED }, /* In */          { in_line_argn, MDOC_CALLABLE | MDOC_PARSED }, /* In */
         { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Li */          { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Li */
         { blk_full, 0 }, /* Nd */          { blk_full, 0 }, /* Nd */
         { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Nm */          { ctx_synopsis, MDOC_CALLABLE | MDOC_PARSED }, /* Nm */
         { blk_part_imp, MDOC_CALLABLE | MDOC_PARSED }, /* Op */          { blk_part_imp, MDOC_CALLABLE | MDOC_PARSED }, /* Op */
         { obsolete, 0 }, /* Ot */          { obsolete, 0 }, /* Ot */
         { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Pa */          { in_line, MDOC_CALLABLE | MDOC_PARSED }, /* Pa */
Line 137  const struct mdoc_macro __mdoc_macros[MDOC_MAX] = {
Line 139  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_argn, MDOC_CALLABLE | MDOC_PARSED }, /* No */          { in_line_argn, MDOC_CALLABLE | MDOC_PARSED | MDOC_IGNDELIM }, /* No */
         { in_line_argn, MDOC_CALLABLE | MDOC_PARSED }, /* Ns */          { in_line_argn, MDOC_CALLABLE | MDOC_PARSED | MDOC_IGNDELIM }, /* 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 */
         { blk_exp_close, MDOC_EXPLICIT | MDOC_CALLABLE | MDOC_PARSED }, /* Pc */          { blk_exp_close, MDOC_EXPLICIT | MDOC_CALLABLE | MDOC_PARSED }, /* Pc */
Line 186  const struct mdoc_macro __mdoc_macros[MDOC_MAX] = {
Line 188  const struct mdoc_macro __mdoc_macros[MDOC_MAX] = {
         { in_line_eoln, 0 }, /* br */          { in_line_eoln, 0 }, /* br */
         { 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 }, /* Ta */
 };  };
   
 const   struct mdoc_macro * const mdoc_macros = __mdoc_macros;  const   struct mdoc_macro * const mdoc_macros = __mdoc_macros;
   
   
 static int  
 swarn(struct mdoc *mdoc, enum mdoc_type type,  
                 int line, int pos, const struct mdoc_node *p)  
 {  
         const char      *n, *t, *tt;  
         int              rc;  
   
         n = t = "<root>";  
         tt = "block";  
   
         switch (type) {  
         case (MDOC_BODY):  
                 tt = "multi-line";  
                 break;  
         case (MDOC_HEAD):  
                 tt = "line";  
                 break;  
         default:  
                 break;  
         }  
   
         switch (p->type) {  
         case (MDOC_BLOCK):  
                 n = mdoc_macronames[p->tok];  
                 t = "block";  
                 break;  
         case (MDOC_BODY):  
                 n = mdoc_macronames[p->tok];  
                 t = "multi-line";  
                 break;  
         case (MDOC_HEAD):  
                 n = mdoc_macronames[p->tok];  
                 t = "line";  
                 break;  
         default:  
                 break;  
         }  
   
         rc = mdoc_vmsg(mdoc, MANDOCERR_SCOPE, line, pos,  
                         "%s scope breaks %s of %s", tt, t, n);  
   
         /* FIXME: logic should be in driver. */  
         return(MDOC_IGN_SCOPE & mdoc->pflags ? rc : 0);  
 }  
   
   
 /*  /*
  * This is called at the end of parsing.  It must traverse up the tree,   * This is called at the end of parsing.  It must traverse up the tree,
  * closing out open [implicit] scopes.  Obviously, open explicit scopes   * closing out open [implicit] scopes.  Obviously, open explicit scopes
Line 251  mdoc_macroend(struct mdoc *m)
Line 208  mdoc_macroend(struct mdoc *m)
   
         n = MDOC_VALID & m->last->flags ?  m->last->parent : m->last;          n = MDOC_VALID & m->last->flags ?  m->last->parent : m->last;
   
         for ( ; n; n = n->parent) {          for ( ; n; n = n->parent)
                 if (MDOC_BLOCK != n->type)                  if (MDOC_BLOCK == n->type &&
                         continue;                      MDOC_EXPLICIT & mdoc_macros[n->tok].flags)
                 if ( ! (MDOC_EXPLICIT & mdoc_macros[n->tok].flags))                          mdoc_nmsg(m, n, MANDOCERR_SCOPEEXIT);
                         continue;  
                 mdoc_nmsg(m, n, MANDOCERR_SYNTSCOPE);  
                 return(0);  
         }  
   
         /* Rewind to the first. */          /* Rewind to the first. */
   
Line 307  rew_last(struct mdoc *mdoc, const struct mdoc_node *to
Line 260  rew_last(struct mdoc *mdoc, const struct mdoc_node *to
         while (mdoc->last != to) {          while (mdoc->last != to) {
                 if ( ! mdoc_valid_post(mdoc))                  if ( ! mdoc_valid_post(mdoc))
                         return(0);                          return(0);
                 if ( ! mdoc_action_post(mdoc))  
                         return(0);  
                 mdoc->last = mdoc->last->parent;                  mdoc->last = mdoc->last->parent;
                 assert(mdoc->last);                  assert(mdoc->last);
         }          }
   
         if ( ! mdoc_valid_post(mdoc))          return(mdoc_valid_post(mdoc));
                 return(0);  
         return(mdoc_action_post(mdoc));  
 }  }
   
   
 /*  /*
  * Return the opening macro of a closing one, e.g., `Ec' has `Eo' as its   * For a block closing macro, return the corresponding opening one.
  * matching pair.   * Otherwise, return the macro itself.
  */   */
 static enum mdoct  static enum mdoct
 rew_alt(enum mdoct tok)  rew_alt(enum mdoct tok)
Line 360  rew_alt(enum mdoct tok)
Line 309  rew_alt(enum mdoct tok)
         case (MDOC_Xc):          case (MDOC_Xc):
                 return(MDOC_Xo);                  return(MDOC_Xo);
         default:          default:
                 break;                  return(tok);
         }          }
         abort();  
         /* NOTREACHED */          /* NOTREACHED */
 }  }
   
   
 /*  /*
  * Rewind rules.  This indicates whether to stop rewinding   * Rewinding to tok, how do we have to handle *p?
  * (REWIND_HALT) without touching our current scope, stop rewinding and   * REWIND_NONE: *p would delimit tok, but no tok scope is open
  * close our current scope (REWIND_REWIND), or continue (REWIND_NOHALT).   *   inside *p, so there is no need to rewind anything at all.
  * The scope-closing and so on occurs in the various rew_* routines.   * 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  static enum rew
 rew_dohalt(enum mdoct tok, enum mdoc_type type,  rew_dohalt(enum mdoct tok, enum mdoc_type type,
                 const struct mdoc_node *p)                  const struct mdoc_node *p)
 {  {
   
           /*
            * 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)          if (MDOC_ROOT == p->type)
                 return(REWIND_HALT);                  return(MDOC_BLOCK == type &&
         if (MDOC_VALID & p->flags)                      MDOC_EXPLICIT & mdoc_macros[tok].flags ?
                 return(REWIND_NOHALT);                      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) {          switch (tok) {
         case (MDOC_Aq):          case (MDOC_Bl):
                 /* FALLTHROUGH */                  if (MDOC_It == p->tok)
         case (MDOC_Bq):                          return(REWIND_MORE);
                 /* FALLTHROUGH */  
         case (MDOC_Brq):  
                 /* FALLTHROUGH */  
         case (MDOC_D1):  
                 /* FALLTHROUGH */  
         case (MDOC_Dl):  
                 /* FALLTHROUGH */  
         case (MDOC_Dq):  
                 /* FALLTHROUGH */  
         case (MDOC_Op):  
                 /* FALLTHROUGH */  
         case (MDOC_Pq):  
                 /* FALLTHROUGH */  
         case (MDOC_Ql):  
                 /* FALLTHROUGH */  
         case (MDOC_Qq):  
                 /* FALLTHROUGH */  
         case (MDOC_Sq):  
                 /* FALLTHROUGH */  
         case (MDOC_Vt):  
                 assert(MDOC_TAIL != type);  
                 if (type == p->type && tok == p->tok)  
                         return(REWIND_REWIND);  
                 break;                  break;
         case (MDOC_It):          case (MDOC_It):
                 assert(MDOC_TAIL != type);  
                 if (type == p->type && tok == p->tok)  
                         return(REWIND_REWIND);  
                 if (MDOC_BODY == p->type && MDOC_Bl == p->tok)                  if (MDOC_BODY == p->type && MDOC_Bl == p->tok)
                         return(REWIND_HALT);                          return(REWIND_NONE);
                 break;                  break;
         case (MDOC_Sh):          /*
                 if (type == p->type && tok == p->tok)           * XXX Badly nested block handling still fails badly
                         return(REWIND_REWIND);           * 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;                  break;
           case (MDOC_Nm):
                   return(REWIND_NONE);
         case (MDOC_Nd):          case (MDOC_Nd):
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
         case (MDOC_Ss):          case (MDOC_Ss):
                 assert(MDOC_TAIL != type);  
                 if (type == p->type && tok == p->tok)  
                         return(REWIND_REWIND);  
                 if (MDOC_BODY == p->type && MDOC_Sh == p->tok)                  if (MDOC_BODY == p->type && MDOC_Sh == p->tok)
                         return(REWIND_HALT);                          return(REWIND_NONE);
                 break;  
         case (MDOC_Ao):  
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
         case (MDOC_Bd):  
                 /* FALLTHROUGH */  
         case (MDOC_Bf):  
                 /* FALLTHROUGH */  
         case (MDOC_Bk):  
                 /* FALLTHROUGH */  
         case (MDOC_Bl):  
                 /* FALLTHROUGH */  
         case (MDOC_Bo):  
                 /* FALLTHROUGH */  
         case (MDOC_Bro):  
                 /* FALLTHROUGH */  
         case (MDOC_Do):  
                 /* FALLTHROUGH */  
         case (MDOC_Eo):  
                 /* FALLTHROUGH */  
         case (MDOC_Fo):  
                 /* FALLTHROUGH */  
         case (MDOC_Oo):  
                 /* FALLTHROUGH */  
         case (MDOC_Po):  
                 /* FALLTHROUGH */  
         case (MDOC_Qo):  
                 /* FALLTHROUGH */  
         case (MDOC_Rs):  
                 /* FALLTHROUGH */  
         case (MDOC_So):  
                 /* FALLTHROUGH */  
         case (MDOC_Xo):  
                 if (type == p->type && tok == p->tok)  
                         return(REWIND_REWIND);  
                 break;  
         /* Multi-line explicit scope close. */  
         case (MDOC_Ac):  
                 /* FALLTHROUGH */  
         case (MDOC_Bc):  
                 /* FALLTHROUGH */  
         case (MDOC_Brc):  
                 /* FALLTHROUGH */  
         case (MDOC_Dc):  
                 /* FALLTHROUGH */  
         case (MDOC_Ec):  
                 /* FALLTHROUGH */  
         case (MDOC_Ed):  
                 /* FALLTHROUGH */  
         case (MDOC_Ek):  
                 /* FALLTHROUGH */  
         case (MDOC_El):  
                 /* FALLTHROUGH */  
         case (MDOC_Fc):  
                 /* FALLTHROUGH */  
         case (MDOC_Ef):  
                 /* FALLTHROUGH */  
         case (MDOC_Oc):  
                 /* FALLTHROUGH */  
         case (MDOC_Pc):  
                 /* FALLTHROUGH */  
         case (MDOC_Qc):  
                 /* FALLTHROUGH */  
         case (MDOC_Re):  
                 /* FALLTHROUGH */  
         case (MDOC_Sc):  
                 /* FALLTHROUGH */  
         case (MDOC_Xc):  
                 if (type == p->type && rew_alt(tok) == p->tok)  
                         return(REWIND_REWIND);  
                 break;  
         default:  
                 abort();  
                 /* NOTREACHED */  
         }  
   
         return(REWIND_NOHALT);  
 }  
   
   
 /*  
  * See if we can break an encountered scope (the rew_dohalt has returned  
  * REWIND_NOHALT).  
  */  
 static int  
 rew_dobreak(enum mdoct tok, const struct mdoc_node *p)  
 {  
   
         assert(MDOC_ROOT != p->type);  
         if (MDOC_ELEM == p->type)  
                 return(1);  
         if (MDOC_TEXT == p->type)  
                 return(1);  
         if (MDOC_VALID & p->flags)  
                 return(1);  
   
         switch (tok) {  
         case (MDOC_It):  
                 return(MDOC_It == p->tok);  
         case (MDOC_Nd):  
                 return(MDOC_Nd == p->tok);  
         case (MDOC_Ss):  
                 return(MDOC_Ss == p->tok);  
         case (MDOC_Sh):          case (MDOC_Sh):
                 if (MDOC_Nd == p->tok)                  if (MDOC_Nd == p->tok || MDOC_Ss == p->tok ||
                         return(1);                      MDOC_Sh == p->tok)
                 if (MDOC_Ss == p->tok)                          return(REWIND_MORE);
                         return(1);  
                 return(MDOC_Sh == p->tok);  
         case (MDOC_El):  
                 if (MDOC_It == p->tok)  
                         return(1);  
                 break;                  break;
         case (MDOC_Oc):  
                 if (MDOC_Op == p->tok)  
                         return(1);  
                 break;  
         default:          default:
                 break;                  break;
         }          }
   
         if (MDOC_EXPLICIT & mdoc_macros[tok].flags)          /*
                 return(p->tok == rew_alt(tok));           * Default block rewinding rules.
         else if (MDOC_BLOCK == p->type)           * In particular, always skip block end markers,
                 return(1);           * 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);
   
         return(tok == p->tok);          /*
            * 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);
 }  }
   
   
Line 574  rew_elem(struct mdoc *mdoc, enum mdoct tok)
Line 440  rew_elem(struct mdoc *mdoc, enum mdoct tok)
 }  }
   
   
   /*
    * We are trying to close a block identified by tok,
    * but the child block *broken is still open.
    * Thus, postpone closing the tok block
    * until the rew_sub call closing *broken.
    */
 static int  static int
   make_pending(struct mdoc_node *broken, enum mdoct tok,
                   struct mdoc *m, int line, int ppos)
   {
           struct mdoc_node *breaker;
   
           /*
            * Iterate backwards, searching for the block matching tok,
            * that is, the block breaking the *broken block.
            */
           for (breaker = broken->parent; breaker; breaker = breaker->parent) {
   
                   /*
                    * 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;
                   }
   
                   if (REWIND_THIS != rew_dohalt(tok, MDOC_BLOCK, breaker))
                           continue;
                   if (MDOC_BODY == broken->type)
                           broken = broken->parent;
   
                   /*
                    * Found the breaker.
                    * If another, outer breaker is already pending on
                    * the *broken block, we must not clobber the link
                    * to the outer breaker, but make it pending on the
                    * new, now inner breaker.
                    * Graphically, "[A breaker=[B broken=[C->A A] tok=B] C]"
                    * 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;
                   mdoc_vmsg(m, MANDOCERR_SCOPENEST, line, ppos,
                       "%s breaks %s", mdoc_macronames[tok],
                       mdoc_macronames[broken->tok]);
                   return(1);
           }
   
           /*
            * 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 *m,  rew_sub(enum mdoc_type t, struct mdoc *m,
                 enum mdoct tok, int line, int ppos)                  enum mdoct tok, int line, int ppos)
 {  {
         struct mdoc_node *n;          struct mdoc_node *n;
         enum rew          c;  
   
         /* LINTED */          n = m->last;
         for (n = m->last; n; n = n->parent) {          while (n) {
                 c = rew_dohalt(tok, t, n);                  switch (rew_dohalt(tok, t, n)) {
                 if (REWIND_HALT == c) {                  case (REWIND_NONE):
                         if (MDOC_BLOCK != t)                          return(1);
                                 return(1);                  case (REWIND_THIS):
                         if ( ! (MDOC_EXPLICIT & mdoc_macros[tok].flags))  
                                 return(1);  
                         /* FIXME: shouldn't raise an error */  
                         mdoc_pmsg(m, line, ppos, MANDOCERR_SYNTNOSCOPE);  
                         return(0);  
                 }  
                 if (REWIND_REWIND == c)  
                         break;                          break;
                 else if (rew_dobreak(tok, n))                  case (REWIND_FORCE):
                           mdoc_vmsg(m, MANDOCERR_SCOPEBROKEN, line, ppos,
                               "%s breaks %s", mdoc_macronames[tok],
                               mdoc_macronames[n->tok]);
                           /* FALLTHROUGH */
                   case (REWIND_MORE):
                           n = n->parent;
                         continue;                          continue;
                 if ( ! swarn(m, t, line, ppos, n))                  case (REWIND_LATER):
                         return(0);                          if (make_pending(n, tok, m, line, ppos) ||
                               MDOC_BLOCK != t)
                                   return(1);
                           /* FALLTHROUGH */
                   case (REWIND_ERROR):
                           mdoc_pmsg(m, line, ppos, MANDOCERR_NOSCOPE);
                           return(1);
                   }
                   break;
         }          }
   
         assert(n);          assert(n);
         if ( ! rew_last(m, n))          if ( ! rew_last(m, n))
                 return(0);                  return(0);
   
 #ifdef  UGLY  
         /*          /*
          * The current block extends an enclosing block beyond a line           * The current block extends an enclosing block.
          * break.  Now that the current block ends, close the enclosing           * Now that the current block ends, close the enclosing block, too.
          * block, too.  
          */           */
         if (NULL != (n = n->pending)) {          while (NULL != (n = n->pending)) {
                 assert(MDOC_HEAD == n->type);  
                 if ( ! rew_last(m, n))                  if ( ! rew_last(m, n))
                         return(0);                          return(0);
                 if ( ! mdoc_body_alloc(m, n->line, n->pos, n->tok))                  if (MDOC_HEAD == n->type &&
                       ! mdoc_body_alloc(m, n->line, n->pos, n->tok))
                         return(0);                          return(0);
         }          }
 #endif  
   
         return(1);          return(1);
 }  }
Line 658  append_delims(struct mdoc *m, int line, int *pos, char
Line 604  append_delims(struct mdoc *m, int line, int *pos, char
                  * knowing which symbols break this behaviour, for                   * knowing which symbols break this behaviour, for
                  * example, `.  ;' shouldn't propogate the double-space.                   * example, `.  ;' shouldn't propogate the double-space.
                  */                   */
                 if (mandoc_eos(p, strlen(p)))                  if (mandoc_eos(p, strlen(p), 0))
                         m->last->flags |= MDOC_EOS;                          m->last->flags |= MDOC_EOS;
         }          }
   
Line 672  append_delims(struct mdoc *m, int line, int *pos, char
Line 618  append_delims(struct mdoc *m, int line, int *pos, char
 static int  static int
 blk_exp_close(MACRO_PROT_ARGS)  blk_exp_close(MACRO_PROT_ARGS)
 {  {
           struct mdoc_node *body;         /* Our own body. */
           struct mdoc_node *later;        /* A sub-block starting later. */
           struct mdoc_node *n;            /* For searching backwards. */
   
         int              j, lastarg, maxargs, flushed, nl;          int              j, lastarg, maxargs, flushed, nl;
         enum margserr    ac;          enum margserr    ac;
         enum mdoct       ntok;          enum mdoct       atok, ntok;
         char            *p;          char            *p;
   
         nl = MDOC_NEWLINE & m->flags;          nl = MDOC_NEWLINE & m->flags;
Line 688  blk_exp_close(MACRO_PROT_ARGS)
Line 638  blk_exp_close(MACRO_PROT_ARGS)
                 break;                  break;
         }          }
   
           /*
            * Search backwards for beginnings of blocks,
            * both of our own and of pending sub-blocks.
            */
           atok = rew_alt(tok);
           body = later = NULL;
           for (n = m->last; n; n = n->parent) {
                   if (MDOC_VALID & n->flags)
                           continue;
   
                   /* Remember the start of our own body. */
                   if (MDOC_BODY == n->type && atok == n->tok) {
                           if (ENDBODY_NOT == n->end)
                                   body = n;
                           continue;
                   }
   
                   if (MDOC_BLOCK != n->type || MDOC_Nm == n->tok)
                           continue;
                   if (atok == n->tok) {
                           assert(body);
   
                           /*
                            * Found the start of our own block.
                            * When there is no pending sub block,
                            * just proceed to closing out.
                            */
                           if (NULL == later)
                                   break;
   
                           /*
                            * When there is a pending sub block,
                            * postpone closing out the current block
                            * until the rew_sub() closing out the sub-block.
                            */
                           make_pending(later, tok, m, line, ppos);
   
                           /*
                            * Mark the place where the formatting - but not
                            * the scope - of the current block ends.
                            */
                           if ( ! mdoc_endbody_alloc(m, line, ppos,
                               atok, body, ENDBODY_SPACE))
                                   return(0);
                           break;
                   }
   
                   /*
                    * When finding an open sub block, remember the last
                    * open explicit block, or, in case there are only
                    * implicit ones, the first open implicit block.
                    */
                   if (later &&
                       MDOC_EXPLICIT & mdoc_macros[later->tok].flags)
                           continue;
                   if (MDOC_CALLABLE & mdoc_macros[n->tok].flags)
                           later = n;
           }
   
         if ( ! (MDOC_CALLABLE & mdoc_macros[tok].flags)) {          if ( ! (MDOC_CALLABLE & mdoc_macros[tok].flags)) {
                 /* FIXME: do this in validate */                  /* FIXME: do this in validate */
                 if (buf[*pos])                  if (buf[*pos])
Line 702  blk_exp_close(MACRO_PROT_ARGS)
Line 711  blk_exp_close(MACRO_PROT_ARGS)
         if ( ! rew_sub(MDOC_BODY, m, tok, line, ppos))          if ( ! rew_sub(MDOC_BODY, m, tok, line, ppos))
                 return(0);                  return(0);
   
         if (maxargs > 0)          if (NULL == later && maxargs > 0)
                 if ( ! mdoc_tail_alloc(m, line, ppos, rew_alt(tok)))                  if ( ! mdoc_tail_alloc(m, line, ppos, rew_alt(tok)))
                         return(0);                          return(0);
   
Line 776  in_line(MACRO_PROT_ARGS)
Line 785  in_line(MACRO_PROT_ARGS)
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
         case (MDOC_Fl):          case (MDOC_Fl):
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
         case (MDOC_Lk):          case (MDOC_Mt):
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
         case (MDOC_Nm):          case (MDOC_Nm):
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
Line 934  blk_full(MACRO_PROT_ARGS)
Line 943  blk_full(MACRO_PROT_ARGS)
         struct mdoc_arg  *arg;          struct mdoc_arg  *arg;
         struct mdoc_node *head; /* save of head macro */          struct mdoc_node *head; /* save of head macro */
         struct mdoc_node *body; /* save of body macro */          struct mdoc_node *body; /* save of body macro */
 #ifdef  UGLY  
         struct mdoc_node *n;          struct mdoc_node *n;
 #endif          enum mdoc_type    mtt;
         enum mdoct        ntok;          enum mdoct        ntok;
         enum margserr     ac, lac;          enum margserr     ac, lac;
         enum margverr     av;          enum margverr     av;
Line 1005  blk_full(MACRO_PROT_ARGS)
Line 1013  blk_full(MACRO_PROT_ARGS)
   
         for ( ; ; ) {          for ( ; ; ) {
                 la = *pos;                  la = *pos;
                 /* Initialise last-phrase-type with ARGS_PHRASE. */                  /* Initialise last-phrase-type with ARGS_PEND. */
                 lac = ARGS_ERROR == ac ? ARGS_PHRASE : ac;                  lac = ARGS_ERROR == ac ? ARGS_PEND : ac;
                 ac = mdoc_args(m, line, pos, buf, tok, &p);                  ac = mdoc_args(m, line, pos, buf, tok, &p);
   
                   if (ARGS_PUNCT == ac)
                           break;
   
                 if (ARGS_ERROR == ac)                  if (ARGS_ERROR == ac)
                         return(0);                          return(0);
                 if (ARGS_EOLN == ac)  
                   if (ARGS_EOLN == ac) {
                           if (ARGS_PPHRASE != lac && ARGS_PHRASE != lac)
                                   break;
                           /*
                            * This is necessary: if the last token on a
                            * line is a `Ta' or tab, then we'll get
                            * 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, m, tok, line, ppos))
                                   return(0);
                           if ( ! mdoc_body_alloc(m, line, ppos, tok))
                                   return(0);
                           body = m->last;
                         break;                          break;
                   }
   
                 /*                  /*
                  * Emit leading punctuation (i.e., punctuation before                   * Emit leading punctuation (i.e., punctuation before
Line 1030  blk_full(MACRO_PROT_ARGS)
Line 1057  blk_full(MACRO_PROT_ARGS)
                         continue;                          continue;
                 }                  }
   
                 /*                  /* Open a head if one hasn't been opened. */
                  * Open a head if one hasn't been opened. Re-open head  
                  * for phrases.  
                  */  
   
                 if (NULL == head ||                  if (NULL == head) {
                                 ARGS_PEND == ac ||  
                                 ARGS_PHRASE == ac ||  
                                 ARGS_PPHRASE == ac) {  
                         if ( ! mdoc_head_alloc(m, line, ppos, tok))                          if ( ! mdoc_head_alloc(m, line, ppos, tok))
                                 return(0);                                  return(0);
                         head = m->last;                          head = m->last;
Line 1048  blk_full(MACRO_PROT_ARGS)
Line 1069  blk_full(MACRO_PROT_ARGS)
                                 ARGS_PEND == ac ||                                  ARGS_PEND == ac ||
                                 ARGS_PPHRASE == ac) {                                  ARGS_PPHRASE == ac) {
                         /*                          /*
                            * If we haven't opened a body yet, rewind the
                            * head; if we have, rewind that instead.
                            */
   
                           mtt = body ? MDOC_BODY : MDOC_HEAD;
                           if ( ! rew_sub(mtt, m, tok, line, ppos))
                                   return(0);
   
                           /* Then allocate our body context. */
   
                           if ( ! mdoc_body_alloc(m, line, ppos, tok))
                                   return(0);
                           body = m->last;
   
                           /*
                          * Process phrases: set whether we're in a                           * Process phrases: set whether we're in a
                          * partial-phrase (this effects line handling)                           * partial-phrase (this effects line handling)
                          * then call down into the phrase parser.                           * then call down into the phrase parser.
                          */                           */
   
                         if (ARGS_PPHRASE == ac)                          if (ARGS_PPHRASE == ac)
                                 m->flags |= MDOC_PPHRASE;                                  m->flags |= MDOC_PPHRASE;
                         if (ARGS_PEND == ac && ARGS_PPHRASE == lac)                          if (ARGS_PEND == ac && ARGS_PPHRASE == lac)
                                 m->flags |= MDOC_PPHRASE;                                  m->flags |= MDOC_PPHRASE;
   
                         if (ARGS_PEND == ac) {                          if ( ! phrase(m, line, la, buf))
                                 if ( ! phrase(m, line, la, buf, lac))  
                                         return(0);  
                         } else if ( ! phrase(m, line, la, buf, ac))  
                                 return(0);                                  return(0);
   
                         m->flags &= ~MDOC_PPHRASE;                          m->flags &= ~MDOC_PPHRASE;
   
                         /* Close out active phrase. */  
   
                         if ( ! rew_sub(MDOC_HEAD, m, tok, line, ppos))  
                                 return(0);  
                         continue;                          continue;
                 }                  }
   
Line 1097  blk_full(MACRO_PROT_ARGS)
Line 1126  blk_full(MACRO_PROT_ARGS)
         /* If we've already opened our body, exit now. */          /* If we've already opened our body, exit now. */
   
         if (NULL != body)          if (NULL != body)
                 return(1);                  goto out;
   
 #ifdef  UGLY  
         /*          /*
          * If there is an open (i.e., unvalidated) sub-block requiring           * If there is an open (i.e., unvalidated) sub-block requiring
          * explicit close-out, postpone switching the current block from           * explicit close-out, postpone switching the current block from
Line 1110  blk_full(MACRO_PROT_ARGS)
Line 1138  blk_full(MACRO_PROT_ARGS)
                 if (MDOC_BLOCK == n->type &&                  if (MDOC_BLOCK == n->type &&
                                 MDOC_EXPLICIT & mdoc_macros[n->tok].flags &&                                  MDOC_EXPLICIT & mdoc_macros[n->tok].flags &&
                                 ! (MDOC_VALID & n->flags)) {                                  ! (MDOC_VALID & n->flags)) {
                         assert( ! (MDOC_ACTED & n->flags));  
                         n->pending = head;                          n->pending = head;
                         return(1);                          return(1);
                 }                  }
         }          }
 #endif  
   
         /* Close out scopes to remain in a consistent state. */          /* Close out scopes to remain in a consistent state. */
   
Line 1124  blk_full(MACRO_PROT_ARGS)
Line 1150  blk_full(MACRO_PROT_ARGS)
         if ( ! mdoc_body_alloc(m, line, ppos, tok))          if ( ! mdoc_body_alloc(m, line, ppos, tok))
                 return(0);                  return(0);
   
   out:
           if ( ! (MDOC_FREECOL & m->flags))
                   return(1);
   
           if ( ! rew_sub(MDOC_BODY, m, tok, line, ppos))
                   return(0);
           if ( ! rew_sub(MDOC_BLOCK, m, tok, line, ppos))
                   return(0);
   
           m->flags &= ~MDOC_FREECOL;
         return(1);          return(1);
 }  }
   
Line 1220  blk_part_imp(MACRO_PROT_ARGS)
Line 1256  blk_part_imp(MACRO_PROT_ARGS)
          */           */
   
         if (n && MDOC_TEXT == n->type && n->string)          if (n && MDOC_TEXT == n->type && n->string)
                 if (mandoc_eos(n->string, strlen(n->string)))                  if (mandoc_eos(n->string, strlen(n->string), 1))
                         n->flags |= MDOC_EOS;                          n->flags |= MDOC_EOS;
   
         /* Up-propogate the end-of-space flag. */          /* Up-propogate the end-of-space flag. */
Line 1230  blk_part_imp(MACRO_PROT_ARGS)
Line 1266  blk_part_imp(MACRO_PROT_ARGS)
                 body->parent->flags |= MDOC_EOS;                  body->parent->flags |= MDOC_EOS;
         }          }
   
           /*
            * 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 = m->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, m, line, ppos);
                           if ( ! mdoc_endbody_alloc(m, line, ppos,
                               tok, body, ENDBODY_NOSPACE))
                                   return(0);
                           return(1);
                   }
           }
   
         /*          /*
          * If we can't rewind to our body, then our scope has already           * If we can't rewind to our body, then our scope has already
          * been closed by another macro (like `Oc' closing `Op').  This           * been closed by another macro (like `Oc' closing `Op').  This
          * is ugly behaviour nodding its head to OpenBSD's overwhelming           * is ugly behaviour nodding its head to OpenBSD's overwhelming
          * crufty use of `Op' breakage.           * crufty use of `Op' breakage.
          *  
          * FIXME - this should be ifdef'd OpenBSD?  
          */           */
         for (n = m->last; n; n = n->parent)          if (n != body && ! mdoc_vmsg(m, MANDOCERR_SCOPENEST,
                 if (body == n)              line, ppos, "%s broken", mdoc_macronames[tok]))
                         break;  
   
         if (NULL == n && ! mdoc_nmsg(m, body, MANDOCERR_SCOPE))  
                 return(0);                  return(0);
   
         if (n && ! rew_last(m, body))          if (n && ! rew_sub(MDOC_BODY, m, tok, line, ppos))
                 return(0);                  return(0);
   
         /* Standard appending of delimiters. */          /* Standard appending of delimiters. */
Line 1255  blk_part_imp(MACRO_PROT_ARGS)
Line 1303  blk_part_imp(MACRO_PROT_ARGS)
   
         /* Rewind scope, if applicable. */          /* Rewind scope, if applicable. */
   
         if (n && ! rew_last(m, blk))          if (n && ! rew_sub(MDOC_BLOCK, m, tok, line, ppos))
                 return(0);                  return(0);
   
         return(1);          return(1);
Line 1523  in_line_eoln(MACRO_PROT_ARGS)
Line 1571  in_line_eoln(MACRO_PROT_ARGS)
   
         assert( ! (MDOC_PARSED & mdoc_macros[tok].flags));          assert( ! (MDOC_PARSED & mdoc_macros[tok].flags));
   
           if (tok == MDOC_Pp)
                   rew_sub(MDOC_BLOCK, m, MDOC_Nm, line, ppos);
   
         /* Parse macro arguments. */          /* Parse macro arguments. */
   
         for (arg = NULL; ; ) {          for (arg = NULL; ; ) {
Line 1586  ctx_synopsis(MACRO_PROT_ARGS)
Line 1637  ctx_synopsis(MACRO_PROT_ARGS)
         nl = MDOC_NEWLINE & m->flags;          nl = MDOC_NEWLINE & m->flags;
   
         /* If we're not in the SYNOPSIS, go straight to in-line. */          /* If we're not in the SYNOPSIS, go straight to in-line. */
         if (SEC_SYNOPSIS != m->lastsec)          if ( ! (MDOC_SYNOPSIS & m->flags))
                 return(in_line(m, tok, line, ppos, pos, buf));                  return(in_line(m, tok, line, ppos, pos, buf));
   
         /* If we're a nested call, same place. */          /* If we're a nested call, same place. */
Line 1598  ctx_synopsis(MACRO_PROT_ARGS)
Line 1649  ctx_synopsis(MACRO_PROT_ARGS)
          * up formatting the block scope, then child nodes will inherit           * up formatting the block scope, then child nodes will inherit
          * the formatting.  Be careful.           * the formatting.  Be careful.
          */           */
           if (MDOC_Nm == tok)
                   return(blk_full(m, tok, line, ppos, pos, buf));
           assert(MDOC_Vt == tok);
         return(blk_part_imp(m, tok, line, ppos, pos, buf));          return(blk_part_imp(m, tok, line, ppos, pos, buf));
 }  }
   
Line 1618  obsolete(MACRO_PROT_ARGS)
Line 1671  obsolete(MACRO_PROT_ARGS)
  * macro is encountered.   * macro is encountered.
  */   */
 static int  static int
 phrase(struct mdoc *m, int line, int ppos, char *buf, enum margserr ac)  phrase(struct mdoc *m, int line, int ppos, char *buf)
 {  {
         int              la, pos;          int              la, pos;
         enum margserr    aac;          enum margserr    ac;
         enum mdoct       ntok;          enum mdoct       ntok;
         char            *p;          char            *p;
   
         assert(ARGS_PHRASE == ac || ARGS_PPHRASE == ac);  
   
         for (pos = ppos; ; ) {          for (pos = ppos; ; ) {
                 la = pos;                  la = pos;
   
                 aac = mdoc_zargs(m, line, &pos, buf, 0, &p);                  ac = mdoc_zargs(m, line, &pos, buf, 0, &p);
   
                 if (ARGS_ERROR == aac)                  if (ARGS_ERROR == ac)
                         return(0);                          return(0);
                 if (ARGS_EOLN == aac)                  if (ARGS_EOLN == ac)
                         break;                          break;
   
                 ntok = ARGS_QWORD == aac ? MDOC_MAX : lookup_raw(p);                  ntok = ARGS_QWORD == ac ? MDOC_MAX : lookup_raw(p);
   
                 if (MDOC_MAX == ntok) {                  if (MDOC_MAX == ntok) {
                         if ( ! mdoc_word_alloc(m, line, la, p))                          if ( ! mdoc_word_alloc(m, line, la, p))
Line 1654  phrase(struct mdoc *m, int line, int ppos, char *buf, 
Line 1705  phrase(struct mdoc *m, int line, int ppos, char *buf, 
 }  }
   
   
   /* ARGSUSED */
   static int
   phrase_ta(MACRO_PROT_ARGS)
   {
           int               la;
           enum mdoct        ntok;
           enum margserr     ac;
           char             *p;
   
           /*
            * FIXME: this is overly restrictive: if the `Ta' is unexpected,
            * it should simply error out with ARGSLOST.
            */
   
           if ( ! rew_sub(MDOC_BODY, m, MDOC_It, line, ppos))
                   return(0);
           if ( ! mdoc_body_alloc(m, line, ppos, MDOC_It))
                   return(0);
   
           for (;;) {
                   la = *pos;
                   ac = mdoc_zargs(m, line, pos, buf, 0, &p);
   
                   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 ( ! mdoc_word_alloc(m, line, la, p))
                                   return(0);
                           continue;
                   }
   
                   if ( ! mdoc_macro(m, ntok, line, la, pos, buf))
                           return(0);
                   return(append_delims(m, line, pos, buf));
           }
   
           return(1);
   }
Legend:
Removed from v.1.73  
changed lines
  Added in v.1.98
CVSweb