]> git.cameronkatri.com Git - mandoc.git/blobdiff - mdoc_html.c
First, properly escape periods with \&. Then consistently refer to
[mandoc.git] / mdoc_html.c
index 9656aced55e87bbaafeb2ed1ad9df7a15d7e3b39..c3b3f68b469146f18c9b2cc4447e512ee8570968 100644 (file)
@@ -1,4 +1,4 @@
-/*     $Id: mdoc_html.c,v 1.155 2011/03/22 14:05:45 kristaps Exp $ */
+/*     $Id: mdoc_html.c,v 1.163 2011/04/04 22:38:26 kristaps Exp $ */
 /*
  * Copyright (c) 2008, 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
  *
@@ -751,8 +751,7 @@ mdoc_nm_pre(MDOC_ARGS)
 static int
 mdoc_xr_pre(MDOC_ARGS)
 {
-       struct htmlpair          tag[2];
-       const struct mdoc_node  *nn;
+       struct htmlpair  tag[2];
 
        if (NULL == n->child)
                return(0);
@@ -768,16 +767,16 @@ mdoc_xr_pre(MDOC_ARGS)
        } else
                print_otag(h, TAG_A, 1, tag);
 
-       nn = n->child;
-       print_text(h, nn->string);
+       n = n->child;
+       print_text(h, n->string);
 
-       if (NULL == (nn = nn->next))
+       if (NULL == (n = n->next))
                return(0);
 
        h->flags |= HTML_NOSPACE;
        print_text(h, "(");
        h->flags |= HTML_NOSPACE;
-       print_text(h, nn->string);
+       print_text(h, n->string);
        h->flags |= HTML_NOSPACE;
        print_text(h, ")");
        return(0);
@@ -1087,9 +1086,9 @@ mdoc_bl_pre(MDOC_ARGS)
 static int
 mdoc_ex_pre(MDOC_ARGS)
 {
-       const struct mdoc_node  *nn;
-       struct tag              *t;
-       struct htmlpair          tag;
+       struct tag      *t;
+       struct htmlpair  tag;
+       int              nchild;
 
        if (n->prev)
                print_otag(h, TAG_BR, 0, NULL);
@@ -1097,22 +1096,25 @@ mdoc_ex_pre(MDOC_ARGS)
        PAIR_CLASS_INIT(&tag, "utility");
 
        print_text(h, "The");
-       for (nn = n->child; nn; nn = nn->next) {
+
+       nchild = n->nchild;
+       for (n = n->child; n; n = n->next) {
+               assert(MDOC_TEXT == n->type);
+
                t = print_otag(h, TAG_B, 1, &tag);
-               print_text(h, nn->string);
+               print_text(h, n->string);
                print_tagq(h, t);
 
-               h->flags |= HTML_NOSPACE;
-
-               if (nn->next && NULL == nn->next->next)
-                       print_text(h, ", and");
-               else if (nn->next)
+               if (nchild > 2 && n->next) {
+                       h->flags |= HTML_NOSPACE;
                        print_text(h, ",");
-               else
-                       h->flags &= ~HTML_NOSPACE;
+               }
+
+               if (n->next && NULL == n->next->next)
+                       print_text(h, "and");
        }
 
-       if (n->child && n->child->next)
+       if (nchild > 1)
                print_text(h, "utilities exit");
        else
                print_text(h, "utility exits");
@@ -1168,14 +1170,13 @@ mdoc_d1_pre(MDOC_ARGS)
 static int
 mdoc_sx_pre(MDOC_ARGS)
 {
-       struct htmlpair          tag[2];
-       const struct mdoc_node  *nn;
-       char                     buf[BUFSIZ];
+       struct htmlpair  tag[2];
+       char             buf[BUFSIZ];
 
        strlcpy(buf, "#", BUFSIZ);
-       for (nn = n->child; nn; nn = nn->next) {
-               html_idcat(buf, nn->string, BUFSIZ);
-               if (nn->next)
+       for (n = n->child; n; n = n->next) {
+               html_idcat(buf, n->string, BUFSIZ);
+               if (n->next)
                        html_idcat(buf, " ", BUFSIZ);
        }
 
@@ -1404,13 +1405,61 @@ mdoc_fa_pre(MDOC_ARGS)
 static int
 mdoc_fd_pre(MDOC_ARGS)
 {
-       struct htmlpair  tag;
+       struct htmlpair  tag[2];
+       char             buf[BUFSIZ];
+       size_t           sz;
+       int              i;
+       struct tag      *t;
 
        synopsis_pre(h, n);
 
-       PAIR_CLASS_INIT(&tag, "macro");
-       print_otag(h, TAG_B, 1, &tag);
-       return(1);
+       if (NULL == (n = n->child))
+               return(0);
+
+       assert(MDOC_TEXT == n->type);
+
+       if (strcmp(n->string, "#include")) {
+               PAIR_CLASS_INIT(&tag[0], "macro");
+               print_otag(h, TAG_B, 1, tag);
+               return(1);
+       }
+
+       PAIR_CLASS_INIT(&tag[0], "includes");
+       print_otag(h, TAG_B, 1, tag);
+       print_text(h, n->string);
+
+       if (NULL != (n = n->next)) {
+               assert(MDOC_TEXT == n->type);
+               strlcpy(buf, '<' == *n->string || '"' == *n->string ? 
+                               n->string + 1 : n->string, BUFSIZ);
+
+               sz = strlen(buf);
+               if (sz && ('>' == buf[sz - 1] || '"' == buf[sz - 1]))
+                       buf[sz - 1] = '\0';
+
+               PAIR_CLASS_INIT(&tag[0], "link-includes");
+               bufinit(h);
+               
+               i = 1;
+               if (h->base_includes) {
+                       buffmt_includes(h, buf);
+                       PAIR_HREF_INIT(&tag[i], h->buf);
+                       i++;
+               } 
+
+               t = print_otag(h, TAG_A, i, tag);
+               print_text(h, n->string);
+               print_tagq(h, t);
+
+               n = n->next;
+       }
+
+       for ( ; n; n = n->next) {
+               assert(MDOC_TEXT == n->type);
+               print_text(h, n->string);
+       }
+
+       return(0);
 }
 
 
@@ -1451,13 +1500,13 @@ mdoc_ft_pre(MDOC_ARGS)
 static int
 mdoc_fn_pre(MDOC_ARGS)
 {
-       struct tag              *t;
-       struct htmlpair          tag[2];
-       const struct mdoc_node  *nn;
-       char                     nbuf[BUFSIZ];
-       const char              *sp, *ep;
-       int                      sz, i;
+       struct tag      *t;
+       struct htmlpair  tag[2];
+       char             nbuf[BUFSIZ];
+       const char      *sp, *ep;
+       int              sz, i, pretty;
 
+       pretty = MDOC_SYNPRETTY & n->flags;
        synopsis_pre(h, n);
 
        /* Split apart into type and name. */
@@ -1509,20 +1558,21 @@ mdoc_fn_pre(MDOC_ARGS)
 
        h->flags |= HTML_NOSPACE;
        print_text(h, "(");
+       h->flags |= HTML_NOSPACE;
 
        bufinit(h);
        PAIR_CLASS_INIT(&tag[0], "farg");
        bufcat_style(h, "white-space", "nowrap");
        PAIR_STYLE_INIT(&tag[1], h);
 
-       for (nn = n->child->next; nn; nn = nn->next) {
+       for (n = n->child->next; n; n = n->next) {
                i = 1;
                if (MDOC_SYNPRETTY & n->flags)
                        i = 2;
                t = print_otag(h, TAG_I, i, tag);
-               print_text(h, nn->string);
+               print_text(h, n->string);
                print_tagq(h, t);
-               if (nn->next) {
+               if (n->next) {
                        h->flags |= HTML_NOSPACE;
                        print_text(h, ",");
                }
@@ -1531,7 +1581,7 @@ mdoc_fn_pre(MDOC_ARGS)
        h->flags |= HTML_NOSPACE;
        print_text(h, ")");
 
-       if (MDOC_SYNPRETTY & n->flags) {
+       if (pretty) {
                h->flags |= HTML_NOSPACE;
                print_text(h, ";");
        }
@@ -1605,20 +1655,22 @@ mdoc_sp_pre(MDOC_ARGS)
 static int
 mdoc_lk_pre(MDOC_ARGS)
 {
-       const struct mdoc_node  *nn;
-       struct htmlpair          tag[2];
+       struct htmlpair  tag[2];
+
+       if (NULL == (n = n->child))
+               return(0);
 
-       nn = n->child;
+       assert(MDOC_TEXT == n->type);
 
        PAIR_CLASS_INIT(&tag[0], "link-ext");
-       PAIR_HREF_INIT(&tag[1], nn->string);
-       print_otag(h, TAG_A, 2, tag);
+       PAIR_HREF_INIT(&tag[1], n->string);
 
-       if (NULL == nn || NULL == nn->next) 
-               return(1);
+       print_otag(h, TAG_A, 2, tag);
 
-       for (nn = nn->next; nn; nn = nn->next) 
-               print_text(h, nn->string);
+       for (n = n->next; n; n = n->next) {
+               assert(MDOC_TEXT == n->type);
+               print_text(h, n->string);
+       }
 
        return(0);
 }
@@ -1628,19 +1680,21 @@ mdoc_lk_pre(MDOC_ARGS)
 static int
 mdoc_mt_pre(MDOC_ARGS)
 {
-       struct htmlpair          tag[2];
-       struct tag              *t;
-       const struct mdoc_node  *nn;
+       struct htmlpair  tag[2];
+       struct tag      *t;
 
        PAIR_CLASS_INIT(&tag[0], "link-mail");
 
-       for (nn = n->child; nn; nn = nn->next) {
+       for (n = n->child; n; n = n->next) {
+               assert(MDOC_TEXT == n->type);
+
                bufinit(h);
                bufcat(h, "mailto:");
-               bufcat(h, nn->string);
+               bufcat(h, n->string);
+
                PAIR_HREF_INIT(&tag[1], h->buf);
                t = print_otag(h, TAG_A, 2, tag);
-               print_text(h, nn->string);
+               print_text(h, n->string);
                print_tagq(h, t);
        }
        
@@ -1696,39 +1750,57 @@ mdoc_fo_post(MDOC_ARGS)
 static int
 mdoc_in_pre(MDOC_ARGS)
 {
-       const struct mdoc_node  *nn;
-       struct tag              *t;
-       struct htmlpair          tag[2];
-       int                      i;
+       struct tag      *t;
+       struct htmlpair  tag[2];
+       int              i;
 
        synopsis_pre(h, n);
 
        PAIR_CLASS_INIT(&tag[0], "includes");
        print_otag(h, TAG_B, 1, tag);
 
+       /*
+        * The first argument of the `In' gets special treatment as
+        * being a linked value.  Subsequent values are printed
+        * afterward.  groff does similarly.  This also handles the case
+        * of no children.
+        */
+
        if (MDOC_SYNPRETTY & n->flags && MDOC_LINE & n->flags)
                print_text(h, "#include");
 
        print_text(h, "<");
        h->flags |= HTML_NOSPACE;
 
-       for (nn = n->child; nn; nn = nn->next) {
+       if (NULL != (n = n->child)) {
+               assert(MDOC_TEXT == n->type);
+
                PAIR_CLASS_INIT(&tag[0], "link-includes");
-               i = 1;
                bufinit(h);
+
+               i = 1;
+
                if (h->base_includes) {
-                       buffmt_includes(h, nn->string);
+                       buffmt_includes(h, n->string);
                        PAIR_HREF_INIT(&tag[i], h->buf);
                        i++;
-               }
+               } 
+
                t = print_otag(h, TAG_A, i, tag);
-               print_mdoc_node(m, nn, h);
+               print_text(h, n->string);
                print_tagq(h, t);
+
+               n = n->next;
        }
 
        h->flags |= HTML_NOSPACE;
        print_text(h, ">");
 
+       for ( ; n; n = n->next) {
+               assert(MDOC_TEXT == n->type);
+               print_text(h, n->string);
+       }
+
        return(0);
 }
 
@@ -1749,31 +1821,38 @@ mdoc_ic_pre(MDOC_ARGS)
 static int
 mdoc_rv_pre(MDOC_ARGS)
 {
-       const struct mdoc_node  *nn;
-       struct htmlpair          tag;
-       struct tag              *t;
+       struct htmlpair  tag;
+       struct tag      *t;
+       int              nchild;
 
        if (n->prev)
                print_otag(h, TAG_BR, 0, NULL);
 
+       PAIR_CLASS_INIT(&tag, "fname");
+
        print_text(h, "The");
 
-       for (nn = n->child; nn; nn = nn->next) {
-               PAIR_CLASS_INIT(&tag, "fname");
+       nchild = n->nchild;
+       for (n = n->child; n; n = n->next) {
+               assert(MDOC_TEXT == n->type);
+
                t = print_otag(h, TAG_B, 1, &tag);
-               print_text(h, nn->string);
+               print_text(h, n->string);
                print_tagq(h, t);
 
                h->flags |= HTML_NOSPACE;
-               if (nn->next && NULL == nn->next->next)
-                       print_text(h, "(), and");
-               else if (nn->next)
-                       print_text(h, "(),");
-               else
-                       print_text(h, "()");
+               print_text(h, "()");
+
+               if (nchild > 2 && n->next) {
+                       h->flags |= HTML_NOSPACE;
+                       print_text(h, ",");
+               }
+
+               if (n->next && NULL == n->next->next)
+                       print_text(h, "and");
        }
 
-       if (n->child && n->child->next)
+       if (nchild > 1)
                print_text(h, "functions return");
        else
                print_text(h, "function returns");