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

Diff for /mandoc/html.c between version 1.2 and 1.109

version 1.2, 2008/12/03 19:21:58 version 1.109, 2010/07/23 00:08:57
Line 1 
Line 1 
 /* $Id$ */  /*      $Id$ */
 /*  /*
  * Copyright (c) 2008 Kristaps Dzonsons <kristaps@kth.se>   * Copyright (c) 2008, 2009, 2010 Kristaps Dzonsons <kristaps@bsd.lv>
  *   *
  * Permission to use, copy, modify, and distribute this software for any   * Permission to use, copy, modify, and distribute this software for any
  * purpose with or without fee is hereby granted, provided that the   * purpose with or without fee is hereby granted, provided that the above
  * above copyright notice and this permission notice appear in all   * copyright notice and this permission notice appear in all copies.
  * copies.  
  *   *
  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL   * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED   * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE   * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL   * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR   * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER   * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR   * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  * 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 <stdarg.h>
   #include <stdio.h>
   #include <stdint.h>
 #include <stdlib.h>  #include <stdlib.h>
 #include <string.h>  #include <string.h>
   #include <unistd.h>
   
 #include "libmdocml.h"  #include "mandoc.h"
 #include "private.h"  #include "out.h"
 #include "ml.h"  #include "chars.h"
   #include "html.h"
   #include "main.h"
   
   struct  htmldata {
           const char       *name;
           int               flags;
   #define HTML_CLRLINE     (1 << 0)
   #define HTML_NOSTACK     (1 << 1)
   #define HTML_AUTOCLOSE   (1 << 2) /* Tag has auto-closure. */
   };
   
 static  ssize_t         html_endtag(struct md_mbuf *,  static  const struct htmldata htmltags[TAG_MAX] = {
                                 const struct md_args *,          {"html",        HTML_CLRLINE}, /* TAG_HTML */
                                 enum md_ns, int);          {"head",        HTML_CLRLINE}, /* TAG_HEAD */
 static  ssize_t         html_begintag(struct md_mbuf *,          {"body",        HTML_CLRLINE}, /* TAG_BODY */
                                 const struct md_args *,          {"meta",        HTML_CLRLINE | HTML_NOSTACK | HTML_AUTOCLOSE}, /* TAG_META */
                                 enum md_ns, int,          {"title",       HTML_CLRLINE}, /* TAG_TITLE */
                                 const int *, const char **);          {"div",         HTML_CLRLINE}, /* TAG_DIV */
 static  int             html_begin(struct md_mbuf *,          {"h1",          0}, /* TAG_H1 */
                                 const struct md_args *);          {"h2",          0}, /* TAG_H2 */
 static  int             html_end(struct md_mbuf *,          {"span",        0}, /* TAG_SPAN */
                                 const struct md_args *);          {"link",        HTML_CLRLINE | HTML_NOSTACK | HTML_AUTOCLOSE}, /* TAG_LINK */
 static  ssize_t         html_blocktagname(struct md_mbuf *,          {"br",          HTML_CLRLINE | HTML_NOSTACK | HTML_AUTOCLOSE}, /* TAG_BR */
                                 const struct md_args *, int);          {"a",           0}, /* TAG_A */
 static  ssize_t         html_blocktagargs(struct md_mbuf *,          {"table",       HTML_CLRLINE}, /* TAG_TABLE */
                                 const struct md_args *, int,          {"col",         HTML_CLRLINE | HTML_NOSTACK | HTML_AUTOCLOSE}, /* TAG_COL */
                                 const int *, const char **);          {"tr",          HTML_CLRLINE}, /* TAG_TR */
 static  ssize_t         html_inlinetagname(struct md_mbuf *,          {"td",          HTML_CLRLINE}, /* TAG_TD */
                                 const struct md_args *, int);          {"li",          HTML_CLRLINE}, /* TAG_LI */
 static  ssize_t         html_inlinetagargs(struct md_mbuf *,          {"ul",          HTML_CLRLINE}, /* TAG_UL */
                                 const struct md_args *, int,          {"ol",          HTML_CLRLINE}, /* TAG_OL */
                                 const int *, const char **);  };
   
   static  const char      *const htmlfonts[HTMLFONT_MAX] = {
           "roman",
           "bold",
           "italic"
   };
   
 static int  static  const char      *const htmlattrs[ATTR_MAX] = {
 html_begin(struct md_mbuf *mbuf, const struct md_args *args)          "http-equiv",
           "content",
           "name",
           "rel",
           "href",
           "type",
           "media",
           "class",
           "style",
           "width",
           "valign",
           "target",
           "id",
           "summary",
   };
   
   static  void              print_spec(struct html *, enum roffdeco,
                                   const char *, size_t);
   static  void              print_res(struct html *, const char *, size_t);
   static  void              print_ctag(struct html *, enum htmltag);
   static  void              print_doctype(struct html *);
   static  void              print_xmltype(struct html *);
   static  int               print_encode(struct html *, const char *, int);
   static  void              print_metaf(struct html *, enum roffdeco);
   static  void              print_attr(struct html *,
                                   const char *, const char *);
   static  void             *ml_alloc(char *, enum htmltype);
   
   
   static void *
   ml_alloc(char *outopts, enum htmltype type)
 {  {
         size_t           res;          struct html     *h;
           const char      *toks[4];
           char            *v;
   
         res = 0;          toks[0] = "style";
         if ( ! ml_puts(mbuf, "<!DOCTYPE HTML PUBLIC \"-//W3C//DTD "          toks[1] = "man";
                                 "HTML 4.01//EN\" \"http://www.w3.org"          toks[2] = "includes";
                                 "/TR/html4/strict.dtd\">\n", &res))          toks[3] = NULL;
                 return(0);  
         if ( ! ml_puts(mbuf, "<html>\n", &res))  
                 return(0);  
         if ( ! ml_puts(mbuf, "<head>\n", &res))  
                 return(0);  
         if ( ! ml_puts(mbuf, " <title>Manual page</title>\n", &res))  
                 return(0);  
         if ( ! ml_puts(mbuf, " <meta http-equiv=\"Content-Type\" "  
                                 "content=\"text/html; "  
                                 "charset=utf-8\">\n", &res))  
                 return(0);  
         if ( ! ml_puts(mbuf, " <meta name=\"resource-type\" "  
                                 "content=\"document\">\n", &res))  
                 return(0);  
         if ( ! ml_puts(mbuf, "</head>\n", &res))  
                 return(0);  
         if ( ! ml_puts(mbuf, "<body>", &res))  
                 return(0);  
   
         return(1);          h = calloc(1, sizeof(struct html));
           if (NULL == h) {
                   perror(NULL);
                   exit(EXIT_FAILURE);
           }
   
           h->type = type;
           h->tags.head = NULL;
           h->ords.head = NULL;
           h->symtab = chars_init(CHARS_HTML);
   
           while (outopts && *outopts)
                   switch (getsubopt(&outopts, UNCONST(toks), &v)) {
                   case (0):
                           h->style = v;
                           break;
                   case (1):
                           h->base_man = v;
                           break;
                   case (2):
                           h->base_includes = v;
                           break;
                   default:
                           break;
                   }
   
           return(h);
 }  }
   
   void *
   html_alloc(char *outopts)
   {
   
 static int          return(ml_alloc(outopts, HTML_HTML_4_01_STRICT));
 html_end(struct md_mbuf *mbuf, const struct md_args *args)  }
   
   
   void *
   xhtml_alloc(char *outopts)
 {  {
         size_t           res;  
   
         res = 0;          return(ml_alloc(outopts, HTML_XHTML_1_0_STRICT));
         if ( ! ml_puts(mbuf, "</body>\n</html>", &res))  }
                 return(0);  
   
         return(1);  
   void
   html_free(void *p)
   {
           struct tag      *tag;
           struct ord      *ord;
           struct html     *h;
   
           h = (struct html *)p;
   
           while ((ord = h->ords.head) != NULL) {
                   h->ords.head = ord->next;
                   free(ord);
           }
   
           while ((tag = h->tags.head) != NULL) {
                   h->tags.head = tag->next;
                   free(tag);
           }
   
           if (h->symtab)
                   chars_free(h->symtab);
   
           free(h);
 }  }
   
   
 static ssize_t  void
 html_blocktagname(struct md_mbuf *mbuf,  print_gen_head(struct html *h)
                 const struct md_args *args, int tok)  
 {  {
         size_t           res;          struct htmlpair  tag[4];
   
         res = 0;          tag[0].key = ATTR_HTTPEQUIV;
           tag[0].val = "Content-Type";
           tag[1].key = ATTR_CONTENT;
           tag[1].val = "text/html; charset=utf-8";
           print_otag(h, TAG_META, 2, tag);
   
         switch (tok) {          tag[0].key = ATTR_NAME;
         case (ROFF_Sh):          tag[0].val = "resource-type";
                 if ( ! ml_puts(mbuf, "blockquote", &res))          tag[1].key = ATTR_CONTENT;
                         return(-1);          tag[1].val = "document";
           print_otag(h, TAG_META, 2, tag);
   
           if (h->style) {
                   tag[0].key = ATTR_REL;
                   tag[0].val = "stylesheet";
                   tag[1].key = ATTR_HREF;
                   tag[1].val = h->style;
                   tag[2].key = ATTR_TYPE;
                   tag[2].val = "text/css";
                   tag[3].key = ATTR_MEDIA;
                   tag[3].val = "all";
                   print_otag(h, TAG_LINK, 4, tag);
           }
   }
   
   
   static void
   print_spec(struct html *h, enum roffdeco d, const char *p, size_t len)
   {
           int              cp;
           const char      *rhs;
           size_t           sz;
   
           if ((cp = chars_spec2cp(h->symtab, p, len)) > 0) {
                   printf("&#%d;", cp);
                   return;
           } else if (-1 == cp && DECO_SSPECIAL == d) {
                   fwrite(p, 1, len, stdout);
                   return;
           } else if (-1 == cp)
                   return;
   
           if (NULL != (rhs = chars_spec2str(h->symtab, p, len, &sz)))
                   fwrite(rhs, 1, sz, stdout);
   }
   
   
   static void
   print_res(struct html *h, const char *p, size_t len)
   {
           int              cp;
           const char      *rhs;
           size_t           sz;
   
           if ((cp = chars_res2cp(h->symtab, p, len)) > 0) {
                   printf("&#%d;", cp);
                   return;
           } else if (-1 == cp)
                   return;
   
           if (NULL != (rhs = chars_res2str(h->symtab, p, len, &sz)))
                   fwrite(rhs, 1, sz, stdout);
   }
   
   
   struct tag *
   print_ofont(struct html *h, enum htmlfont font)
   {
           struct htmlpair  tag;
   
           h->metal = h->metac;
           h->metac = font;
   
           /* FIXME: DECO_ROMAN should just close out preexisting. */
   
           if (h->metaf && h->tags.head == h->metaf)
                   print_tagq(h, h->metaf);
   
           PAIR_CLASS_INIT(&tag, htmlfonts[font]);
           h->metaf = print_otag(h, TAG_SPAN, 1, &tag);
           return(h->metaf);
   }
   
   
   static void
   print_metaf(struct html *h, enum roffdeco deco)
   {
           enum htmlfont    font;
   
           switch (deco) {
           case (DECO_PREVIOUS):
                   font = h->metal;
                 break;                  break;
         case (ROFF_Bd):          case (DECO_ITALIC):
                 if ( ! ml_puts(mbuf, "pre", &res))                  font = HTMLFONT_ITALIC;
                         return(-1);  
                 break;                  break;
         case (ROFF_Bl):          case (DECO_BOLD):
                 if ( ! ml_puts(mbuf, "ul", &res))                  font = HTMLFONT_BOLD;
                         return(-1);  
                 break;                  break;
         case (ROFF_It):          case (DECO_ROMAN):
                 if ( ! ml_puts(mbuf, "li", &res))                  font = HTMLFONT_NONE;
                         return(-1);  
                 break;                  break;
         default:          default:
                 if ( ! ml_puts(mbuf, "div", &res))                  abort();
                         return(-1);                  /* NOTREACHED */
                 break;  
         }          }
   
         return((size_t)res);          (void)print_ofont(h, font);
 }  }
   
   
 /* ARGSUSED */  static int
 static ssize_t  print_encode(struct html *h, const char *p, int norecurse)
 html_blocktagargs(struct md_mbuf *mbuf, const struct md_args *args,  
                 int tok, const int *argc, const char **argv)  
 {  {
           size_t           sz;
           int              len, nospace;
           const char      *seq;
           enum roffdeco    deco;
           static const char rejs[6] = { '\\', '<', '>', '&', ASCII_HYPH, '\0' };
   
         switch (tok) {          nospace = 0;
         default:  
                 return(0);          for (; *p; p++) {
                   sz = strcspn(p, rejs);
   
                   fwrite(p, 1, sz, stdout);
                   p += /* LINTED */
                           sz;
   
                   if ('<' == *p) {
                           printf("&lt;");
                           continue;
                   } else if ('>' == *p) {
                           printf("&gt;");
                           continue;
                   } else if ('&' == *p) {
                           printf("&amp;");
                           continue;
                   } else if (ASCII_HYPH == *p) {
                           /*
                            * Note: "soft hyphens" aren't graphically
                            * displayed when not breaking the text; we want
                            * them to be displayed.
                            */
                           /*printf("&#173;");*/
                           putchar('-');
                           continue;
                   } else if ('\0' == *p)
                           break;
   
                   seq = ++p;
                   len = a2roffdeco(&deco, &seq, &sz);
   
                   switch (deco) {
                   case (DECO_RESERVED):
                           print_res(h, seq, sz);
                           break;
                   case (DECO_SSPECIAL):
                           /* FALLTHROUGH */
                   case (DECO_SPECIAL):
                           print_spec(h, deco, seq, sz);
                           break;
                   case (DECO_PREVIOUS):
                           /* FALLTHROUGH */
                   case (DECO_BOLD):
                           /* FALLTHROUGH */
                   case (DECO_ITALIC):
                           /* FALLTHROUGH */
                   case (DECO_ROMAN):
                           if (norecurse)
                                   break;
                           print_metaf(h, deco);
                           break;
                   default:
                           break;
                   }
   
                   p += len - 1;
   
                   if (DECO_NOSPACE == deco && '\0' == *(p + 1))
                           nospace = 1;
         }          }
   
         return(-1);          return(nospace);
 }  }
   
   
 /* ARGSUSED */  static void
 static ssize_t  print_attr(struct html *h, const char *key, const char *val)
 html_inlinetagargs(struct md_mbuf *mbuf, const struct md_args *args,  
                 int tok, const int *argc, const char **argv)  
 {  {
           printf(" %s=\"", key);
           (void)print_encode(h, val, 1);
           putchar('\"');
   }
   
         switch (tok) {  
         default:  struct tag *
                 return(0);  print_otag(struct html *h, enum htmltag tag,
                   int sz, const struct htmlpair *p)
   {
           int              i;
           struct tag      *t;
   
           /* Push this tags onto the stack of open scopes. */
   
           if ( ! (HTML_NOSTACK & htmltags[tag].flags)) {
                   t = malloc(sizeof(struct tag));
                   if (NULL == t) {
                           perror(NULL);
                           exit(EXIT_FAILURE);
                   }
                   t->tag = tag;
                   t->next = h->tags.head;
                   h->tags.head = t;
           } else
                   t = NULL;
   
           if ( ! (HTML_NOSPACE & h->flags))
                   if ( ! (HTML_CLRLINE & htmltags[tag].flags)) {
                           /* Manage keeps! */
                           if ( ! (HTML_KEEP & h->flags)) {
                                   if (HTML_PREKEEP & h->flags)
                                           h->flags |= HTML_KEEP;
                                   putchar(' ');
                           } else
                                   printf("&#160;");
                   }
   
           if ( ! (h->flags & HTML_NONOSPACE))
                   h->flags &= ~HTML_NOSPACE;
   
           /* Print out the tag name and attributes. */
   
           printf("<%s", htmltags[tag].name);
           for (i = 0; i < sz; i++)
                   print_attr(h, htmlattrs[p[i].key], p[i].val);
   
           /* Add non-overridable attributes. */
   
           if (TAG_HTML == tag && HTML_XHTML_1_0_STRICT == h->type) {
                   print_attr(h, "xmlns", "http://www.w3.org/1999/xhtml");
                   print_attr(h, "xml:lang", "en");
                   print_attr(h, "lang", "en");
         }          }
   
         return(-1);          /* Accomodate for XML "well-formed" singleton escaping. */
   
           if (HTML_AUTOCLOSE & htmltags[tag].flags)
                   switch (h->type) {
                   case (HTML_XHTML_1_0_STRICT):
                           putchar('/');
                           break;
                   default:
                           break;
                   }
   
           putchar('>');
   
           h->flags |= HTML_NOSPACE;
           return(t);
 }  }
   
   
 static ssize_t  static void
 html_inlinetagname(struct md_mbuf *mbuf,  print_ctag(struct html *h, enum htmltag tag)
                 const struct md_args *args, int tok)  
 {  {
         size_t           res;  
           printf("</%s>", htmltags[tag].name);
           if (HTML_CLRLINE & htmltags[tag].flags) {
                   h->flags |= HTML_NOSPACE;
                   putchar('\n');
           }
   }
   
         res = 0;  
   
         switch (tok) {  void
         case (ROFF_Sh):  print_gen_decls(struct html *h)
                 if ( ! ml_puts(mbuf, "h1", &res))  {
                         return(-1);  
           print_xmltype(h);
           print_doctype(h);
   }
   
   
   static void
   print_xmltype(struct html *h)
   {
   
           if (HTML_XHTML_1_0_STRICT == h->type)
                   printf("<?xml version=\"1.0\" encoding=\"UTF-8\"?>");
   }
   
   
   static void
   print_doctype(struct html *h)
   {
           const char      *doctype;
           const char      *dtd;
           const char      *name;
   
           switch (h->type) {
           case (HTML_HTML_4_01_STRICT):
                   name = "HTML";
                   doctype = "-//W3C//DTD HTML 4.01//EN";
                   dtd = "http://www.w3.org/TR/html4/strict.dtd";
                 break;                  break;
         case (ROFF_Ss):  
                 if ( ! ml_puts(mbuf, "h2", &res))  
                         return(-1);  
                 break;  
         default:          default:
                 if ( ! ml_puts(mbuf, "span", &res))                  name = "html";
                         return(-1);                  doctype = "-//W3C//DTD XHTML 1.0 Strict//EN";
                   dtd = "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd";
                 break;                  break;
         }          }
   
         return((ssize_t)res);          printf("<!DOCTYPE %s PUBLIC \"%s\" \"%s\">\n",
                           name, doctype, dtd);
 }  }
   
   
 static ssize_t  void
 html_begintag(struct md_mbuf *mbuf, const struct md_args *args,  print_text(struct html *h, const char *word)
                 enum md_ns ns, int tok,  
                 const int *argc, const char **argv)  
 {  {
   
         assert(ns != MD_NS_DEFAULT);          if (word[0] && '\0' == word[1])
         if (MD_NS_BLOCK == ns) {                  switch (word[0]) {
                 if ( ! html_blocktagname(mbuf, args, tok))                  case('.'):
                         return(0);                          /* FALLTHROUGH */
                 return(html_blocktagargs(mbuf, args,                  case(','):
                                         tok, argc, argv));                          /* FALLTHROUGH */
                   case(';'):
                           /* FALLTHROUGH */
                   case(':'):
                           /* FALLTHROUGH */
                   case('?'):
                           /* FALLTHROUGH */
                   case('!'):
                           /* FALLTHROUGH */
                   case(')'):
                           /* FALLTHROUGH */
                   case(']'):
                           if ( ! (HTML_IGNDELIM & h->flags))
                                   h->flags |= HTML_NOSPACE;
                           break;
                   default:
                           break;
                   }
   
           if ( ! (HTML_NOSPACE & h->flags)) {
                   /* Manage keeps! */
                   if ( ! (HTML_KEEP & h->flags)) {
                           if (HTML_PREKEEP & h->flags)
                                   h->flags |= HTML_KEEP;
                           putchar(' ');
                   } else
                           printf("&#160;");
         }          }
   
         if ( ! html_inlinetagname(mbuf, args, tok))          assert(word);
                 return(0);          if ( ! print_encode(h, word, 0))
         return(html_inlinetagargs(mbuf, args, tok, argc, argv));                  if ( ! (h->flags & HTML_NONOSPACE))
                           h->flags &= ~HTML_NOSPACE;
   
           /*
            * Note that we don't process the pipe: the parser sees it as
            * punctuation, but we don't in terms of typography.
            */
           if (word[0] && '\0' == word[1])
                   switch (word[0]) {
                   case('('):
                           /* FALLTHROUGH */
                   case('['):
                           h->flags |= HTML_NOSPACE;
                           break;
                   default:
                           break;
                   }
 }  }
   
   
 static ssize_t  void
 html_endtag(struct md_mbuf *mbuf, const struct md_args *args,  print_tagq(struct html *h, const struct tag *until)
                 enum md_ns ns, int tok)  
 {  {
           struct tag      *tag;
   
         assert(ns != MD_NS_DEFAULT);          while ((tag = h->tags.head) != NULL) {
         if (MD_NS_BLOCK == ns)                  if (tag == h->metaf)
                 return(html_blocktagname(mbuf, args, tok));                          h->metaf = NULL;
                   print_ctag(h, tag->tag);
                   h->tags.head = tag->next;
                   free(tag);
                   if (until && tag == until)
                           return;
           }
   }
   
         return(html_inlinetagname(mbuf, args, tok));  
   void
   print_stagq(struct html *h, const struct tag *suntil)
   {
           struct tag      *tag;
   
           while ((tag = h->tags.head) != NULL) {
                   if (suntil && tag == suntil)
                           return;
                   if (tag == h->metaf)
                           h->metaf = NULL;
                   print_ctag(h, tag->tag);
                   h->tags.head = tag->next;
                   free(tag);
           }
 }  }
   
   
 int  void
 md_line_html(void *data, char *buf)  bufinit(struct html *h)
 {  {
   
         return(mlg_line((struct md_mlg *)data, buf));          h->buf[0] = '\0';
           h->buflen = 0;
 }  }
   
   
 int  void
 md_exit_html(void *data, int flush)  bufcat_style(struct html *h, const char *key, const char *val)
 {  {
   
         return(mlg_exit((struct md_mlg *)data, flush));          bufcat(h, key);
           bufncat(h, ":", 1);
           bufcat(h, val);
           bufncat(h, ";", 1);
 }  }
   
   
 void *  void
 md_init_html(const struct md_args *args,  bufcat(struct html *h, const char *p)
                 struct md_mbuf *mbuf, const struct md_rbuf *rbuf)  
 {  {
   
         return(mlg_alloc(args, rbuf, mbuf, html_begintag,          bufncat(h, p, strlen(p));
                                 html_endtag, html_begin, html_end));  
 }  }
   
   
   void
   buffmt(struct html *h, const char *fmt, ...)
   {
           va_list          ap;
   
           va_start(ap, fmt);
           (void)vsnprintf(h->buf + (int)h->buflen,
                           BUFSIZ - h->buflen - 1, fmt, ap);
           va_end(ap);
           h->buflen = strlen(h->buf);
   }
   
   
   void
   bufncat(struct html *h, const char *p, size_t sz)
   {
   
           if (h->buflen + sz > BUFSIZ - 1)
                   sz = BUFSIZ - 1 - h->buflen;
   
           (void)strncat(h->buf, p, sz);
           h->buflen += sz;
   }
   
   
   void
   buffmt_includes(struct html *h, const char *name)
   {
           const char      *p, *pp;
   
           pp = h->base_includes;
   
           while (NULL != (p = strchr(pp, '%'))) {
                   bufncat(h, pp, (size_t)(p - pp));
                   switch (*(p + 1)) {
                   case('I'):
                           bufcat(h, name);
                           break;
                   default:
                           bufncat(h, p, 2);
                           break;
                   }
                   pp = p + 2;
           }
           if (pp)
                   bufcat(h, pp);
   }
   
   
   void
   buffmt_man(struct html *h,
                   const char *name, const char *sec)
   {
           const char      *p, *pp;
   
           pp = h->base_man;
   
           /* LINTED */
           while (NULL != (p = strchr(pp, '%'))) {
                   bufncat(h, pp, (size_t)(p - pp));
                   switch (*(p + 1)) {
                   case('S'):
                           bufcat(h, sec ? sec : "1");
                           break;
                   case('N'):
                           buffmt(h, name);
                           break;
                   default:
                           bufncat(h, p, 2);
                           break;
                   }
                   pp = p + 2;
           }
           if (pp)
                   bufcat(h, pp);
   }
   
   
   void
   bufcat_su(struct html *h, const char *p, const struct roffsu *su)
   {
           double           v;
           const char      *u;
   
           v = su->scale;
   
           switch (su->unit) {
           case (SCALE_CM):
                   u = "cm";
                   break;
           case (SCALE_IN):
                   u = "in";
                   break;
           case (SCALE_PC):
                   u = "pc";
                   break;
           case (SCALE_PT):
                   u = "pt";
                   break;
           case (SCALE_EM):
                   u = "em";
                   break;
           case (SCALE_MM):
                   if (0 == (v /= 100))
                           v = 1;
                   u = "em";
                   break;
           case (SCALE_EN):
                   u = "ex";
                   break;
           case (SCALE_BU):
                   u = "ex";
                   break;
           case (SCALE_VS):
                   u = "em";
                   break;
           default:
                   u = "ex";
                   break;
           }
   
           /*
            * XXX: the CSS spec isn't clear as to which types accept
            * integer or real numbers, so we just make them all decimals.
            */
           buffmt(h, "%s: %.2f%s;", p, v, u);
   }
   
   
   void
   html_idcat(char *dst, const char *src, int sz)
   {
           int              ssz;
   
           assert(sz);
   
           /* Cf. <http://www.w3.org/TR/html4/types.html#h-6.2>. */
   
           for ( ; *dst != '\0' && sz; dst++, sz--)
                   /* Jump to end. */ ;
   
           assert(sz > 2);
   
           /* We can't start with a number (bah). */
   
           *dst++ = 'x';
           *dst = '\0';
           sz--;
   
           for ( ; *src != '\0' && sz > 1; src++) {
                   ssz = snprintf(dst, (size_t)sz, "%.2x", *src);
                   sz -= ssz;
                   dst += ssz;
           }
   }

Legend:
Removed from v.1.2  
changed lines
  Added in v.1.109

CVSweb