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

Diff for /mandoc/Attic/validate.c between version 1.8 and 1.14

version 1.8, 2008/12/30 13:43:53 version 1.14, 2009/01/03 18:38:39
Line 17 
Line 17 
  * PERFORMANCE OF THIS SOFTWARE.   * PERFORMANCE OF THIS SOFTWARE.
  */   */
 #include <assert.h>  #include <assert.h>
 #include <ctype.h>  
 #include <stdlib.h>  #include <stdlib.h>
 #include <stdio.h>  
 #include <string.h>  
 #ifdef  __linux__  
 #include <time.h>  
 #endif  
   
 #include "private.h"  #include "private.h"
   
 /* FIXME: maxlineargs should be per LINE, no per TOKEN. */  /* FIXME: `.St' can only have one argument set. */
 /* FIXME: prologue check should be in macro_call. */  
   
 #define _CC(p)  ((const char **)p)  typedef int     (*v_args_sz)(struct mdoc *, int, int, int);
   typedef int     (*v_args)(struct mdoc *, int, int,
                           int, const char *[],
                           int, const struct mdoc_arg *);
   typedef int     (*v_tree)(struct mdoc *, int, int);
   
 static  int       scope_rewind_exp(struct mdoc *, int, int, int);  
 static  int       scope_rewind_imp(struct mdoc *, int, int);  
 static  int       append_text(struct mdoc *, int,  
                         int, int, char *[]);  
 static  int       append_const(struct mdoc *, int, int, int, char *[]);  
 static  int       append_constarg(struct mdoc *, int, int,  
                          int, const struct mdoc_arg *);  
 static  int       append_scoped(struct mdoc *, int, int, int,  
                         const char *[], int, const struct mdoc_arg *);  
 static  int       append_delims(struct mdoc *, int, int *, char *);  
   
   struct  valids {
           v_args_sz sz;
           v_args    args;
           v_tree    tree_pre;
           v_tree    tree_post;
   };
   
 static int  
 append_delims(struct mdoc *mdoc, int tok, int *pos, char *buf)  
 {  
         int              c, lastarg;  
         char            *p;  
   
         if (0 == buf[*pos])  static  int       assert_eq0(struct mdoc *, int, int, int);
                 return(1);  static  int       assert_le1(struct mdoc *, int, int, int);
   static  int       need_eq0(struct mdoc *, int, int, int);
   static  int       need_eq1(struct mdoc *, int, int, int);
   static  int       need_ge1(struct mdoc *, int, int, int);
   static  int       need_le2(struct mdoc *, int, int, int);
   static  int       want_eq0(struct mdoc *, int, int, int);
   static  int       want_ge1(struct mdoc *, int, int, int);
   
         mdoc_msg(mdoc, *pos, "`%s' flushing punctuation",  static  int       tree_pre_ref(struct mdoc *, int, int);
                         mdoc_macronames[tok]);  static  int       tree_pre_display(struct mdoc *, int, int);
   
         for (;;) {  static  int       tree_post_onlyhead(struct mdoc *, int, int);
                 lastarg = *pos;  static  int       tree_post_onlybody(struct mdoc *, int, int);
                 c = mdoc_args(mdoc, tok, pos, buf, 0, &p);  static  int       tree_post_warnemptybody(struct mdoc *, int, int);
                 if (ARGS_ERROR == c)  
                         return(0);  
                 else if (ARGS_EOLN == c)  
                         break;  
                 assert(mdoc_isdelim(p));  
                 mdoc_word_alloc(mdoc, lastarg, p);  
         }  
   
         return(1);  static  int       args_bool(struct mdoc *, int, int,
 }                          int, const char *[],
                           int, const struct mdoc_arg *);
   static  int       args_sh(struct mdoc *, int, int,
                           int, const char *[],
                           int, const struct mdoc_arg *);
   static  int       args_an(struct mdoc *, int, int,
                           int, const char *[],
                           int, const struct mdoc_arg *);
   static  int       args_nopunct(struct mdoc *, int, int,
                           int, const char *[],
                           int, const struct mdoc_arg *);
   static  int       args_xr(struct mdoc *, int, int,
                           int, const char *[],
                           int, const struct mdoc_arg *);
   
   
   const   struct valids mdoc_valids[MDOC_MAX] = {
           { NULL, NULL, NULL, NULL }, /* \" */
           { NULL, NULL, NULL, NULL }, /* Dd */ /* TODO */
           { NULL, NULL, NULL, NULL }, /* Dt */ /* TODO */
           { NULL, NULL, NULL, NULL }, /* Os */ /* TODO */
           { want_ge1, args_sh, NULL, NULL }, /* Sh */
           { want_ge1, NULL, NULL, NULL }, /* Ss */
           { want_eq0, NULL, NULL, NULL }, /* Pp */
           { assert_eq0, NULL, tree_pre_display, tree_post_onlyhead }, /* D1 */
           { assert_eq0, NULL, tree_pre_display, tree_post_onlyhead }, /* Dl */
           { want_eq0, NULL, tree_pre_display, tree_post_warnemptybody }, /* Bd */
           { assert_eq0, NULL, NULL, tree_post_onlybody }, /* Ed */
           { want_eq0, NULL, NULL, NULL }, /* Bl */
           { assert_eq0, NULL, NULL, tree_post_onlybody }, /* El */
           { NULL, NULL, NULL, NULL }, /* It */
           { need_ge1, NULL, NULL, NULL }, /* Ad */
           { NULL, args_an, NULL, NULL }, /* An */
           { NULL, NULL, NULL, NULL }, /* Ar */
           { need_ge1, NULL, NULL, NULL }, /* Cd */
           { NULL, NULL, NULL, NULL }, /* Cm */
           { need_ge1, NULL, NULL, NULL }, /* Dv */
           { need_ge1, NULL, NULL, NULL }, /* Er */
           { need_ge1, NULL, NULL, NULL }, /* Ev */
           { NULL, NULL, NULL, NULL }, /* Ex */
           { need_ge1, NULL, NULL, NULL }, /* Fa */
           { NULL, NULL, NULL, NULL }, /* Fd */
           { NULL, NULL, NULL, NULL }, /* Fl */
           { need_ge1, NULL, NULL, NULL }, /* Fn */
           { want_ge1, NULL, NULL, NULL }, /* Ft */
           { need_ge1, NULL, NULL, NULL }, /* Ic */
           { need_eq1, NULL, NULL, NULL }, /* In */
           { want_ge1, NULL, NULL, NULL }, /* Li */
           { want_ge1, NULL, NULL, NULL }, /* Nd */
           { NULL, NULL, NULL, NULL }, /* Nm */
           { NULL, NULL, NULL, NULL }, /* Op */
           { NULL, NULL, NULL, NULL }, /* Ot */
           { want_ge1, NULL, NULL, NULL }, /* Pa */
           { NULL, NULL, NULL, NULL }, /* Rv */
           { NULL, NULL, NULL, NULL }, /* St */
           { need_ge1, NULL, NULL, NULL }, /* Va */
           { need_ge1, NULL, NULL, NULL }, /* Vt */
           { need_le2, args_xr, NULL, NULL }, /* Xr */
           { need_ge1, NULL, tree_pre_ref, NULL }, /* %A */
           { need_ge1, NULL, tree_pre_ref, NULL }, /* %B */
           { need_ge1, NULL, tree_pre_ref, NULL }, /* %D */
           { need_ge1, NULL, tree_pre_ref, NULL }, /* %I */
           { need_ge1, NULL, tree_pre_ref, NULL }, /* %J */
           { need_ge1, NULL, tree_pre_ref, NULL }, /* %N */
           { need_ge1, NULL, tree_pre_ref, NULL }, /* %O */
           { need_ge1, NULL, tree_pre_ref, NULL }, /* %P */
           { need_ge1, NULL, tree_pre_ref, NULL }, /* %R */
           { need_ge1, NULL, tree_pre_ref, NULL }, /* %T */
           { need_ge1, NULL, tree_pre_ref, NULL }, /* %V */
           { NULL, NULL, NULL, NULL }, /* Ac */
           { NULL, NULL, NULL, NULL }, /* Ao */
           { NULL, NULL, NULL, NULL }, /* Aq */
           { need_le2, args_nopunct, NULL, NULL }, /* At */
           { NULL, NULL, NULL, NULL }, /* Bc */
           { NULL, NULL, NULL, NULL }, /* Bf */
           { NULL, NULL, NULL, NULL }, /* Bo */
           { NULL, NULL, NULL, NULL }, /* Bq */
           { assert_le1, NULL, NULL, NULL }, /* Bsx */
           { assert_le1, NULL, NULL, NULL }, /* Bx */
           { need_eq1, args_bool, NULL, NULL }, /* Db */
           { NULL, NULL, NULL, NULL }, /* Dc */
           { NULL, NULL, NULL, NULL }, /* Do */
           { NULL, NULL, NULL, NULL }, /* Dq */
           { NULL, NULL, NULL, NULL }, /* Ec */
           { NULL, NULL, NULL, NULL }, /* Ef */ /* -symbolic, etc. */
           { need_ge1, NULL, NULL, NULL }, /* Em */
           { NULL, NULL, NULL, NULL }, /* Eo */
           { assert_le1, NULL, NULL, NULL }, /* Fx */
           { want_ge1, NULL, NULL, NULL }, /* Ms */
           { NULL, NULL, NULL, NULL }, /* No */
           { NULL, NULL, NULL, NULL }, /* Ns */
           { assert_le1, NULL, NULL, NULL }, /* Nx */
           { assert_le1, NULL, NULL, NULL }, /* Ox */
           { NULL, NULL, NULL, NULL }, /* Pc */
           { NULL, NULL, NULL, NULL }, /* Pf */ /* 2 or more arguments */
           { NULL, NULL, NULL, NULL }, /* Po */
           { NULL, NULL, NULL, NULL }, /* Pq */
           { NULL, NULL, NULL, NULL }, /* Qc */
           { NULL, NULL, NULL, NULL }, /* Ql */
           { NULL, NULL, NULL, NULL }, /* Qo */
           { NULL, NULL, NULL, NULL }, /* Qq */
           { NULL, NULL, NULL, NULL }, /* Re */
           { NULL, NULL, NULL, NULL }, /* Rs */
           { NULL, NULL, NULL, NULL }, /* Sc */
           { NULL, NULL, NULL, NULL }, /* So */
           { NULL, NULL, NULL, NULL }, /* Sq */
           { need_eq1, args_bool, NULL, NULL }, /* Sm */
           { need_ge1, NULL, NULL, NULL }, /* Sx */
           { need_ge1, NULL, NULL, NULL }, /* Sy */
           { want_ge1, NULL, NULL, NULL }, /* Tn */
           { assert_eq0, NULL, NULL, NULL }, /* Ux */
           { NULL, NULL, NULL, NULL }, /* Xc */
           { NULL, NULL, NULL, NULL }, /* Xo */
           { NULL, NULL, NULL, NULL }, /* Fo */
           { NULL, NULL, NULL, NULL }, /* Fc */
           { NULL, NULL, NULL, NULL }, /* Oo */
           { NULL, NULL, NULL, NULL }, /* Oc */
           { NULL, NULL, NULL, NULL }, /* Bk */
           { NULL, NULL, NULL, NULL }, /* Ek */
           { need_eq0, NULL, NULL, NULL }, /* Bt */
           { need_eq1, NULL, NULL, NULL }, /* Hf */
           { NULL, NULL, NULL, NULL }, /* Fr */
           { need_eq0, NULL, NULL, NULL }, /* Ud */
   };
   
   
 static int  static int
 scope_rewind_imp(struct mdoc *mdoc, int ppos, int tok)  need_le2(struct mdoc *mdoc, int tok, int pos, int sz)
 {  {
         struct mdoc_node *n;          if (sz <= 2)
         int               t;                  return(1);
           return(mdoc_err(mdoc, tok, pos, ERR_ARGS_LE2));
   }
   
         n = mdoc->last ? mdoc->last->parent : NULL;  
   
         /* LINTED */  static int
         for ( ; n; n = n->parent) {  want_ge1(struct mdoc *mdoc, int tok, int pos, int sz)
                 if (MDOC_BLOCK != n->type)  {
                         continue;          if (sz > 0)
                 if (tok == (t = n->data.block.tok))  
                         break;  
                 if ( ! (MDOC_EXPLICIT & mdoc_macros[t].flags))  
                         continue;  
                 return(mdoc_err(mdoc, tok, ppos, ERR_SCOPE_BREAK));  
         }  
   
         if (n) {  
                 mdoc->last = n;  
                 mdoc_msg(mdoc, ppos, "scope: rewound implicit `%s'",  
                                 mdoc_macronames[tok]);  
                 return(1);                  return(1);
         }          return(mdoc_warn(mdoc, tok, pos, WARN_ARGS_GE1));
   
         mdoc_msg(mdoc, ppos, "scope: new implicit `%s'",  
                         mdoc_macronames[tok]);  
         return(1);  
 }  }
   
   
 static int  static int
 scope_rewind_exp(struct mdoc *mdoc, int ppos, int tok, int dst)  want_eq0(struct mdoc *mdoc, int tok, int pos, int sz)
 {  {
         struct mdoc_node *n;          if (sz == 0)
                   return(1);
           return(mdoc_warn(mdoc, tok, pos, WARN_ARGS_EQ0));
   }
   
         assert(mdoc->last);  
   
         /* LINTED */  static int
         for (n = mdoc->last->parent; n; n = n->parent) {  need_eq0(struct mdoc *mdoc, int tok, int pos, int sz)
                 if (MDOC_BLOCK != n->type)  {
                         continue;          if (sz == 0)
                 if (dst == n->data.block.tok)                  return(1);
                         break;          return(mdoc_err(mdoc, tok, pos, ERR_ARGS_EQ0));
                 return(mdoc_err(mdoc, tok, ppos, ERR_SCOPE_BREAK));  
         }  
   
         if (NULL == (mdoc->last = n))  
                 return(mdoc_err(mdoc, tok, ppos, ERR_SCOPE_NOCTX));  
   
         mdoc_msg(mdoc, ppos, "scope: rewound explicit `%s' to `%s'",  
                         mdoc_macronames[tok], mdoc_macronames[dst]);  
   
         return(1);  
 }  }
   
   
 static int  static int
 append_constarg(struct mdoc *mdoc, int tok, int pos,  assert_le1(struct mdoc *mdoc, int tok, int pos, int sz)
                 int argc, const struct mdoc_arg *argv)  
 {  {
   
         switch (tok) {          assert(sz <= 1);
         default:  
                 break;  
         }  
   
         mdoc_elem_alloc(mdoc, pos, tok, argc, argv, 0, NULL);  
         return(1);          return(1);
 }  }
   
   
 /*  
  * Append a node with implicit or explicit scoping ONLY.  ALL macros  
  * with the implicit- or explicit-scope callback must be included here.  
  */  
 static int  static int
 append_scoped(struct mdoc *mdoc, int tok, int pos,  assert_eq0(struct mdoc *mdoc, int tok, int pos, int sz)
                 int sz, const char *args[],  
                 int argc, const struct mdoc_arg *argv)  
 {  {
         enum mdoc_sec     sec;  
         struct mdoc_node *node;  
   
         switch (tok) {          assert(sz == 0);
          /* ======= ADD MORE MACRO CHECKS BELOW. ======= */  
   
         case (MDOC_Sh):  
                 /*  
                  * Check rules for section ordering.  We can have  
                  * "known" sections (like NAME and so on) and "custom"  
                  * sections, which are unknown.  If we have a known  
                  * section, we should fall within the conventional  
                  * section order.  
                  */  
                 if (0 == sz)  
                         return(mdoc_err(mdoc, tok, pos, ERR_ARGS_GE1));  
   
                 sec = mdoc_atosec((size_t)sz, _CC(args));  
                 if (SEC_CUSTOM != sec && sec < mdoc->sec_lastn)  
                         if ( ! mdoc_warn(mdoc, tok, pos, WARN_SEC_OO))  
                                 return(0);  
   
                 if (SEC_BODY == mdoc->sec_last && SEC_NAME != sec)  
                         return(mdoc_err(mdoc, tok, pos, ERR_SEC_NAME));  
                 if (SEC_CUSTOM != sec)  
                         mdoc->sec_lastn = sec;  
                 mdoc->sec_last = sec;  
                 break;  
   
         case (MDOC_Ss):  
                 if (0 != sz)  
                         break;  
                 return(mdoc_err(mdoc, tok, pos, ERR_ARGS_GE1));  
   
         case (MDOC_Bd):  
                 /*  
                  * We can't be nested within any other block displays  
                  * (or really any other kind of display, although Bd is  
                  * the only multi-line one that will show up).  
                  */  
                 assert(mdoc->last);  
                 node = mdoc->last->parent;  
                 /* LINTED */  
                 for ( ; node; node = node->parent) {  
                         if (node->type != MDOC_BLOCK)  
                                 continue;  
                         if (node->data.block.tok != MDOC_Bd)  
                                 continue;  
                         break;  
                 }  
                 if (NULL == node)  
                         break;  
                 return(mdoc_err(mdoc, tok, pos, ERR_SCOPE_NONEST));  
   
         case (MDOC_Bl):  
                 break;  
   
          /* ======= ADD MORE MACRO CHECKS ABOVE. ======= */  
         default:  
                 abort();  
                 /* NOTREACHED */  
         }  
   
         mdoc_block_alloc(mdoc, pos, tok, (size_t)argc, argv);  
         mdoc_head_alloc(mdoc, pos, tok, (size_t)sz, _CC(args));  
         mdoc_body_alloc(mdoc, pos, tok);  
         return(1);          return(1);
 }  }
   
   
 static int  static int
 append_const(struct mdoc *mdoc, int tok,  need_eq1(struct mdoc *mdoc, int tok, int pos, int sz)
                 int pos, int sz, char *args[])  
 {  {
           if (sz == 1)
         switch (tok) {  
          /* ======= ADD MORE MACRO CHECKS BELOW. ======= */  
   
         /* FIXME: this is the ugliest part of this page. */  
         case (MDOC_At):  
                 /* This needs special handling. */  
                 if (0 == sz)  
                         break;  
                 else if (sz > 2)  
                         return(mdoc_err(mdoc, tok, pos, ERR_ARGS_LE2));  
   
                 if (ATT_DEFAULT != mdoc_atoatt(args[0])) {  
                         mdoc_elem_alloc(mdoc, pos, tok, 0,  
                                         NULL, 1, _CC(&args[0]));  
                 } else {  
                         mdoc_elem_alloc(mdoc, pos, tok,  
                                         0, NULL, 0, NULL);  
                         if (mdoc_isdelim(args[0]))  
                                 return(mdoc_err(mdoc, tok, pos, ERR_SYNTAX_NOPUNCT));  
                         mdoc_word_alloc(mdoc, pos, args[0]);  
                 }  
   
                 if (1 == sz)  
                         return(1);  
                 if (mdoc_isdelim(args[1]))  
                         return(mdoc_err(mdoc, tok, pos, ERR_SYNTAX_NOPUNCT));  
                 mdoc_word_alloc(mdoc, pos, args[1]);  
                 return(1);                  return(1);
           return(mdoc_err(mdoc, tok, pos, ERR_ARGS_EQ1));
         case (MDOC_Nd):  
                 if (sz > 0)  
                         break;  
                 if ( ! mdoc_warn(mdoc, tok, pos, WARN_ARGS_GE1))  
                         return(0);  
                 break;  
   
         case (MDOC_Hf):  
                 if (1 == sz)  
                         break;  
                 return(mdoc_err(mdoc, tok, pos, ERR_ARGS_EQ1));  
   
         case (MDOC_Bx):  
                 /* FALLTHROUGH */  
         case (MDOC_Bsx):  
                 /* FALLTHROUGH */  
         case (MDOC_Os):  
                 /* FALLTHROUGH */  
         case (MDOC_Fx):  
                 /* FALLTHROUGH */  
         case (MDOC_Nx):  
                 assert(sz <= 1);  
                 break;  
   
         case (MDOC_Ux):  
                 assert(0 == sz);  
                 break;  
   
         case (MDOC_Bt):  
                 /* FALLTHROUGH */  
         case (MDOC_Ud):  
                 if (0 == sz)  
                         break;  
                 return(mdoc_err(mdoc, tok, pos, ERR_ARGS_EQ0));  
   
          /* ======= ADD MORE MACRO CHECKS ABOVE. ======= */  
         default:  
                 abort();  
                 /* NOTREACHED */  
         }  
   
         mdoc_elem_alloc(mdoc, pos, tok, 0, NULL, (size_t)sz, _CC(args));  
         return(1);  
 }  }
   
   
 static int  static int
 append_text(struct mdoc *mdoc, int tok,  need_ge1(struct mdoc *mdoc, int tok, int pos, int sz)
                 int pos, int sz, char *args[])  
 {  {
           if (sz > 0)
         switch (tok) {                  return(1);
          /* ======= ADD MORE MACRO CHECKS BELOW. ======= */          return(mdoc_err(mdoc, tok, pos, ERR_ARGS_GE1));
         case (MDOC_Pp):  
                 if (0 == sz)  
                         break;  
                 if ( ! mdoc_warn(mdoc, tok, pos, WARN_ARGS_EQ0))  
                         return(0);  
                 break;  
   
         case (MDOC_Ft):  
                 /* FALLTHROUGH */  
         case (MDOC_Li):  
                 /* FALLTHROUGH */  
         case (MDOC_Ms):  
                 /* FALLTHROUGH */  
         case (MDOC_Pa):  
                 /* FALLTHROUGH */  
         case (MDOC_Tn):  
                 if (0 < sz)  
                         break;  
                 if ( ! mdoc_warn(mdoc, tok, pos, WARN_ARGS_GE1))  
                         return(0);  
                 break;  
   
         case (MDOC_Ar):  
                 /* FALLTHROUGH */  
         case (MDOC_Cm):  
                 /* FALLTHROUGH */  
         case (MDOC_Fl):  
                 /* These can have no arguments. */  
                 break;  
   
         case (MDOC_Ad):  
                 /* FALLTHROUGH */  
         case (MDOC_Em):  
                 /* FALLTHROUGH */  
         case (MDOC_Er):  
                 /* FALLTHROUGH */  
         case (MDOC_Ev):  
                 /* FALLTHROUGH */  
         case (MDOC_Fa):  
                 /* FALLTHROUGH */  
         case (MDOC_Dv):  
                 /* FALLTHROUGH */  
         case (MDOC_Ic):  
                 /* FALLTHROUGH */  
         case (MDOC_Sy):  
                 /* FALLTHROUGH */  
         case (MDOC_Sx):  
                 /* FALLTHROUGH */  
         case (MDOC_Va):  
                 /* FALLTHROUGH */  
         case (MDOC_Vt):  
                 if (0 < sz)  
                         break;  
                 return(mdoc_err(mdoc, tok, pos, ERR_ARGS_GE1));  
          /* ======= ADD MORE MACRO CHECKS ABOVE. ======= */  
         default:  
                 abort();  
                 /* NOTREACHED */  
         }  
   
         mdoc_elem_alloc(mdoc, pos, tok, 0, NULL, (size_t)sz, _CC(args));  
         return(1);  
 }  }
   
   
 int  static int
 macro_text(MACRO_PROT_ARGS)  tree_post_onlybody(struct mdoc *mdoc, int tok, int pos)
 {  {
         int               lastarg, lastpunct, c, j;          struct mdoc_node *n;
         char             *args[MDOC_LINEARG_MAX];  
   
         if (SEC_PROLOGUE == mdoc->sec_lastn)          assert(mdoc->last);
                 return(mdoc_err(mdoc, tok, ppos, ERR_SEC_PROLOGUE));          n = mdoc->last;
   
         /* Token pre-processing.  */          assert(MDOC_BLOCK == n->type);
           assert(n->child);
   
         switch (tok) {          if (MDOC_BODY == n->child->type) {
         case (MDOC_Pp):                  if (n->child->child)
                 /* `.Pp' ignored when following `.Sh' or `.Ss'. */  
                 assert(mdoc->last);  
                 if (MDOC_BODY != mdoc->last->type)  
                         break;  
                 switch (mdoc->last->data.body.tok) {  
                 case (MDOC_Ss):  
                         /* FALLTHROUGH */  
                 case (MDOC_Sh):  
                         if ( ! mdoc_warn(mdoc, tok, ppos, WARN_IGN_AFTER_BLK))  
                                 return(0);  
                         return(1);                          return(1);
                 default:                  return(mdoc_err(mdoc, tok, pos, ERR_SYNTAX_EMPTYBODY));
                         break;  
                 }  
                 break;  
         default:  
                 break;  
         }          }
   
         /* Process line parameters. */          return(mdoc_err(mdoc, tok, pos, ERR_SYNTAX_CHILDBODY));
   
         j = 0;  
         lastarg = ppos;  
         lastpunct = 0;  
   
 again:  
         if (j == MDOC_LINEARG_MAX)  
                 return(mdoc_err(mdoc, tok, lastarg, ERR_ARGS_MANY));  
   
         /*  
          * Parse out the next argument, unquoted and unescaped.   If  
          * we're a word (which may be punctuation followed eventually by  
          * a real word), then fall into checking for callables.  If  
          * only punctuation remains and we're the first, then flush  
          * arguments, punctuation and exit; else, return to the caller.  
          */  
   
         lastarg = *pos;  
   
         switch (mdoc_args(mdoc, tok, pos, buf, ARGS_DELIM, &args[j])) {  
         case (ARGS_ERROR):  
                 return(0);  
         case (ARGS_WORD):  
                 break;  
         case (ARGS_PUNCT):  
                 if ( ! lastpunct && ! append_text(mdoc, tok, ppos, j, args))  
                         return(0);  
                 if (ppos > 1)  
                         return(1);  
                 return(append_delims(mdoc, tok, pos, buf));  
         case (ARGS_EOLN):  
                 if (lastpunct)  
                         return(1);  
                 return(append_text(mdoc, tok, ppos, j, args));  
         default:  
                 abort();  
                 /* NOTREACHED */  
         }  
   
         /*  
          * Command found.  First flush out arguments, then call the  
          * command.  If we're the line macro when it exits, flush  
          * terminal punctuation.  
          */  
   
         if (MDOC_MAX != (c = mdoc_find(mdoc, args[j]))) {  
                 if ( ! lastpunct && ! append_text(mdoc, tok, ppos, j, args))  
                         return(0);  
                 if ( ! mdoc_macro(mdoc, c, lastarg, pos, buf))  
                         return(0);  
                 if (ppos > 1)  
                         return(1);  
                 return(append_delims(mdoc, tok, pos, buf));  
         }  
   
         /* Word/non-term-punctuation found. */  
   
         if ( ! mdoc_isdelim(args[j])) {  
                 /* Words are appended to the array of arguments. */  
                 j++;  
                 lastpunct = 0;  
                 goto again;  
         }  
   
         /*  
          * For punctuation, flush all collected words, then flush  
          * punctuation, then start collecting again.   Of course, this  
          * is non-terminal punctuation.  
          */  
   
         if ( ! lastpunct && ! append_text(mdoc, tok, ppos, j, args))  
                 return(0);  
   
         mdoc_word_alloc(mdoc, lastarg, args[j]);  
         j = 0;  
         lastpunct = 1;  
   
         goto again;  
         /* NOTREACHED */  
 }  }
   
   
 int  static int
 macro_prologue_dtitle(MACRO_PROT_ARGS)  tree_post_warnemptybody(struct mdoc *mdoc, int tok, int pos)
 {  {
         int               lastarg, j;          struct mdoc_node *n;
         char             *args[MDOC_LINEARG_MAX];  
   
         if (SEC_PROLOGUE != mdoc->sec_lastn)          assert(mdoc->last);
                 return(mdoc_err(mdoc, tok, ppos, ERR_SEC_NPROLOGUE));          n = mdoc->last;
         if (0 == mdoc->meta.date)  
                 return(mdoc_err(mdoc, tok, ppos, ERR_SEC_PROLOGUE_OO));  
         if (mdoc->meta.title[0])  
                 return(mdoc_err(mdoc, tok, ppos, ERR_SEC_PROLOGUE_REP));  
   
         j = -1;          assert(MDOC_BLOCK == n->type);
         lastarg = ppos;          assert(n->child);
   
 again:          for (n = n->child; n; n = n->next)
         if (j == MDOC_LINEARG_MAX)                  if (MDOC_BODY == n->type)
                 return(mdoc_err(mdoc, tok, lastarg, ERR_ARGS_MANY));                          break;
   
         lastarg = *pos;          if (n && n->child)
   
         switch (mdoc_args(mdoc, tok, pos, buf, 0, &args[++j])) {  
         case (ARGS_EOLN):  
                 if (mdoc->meta.title)  
                         return(1);  
                 if ( ! mdoc_warn(mdoc, tok, ppos, WARN_ARGS_GE1))  
                         return(0);  
                 (void)xstrlcpy(mdoc->meta.title,  
                                 "UNTITLED", META_TITLE_SZ);  
                 return(1);                  return(1);
         case (ARGS_ERROR):          return(mdoc_warn(mdoc, tok, pos, WARN_SYNTAX_EMPTYBODY));
                 return(0);  
         default:  
                 break;  
         }  
   
         if (MDOC_MAX != mdoc_find(mdoc, args[j]) && ! mdoc_warn  
                         (mdoc, tok, lastarg, WARN_SYNTAX_MACLIKE))  
                 return(0);  
   
         if (0 == j) {  
                 if (xstrlcpy(mdoc->meta.title, args[0], META_TITLE_SZ))  
                         goto again;  
                 return(mdoc_err(mdoc, tok, lastarg, ERR_SYNTAX_ARGFORM));  
   
         } else if (1 == j) {  
                 mdoc->meta.msec = mdoc_atomsec(args[1]);  
                 if (MSEC_DEFAULT != mdoc->meta.msec)  
                         goto again;  
                 return(mdoc_err(mdoc, tok, -1, ERR_SYNTAX_ARGFORM));  
   
         } else if (2 == j) {  
                 mdoc->meta.vol = mdoc_atovol(args[2]);  
                 if (VOL_DEFAULT != mdoc->meta.vol)  
                         goto again;  
                 mdoc->meta.arch = mdoc_atoarch(args[2]);  
                 if (ARCH_DEFAULT != mdoc->meta.arch)  
                         goto again;  
                 return(mdoc_err(mdoc, tok, lastarg, ERR_SYNTAX_ARGFORM));  
         }  
   
         return(mdoc_err(mdoc, tok, lastarg, ERR_ARGS_MANY));  
 }  }
   
   
 int  static int
 macro_prologue_os(MACRO_PROT_ARGS)  tree_post_onlyhead(struct mdoc *mdoc, int tok, int pos)
 {  {
         int               lastarg, j;          struct mdoc_node *n;
         char             *args[MDOC_LINEARG_MAX];  
   
         if (SEC_PROLOGUE != mdoc->sec_lastn)          assert(mdoc->last);
                 return(mdoc_err(mdoc, tok, ppos, ERR_SEC_NPROLOGUE));          n = mdoc->last;
         if (0 == mdoc->meta.title[0])  
                 return(mdoc_err(mdoc, tok, ppos, ERR_SEC_PROLOGUE_OO));  
         if (mdoc->meta.os[0])  
                 return(mdoc_err(mdoc, tok, ppos, ERR_SEC_PROLOGUE_REP));  
   
         j = -1;          assert(MDOC_BLOCK == n->type);
         lastarg = ppos;          assert(n->child);
   
 again:          n = n->child;
         if (j == MDOC_LINEARG_MAX)  
                 return(mdoc_err(mdoc, tok, lastarg, ERR_ARGS_MANY));  
   
         lastarg = *pos;          if (MDOC_HEAD != n->type)
                   return(mdoc_err(mdoc, tok, pos, ERR_SYNTAX_CHILDHEAD));
         switch (mdoc_args(mdoc, tok, pos, buf,          if (n->child)
                                 ARGS_QUOTED, &args[++j])) {  
         case (ARGS_EOLN):  
                 mdoc->sec_lastn = mdoc->sec_last = SEC_BODY;  
                 return(1);                  return(1);
         case (ARGS_ERROR):          return(mdoc_err(mdoc, tok, pos, ERR_SYNTAX_EMPTYHEAD));
                 return(0);  
         default:  
                 break;  
         }  
   
         if ( ! xstrlcat(mdoc->meta.os, args[j], sizeof(mdoc->meta.os)))  
                 return(mdoc_err(mdoc, tok, lastarg, ERR_SYNTAX_ARGFORM));  
         if ( ! xstrlcat(mdoc->meta.os, " ", sizeof(mdoc->meta.os)))  
                 return(mdoc_err(mdoc, tok, lastarg, ERR_SYNTAX_ARGFORM));  
   
         goto again;  
         /* NOTREACHED */  
 }  }
   
   
 int  static int
 macro_prologue_ddate(MACRO_PROT_ARGS)  args_an(struct mdoc *mdoc, int tok, int pos,
                   int sz, const char *args[],
                   int argc, const struct mdoc_arg *argv)
 {  {
         int               lastarg, j;  
         char             *args[MDOC_LINEARG_MAX], date[64];  
   
         if (SEC_PROLOGUE != mdoc->sec_lastn)          printf("argc=%d, sz=%d\n", argc, sz);
                 return(mdoc_err(mdoc, tok, ppos, ERR_SEC_NPROLOGUE));          if (0 != argc && 0 != sz)
         if (mdoc->meta.title[0])                  return(mdoc_warn(mdoc, tok, pos, WARN_ARGS_EQ0));
                 return(mdoc_err(mdoc, tok, ppos, ERR_SEC_PROLOGUE_OO));          return(1);
         if (mdoc->meta.date)  }
                 return(mdoc_err(mdoc, tok, ppos, ERR_SEC_PROLOGUE_REP));  
   
         j = -1;  
         date[0] = 0;  
         lastarg = ppos;  
   
 again:  static int
         if (j == MDOC_LINEARG_MAX)  args_sh(struct mdoc *mdoc, int tok, int pos,
                 return(mdoc_err(mdoc, tok, lastarg, ERR_ARGS_MANY));                  int sz, const char *args[],
                   int argc, const struct mdoc_arg *argv)
   {
           enum mdoc_sec    sec;
   
         lastarg = *pos;          sec = mdoc_atosec((size_t)sz, args);
         switch (mdoc_args(mdoc, tok, pos, buf, 0, &args[++j])) {          if (SEC_CUSTOM != sec && sec < mdoc->sec_lastn)
         case (ARGS_EOLN):                  if ( ! mdoc_warn(mdoc, tok, pos, WARN_SEC_OO))
                 if (mdoc->meta.date)                          return(0);
                         return(1);          if (SEC_BODY == mdoc->sec_last && SEC_NAME != sec)
                 mdoc->meta.date = mdoc_atotime(date);                  return(mdoc_err(mdoc, tok, pos, ERR_SEC_NAME));
                 if (mdoc->meta.date)  
                         return(1);  
                 return(mdoc_err(mdoc, tok, ppos, ERR_SYNTAX_ARGFORM));  
         case (ARGS_ERROR):  
                 return(0);  
         default:  
                 break;  
         }  
   
         if (MDOC_MAX != mdoc_find(mdoc, args[j]) && ! mdoc_warn  
                         (mdoc, tok, lastarg, WARN_SYNTAX_MACLIKE))  
                 return(0);  
   
         if (0 == j) {  
                 if (xstrcmp("$Mdocdate$", args[j])) {  
                         mdoc->meta.date = time(NULL);  
                         goto again;  
                 } else if (xstrcmp("$Mdocdate:", args[j]))  
                         goto again;  
         } else if (4 == j)  
                 if ( ! xstrcmp("$", args[j]))  
                         goto again;  
   
         if ( ! xstrlcat(date, args[j], sizeof(date)))          return(1);
                 return(mdoc_err(mdoc, tok, lastarg, ERR_SYNTAX_ARGFORM));  
         if ( ! xstrlcat(date, " ", sizeof(date)))  
                 return(mdoc_err(mdoc, tok, lastarg, ERR_SYNTAX_ARGFORM));  
   
         goto again;  
         /* NOTREACHED */  
 }  }
   
   
 int  static int
 macro_scoped_explicit(MACRO_PROT_ARGS)  args_bool(struct mdoc *mdoc, int tok, int pos,
                   int sz, const char *args[],
                   int argc, const struct mdoc_arg *argv)
 {  {
         int               c, lastarg, j;          int              i;
         struct mdoc_arg   argv[MDOC_LINEARG_MAX];  
         struct mdoc_node *n;  
   
         if (SEC_PROLOGUE == mdoc->sec_lastn)          for (i = 0; i < sz; i++) {
                 return(mdoc_err(mdoc, tok, ppos, ERR_SEC_PROLOGUE));                  if (xstrcmp(args[i], "on"))
   
         /*  
          * First close out the explicit scope.  The `end' tags (such as  
          * `.El' to `.Bl' don't cause anything to happen: we merely  
          * readjust our last parse point.  
          */  
   
         switch (tok) {  
         case (MDOC_El):  
                 return(scope_rewind_exp(mdoc, ppos, tok, MDOC_Bl));  
         case (MDOC_Ed):  
                 return(scope_rewind_exp(mdoc, ppos, tok, MDOC_Bd));  
         default:  
                 break;  
         }  
   
         assert(MDOC_EXPLICIT & mdoc_macros[tok].flags);  
   
         /* Token pre-processing. */  
   
         switch (tok) {  
         case (MDOC_Bl):  
                 /* FALLTHROUGH */  
         case (MDOC_Bd):  
                 /* `.Pp' ignored when preceding `.Bl' or `.Bd'. */  
                 assert(mdoc->last);  
                 if (MDOC_ELEM != mdoc->last->type)  
                         break;  
                 if (MDOC_Pp != mdoc->last->data.elem.tok)  
                         break;  
                 if ( ! mdoc_warn(mdoc, tok, ppos, WARN_IGN_BEFORE_BLK))  
                         return(0);  
                 assert(mdoc->last->prev);  
                 n = mdoc->last;  
                 mdoc->last = mdoc->last->prev;  
                 mdoc->last->next = NULL;  
                 mdoc_node_free(n);  
                 break;  
         default:  
                 break;  
         }  
   
         lastarg = *pos;  
   
         for (j = 0; j < MDOC_LINEARG_MAX; j++) {  
                 lastarg = *pos;  
                 c = mdoc_argv(mdoc, tok, &argv[j], pos, buf);  
                 if (0 == c)  
                         break;  
                 else if (1 == c)  
                         continue;                          continue;
                   if (xstrcmp(args[i], "off"))
                 mdoc_argv_free(j, argv);                          continue;
                 return(0);                  return(mdoc_err(mdoc, tok, pos, ERR_SYNTAX_ARGBAD));
         }          }
           return(1);
         if (MDOC_LINEARG_MAX == j) {  
                 mdoc_argv_free(j, argv);  
                 return(mdoc_err(mdoc, tok, lastarg, ERR_ARGS_MANY));  
         }  
   
         c = append_scoped(mdoc, tok, ppos, 0, NULL, j, argv);  
         mdoc_argv_free(j, argv);  
         return(c);  
 }  }
   
   
 /*  static int
  * Implicity-scoped macros, like `.Ss', have a scope that terminates  tree_pre_ref(struct mdoc *mdoc, int tok, int pos)
  * with a subsequent call to the same macro.  Implicit macros cannot  
  * break the scope of explicitly-scoped macros; however, they can break  
  * the scope of other implicit macros (so `.Sh' can break `.Ss').  This  
  * is ok with macros like `.It' because they exist only within an  
  * explicit context.  
  *  
  * These macros put line arguments (which it's allowed to have) into the  
  * HEAD section and open a BODY scope to be used until the macro scope  
  * closes.  
  */  
 int  
 macro_scoped_implicit(MACRO_PROT_ARGS)  
 {  {
         int               lastarg, j;  
         char             *args[MDOC_LINEARG_MAX];  
         struct mdoc_node *n;          struct mdoc_node *n;
   
         assert( ! (MDOC_EXPLICIT & mdoc_macros[tok].flags));          assert(mdoc->last);
           for (n = mdoc->last ; n; n = n->parent) {
         if (SEC_PROLOGUE == mdoc->sec_lastn)                  if (MDOC_BLOCK != n->type)
                 return(mdoc_err(mdoc, tok, ppos, ERR_SEC_PROLOGUE));                          continue;
                   if (MDOC_Rs != n->data.block.tok)
         /* Token pre-processing. */  
   
         switch (tok) {  
         case (MDOC_Ss):  
                 /* FALLTHROUGH */  
         case (MDOC_Sh):  
                 /* `.Pp' ignored when preceding `.Ss' or `.Sh'. */  
                 if (NULL == mdoc->last)  
                         break;                          break;
                 if (MDOC_ELEM != mdoc->last->type)                  return(1);
                         break;  
                 if (MDOC_Pp != mdoc->last->data.elem.tok)  
                         break;  
                 if ( ! mdoc_warn(mdoc, tok, ppos, WARN_IGN_BEFORE_BLK))  
                         return(0);  
                 assert(mdoc->last->prev);  
                 n = mdoc->last;  
                 mdoc_msg(mdoc, ppos, "removing prior `Pp' macro");  
                 mdoc->last = mdoc->last->prev;  
                 mdoc->last->next = NULL;  
                 mdoc_node_free(n);  
                 break;  
         default:  
                 break;  
         }          }
   
         /* Rewind our scope. */          return(mdoc_err(mdoc, tok, pos, ERR_SCOPE_NOCTX));
   }
   
         if ( ! scope_rewind_imp(mdoc, ppos, tok))  
                 return(0);  
   
         j = 0;  static int
         lastarg = ppos;  args_xr(struct mdoc *mdoc, int tok, int pos,
                   int sz, const char *args[],
                   int argc, const struct mdoc_arg *argv)
   {
   
         /*          if (1 == sz)
          * Process until we hit a line.  Note that current implicit                  return(1);
          * macros don't have any arguments, so we don't need to do any          if (0 == sz)
          * argument processing.                  return(mdoc_err(mdoc, tok, pos, ERR_ARGS_GE1));
          */          if (MSEC_DEFAULT == mdoc_atomsec(args[1]))
                   return(mdoc_err(mdoc, tok, pos, ERR_SYNTAX_ARGFORM));
 again:          return(1);
         if (j == MDOC_LINEARG_MAX)  
                 return(mdoc_err(mdoc, tok, lastarg, ERR_ARGS_MANY));  
   
         lastarg = *pos;  
   
         switch (mdoc_args(mdoc, tok, pos, buf, 0, &args[j])) {  
         case (ARGS_ERROR):  
                 return(0);  
         case (ARGS_EOLN):  
                 return(append_scoped(mdoc, tok, ppos, j, _CC(args), 0, NULL));  
         default:  
                 break;  
         }  
   
         if (MDOC_MAX != mdoc_find(mdoc, args[j]))  
                 if ( ! mdoc_warn(mdoc, tok, lastarg, WARN_SYNTAX_MACLIKE))  
                         return(0);  
   
         j++;  
         goto again;  
         /* NOTREACHED */  
 }  }
   
   
 /*  static int
  * A line-scoped macro opens a scope for the contents of its line, which  args_nopunct(struct mdoc *mdoc, int tok, int pos,
  * are placed under the HEAD node.  Punctuation trailing the line is put                  int sz, const char *args[],
  * as a sibling to the HEAD node, under the BLOCK node.                  int argc, const struct mdoc_arg *argv)
  */  
 int  
 macro_scoped_line(MACRO_PROT_ARGS)  
 {  {
         int               lastarg, c, j;          int              i;
         char              *p;  
         struct mdoc_node  *n;  
   
         if (SEC_PROLOGUE == mdoc->sec_lastn)          if (0 == sz)
                 return(mdoc_err(mdoc, tok, ppos, ERR_SEC_PROLOGUE));                  return(1);
   
         assert(1 == ppos);          i = 0;
           if (ATT_DEFAULT == mdoc_atoatt(args[i]))
         /* Token pre-processing.  */                  i++;
           for ( ; i < sz; i++) {
         switch (tok) {                  if ( ! mdoc_isdelim(args[i]))
         case (MDOC_D1):                          continue;
                 /* FALLTHROUGH */                  return(mdoc_err(mdoc, tok, pos, ERR_SYNTAX_NOPUNCT));
         case (MDOC_Dl):  
                 /* These can't be nested in a display block. */  
                 assert(mdoc->last);  
                 for (n = mdoc->last->parent ; n; n = n->parent)  
                         if (MDOC_BLOCK != n->type)  
                                 continue;  
                         else if (MDOC_Bd == n->data.block.tok)  
                                 break;  
                 if (NULL == n)  
                         break;  
                 return(mdoc_err(mdoc, tok, ppos, ERR_SCOPE_NONEST));  
         default:  
                 break;  
         }          }
           return(1);
         /*  
          * All line-scoped macros have a HEAD and optionally a BODY  
          * section.  We open our scope here; when we exit this function,  
          * we'll rewind our scope appropriately.  
          */  
   
         mdoc_block_alloc(mdoc, ppos, tok, 0, NULL);  
         mdoc_head_alloc(mdoc, ppos, tok, 0, NULL);  
   
         /* Process line parameters. */  
   
         j = 0;  
         lastarg = ppos;  
   
 again:  
         if (j == MDOC_LINEARG_MAX)  
                 return(mdoc_err(mdoc, tok, lastarg, ERR_ARGS_MANY));  
   
         lastarg = *pos;  
         c = mdoc_args(mdoc, tok, pos, buf, ARGS_DELIM, &p);  
   
         switch (c) {  
         case (ARGS_ERROR):  
                 return(0);  
         case (ARGS_WORD):  
                 break;  
         case (ARGS_PUNCT):  
                 if ( ! append_delims(mdoc, tok, pos, buf))  
                         return(0);  
                 return(scope_rewind_imp(mdoc, ppos, tok));  
         case (ARGS_EOLN):  
                 return(scope_rewind_imp(mdoc, ppos, tok));  
         default:  
                 abort();  
                 /* NOTREACHED */  
         }  
   
         if (MDOC_MAX != (c = mdoc_find(mdoc, p))) {  
                 if ( ! mdoc_macro(mdoc, c, lastarg, pos, buf))  
                         return(0);  
                 if ( ! append_delims(mdoc, tok, pos, buf))  
                         return(0);  
                 return(scope_rewind_imp(mdoc, ppos, tok));  
         }  
   
         if (mdoc_isdelim(p))  
                 j = 0;  
   
         mdoc_word_alloc(mdoc, lastarg, p);  
         goto again;  
         /* NOTREACHED */  
 }  }
   
   
 /*  static int
  * Partial-line scope is identical to line scope (macro_scoped_line())  tree_pre_display(struct mdoc *mdoc, int tok, int pos)
  * except that trailing punctuation is appended to the BLOCK, instead of  
  * contained within the HEAD.  
  */  
 int  
 macro_scoped_pline(MACRO_PROT_ARGS)  
 {  {
         int               lastarg, c, j;          struct mdoc_node *node;
         char              *p;  
   
         if (SEC_PROLOGUE == mdoc->sec_lastn)          assert(mdoc->last);
                 return(mdoc_err(mdoc, tok, ppos, ERR_SEC_PROLOGUE));  
   
         /* Token pre-processing.  */          /* Displays may not be nested in other displays. */
   
         switch (tok) {          /* LINTED */
         case (MDOC_Ql):          for (node = mdoc->last; node; node = node->parent) {
                 if ( ! mdoc_warn(mdoc, tok, ppos, WARN_COMPAT_TROFF))                  if (node->type != MDOC_BLOCK)
                         return(0);                          continue;
                   if (node->data.block.tok != MDOC_Bd)
                           continue;
                 break;                  break;
         default:  
                 break;  
         }          }
           if (NULL == node)
         mdoc_block_alloc(mdoc, ppos, tok, 0, NULL);                  return(1);
         mdoc_head_alloc(mdoc, ppos, tok, 0, NULL);          return(mdoc_err(mdoc, tok, pos, ERR_SCOPE_NONEST));
   
         /* Process line parameters. */  
   
         j = 0;  
         lastarg = ppos;  
   
 again:  
         if (j == MDOC_LINEARG_MAX)  
                 return(mdoc_err(mdoc, tok, lastarg, ERR_ARGS_MANY));  
   
         lastarg = *pos;  
         c = mdoc_args(mdoc, tok, pos, buf, ARGS_DELIM, &p);  
   
         switch (c) {  
         case (ARGS_ERROR):  
                 return(0);  
         case (ARGS_WORD):  
                 break;  
         case (ARGS_PUNCT):  
                 if ( ! scope_rewind_imp(mdoc, ppos, tok))  
                         return(0);  
                 if (ppos > 1)  
                         return(1);  
                 return(append_delims(mdoc, tok, pos, buf));  
         case (ARGS_EOLN):  
                 return(scope_rewind_imp(mdoc, ppos, tok));  
         default:  
                 abort();  
                 /* NOTREACHED */  
         }  
   
         if (MDOC_MAX != (c = mdoc_find(mdoc, p))) {  
                 if ( ! mdoc_macro(mdoc, c, lastarg, pos, buf))  
                         return(0);  
                 if ( ! scope_rewind_imp(mdoc, ppos, tok))  
                         return(0);  
                 if (ppos > 1)  
                         return(1);  
                 return(append_delims(mdoc, tok, pos, buf));  
         }  
   
         if (mdoc_isdelim(p))  
                 j = 0;  
   
         mdoc_word_alloc(mdoc, lastarg, p);  
         goto again;  
         /* NOTREACHED */  
 }  }
   
   
 /*  
  * A delimited-constant macro is similar to a general text macro: the  
  * macro is followed by a 0 or 1 arguments (possibly-unspecified) then  
  * terminating punctuation, other words, or another callable macro.  
  */  
 int  int
 macro_constant_delimited(MACRO_PROT_ARGS)  mdoc_valid_pre(struct mdoc *mdoc, int tok, int pos,
                   int sz, const char *args[],
                   int argc, const struct mdoc_arg *argv)
 {  {
         int               lastarg, flushed, c, maxargs;  
         char             *p;  
   
         if (SEC_PROLOGUE == mdoc->sec_lastn)          assert(tok < MDOC_MAX);
                 return(mdoc_err(mdoc, tok, ppos, ERR_SEC_PROLOGUE));          if (mdoc_valids[tok].sz)
                   if ( ! (*mdoc_valids[tok].sz)(mdoc, tok, pos, sz))
         /* Process line parameters. */  
   
         lastarg = ppos;  
         flushed = 0;  
   
         /* Token pre-processing. */  
   
         switch (tok) {  
         case (MDOC_Ux):  
                 maxargs = 0;  
                 break;  
         default:  
                 maxargs = 1;  
                 break;  
         }  
   
 again:  
         lastarg = *pos;  
   
         switch (mdoc_args(mdoc, tok, pos, buf, ARGS_DELIM, &p)) {  
         case (ARGS_ERROR):  
                 return(0);  
         case (ARGS_WORD):  
                 break;  
         case (ARGS_PUNCT):  
                 if ( ! flushed && ! append_const(mdoc, tok, ppos, 0, &p))  
                         return(0);                          return(0);
                 if (ppos > 1)          if (mdoc_valids[tok].args)
                         return(1);                  if ( ! (*mdoc_valids[tok].args)(mdoc, tok, pos,
                 return(append_delims(mdoc, tok, pos, buf));                                          sz, args, argc, argv))
         case (ARGS_EOLN):  
                 if (flushed)  
                         return(1);  
                 return(append_const(mdoc, tok, ppos, 0, &p));  
         default:  
                 abort();  
                 /* NOTREACHED */  
         }  
   
         /* Accepts no arguments: flush out symbol and continue. */  
   
         if (0 == maxargs) {  
                 if ( ! append_const(mdoc, tok, ppos, 0, &p))  
                         return(0);                          return(0);
                 flushed = 1;          if (mdoc_valids[tok].tree_pre)
         }                  if ( ! (*mdoc_valids[tok].tree_pre)(mdoc, tok, pos))
   
         if (MDOC_MAX != (c = mdoc_find(mdoc, p))) {  
                 if ( ! flushed && ! append_const(mdoc, tok, ppos, 0, &p))  
                         return(0);                          return(0);
                 if ( ! mdoc_macro(mdoc, c, lastarg, pos, buf))          return(1);
                         return(0);  
                 if (ppos > 1)  
                         return(1);  
                 return(append_delims(mdoc, tok, pos, buf));  
         }  
   
         /*  
          * We only accept one argument; subsequent tokens are considered  
          * as literal words (until a macro).  
          */  
   
         if ( ! flushed && ! mdoc_isdelim(p)) {  
                if ( ! append_const(mdoc, tok, ppos, 1, &p))  
                         return(0);  
                 flushed = 1;  
                 goto again;  
         } else if ( ! flushed) {  
                 if ( ! append_const(mdoc, tok, ppos, 0, &p))  
                         return(0);  
                 flushed = 1;  
         }  
   
         mdoc_word_alloc(mdoc, lastarg, p);  
         goto again;  
         /* NOTREACHED */  
 }  }
   
   
 int  int
 macro_constant(MACRO_PROT_ARGS)  mdoc_valid_post(struct mdoc *mdoc, int tok, int pos)
 {  {
         int               lastarg, j;  
         char             *args[MDOC_LINEARG_MAX];  
   
         if (SEC_PROLOGUE == mdoc->sec_lastn)          if (mdoc_valids[tok].tree_post)
                 return(mdoc_err(mdoc, tok, ppos, ERR_SEC_PROLOGUE));                  return((*mdoc_valids[tok].tree_post)(mdoc, tok, pos));
           return(1);
         j = 0;  
         lastarg = ppos;  
   
 again:  
         if (j == MDOC_LINEARG_MAX)  
                 return(mdoc_err(mdoc, tok, lastarg, ERR_ARGS_MANY));  
   
         lastarg = *pos;  
   
         switch (mdoc_args(mdoc, tok, pos, buf, 0, &args[j])) {  
         case (ARGS_ERROR):  
                 return(0);  
         case (ARGS_WORD):  
                 break;  
         case (ARGS_EOLN):  
                 return(append_const(mdoc, tok, ppos, j, args));  
         default:  
                 abort();  
                 /* NOTREACHED */  
         }  
   
         if (MDOC_MAX != mdoc_find(mdoc, args[j]))  
                 if ( ! mdoc_warn(mdoc, tok, lastarg, WARN_SYNTAX_MACLIKE))  
                         return(0);  
   
         j++;  
         goto again;  
         /* NOTREACHED */  
 }  }
   
   
 int  
 macro_constant_argv(MACRO_PROT_ARGS)  
 {  
         int               c, lastarg, j;  
         struct mdoc_arg   argv[MDOC_LINEARG_MAX];  
   
         if (SEC_PROLOGUE == mdoc->sec_lastn)  
                 return(mdoc_err(mdoc, tok, ppos, ERR_SEC_PROLOGUE));  
   
         lastarg = *pos;  
   
         for (j = 0; j < MDOC_LINEARG_MAX; j++) {  
                 lastarg = *pos;  
                 c = mdoc_argv(mdoc, tok, &argv[j], pos, buf);  
                 if (0 == c)  
                         break;  
                 else if (1 == c)  
                         continue;  
   
                 mdoc_argv_free(j, argv);  
                 return(0);  
         }  
   
         if (MDOC_LINEARG_MAX == j) {  
                 mdoc_argv_free(j, argv);  
                 return(mdoc_err(mdoc, tok, lastarg, ERR_ARGS_MANY));  
         }  
   
         c = append_constarg(mdoc, tok, ppos, j, argv);  
         mdoc_argv_free(j, argv);  
         return(c);  
 }  
Legend:
Removed from v.1.8  
changed lines
  Added in v.1.14
CVSweb