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

Diff for /mandoc/mdoc.c between version 1.84 and 1.89

version 1.84, 2009/06/17 07:59:47 version 1.89, 2009/07/07 09:29:15
Line 23 
Line 23 
   
 #include "libmdoc.h"  #include "libmdoc.h"
   
 enum    merr {  const   char *const __mdoc_merrnames[MERRMAX] = {
         ENOCALL,          "trailing whitespace", /* ETAILWS */
         EBODYPROL,          "empty last list column", /* ECOLEMPTY */
         EPROLBODY,          "argument-like parameter", /* EARGVPARM */
         ESPACE,          "unexpected quoted parameter", /* EQUOTPARM */
         ETEXTPROL,          "unterminated quoted parameter", /* EQUOTTERM */
         ENOBLANK,          "system: malloc error", /* EMALLOC */
         EMALLOC          "argument parameter suggested", /* EARGVAL */
           "macro not callable", /* ENOCALL */
           "macro disallowed in prologue", /* EBODYPROL */
           "macro disallowed in body", /* EPROLBODY */
           "text disallowed in prologue", /* ETEXTPROL */
           "blank line disallowed", /* ENOBLANK */
           "text parameter too long", /* ETOOLONG */
           "invalid escape sequence", /* EESCAPE */
           "invalid character", /* EPRINT */
           "document has no body", /* ENODAT */
           "document has no prologue", /* ENOPROLOGUE */
           "expected line arguments", /* ELINE */
           "invalid AT&T argument", /* EATT */
           "default name not yet set", /* ENAME */
           "missing list type", /* ELISTTYPE */
           "missing display type", /* EDISPTYPE */
           "too many display types", /* EMULTIDISP */
           "too many list types", /* EMULTILIST */
           "NAME section must be first", /* ESECNAME */
           "badly-formed NAME section", /* ENAMESECINC */
           "argument repeated", /* EARGREP */
           "expected boolean parameter", /* EBOOL */
           "inconsistent column syntax", /* ECOLMIS */
           "nested display invalid", /* ENESTDISP */
           "width argument missing", /* EMISSWIDTH */
           "invalid section for this manual section", /* EWRONGMSEC */
           "section out of conventional order", /* ESECOOO */
           "section repeated", /* ESECREP */
           "invalid standard argument", /* EBADSTAND */
           "multi-line arguments discouraged", /* ENOMULTILINE */
           "multi-line arguments suggested", /* EMULTILINE */
           "line arguments discouraged", /* ENOLINE */
           "prologue macro out of conventional order", /* EPROLOOO */
           "prologue macro repeated", /* EPROLREP */
           "invalid manual section", /* EBADMSEC */
           "invalid section", /* EBADSEC */
           "invalid font mode", /* EFONT */
           "invalid date syntax", /* EBADDATE */
           "invalid number format", /* ENUMFMT */
           "superfluous width argument", /* ENOWIDTH */
           "system: utsname error", /* EUTSNAME */
           "obsolete macro", /* EOBS */
           "macro-like parameter", /* EMACPARM */
           "end-of-line scope violation", /* EIMPBRK */
           "empty macro ignored", /* EIGNE */
           "unclosed explicit scope", /* EOPEN */
           "unterminated quoted phrase", /* EQUOTPHR */
           "closure macro without prior context", /* ENOCTX */
           "invalid whitespace after control character", /* ESPACE */
 };  };
   
 const   char *const __mdoc_macronames[MDOC_MAX] = {  const   char *const __mdoc_macronames[MDOC_MAX] = {
Line 95  static int    node_append(struct mdoc *, 
Line 143  static int    node_append(struct mdoc *, 
 static  int               parsetext(struct mdoc *, int, char *);  static  int               parsetext(struct mdoc *, int, char *);
 static  int               parsemacro(struct mdoc *, int, char *);  static  int               parsemacro(struct mdoc *, int, char *);
 static  int               macrowarn(struct mdoc *, int, const char *);  static  int               macrowarn(struct mdoc *, int, const char *);
 static  int               perr(struct mdoc *, int, int, enum merr);  
   
   
 const struct mdoc_node *  const struct mdoc_node *
 mdoc_node(const struct mdoc *m)  mdoc_node(const struct mdoc *m)
 {  {
Line 113  mdoc_meta(const struct mdoc *m)
Line 161  mdoc_meta(const struct mdoc *m)
 }  }
   
   
   /*
    * Frees volatile resources (parse tree, meta-data, fields).
    */
 static void  static void
 mdoc_free1(struct mdoc *mdoc)  mdoc_free1(struct mdoc *mdoc)
 {  {
Line 132  mdoc_free1(struct mdoc *mdoc)
Line 183  mdoc_free1(struct mdoc *mdoc)
 }  }
   
   
   /*
    * Allocate all volatile resources (parse tree, meta-data, fields).
    */
 static int  static int
 mdoc_alloc1(struct mdoc *mdoc)  mdoc_alloc1(struct mdoc *mdoc)
 {  {
   
         bzero(&mdoc->meta, sizeof(struct mdoc_meta));          bzero(&mdoc->meta, sizeof(struct mdoc_meta));
         mdoc->flags = 0;          mdoc->flags = 0;
         mdoc->lastnamed = mdoc->lastsec = 0;          mdoc->lastnamed = mdoc->lastsec = SEC_NONE;
         mdoc->last = calloc(1, sizeof(struct mdoc_node));          mdoc->last = calloc(1, sizeof(struct mdoc_node));
         if (NULL == mdoc->last)          if (NULL == mdoc->last)
                 return(0);                  return(0);
Line 151  mdoc_alloc1(struct mdoc *mdoc)
Line 205  mdoc_alloc1(struct mdoc *mdoc)
   
   
 /*  /*
  * Free up all resources contributed by a parse:  the node tree,   * Free up volatile resources (see mdoc_free1()) then re-initialises the
  * meta-data and so on.  Then reallocate the root node for another   * data with mdoc_alloc1().  After invocation, parse data has been reset
  * parse.   * and the parser is ready for re-invocation on a new tree; however,
    * cross-parse non-volatile data is kept intact.
  */   */
 int  int
 mdoc_reset(struct mdoc *mdoc)  mdoc_reset(struct mdoc *mdoc)
Line 165  mdoc_reset(struct mdoc *mdoc)
Line 220  mdoc_reset(struct mdoc *mdoc)
   
   
 /*  /*
  * Completely free up all resources.   * Completely free up all volatile and non-volatile parse resources.
    * After invocation, the pointer is no longer usable.
  */   */
 void  void
 mdoc_free(struct mdoc *mdoc)  mdoc_free(struct mdoc *mdoc)
Line 178  mdoc_free(struct mdoc *mdoc)
Line 234  mdoc_free(struct mdoc *mdoc)
 }  }
   
   
   /*
    * Allocate volatile and non-volatile parse resources.
    */
 struct mdoc *  struct mdoc *
 mdoc_alloc(void *data, int pflags, const struct mdoc_cb *cb)  mdoc_alloc(void *data, int pflags, const struct mdoc_cb *cb)
 {  {
Line 204  mdoc_alloc(void *data, int pflags, const struct mdoc_c
Line 263  mdoc_alloc(void *data, int pflags, const struct mdoc_c
   
 /*  /*
  * Climb back up the parse tree, validating open scopes.  Mostly calls   * Climb back up the parse tree, validating open scopes.  Mostly calls
  * through to macro_end in macro.c.   * through to macro_end() in macro.c.
  */   */
 int  int
 mdoc_endparse(struct mdoc *m)  mdoc_endparse(struct mdoc *m)
Line 221  mdoc_endparse(struct mdoc *m)
Line 280  mdoc_endparse(struct mdoc *m)
   
 /*  /*
  * Main parse routine.  Parses a single line -- really just hands off to   * Main parse routine.  Parses a single line -- really just hands off to
  * the macro or text parser.   * the macro (parsemacro()) or text parser (parsetext()).
  */   */
 int  int
 mdoc_parseln(struct mdoc *m, int ln, char *buf)  mdoc_parseln(struct mdoc *m, int ln, char *buf)
Line 248  mdoc_verr(struct mdoc *mdoc, int ln, int pos, 
Line 307  mdoc_verr(struct mdoc *mdoc, int ln, int pos, 
         va_start(ap, fmt);          va_start(ap, fmt);
         (void)vsnprintf(buf, sizeof(buf) - 1, fmt, ap);          (void)vsnprintf(buf, sizeof(buf) - 1, fmt, ap);
         va_end(ap);          va_end(ap);
   
         return((*mdoc->cb.mdoc_err)(mdoc->data, ln, pos, buf));          return((*mdoc->cb.mdoc_err)(mdoc->data, ln, pos, buf));
 }  }
   
   
 int  int
 mdoc_vwarn(struct mdoc *mdoc, int ln, int pos,  mdoc_vwarn(struct mdoc *mdoc, int ln, int pos, const char *fmt, ...)
                 enum mdoc_warn type, const char *fmt, ...)  
 {  {
         char             buf[256];          char             buf[256];
         va_list          ap;          va_list          ap;
Line 265  mdoc_vwarn(struct mdoc *mdoc, int ln, int pos, 
Line 324  mdoc_vwarn(struct mdoc *mdoc, int ln, int pos, 
         va_start(ap, fmt);          va_start(ap, fmt);
         (void)vsnprintf(buf, sizeof(buf) - 1, fmt, ap);          (void)vsnprintf(buf, sizeof(buf) - 1, fmt, ap);
         va_end(ap);          va_end(ap);
         return((*mdoc->cb.mdoc_warn)(mdoc->data, ln, pos, type, buf));  
 }  
   
           return((*mdoc->cb.mdoc_warn)(mdoc->data, ln, pos, buf));
 int  
 mdoc_nerr(struct mdoc *mdoc, const struct mdoc_node *node,  
                 const char *fmt, ...)  
 {  
         char             buf[256];  
         va_list          ap;  
   
         if (NULL == mdoc->cb.mdoc_err)  
                 return(0);  
   
         va_start(ap, fmt);  
         (void)vsnprintf(buf, sizeof(buf) - 1, fmt, ap);  
         va_end(ap);  
         return((*mdoc->cb.mdoc_err)(mdoc->data,  
                                 node->line, node->pos, buf));  
 }  }
   
   
 int  int
 mdoc_warn(struct mdoc *mdoc, enum mdoc_warn type,  mdoc_err(struct mdoc *m, int line, int pos, int iserr, enum merr type)
                 const char *fmt, ...)  
 {  {
         char             buf[256];          const char      *p;
         va_list          ap;  
   
         if (NULL == mdoc->cb.mdoc_warn)          p = __mdoc_merrnames[(int)type];
                 return(0);          assert(p);
   
         va_start(ap, fmt);          if (iserr)
         (void)vsnprintf(buf, sizeof(buf) - 1, fmt, ap);                  return(mdoc_verr(m, line, pos, p));
         va_end(ap);  
         return((*mdoc->cb.mdoc_warn)(mdoc->data, mdoc->last->line,  
                                 mdoc->last->pos, type, buf));  
 }  
   
           return(mdoc_vwarn(m, line, pos, p));
 int  
 mdoc_err(struct mdoc *mdoc, const char *fmt, ...)  
 {  
         char             buf[256];  
         va_list          ap;  
   
         if (NULL == mdoc->cb.mdoc_err)  
                 return(0);  
   
         va_start(ap, fmt);  
         (void)vsnprintf(buf, sizeof(buf) - 1, fmt, ap);  
         va_end(ap);  
         return((*mdoc->cb.mdoc_err)(mdoc->data, mdoc->last->line,  
                                 mdoc->last->pos, buf));  
 }  }
   
   
 int  int
 mdoc_pwarn(struct mdoc *mdoc, int line, int pos, enum mdoc_warn type,  
                 const char *fmt, ...)  
 {  
         char             buf[256];  
         va_list          ap;  
   
         if (NULL == mdoc->cb.mdoc_warn)  
                 return(0);  
   
         va_start(ap, fmt);  
         (void)vsnprintf(buf, sizeof(buf) - 1, fmt, ap);  
         va_end(ap);  
         return((*mdoc->cb.mdoc_warn)(mdoc->data,  
                                 line, pos, type, buf));  
 }  
   
 int  
 mdoc_perr(struct mdoc *mdoc, int line, int pos, const char *fmt, ...)  
 {  
         char             buf[256];  
         va_list          ap;  
   
         if (NULL == mdoc->cb.mdoc_err)  
                 return(0);  
   
         va_start(ap, fmt);  
         (void)vsnprintf(buf, sizeof(buf) - 1, fmt, ap);  
         va_end(ap);  
         return((*mdoc->cb.mdoc_err)(mdoc->data, line, pos, buf));  
 }  
   
   
 int  
 mdoc_macro(struct mdoc *m, int tok,  mdoc_macro(struct mdoc *m, int tok,
                 int ln, int pp, int *pos, char *buf)                  int ln, int pp, int *pos, char *buf)
 {  {
   
         /* FIXME - these should happen during validation. */  
   
         if (MDOC_PROLOGUE & mdoc_macros[tok].flags &&          if (MDOC_PROLOGUE & mdoc_macros[tok].flags &&
                         SEC_PROLOGUE != m->lastnamed)                          MDOC_PBODY & m->flags)
                 return(perr(m, ln, pp, EPROLBODY));                  return(mdoc_perr(m, ln, pp, EPROLBODY));
   
         if ( ! (MDOC_PROLOGUE & mdoc_macros[tok].flags) &&          if ( ! (MDOC_PROLOGUE & mdoc_macros[tok].flags) &&
                         SEC_PROLOGUE == m->lastnamed)                          ! (MDOC_PBODY & m->flags))
                 return(perr(m, ln, pp, EBODYPROL));                  return(mdoc_perr(m, ln, pp, EBODYPROL));
   
         if (1 != pp && ! (MDOC_CALLABLE & mdoc_macros[tok].flags))          if (1 != pp && ! (MDOC_CALLABLE & mdoc_macros[tok].flags))
                 return(perr(m, ln, pp, ENOCALL));                  return(mdoc_perr(m, ln, pp, ENOCALL));
   
         return((*mdoc_macros[tok].fp)(m, tok, ln, pp, pos, buf));          return((*mdoc_macros[tok].fp)(m, tok, ln, pp, pos, buf));
 }  }
   
   
 static int  static int
 perr(struct mdoc *m, int line, int pos, enum merr type)  
 {  
         char            *p;  
   
         p = NULL;  
         switch (type) {  
         case (ENOCALL):  
                 p = "not callable";  
                 break;  
         case (EPROLBODY):  
                 p = "macro disallowed in document body";  
                 break;  
         case (EBODYPROL):  
                 p = "macro disallowed in document prologue";  
                 break;  
         case (EMALLOC):  
                 p = "memory exhausted";  
                 break;  
         case (ETEXTPROL):  
                 p = "text disallowed in document prologue";  
                 break;  
         case (ENOBLANK):  
                 p = "blank lines disallowed in non-literal contexts";  
                 break;  
         case (ESPACE):  
                 p = "whitespace disallowed after delimiter";  
                 break;  
         }  
         assert(p);  
         return(mdoc_perr(m, line, pos, p));  
 }  
   
   
 static int  
 node_append(struct mdoc *mdoc, struct mdoc_node *p)  node_append(struct mdoc *mdoc, struct mdoc_node *p)
 {  {
   
Line 434  node_append(struct mdoc *mdoc, struct mdoc_node *p)
Line 386  node_append(struct mdoc *mdoc, struct mdoc_node *p)
                 /* NOTREACHED */                  /* NOTREACHED */
         }          }
   
           p->parent->nchild++;
   
         if ( ! mdoc_valid_pre(mdoc, p))          if ( ! mdoc_valid_pre(mdoc, p))
                 return(0);                  return(0);
         if ( ! mdoc_action_pre(mdoc, p))          if ( ! mdoc_action_pre(mdoc, p))
Line 480  node_alloc(struct mdoc *mdoc, int line, 
Line 434  node_alloc(struct mdoc *mdoc, int line, 
         struct mdoc_node *p;          struct mdoc_node *p;
   
         if (NULL == (p = calloc(1, sizeof(struct mdoc_node)))) {          if (NULL == (p = calloc(1, sizeof(struct mdoc_node)))) {
                 (void)perr(mdoc, (mdoc)->last->line,                  (void)mdoc_nerr(mdoc, mdoc->last, EMALLOC);
                                 (mdoc)->last->pos, EMALLOC);  
                 return(NULL);                  return(NULL);
         }          }
   
Line 577  mdoc_word_alloc(struct mdoc *mdoc, 
Line 530  mdoc_word_alloc(struct mdoc *mdoc, 
         if (NULL == p)          if (NULL == p)
                 return(0);                  return(0);
         if (NULL == (p->string = strdup(word))) {          if (NULL == (p->string = strdup(word))) {
                 (void)perr(mdoc, (mdoc)->last->line,                  (void)mdoc_nerr(mdoc, mdoc->last, EMALLOC);
                                 (mdoc)->last->pos, EMALLOC);  
                 return(0);                  return(0);
         }          }
   
         return(node_append(mdoc, p));          return(node_append(mdoc, p));
 }  }
   
Line 589  void
Line 542  void
 mdoc_node_free(struct mdoc_node *p)  mdoc_node_free(struct mdoc_node *p)
 {  {
   
           if (p->parent)
                   p->parent->nchild--;
         if (p->string)          if (p->string)
                 free(p->string);                  free(p->string);
         if (p->args)          if (p->args)
Line 606  mdoc_node_freelist(struct mdoc_node *p)
Line 561  mdoc_node_freelist(struct mdoc_node *p)
         if (p->next)          if (p->next)
                 mdoc_node_freelist(p->next);                  mdoc_node_freelist(p->next);
   
           assert(0 == p->nchild);
         mdoc_node_free(p);          mdoc_node_free(p);
 }  }
   
Line 618  static int
Line 574  static int
 parsetext(struct mdoc *m, int line, char *buf)  parsetext(struct mdoc *m, int line, char *buf)
 {  {
   
         if (SEC_PROLOGUE == m->lastnamed)          if (SEC_NONE == m->lastnamed)
                 return(perr(m, line, 0, ETEXTPROL));                  return(mdoc_perr(m, line, 0, ETEXTPROL));
   
         if (0 == buf[0] && ! (MDOC_LITERAL & m->flags))          if (0 == buf[0] && ! (MDOC_LITERAL & m->flags))
                 return(perr(m, line, 0, ENOBLANK));                  return(mdoc_perr(m, line, 0, ENOBLANK));
   
         if ( ! mdoc_word_alloc(m, line, 0, buf))          if ( ! mdoc_word_alloc(m, line, 0, buf))
                 return(0);                  return(0);
Line 636  static int
Line 592  static int
 macrowarn(struct mdoc *m, int ln, const char *buf)  macrowarn(struct mdoc *m, int ln, const char *buf)
 {  {
         if ( ! (MDOC_IGN_MACRO & m->pflags))          if ( ! (MDOC_IGN_MACRO & m->pflags))
                 return(mdoc_perr(m, ln, 1,                  return(mdoc_verr(m, ln, 1,
                                 "unknown macro: %s%s",                                  "unknown macro: %s%s",
                                 buf, strlen(buf) > 3 ? "..." : ""));                                  buf, strlen(buf) > 3 ? "..." : ""));
         return(mdoc_pwarn(m, ln, 1, WARN_SYNTAX,          return(mdoc_vwarn(m, ln, 1, "unknown macro: %s%s",
                                 "unknown macro: %s%s",  
                                 buf, strlen(buf) > 3 ? "..." : ""));                                  buf, strlen(buf) > 3 ? "..." : ""));
 }  }
   
Line 666  parsemacro(struct mdoc *m, int ln, char *buf)
Line 621  parsemacro(struct mdoc *m, int ln, char *buf)
                         i++;                          i++;
                 if (0 == buf[i])                  if (0 == buf[i])
                         return(1);                          return(1);
                 return(perr(m, ln, 1, ESPACE));                  return(mdoc_perr(m, ln, 1, ESPACE));
         }          }
   
         /* Copy the first word into a nil-terminated buffer. */          /* Copy the first word into a nil-terminated buffer. */
Legend:
Removed from v.1.84  
changed lines
  Added in v.1.89
CVSweb