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

Diff for /mandoc/man.c between version 1.38 and 1.53

version 1.38, 2009/08/22 08:56:16 version 1.53, 2010/03/23 21:50:43
Line 14 
Line 14 
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF   * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.   * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */   */
   #ifdef HAVE_CONFIG_H
   #include "config.h"
   #endif
   
   #include <sys/types.h>
   
 #include <assert.h>  #include <assert.h>
 #include <ctype.h>  #include <ctype.h>
 #include <stdarg.h>  #include <stdarg.h>
Line 22 
Line 28 
 #include <string.h>  #include <string.h>
   
 #include "libman.h"  #include "libman.h"
   #include "libmandoc.h"
   
 const   char *const __man_merrnames[WERRMAX] = {  const   char *const __man_merrnames[WERRMAX] = {
         "invalid character", /* WNPRINT */          "invalid character", /* WNPRINT */
         "system: malloc error", /* WNMEM */  
         "invalid manual section", /* WMSEC */          "invalid manual section", /* WMSEC */
         "invalid date format", /* WDATE */          "invalid date format", /* WDATE */
         "scope of prior line violated", /* WLNSCOPE */          "scope of prior line violated", /* WLNSCOPE */
           "over-zealous prior line scope violation", /* WLNSCOPE2 */
         "trailing whitespace", /* WTSPACE */          "trailing whitespace", /* WTSPACE */
         "unterminated quoted parameter", /* WTQUOTE */          "unterminated quoted parameter", /* WTQUOTE */
         "document has no body", /* WNODATA */          "document has no body", /* WNODATA */
Line 38  const char *const __man_merrnames[WERRMAX] = {   
Line 45  const char *const __man_merrnames[WERRMAX] = {   
         "expected block head arguments", /* WHEADARGS */          "expected block head arguments", /* WHEADARGS */
         "expected block body arguments", /* WBODYARGS */          "expected block body arguments", /* WBODYARGS */
         "expected empty block head", /* WNHEADARGS */          "expected empty block head", /* WNHEADARGS */
         "unknown macro", /* WMACRO */  
         "ill-formed macro", /* WMACROFORM */          "ill-formed macro", /* WMACROFORM */
         "scope open on exit", /* WEXITSCOPE */          "scope open on exit", /* WEXITSCOPE */
         "no scope context", /* WNOSCOPE */          "no scope context", /* WNOSCOPE */
Line 54  const char *const __man_macronames[MAN_MAX] = {   
Line 60  const char *const __man_macronames[MAN_MAX] = {   
         "R",            "B",            "I",            "IR",          "R",            "B",            "I",            "IR",
         "RI",           "na",           "i",            "sp",          "RI",           "na",           "i",            "sp",
         "nf",           "fi",           "r",            "RE",          "nf",           "fi",           "r",            "RE",
         "RS",           "DT"          "RS",           "DT",           "UC",           "PD",
           "Sp",           "Vb",           "Ve",
         };          };
   
 const   char * const *man_macronames = __man_macronames;  const   char * const *man_macronames = __man_macronames;
   
 static  struct man_node *man_node_alloc(int, int,  static  struct man_node *man_node_alloc(int, int,
                                 enum man_type, int);                                  enum man_type, enum mant);
 static  int              man_node_append(struct man *,  static  int              man_node_append(struct man *,
                                 struct man_node *);                                  struct man_node *);
 static  int              man_ptext(struct man *, int, char *);  static  int              man_ptext(struct man *, int, char *);
 static  int              man_pmacro(struct man *, int, char *);  static  int              man_pmacro(struct man *, int, char *);
 static  void             man_free1(struct man *);  static  void             man_free1(struct man *);
 static  int              man_alloc1(struct man *);  static  void             man_alloc1(struct man *);
 static  int              pstring(struct man *, int, int,  static  int              pstring(struct man *, int, int,
                                 const char *, size_t);                                  const char *, size_t);
   static  int              macrowarn(struct man *, int, const char *);
   
 #ifdef __linux__  
 extern  size_t            strlcpy(char *, const char *, size_t);  
 #endif  
   
   
 const struct man_node *  const struct man_node *
 man_node(const struct man *m)  man_node(const struct man *m)
 {  {
Line 91  man_meta(const struct man *m)
Line 95  man_meta(const struct man *m)
 }  }
   
   
 int  void
 man_reset(struct man *man)  man_reset(struct man *man)
 {  {
   
         man_free1(man);          man_free1(man);
         return(man_alloc1(man));          man_alloc1(man);
 }  }
   
   
Line 105  man_free(struct man *man)
Line 109  man_free(struct man *man)
 {  {
   
         man_free1(man);          man_free1(man);
   
         if (man->htab)  
                 man_hash_free(man->htab);  
         free(man);          free(man);
 }  }
   
Line 117  man_alloc(void *data, int pflags, const struct man_cb 
Line 118  man_alloc(void *data, int pflags, const struct man_cb 
 {  {
         struct man      *p;          struct man      *p;
   
         if (NULL == (p = calloc(1, sizeof(struct man))))          p = mandoc_calloc(1, sizeof(struct man));
                 return(NULL);  
   
         if ( ! man_alloc1(p)) {          if (cb)
                 free(p);                  memcpy(&p->cb, cb, sizeof(struct man_cb));
                 return(NULL);  
         }  
   
           man_hash_init();
         p->data = data;          p->data = data;
         p->pflags = pflags;          p->pflags = pflags;
         (void)memcpy(&p->cb, cb, sizeof(struct man_cb));  
   
         if (NULL == (p->htab = man_hash_alloc())) {          man_alloc1(p);
                 free(p);  
                 return(NULL);  
         }  
         return(p);          return(p);
 }  }
   
Line 175  man_free1(struct man *man)
Line 170  man_free1(struct man *man)
 }  }
   
   
 static int  static void
 man_alloc1(struct man *m)  man_alloc1(struct man *m)
 {  {
   
         bzero(&m->meta, sizeof(struct man_meta));          memset(&m->meta, 0, sizeof(struct man_meta));
         m->flags = 0;          m->flags = 0;
         m->last = calloc(1, sizeof(struct man_node));          m->last = mandoc_calloc(1, sizeof(struct man_node));
         if (NULL == m->last)  
                 return(0);  
         m->first = m->last;          m->first = m->last;
         m->last->type = MAN_ROOT;          m->last->type = MAN_ROOT;
         m->next = MAN_NEXT_CHILD;          m->next = MAN_NEXT_CHILD;
         return(1);  
 }  }
   
   
Line 250  man_node_append(struct man *man, struct man_node *p)
Line 242  man_node_append(struct man *man, struct man_node *p)
   
   
 static struct man_node *  static struct man_node *
 man_node_alloc(int line, int pos, enum man_type type, int tok)  man_node_alloc(int line, int pos, enum man_type type, enum mant tok)
 {  {
         struct man_node *p;          struct man_node *p;
   
         p = calloc(1, sizeof(struct man_node));          p = mandoc_calloc(1, sizeof(struct man_node));
         if (NULL == p)  
                 return(NULL);  
   
         p->line = line;          p->line = line;
         p->pos = pos;          p->pos = pos;
         p->type = type;          p->type = type;
Line 267  man_node_alloc(int line, int pos, enum man_type type, 
Line 256  man_node_alloc(int line, int pos, enum man_type type, 
   
   
 int  int
 man_elem_alloc(struct man *m, int line, int pos, int tok)  man_elem_alloc(struct man *m, int line, int pos, enum mant tok)
 {  {
         struct man_node *p;          struct man_node *p;
   
         p = man_node_alloc(line, pos, MAN_ELEM, tok);          p = man_node_alloc(line, pos, MAN_ELEM, tok);
         if (NULL == p)  
                 return(0);  
         if ( ! man_node_append(m, p))          if ( ! man_node_append(m, p))
                 return(0);                  return(0);
         m->next = MAN_NEXT_CHILD;          m->next = MAN_NEXT_CHILD;
Line 282  man_elem_alloc(struct man *m, int line, int pos, int t
Line 269  man_elem_alloc(struct man *m, int line, int pos, int t
   
   
 int  int
 man_head_alloc(struct man *m, int line, int pos, int tok)  man_head_alloc(struct man *m, int line, int pos, enum mant tok)
 {  {
         struct man_node *p;          struct man_node *p;
   
         p = man_node_alloc(line, pos, MAN_HEAD, tok);          p = man_node_alloc(line, pos, MAN_HEAD, tok);
         if (NULL == p)  
                 return(0);  
         if ( ! man_node_append(m, p))          if ( ! man_node_append(m, p))
                 return(0);                  return(0);
         m->next = MAN_NEXT_CHILD;          m->next = MAN_NEXT_CHILD;
Line 297  man_head_alloc(struct man *m, int line, int pos, int t
Line 282  man_head_alloc(struct man *m, int line, int pos, int t
   
   
 int  int
 man_body_alloc(struct man *m, int line, int pos, int tok)  man_body_alloc(struct man *m, int line, int pos, enum mant tok)
 {  {
         struct man_node *p;          struct man_node *p;
   
         p = man_node_alloc(line, pos, MAN_BODY, tok);          p = man_node_alloc(line, pos, MAN_BODY, tok);
         if (NULL == p)  
                 return(0);  
         if ( ! man_node_append(m, p))          if ( ! man_node_append(m, p))
                 return(0);                  return(0);
         m->next = MAN_NEXT_CHILD;          m->next = MAN_NEXT_CHILD;
Line 312  man_body_alloc(struct man *m, int line, int pos, int t
Line 295  man_body_alloc(struct man *m, int line, int pos, int t
   
   
 int  int
 man_block_alloc(struct man *m, int line, int pos, int tok)  man_block_alloc(struct man *m, int line, int pos, enum mant tok)
 {  {
         struct man_node *p;          struct man_node *p;
   
         p = man_node_alloc(line, pos, MAN_BLOCK, tok);          p = man_node_alloc(line, pos, MAN_BLOCK, tok);
         if (NULL == p)  
                 return(0);  
         if ( ! man_node_append(m, p))          if ( ! man_node_append(m, p))
                 return(0);                  return(0);
         m->next = MAN_NEXT_CHILD;          m->next = MAN_NEXT_CHILD;
Line 333  pstring(struct man *m, int line, int pos, 
Line 314  pstring(struct man *m, int line, int pos, 
         struct man_node *n;          struct man_node *n;
         size_t           sv;          size_t           sv;
   
         n = man_node_alloc(line, pos, MAN_TEXT, -1);          n = man_node_alloc(line, pos, MAN_TEXT, MAN_MAX);
         if (NULL == n)          n->string = mandoc_malloc(len + 1);
                 return(0);  
   
         n->string = malloc(len + 1);  
         if (NULL == n->string) {  
                 free(n);  
                 return(0);  
         }  
   
         sv = strlcpy(n->string, p, len + 1);          sv = strlcpy(n->string, p, len + 1);
   
         /* Prohibit truncation. */          /* Prohibit truncation. */
Line 394  static int
Line 367  static int
 man_ptext(struct man *m, int line, char *buf)  man_ptext(struct man *m, int line, char *buf)
 {  {
         int              i, j;          int              i, j;
           char             sv;
   
         /* Literal free-form text whitespace is preserved. */          /* Literal free-form text whitespace is preserved. */
   
Line 407  man_ptext(struct man *m, int line, char *buf)
Line 381  man_ptext(struct man *m, int line, char *buf)
   
         for (i = 0; ' ' == buf[i]; i++)          for (i = 0; ' ' == buf[i]; i++)
                 /* Skip leading whitespace. */ ;                  /* Skip leading whitespace. */ ;
         if (0 == buf[i]) {  
           if ('\0' == buf[i]) {
                   /* Trailing whitespace? */
                   if (i && ' ' == buf[i - 1])
                           if ( ! man_pwarn(m, line, i - 1, WTSPACE))
                                   return(0);
                 if ( ! pstring(m, line, 0, &buf[i], 0))                  if ( ! pstring(m, line, 0, &buf[i], 0))
                         return(0);                          return(0);
                 goto descope;                  goto descope;
Line 421  man_ptext(struct man *m, int line, char *buf)
Line 400  man_ptext(struct man *m, int line, char *buf)
                 if (i && ' ' == buf[i] && '\\' == buf[i - 1])                  if (i && ' ' == buf[i] && '\\' == buf[i - 1])
                         continue;                          continue;
   
                 buf[i++] = 0;                  sv = buf[i];
                   buf[i++] = '\0';
   
                 if ( ! pstring(m, line, j, &buf[j], (size_t)(i - j)))                  if ( ! pstring(m, line, j, &buf[j], (size_t)(i - j)))
                         return(0);                          return(0);
   
                   /* Trailing whitespace?  Check at overwritten byte. */
   
                   if (' ' == sv && '\0' == buf[i])
                           if ( ! man_pwarn(m, line, i - 1, WTSPACE))
                                   return(0);
   
                 for ( ; ' ' == buf[i]; i++)                  for ( ; ' ' == buf[i]; i++)
                         /* Skip trailing whitespace. */ ;                          /* Skip trailing whitespace. */ ;
   
                 j = i;                  j = i;
                 if (0 == buf[i])  
                   /* Trailing whitespace? */
   
                   if (' ' == buf[i - 1] && '\0' == buf[i])
                           if ( ! man_pwarn(m, line, i - 1, WTSPACE))
                                   return(0);
   
                   if ('\0' == buf[i])
                         break;                          break;
         }          }
   
Line 460  descope:
Line 454  descope:
 }  }
   
   
   static int
   macrowarn(struct man *m, int ln, const char *buf)
   {
           if ( ! (MAN_IGN_MACRO & m->pflags))
                   return(man_verr(m, ln, 0,
                                   "unknown macro: %s%s",
                                   buf, strlen(buf) > 3 ? "..." : ""));
           return(man_vwarn(m, ln, 0, "unknown macro: %s%s",
                                   buf, strlen(buf) > 3 ? "..." : ""));
   }
   
   
 int  int
 man_pmacro(struct man *m, int ln, char *buf)  man_pmacro(struct man *m, int ln, char *buf)
 {  {
         int              i, j, c, ppos, fl;          int              i, j, ppos, fl;
           enum mant        tok;
         char             mac[5];          char             mac[5];
         struct man_node *n;          struct man_node *n;
   
Line 471  man_pmacro(struct man *m, int ln, char *buf)
Line 478  man_pmacro(struct man *m, int ln, char *buf)
   
         fl = m->flags;          fl = m->flags;
   
         if (0 == buf[1])          if ('\0' == buf[1])
                 goto out;                  return(1);
   
         i = 1;          i = 1;
   
Line 480  man_pmacro(struct man *m, int ln, char *buf)
Line 487  man_pmacro(struct man *m, int ln, char *buf)
                 i++;                  i++;
                 while (buf[i] && ' ' == buf[i])                  while (buf[i] && ' ' == buf[i])
                         i++;                          i++;
                 if (0 == buf[i])                  if ('\0' == buf[i])
                         goto out;                          goto out;
         }          }
   
Line 489  man_pmacro(struct man *m, int ln, char *buf)
Line 496  man_pmacro(struct man *m, int ln, char *buf)
         /* Copy the first word into a nil-terminated buffer. */          /* Copy the first word into a nil-terminated buffer. */
   
         for (j = 0; j < 4; j++, i++) {          for (j = 0; j < 4; j++, i++) {
                 if (0 == (mac[j] = buf[i]))                  if ('\0' == (mac[j] = buf[i]))
                         break;                          break;
                 else if (' ' == buf[i])                  else if (' ' == buf[i])
                         break;                          break;
Line 501  man_pmacro(struct man *m, int ln, char *buf)
Line 508  man_pmacro(struct man *m, int ln, char *buf)
                 return(man_perr(m, ln, i, WNPRINT));                  return(man_perr(m, ln, i, WNPRINT));
         }          }
   
         mac[j] = 0;          mac[j] = '\0';
   
         if (j == 4 || j < 1) {          if (j == 4 || j < 1) {
                 if ( ! (MAN_IGN_MACRO & m->pflags)) {                  if ( ! (MAN_IGN_MACRO & m->pflags)) {
Line 513  man_pmacro(struct man *m, int ln, char *buf)
Line 520  man_pmacro(struct man *m, int ln, char *buf)
                 return(1);                  return(1);
         }          }
   
         if (MAN_MAX == (c = man_hash_find(m->htab, mac))) {          if (MAN_MAX == (tok = man_hash_find(mac))) {
                 if ( ! (MAN_IGN_MACRO & m->pflags)) {                  if ( ! macrowarn(m, ln, mac))
                         (void)man_perr(m, ln, ppos, WMACRO);  
                         goto err;                          goto err;
                 }  
                 if ( ! man_pwarn(m, ln, ppos, WMACRO))  
                         goto err;  
                 return(1);                  return(1);
         }          }
   
Line 528  man_pmacro(struct man *m, int ln, char *buf)
Line 531  man_pmacro(struct man *m, int ln, char *buf)
         while (buf[i] && ' ' == buf[i])          while (buf[i] && ' ' == buf[i])
                 i++;                  i++;
   
         /* Remove prior ELINE macro, if applicable. */          /* Trailing whitespace? */
   
         if (m->flags & MAN_ELINE) {          if ('\0' == buf[i] && ' ' == buf[i - 1])
                   if ( ! man_pwarn(m, ln, i - 1, WTSPACE))
                           goto err;
   
           /*
            * Remove prior ELINE macro, as it's being clobbering by a new
            * macro.  Note that NSCOPED macros do not close out ELINE
            * macros---they don't print text---so we let those slip by.
            */
   
           if ( ! (MAN_NSCOPED & man_macros[tok].flags) &&
                           m->flags & MAN_ELINE) {
                   assert(MAN_TEXT != m->last->type);
   
                   /*
                    * This occurs in the following construction:
                    *   .B
                    *   .br
                    *   .B
                    *   .br
                    *   I hate man macros.
                    * Flat-out disallow this madness.
                    */
                   if (MAN_NSCOPED & man_macros[m->last->tok].flags)
                           return(man_perr(m, ln, ppos, WLNSCOPE));
   
                 n = m->last;                  n = m->last;
   
                   assert(n);
                 assert(NULL == n->child);                  assert(NULL == n->child);
                 assert(0 == n->nchild);                  assert(0 == n->nchild);
   
                 if ( ! man_nwarn(m, n, WLNSCOPE))                  if ( ! man_nwarn(m, n, WLNSCOPE))
                         return(0);                          return(0);
   
                 if (n->prev) {                  man_node_unlink(m, n);
                         assert(n != n->parent->child);  
                         assert(n == n->prev->next);  
                         n->prev->next = NULL;  
                         m->last = n->prev;  
                         m->next = MAN_NEXT_SIBLING;  
                 } else {  
                         assert(n == n->parent->child);  
                         n->parent->child = NULL;  
                         m->last = n->parent;  
                         m->next = MAN_NEXT_CHILD;  
                 }  
   
                 man_node_free(n);                  man_node_free(n);
                 m->flags &= ~MAN_ELINE;                  m->flags &= ~MAN_ELINE;
         }          }
   
         /* Begin recursive parse sequence. */          /* Begin recursive parse sequence. */
   
         assert(man_macros[c].fp);          assert(man_macros[tok].fp);
   
         if ( ! (*man_macros[c].fp)(m, c, ln, ppos, &i, buf))          if ( ! (*man_macros[tok].fp)(m, tok, ln, ppos, &i, buf))
                 goto err;                  goto err;
   
 out:  out:
         if ( ! (MAN_BLINE & fl))          /*
            * We weren't in a block-line scope when entering the
            * above-parsed macro, so return.
            */
   
           if ( ! (MAN_BLINE & fl)) {
                   m->flags &= ~MAN_ILINE;
                 return(1);                  return(1);
           }
   
           /*
            * If we're in a block scope, then allow this macro to slip by
            * without closing scope around it.
            */
   
           if (MAN_ILINE & m->flags) {
                   m->flags &= ~MAN_ILINE;
                   return(1);
           }
   
         /*          /*
          * If we've opened a new next-line element scope, then return           * If we've opened a new next-line element scope, then return
          * now, as the next line will close out the block scope.           * now, as the next line will close out the block scope.
Line 633  man_err(struct man *m, int line, int pos, int iserr, e
Line 669  man_err(struct man *m, int line, int pos, int iserr, e
                 return(man_verr(m, line, pos, p));                  return(man_verr(m, line, pos, p));
   
         return(man_vwarn(m, line, pos, p));          return(man_vwarn(m, line, pos, p));
   }
   
   
   void
   man_node_unlink(struct man *m, struct man_node *n)
   {
   
           if (n->prev) {
                   n->prev->next = n->next;
                   if (m->last == n) {
                           assert(NULL == n->next);
                           m->last = n->prev;
                           m->next = MAN_NEXT_SIBLING;
                   }
           } else {
                   n->parent->child = n->next;
                   if (m->last == n) {
                           assert(NULL == n->next);
                           m->last = n->parent;
                           m->next = MAN_NEXT_CHILD;
                   }
           }
   
           if (n->next)
                   n->next->prev = n->prev;
 }  }
Legend:
Removed from v.1.38  
changed lines
  Added in v.1.53
CVSweb