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

Diff for /mandoc/mdoc.c between version 1.86 and 1.99

version 1.86, 2009/06/18 20:46:19 version 1.99, 2009/08/13 11:43:24
Line 23 
Line 23 
   
 #include "libmdoc.h"  #include "libmdoc.h"
   
 enum    merr {  const   char *const __mdoc_merrnames[MERRMAX] = {
         ENOCALL,          "trailing whitespace", /* ETAILWS */
         EBODYPROL,          "unexpected quoted parameter", /* EQUOTPARM */
         EPROLBODY,          "unterminated quoted parameter", /* EQUOTTERM */
         ESPACE,          "system: malloc error", /* EMALLOC */
         ETEXTPROL,          "argument parameter suggested", /* EARGVAL */
         ENOBLANK,          "macro disallowed in prologue", /* EBODYPROL */
         EMALLOC          "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 */
           "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 */
           "no description found for library" /* ELIB */
 };  };
   
 const   char *const __mdoc_macronames[MDOC_MAX] = {  const   char *const __mdoc_macronames[MDOC_MAX] = {
Line 68  const char *const __mdoc_macronames[MDOC_MAX] = {   
Line 113  const char *const __mdoc_macronames[MDOC_MAX] = {   
         /* LINTED */          /* LINTED */
         "Brc",          "\%C",          "Es",           "En",          "Brc",          "\%C",          "Es",           "En",
         /* LINTED */          /* LINTED */
         "Dx",           "\%Q"          "Dx",           "\%Q",          "br",           "sp"
         };          };
   
 const   char *const __mdoc_argnames[MDOC_ARG_MAX] = {  const   char *const __mdoc_argnames[MDOC_ARG_MAX] = {
Line 95  static int    node_append(struct mdoc *, 
Line 140  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);  static  int               pstring(struct mdoc *, int, int,
                                   const char *, size_t);
   
   #ifdef __linux__
   extern  size_t            strlcpy(char *, const char *, size_t);
   #endif
   
   
 const struct mdoc_node *  const struct mdoc_node *
 mdoc_node(const struct mdoc *m)  mdoc_node(const struct mdoc *m)
 {  {
Line 259  mdoc_verr(struct mdoc *mdoc, int ln, int pos, 
Line 310  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 276  mdoc_vwarn(struct mdoc *mdoc, int ln, int pos, 
Line 327  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)
 {  {
           /*
            * If we're in the prologue, deny "body" macros.  Similarly, if
            * we're in the body, deny prologue calls.
            */
         if (MDOC_PROLOGUE & mdoc_macros[tok].flags &&          if (MDOC_PROLOGUE & mdoc_macros[tok].flags &&
                         MDOC_PBODY & m->flags)                          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) &&
                         ! (MDOC_PBODY & m->flags))                          ! (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))  
                 return(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 484  node_append(struct mdoc *mdoc, struct mdoc_node *p)
Line 431  node_append(struct mdoc *mdoc, struct mdoc_node *p)
   
   
 static struct mdoc_node *  static struct mdoc_node *
 node_alloc(struct mdoc *mdoc, int line,  node_alloc(struct mdoc *m, int line,
                 int pos, int tok, enum mdoc_type type)                  int pos, int tok, enum mdoc_type type)
 {  {
         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(m, m->last, EMALLOC);
                                 (mdoc)->last->pos, EMALLOC);  
                 return(NULL);                  return(NULL);
         }          }
   
         p->sec = mdoc->lastsec;          p->sec = m->lastsec;
         p->line = line;          p->line = line;
         p->pos = pos;          p->pos = pos;
         p->tok = tok;          p->tok = tok;
Line 507  node_alloc(struct mdoc *mdoc, int line, 
Line 453  node_alloc(struct mdoc *mdoc, int line, 
   
   
 int  int
 mdoc_tail_alloc(struct mdoc *mdoc, int line, int pos, int tok)  mdoc_tail_alloc(struct mdoc *m, int line, int pos, int tok)
 {  {
         struct mdoc_node *p;          struct mdoc_node *p;
   
         p = node_alloc(mdoc, line, pos, tok, MDOC_TAIL);          p = node_alloc(m, line, pos, tok, MDOC_TAIL);
         if (NULL == p)          if (NULL == p)
                 return(0);                  return(0);
         return(node_append(mdoc, p));          return(node_append(m, p));
 }  }
   
   
 int  int
 mdoc_head_alloc(struct mdoc *mdoc, int line, int pos, int tok)  mdoc_head_alloc(struct mdoc *m, int line, int pos, int tok)
 {  {
         struct mdoc_node *p;          struct mdoc_node *p;
   
         assert(mdoc->first);          assert(m->first);
         assert(mdoc->last);          assert(m->last);
   
         p = node_alloc(mdoc, line, pos, tok, MDOC_HEAD);          p = node_alloc(m, line, pos, tok, MDOC_HEAD);
         if (NULL == p)          if (NULL == p)
                 return(0);                  return(0);
         return(node_append(mdoc, p));          return(node_append(m, p));
 }  }
   
   
 int  int
 mdoc_body_alloc(struct mdoc *mdoc, int line, int pos, int tok)  mdoc_body_alloc(struct mdoc *m, int line, int pos, int tok)
 {  {
         struct mdoc_node *p;          struct mdoc_node *p;
   
         p = node_alloc(mdoc, line, pos, tok, MDOC_BODY);          p = node_alloc(m, line, pos, tok, MDOC_BODY);
         if (NULL == p)          if (NULL == p)
                 return(0);                  return(0);
         return(node_append(mdoc, p));          return(node_append(m, p));
 }  }
   
   
 int  int
 mdoc_block_alloc(struct mdoc *mdoc, int line, int pos,  mdoc_block_alloc(struct mdoc *m, int line, int pos,
                 int tok, struct mdoc_arg *args)                  int tok, struct mdoc_arg *args)
 {  {
         struct mdoc_node *p;          struct mdoc_node *p;
   
         p = node_alloc(mdoc, line, pos, tok, MDOC_BLOCK);          p = node_alloc(m, line, pos, tok, MDOC_BLOCK);
         if (NULL == p)          if (NULL == p)
                 return(0);                  return(0);
         p->args = args;          p->args = args;
         if (p->args)          if (p->args)
                 (args->refcnt)++;                  (args->refcnt)++;
         return(node_append(mdoc, p));          return(node_append(m, p));
 }  }
   
   
 int  int
 mdoc_elem_alloc(struct mdoc *mdoc, int line, int pos,  mdoc_elem_alloc(struct mdoc *m, int line, int pos,
                 int tok, struct mdoc_arg *args)                  int tok, struct mdoc_arg *args)
 {  {
         struct mdoc_node *p;          struct mdoc_node *p;
   
         p = node_alloc(mdoc, line, pos, tok, MDOC_ELEM);          p = node_alloc(m, line, pos, tok, MDOC_ELEM);
         if (NULL == p)          if (NULL == p)
                 return(0);                  return(0);
         p->args = args;          p->args = args;
         if (p->args)          if (p->args)
                 (args->refcnt)++;                  (args->refcnt)++;
         return(node_append(mdoc, p));          return(node_append(m, p));
 }  }
   
   
 int  static int
 mdoc_word_alloc(struct mdoc *mdoc,  pstring(struct mdoc *m, int line, int pos, const char *p, size_t len)
                 int line, int pos, const char *word)  
 {  {
         struct mdoc_node *p;          struct mdoc_node *n;
           size_t            sv;
   
         p = node_alloc(mdoc, line, pos, -1, MDOC_TEXT);          n = node_alloc(m, line, pos, -1, MDOC_TEXT);
         if (NULL == p)          if (NULL == n)
                 return(0);                  return(mdoc_nerr(m, m->last, EMALLOC));
         if (NULL == (p->string = strdup(word))) {  
                 (void)perr(mdoc, (mdoc)->last->line,          n->string = malloc(len + 1);
                                 (mdoc)->last->pos, EMALLOC);          if (NULL == n->string) {
                 return(0);                  free(n);
                   return(mdoc_nerr(m, m->last, EMALLOC));
         }          }
         return(node_append(mdoc, p));  
           sv = strlcpy(n->string, p, len + 1);
   
           /* Prohibit truncation. */
           assert(sv < len + 1);
   
           return(node_append(m, n));
 }  }
   
   
   int
   mdoc_word_alloc(struct mdoc *m, int line, int pos, const char *p)
   {
   
           return(pstring(m, line, pos, p, strlen(p)));
   }
   
   
 void  void
 mdoc_node_free(struct mdoc_node *p)  mdoc_node_free(struct mdoc_node *p)
 {  {
Line 630  mdoc_node_freelist(struct mdoc_node *p)
Line 591  mdoc_node_freelist(struct mdoc_node *p)
 static int  static int
 parsetext(struct mdoc *m, int line, char *buf)  parsetext(struct mdoc *m, int line, char *buf)
 {  {
           int              i, j;
   
         if (SEC_NONE == m->lastnamed)          if (SEC_NONE == m->lastnamed)
                 return(perr(m, line, 0, ETEXTPROL));                  return(mdoc_perr(m, line, 0, ETEXTPROL));
   
           /*
            * If in literal mode, then pass the buffer directly to the
            * back-end, as it should be preserved as a single term.
            */
   
         if (0 == buf[0] && ! (MDOC_LITERAL & m->flags))          if (MDOC_LITERAL & m->flags) {
                 return(perr(m, line, 0, ENOBLANK));                  if ( ! mdoc_word_alloc(m, line, 0, buf))
                           return(0);
                   m->next = MDOC_NEXT_SIBLING;
                   return(1);
           }
   
         if ( ! mdoc_word_alloc(m, line, 0, buf))          /* Disallow blank/white-space lines in non-literal mode. */
   
           for (i = 0; ' ' == buf[i]; i++)
                   /* Skip leading whitespace. */ ;
           if (0 == buf[i])
                   return(mdoc_perr(m, line, 0, ENOBLANK));
   
           /*
            * Break apart a free-form line into tokens.  Spaces are
            * stripped out of the input.
            */
   
           for (j = i; buf[i]; i++) {
                   if (' ' != buf[i])
                           continue;
   
                   /* Escaped whitespace. */
                   if (i && ' ' == buf[i] && '\\' == buf[i - 1])
                           continue;
   
                   buf[i++] = 0;
                   if ( ! pstring(m, line, j, &buf[j], (size_t)(i - j)))
                           return(0);
                   m->next = MDOC_NEXT_SIBLING;
   
                   for ( ; ' ' == buf[i]; i++)
                           /* Skip trailing whitespace. */ ;
   
                   j = i;
                   if (0 == buf[i])
                           break;
           }
   
           if (j != i && ! pstring(m, line, j, &buf[j], (size_t)(i - j)))
                 return(0);                  return(0);
   
         m->next = MDOC_NEXT_SIBLING;          m->next = MDOC_NEXT_SIBLING;
Line 645  parsetext(struct mdoc *m, int line, char *buf)
Line 649  parsetext(struct mdoc *m, int line, char *buf)
 }  }
   
   
   
   
 static int  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, 0,
                                 "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, 0, "unknown macro: %s%s",
                                 "unknown macro: %s%s",  
                                 buf, strlen(buf) > 3 ? "..." : ""));                                  buf, strlen(buf) > 3 ? "..." : ""));
 }  }
   
Line 670  parsemacro(struct mdoc *m, int ln, char *buf)
Line 675  parsemacro(struct mdoc *m, int ln, char *buf)
   
         /* Empty lines are ignored. */          /* Empty lines are ignored. */
   
           /* FIXME: this can accept `.    xx' like libman! */
   
         if (0 == buf[1])          if (0 == buf[1])
                 return(1);                  return(1);
   
Line 679  parsemacro(struct mdoc *m, int ln, char *buf)
Line 686  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. */
Line 710  parsemacro(struct mdoc *m, int ln, char *buf)
Line 717  parsemacro(struct mdoc *m, int ln, char *buf)
         while (buf[i] && ' ' == buf[i])          while (buf[i] && ' ' == buf[i])
                 i++;                  i++;
   
         /* Begin recursive parse sequence. */          /*
            * Begin recursive parse sequence.  Since we're at the start of
            * the line, we don't need to do callable/parseable checks.
            */
         if ( ! mdoc_macro(m, c, ln, 1, &i, buf))          if ( ! mdoc_macro(m, c, ln, 1, &i, buf))
                 goto err;                  goto err;
   

Legend:
Removed from v.1.86  
changed lines
  Added in v.1.99

CVSweb