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

Diff for /mandoc/Attic/macro.c between version 1.58 and 1.70

version 1.58, 2009/03/08 11:41:22 version 1.70, 2009/03/12 16:30:50
Line 21 
Line 21 
 #include <stdlib.h>  #include <stdlib.h>
 #include <stdio.h>  #include <stdio.h>
 #include <string.h>  #include <string.h>
 #ifdef  __linux__  
 #include <time.h>  
 #endif  
   
   #include "private.h"
   
 /*  /*
  * This has scanning/parsing routines, each of which extract a macro and   * This has scanning/parsing routines, each of which extract a macro and
  * its arguments and parameters, then know how to progress to the next   * its arguments and parameters, then know how to progress to the next
  * macro.   * macro.
  */   */
   
 #include "private.h"  /* FIXME: .Fl, .Ar, .Cd handling of `|'. */
   
 static int        macro_obsolete(MACRO_PROT_ARGS);  static  int       macro_obsolete(MACRO_PROT_ARGS);
 static int        macro_constant(MACRO_PROT_ARGS);  static  int       macro_constant(MACRO_PROT_ARGS);
 static int        macro_constant_scoped(MACRO_PROT_ARGS);  static  int       macro_constant_scoped(MACRO_PROT_ARGS);
 static int        macro_constant_delimited(MACRO_PROT_ARGS);  static  int       macro_constant_delimited(MACRO_PROT_ARGS);
 static int        macro_text(MACRO_PROT_ARGS);  static  int       macro_text(MACRO_PROT_ARGS);
 static int        macro_scoped(MACRO_PROT_ARGS);  static  int       macro_scoped(MACRO_PROT_ARGS);
 static int        macro_scoped_close(MACRO_PROT_ARGS);  static  int       macro_scoped_close(MACRO_PROT_ARGS);
 static int        macro_scoped_line(MACRO_PROT_ARGS);  static  int       macro_scoped_line(MACRO_PROT_ARGS);
   static  int       macro_phrase(struct mdoc *, int, int, char *);
   
 #define REWIND_REWIND   (1 << 0)  #define REWIND_REWIND   (1 << 0)
 #define REWIND_NOHALT   (1 << 1)  #define REWIND_NOHALT   (1 << 1)
Line 60  static int   append_delims(struct mdoc *, int, int *, 
Line 60  static int   append_delims(struct mdoc *, int, int *, 
 static  int       lookup(struct mdoc *, int, int, int, const char *);  static  int       lookup(struct mdoc *, int, int, int, const char *);
 static  int       pwarn(struct mdoc *, int, int, int);  static  int       pwarn(struct mdoc *, int, int, int);
 static  int       perr(struct mdoc *, int, int, int);  static  int       perr(struct mdoc *, int, int, int);
   static  int       scopewarn(struct mdoc *, enum mdoc_type, int, int,
                           const struct mdoc_node *);
   
 #define WMACPARM        (1)  #define WMACPARM        (1)
 #define WOBS            (2)  #define WOBS            (2)
Line 87  const struct mdoc_macro __mdoc_macros[MDOC_MAX] = {
Line 89  const struct mdoc_macro __mdoc_macros[MDOC_MAX] = {
         { macro_text, MDOC_CALLABLE | MDOC_PARSED }, /* Ad */          { macro_text, MDOC_CALLABLE | MDOC_PARSED }, /* Ad */
         { macro_text, MDOC_PARSED }, /* An */          { macro_text, MDOC_PARSED }, /* An */
         { macro_text, MDOC_CALLABLE | MDOC_PARSED }, /* Ar */          { macro_text, MDOC_CALLABLE | MDOC_PARSED }, /* Ar */
         { macro_constant, 0 }, /* Cd */          { macro_constant, MDOC_CALLABLE }, /* Cd */
         { macro_text, MDOC_CALLABLE | MDOC_PARSED }, /* Cm */          { macro_text, MDOC_CALLABLE | MDOC_PARSED }, /* Cm */
         { macro_text, MDOC_CALLABLE | MDOC_PARSED }, /* Dv */          { macro_text, MDOC_CALLABLE | MDOC_PARSED }, /* Dv */
         { macro_text, MDOC_CALLABLE | MDOC_PARSED }, /* Er */          { macro_text, MDOC_CALLABLE | MDOC_PARSED }, /* Er */
Line 179  const struct mdoc_macro __mdoc_macros[MDOC_MAX] = {
Line 181  const struct mdoc_macro __mdoc_macros[MDOC_MAX] = {
         { macro_obsolete, 0 }, /* Fr */          { macro_obsolete, 0 }, /* Fr */
         { macro_constant, 0 }, /* Ud */          { macro_constant, 0 }, /* Ud */
         { macro_constant, 0 }, /* Lb */          { macro_constant, 0 }, /* Lb */
           { macro_constant_delimited, MDOC_CALLABLE | MDOC_PARSED }, /* Ap */
           { macro_text, 0 }, /* Lp */
           { macro_text, MDOC_PARSED }, /* Lk */
           { macro_text, MDOC_PARSED }, /* Mt */
           { macro_scoped_line, MDOC_CALLABLE | MDOC_PARSED }, /* Brq */
           { macro_constant_scoped, MDOC_CALLABLE | MDOC_PARSED | MDOC_EXPLICIT }, /* Bro */
           { macro_scoped_close, MDOC_EXPLICIT | MDOC_CALLABLE | MDOC_PARSED }, /* Brc */
           { macro_constant, 0 }, /* %C */
 };  };
   
 const   struct mdoc_macro * const mdoc_macros = __mdoc_macros;  const   struct mdoc_macro * const mdoc_macros = __mdoc_macros;
   
   
   /*
    * This is called at the end of parsing.  It must traverse up the tree,
    * closing out open [implicit] scopes.  Obviously, open explicit scopes
    * are errors.
    */
   int
   macro_end(struct mdoc *mdoc)
   {
           struct mdoc_node *n;
   
           assert(mdoc->first);
           assert(mdoc->last);
   
           /* Scan for open explicit scopes. */
   
           n = MDOC_VALID & mdoc->last->flags ?
                   mdoc->last->parent : mdoc->last;
   
           for ( ; n; n = n->parent) {
                   if (MDOC_BLOCK != n->type)
                           continue;
                   if ( ! (MDOC_EXPLICIT & mdoc_macros[n->tok].flags))
                           continue;
                   return(mdoc_nerr(mdoc, n,
                                   "macro scope still open on exit"));
           }
   
           return(rewind_last(mdoc, mdoc->first));
   }
   
   
 static int  static int
 perr(struct mdoc *mdoc, int line, int pos, int type)  perr(struct mdoc *mdoc, int line, int pos, int type)
 {  {
Line 192  perr(struct mdoc *mdoc, int line, int pos, int type)
Line 233  perr(struct mdoc *mdoc, int line, int pos, int type)
         switch (type) {          switch (type) {
         case (ENOCTX):          case (ENOCTX):
                 c = mdoc_perr(mdoc, line, pos,                  c = mdoc_perr(mdoc, line, pos,
                                 "closing macro has prior context");                                  "closing macro has no prior context");
                 break;                  break;
         case (ENOPARMS):          case (ENOPARMS):
                 c = mdoc_perr(mdoc, line, pos,                  c = mdoc_perr(mdoc, line, pos,
Line 228  pwarn(struct mdoc *mdoc, int line, int pos, int type)
Line 269  pwarn(struct mdoc *mdoc, int line, int pos, int type)
   
   
 static int  static int
   scopewarn(struct mdoc *mdoc, enum mdoc_type type,
                   int line, int pos, const struct mdoc_node *p)
   {
           const char      *n, *t, *tt;
   
           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;
           }
   
           if ( ! (MDOC_IGN_SCOPE & mdoc->pflags))
                   return(mdoc_perr(mdoc, line, pos,
                                   "%s scope breaks %s scope of %s",
                                   tt, t, n));
           return(mdoc_pwarn(mdoc, line, pos, WARN_SYNTAX,
                                   "%s scope breaks %s scope of %s",
                                   tt, t, n));
   }
   
   
   static int
 lookup(struct mdoc *mdoc, int line, int pos, int from, const char *p)  lookup(struct mdoc *mdoc, int line, int pos, int from, const char *p)
 {  {
         int              res;          int              res;
Line 274  rewind_alt(int tok)
Line 362  rewind_alt(int tok)
                 return(MDOC_Ao);                  return(MDOC_Ao);
         case (MDOC_Bc):          case (MDOC_Bc):
                 return(MDOC_Bo);                  return(MDOC_Bo);
           case (MDOC_Brc):
                   return(MDOC_Bro);
         case (MDOC_Dc):          case (MDOC_Dc):
                 return(MDOC_Do);                  return(MDOC_Do);
         case (MDOC_Ec):          case (MDOC_Ec):
Line 323  rewind_dohalt(int tok, enum mdoc_type type, const stru
Line 413  rewind_dohalt(int tok, enum mdoc_type type, const stru
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
         case (MDOC_Bq):          case (MDOC_Bq):
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
           case (MDOC_Brq):
                   /* FALLTHROUGH */
         case (MDOC_D1):          case (MDOC_D1):
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
         case (MDOC_Dl):          case (MDOC_Dl):
Line 377  rewind_dohalt(int tok, enum mdoc_type type, const stru
Line 469  rewind_dohalt(int tok, enum mdoc_type type, const stru
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
         case (MDOC_Bo):          case (MDOC_Bo):
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
           case (MDOC_Bro):
                   /* FALLTHROUGH */
         case (MDOC_Do):          case (MDOC_Do):
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
         case (MDOC_Eo):          case (MDOC_Eo):
Line 403  rewind_dohalt(int tok, enum mdoc_type type, const stru
Line 497  rewind_dohalt(int tok, enum mdoc_type type, const stru
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
         case (MDOC_Bc):          case (MDOC_Bc):
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
           case (MDOC_Brc):
                   /* FALLTHROUGH */
         case (MDOC_Dc):          case (MDOC_Dc):
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
         case (MDOC_Ec):          case (MDOC_Ec):
Line 512  rewind_subblock(enum mdoc_type type, struct mdoc *mdoc
Line 608  rewind_subblock(enum mdoc_type type, struct mdoc *mdoc
                         break;                          break;
                 else if (rewind_dobreak(tok, n))                  else if (rewind_dobreak(tok, n))
                         continue;                          continue;
                 return(mdoc_perr(mdoc, line, ppos,                  if ( ! scopewarn(mdoc, type, line, ppos, n))
                         "scope breaks %s", MDOC_ROOT == n->type ?                          return(0);
                         "<root>" : mdoc_macronames[n->tok]));  
         }          }
   
         assert(n);          assert(n);
Line 537  rewind_expblock(struct mdoc *mdoc, int tok, int line, 
Line 632  rewind_expblock(struct mdoc *mdoc, int tok, int line, 
                         break;                          break;
                 else if (rewind_dobreak(tok, n))                  else if (rewind_dobreak(tok, n))
                         continue;                          continue;
                 return(mdoc_perr(mdoc, line, ppos,                  if ( ! scopewarn(mdoc, MDOC_BLOCK, line, ppos, n))
                         "scope breaks %s", MDOC_ROOT == n->type ?                          return(0);
                         "<root>" : mdoc_macronames[n->tok]));  
         }          }
   
         assert(n);          assert(n);
Line 562  rewind_impblock(struct mdoc *mdoc, int tok, int line, 
Line 656  rewind_impblock(struct mdoc *mdoc, int tok, int line, 
                         break;                          break;
                 else if (rewind_dobreak(tok, n))                  else if (rewind_dobreak(tok, n))
                         continue;                          continue;
                 return(mdoc_perr(mdoc, line, ppos,                  if ( ! scopewarn(mdoc, MDOC_BLOCK, line, ppos, n))
                         "scope breaks %s", MDOC_ROOT == n->type ?                          return(0);
                         "<root>" : mdoc_macronames[n->tok]));  
         }          }
   
         assert(n);          assert(n);
Line 751  macro_text(MACRO_PROT_ARGS)
Line 844  macro_text(MACRO_PROT_ARGS)
         for (;;) {          for (;;) {
                 la = *pos;                  la = *pos;
                 w = mdoc_args(mdoc, line, pos, buf, tok, &p);                  w = mdoc_args(mdoc, line, pos, buf, tok, &p);
                 assert(ARGS_PHRASE != c);                  assert(ARGS_PHRASE != w);
   
                 if (ARGS_ERROR == w)                  if (ARGS_ERROR == w)
                         return(0);                          return(0);
Line 760  macro_text(MACRO_PROT_ARGS)
Line 853  macro_text(MACRO_PROT_ARGS)
                 if (ARGS_PUNCT == w)                  if (ARGS_PUNCT == w)
                         break;                          break;
   
                   /* Quoted words shouldn't be looked-up. */
   
                 c = ARGS_QWORD == w ? MDOC_MAX :                  c = ARGS_QWORD == w ? MDOC_MAX :
                         lookup(mdoc, line, la, tok, p);                          lookup(mdoc, line, la, tok, p);
   
                   /* MDOC_MAX (not a macro) or -1 (error). */
   
                 if (MDOC_MAX != c && -1 != c) {                  if (MDOC_MAX != c && -1 != c) {
                         if (0 == lastpunct && ! rewind_elem(mdoc, tok))                          if (0 == lastpunct && ! rewind_elem(mdoc, tok))
                                 return(0);                                  return(0);
Line 775  macro_text(MACRO_PROT_ARGS)
Line 872  macro_text(MACRO_PROT_ARGS)
                 } else if (-1 == c)                  } else if (-1 == c)
                         return(0);                          return(0);
   
                 /* FIXME: .Fl and .Ar handling of `|'. */                  /* Non-quote-enclosed punctuation. */
   
                 if (ARGS_QWORD != w && mdoc_isdelim(p)) {                  if (ARGS_QWORD != w && mdoc_isdelim(p)) {
                         if (0 == lastpunct && ! rewind_elem(mdoc, tok))                          if (0 == lastpunct && ! rewind_elem(mdoc, tok))
Line 826  macro_text(MACRO_PROT_ARGS)
Line 923  macro_text(MACRO_PROT_ARGS)
  *             TEXT (`Another.')   *             TEXT (`Another.')
  *   *
  * Note that the `.It' macro, possibly the most difficult (as it has   * Note that the `.It' macro, possibly the most difficult (as it has
  * embedded scope, etc.) is handled by this routine.   * embedded scope, etc.) is handled by this routine.  It handles
    * columnar output, where columns are "phrases" and denote multiple
    * block heads.
  */   */
 static int  static int
 macro_scoped(MACRO_PROT_ARGS)  macro_scoped(MACRO_PROT_ARGS)
 {  {
         int               c, lastarg;          int               c, lastarg, reopen;
         struct mdoc_arg  *arg;          struct mdoc_arg  *arg;
         char             *p;          char             *p;
   
Line 883  macro_scoped(MACRO_PROT_ARGS)
Line 982  macro_scoped(MACRO_PROT_ARGS)
   
         if ( ! mdoc_head_alloc(mdoc, line, ppos, tok))          if ( ! mdoc_head_alloc(mdoc, line, ppos, tok))
                 return(0);                  return(0);
   
           /* Indicate that columnar scope shouldn't be reopened. */
           reopen = 0;
         mdoc->next = MDOC_NEXT_CHILD;          mdoc->next = MDOC_NEXT_CHILD;
   
         for (;;) {          for (;;) {
Line 894  macro_scoped(MACRO_PROT_ARGS)
Line 996  macro_scoped(MACRO_PROT_ARGS)
                 if (ARGS_EOLN == c)                  if (ARGS_EOLN == c)
                         break;                          break;
                 if (ARGS_PHRASE == c) {                  if (ARGS_PHRASE == c) {
                           if (reopen && ! mdoc_head_alloc(mdoc, line, ppos, tok))
                                   return(0);
                           mdoc->next = MDOC_NEXT_CHILD;
   
                         /*                          /*
                         if ( ! mdoc_phrase(mdoc, line, lastarg, buf))                           * Phrases are self-contained macro phrases used
                            * in the columnar output of a macro. They need
                            * special handling.
                            */
                           if ( ! macro_phrase(mdoc, line, lastarg, buf))
                                 return(0);                                  return(0);
                         */                          if ( ! rewind_subblock(MDOC_HEAD, mdoc, tok, line, ppos))
                                   return(0);
   
                           reopen = 1;
                         continue;                          continue;
                 }                  }
   
                 /* FIXME: if .It -column, the lookup must be for a  
                  * sub-line component.  BLAH. */  
   
                 if (-1 == (c = lookup(mdoc, line, lastarg, tok, p)))                  if (-1 == (c = lookup(mdoc, line, lastarg, tok, p)))
                         return(0);                          return(0);
   
Line 1158  macro_constant_delimited(MACRO_PROT_ARGS)
Line 1268  macro_constant_delimited(MACRO_PROT_ARGS)
          */           */
   
         switch (tok) {          switch (tok) {
           case (MDOC_Ap):
                   /* FALLTHROUGH */
         case (MDOC_No):          case (MDOC_No):
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
         case (MDOC_Ns):          case (MDOC_Ns):
Line 1282  macro_constant(MACRO_PROT_ARGS)
Line 1394  macro_constant(MACRO_PROT_ARGS)
         struct mdoc_arg  *arg;          struct mdoc_arg  *arg;
         char             *p;          char             *p;
   
         assert( ! (MDOC_CALLABLE & mdoc_macros[tok].flags));  
   
         arg = NULL;          arg = NULL;
   
         for (;;) {          for (;;) {
Line 1343  macro_obsolete(MACRO_PROT_ARGS)
Line 1453  macro_obsolete(MACRO_PROT_ARGS)
 }  }
   
   
 /*  static int
  * This is called at the end of parsing.  It must traverse up the tree,  macro_phrase(struct mdoc *mdoc, int line, int ppos, char *buf)
  * closing out open [implicit] scopes.  Obviously, open explicit scopes  
  * are errors.  
  */  
 int  
 macro_end(struct mdoc *mdoc)  
 {  {
         struct mdoc_node *n;          int              i, la, c;
   
         assert(mdoc->first);          for (i = ppos; buf[i]; ) {
         assert(mdoc->last);                  assert(' ' != buf[i]);
   
         /* Scan for open explicit scopes. */                  la = i;
                   if ('\"' == buf[i]) {
                           la = ++i;
                           while (buf[i] && '\"' != buf[i])
                                   i++;
                           if (0 == buf[i])
                                   return(mdoc_err(mdoc, "unterminated quoted parameter"));
                   } else
                           while (buf[i] && ! isspace ((unsigned char)buf[i]))
                                   i++;
   
         n = MDOC_VALID & mdoc->last->flags ?                  if (buf[i])
                 mdoc->last->parent : mdoc->last;                          buf[i++] = 0;
   
         for ( ; n; n = n->parent) {                  while (buf[i] && isspace((unsigned char)buf[i]))
                 if (MDOC_BLOCK != n->type)                          i++;
                         continue;  
                 if ( ! (MDOC_EXPLICIT & mdoc_macros[n->tok].flags))                  if (MDOC_MAX != (c = mdoc_tokhash_find(mdoc->htab, &buf[la]))) {
                         continue;                          if ( ! mdoc_macro(mdoc, c, line, la, &i, buf))
                 return(mdoc_nerr(mdoc, n,                                  return(0);
                                 "macro scope still open on exit"));                          return(append_delims(mdoc, line, &i, buf));
                   }
   
                   if ( ! mdoc_word_alloc(mdoc, line, la, &buf[la]))
                           return(0);
                   mdoc->next = MDOC_NEXT_SIBLING;
   
                   while (buf[i] && isspace((unsigned char)buf[i]))
                           i++;
         }          }
   
         return(rewind_last(mdoc, mdoc->first));          return(1);
 }  }
Legend:
Removed from v.1.58  
changed lines
  Added in v.1.70
CVSweb