Fully integrate apropos(1) into mandoc(1).

[mandoc.git] / man_html.c

diff --git a/man_html.c b/man_html.c
index 73709b824c45ebe2504ffcfcbccd6c9762ff8598..5c59d27cdedeae17d1399eb52fd40bb779812a65 100644 (file)
--- a/man_html.c
+++ b/man_html.c
@@ -1,6 +1,7 @@
-/*     $Id: man_html.c,v 1.88 2012/06/02 20:16:23 schwarze Exp $ */
+/*     $Id: man_html.c,v 1.97 2014/08/10 23:54:41 schwarze Exp $ */

 /*
  * Copyright (c) 2008-2012 Kristaps Dzonsons <kristaps@bsd.lv>
 /*
  * Copyright (c) 2008-2012 Kristaps Dzonsons <kristaps@bsd.lv>

+ * Copyright (c) 2013, 2014 Ingo Schwarze <schwarze@openbsd.org>

  *
  * Permission to use, copy, modify, and distribute this software for any
  * purpose with or without fee is hereby granted, provided that the above
  *
  * Permission to use, copy, modify, and distribute this software for any
  * purpose with or without fee is hereby granted, provided that the above


@@ -14,9 +15,7 @@
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */

-#ifdef HAVE_CONFIG_H

 #include "config.h"
 #include "config.h"

-#endif

 
 #include <sys/types.h>
 
 
 #include <sys/types.h>
 


@@ -27,6 +26,7 @@
 #include <string.h>
 
 #include "mandoc.h"
 #include <string.h>
 
 #include "mandoc.h"

+#include "mandoc_aux.h"

 #include "out.h"
 #include "html.h"
 #include "man.h"
 #include "out.h"
 #include "html.h"
 #include "man.h"


@@ -37,7 +37,7 @@
 
 #define        INDENT            5
 
 
 #define        INDENT            5
 

-#define        MAN_ARGS          const struct man_meta *m, \
+#define        MAN_ARGS          const struct man_meta *man, \

                          const struct man_node *n, \
                          struct mhtml *mh, \
                          struct html *h
                          const struct man_node *n, \
                          struct mhtml *mh, \
                          struct html *h


@@ -52,7 +52,7 @@ struct        htmlman {
        int             (*post)(MAN_ARGS);
 };
 
        int             (*post)(MAN_ARGS);
 };
 

-static void              print_bvspace(struct html *, 
+static void              print_bvspace(struct html *,

                                const struct man_node *);
 static void              print_man(MAN_ARGS);
 static void              print_man_head(MAN_ARGS);
                                const struct man_node *);
 static void              print_man(MAN_ARGS);
 static void              print_man_head(MAN_ARGS);


@@ -70,6 +70,7 @@ static        int               man_RS_pre(MAN_ARGS);
 static int               man_SH_pre(MAN_ARGS);
 static int               man_SM_pre(MAN_ARGS);
 static int               man_SS_pre(MAN_ARGS);
 static int               man_SH_pre(MAN_ARGS);
 static int               man_SM_pre(MAN_ARGS);
 static int               man_SS_pre(MAN_ARGS);

+static int               man_UR_pre(MAN_ARGS);

 static int               man_alt_pre(MAN_ARGS);
 static int               man_br_pre(MAN_ARGS);
 static int               man_ign_pre(MAN_ARGS);
 static int               man_alt_pre(MAN_ARGS);
 static int               man_br_pre(MAN_ARGS);
 static int               man_ign_pre(MAN_ARGS);


@@ -88,7 +89,7 @@ static        const struct htmlman mans[MAN_MAX] = {
        { man_PP_pre, NULL }, /* PP */
        { man_PP_pre, NULL }, /* P */
        { man_IP_pre, NULL }, /* IP */
        { man_PP_pre, NULL }, /* PP */
        { man_PP_pre, NULL }, /* P */
        { man_IP_pre, NULL }, /* IP */

-       { man_HP_pre, NULL }, /* HP */ 
+       { man_HP_pre, NULL }, /* HP */

        { man_SM_pre, NULL }, /* SM */
        { man_SM_pre, NULL }, /* SB */
        { man_alt_pre, NULL }, /* BI */
        { man_SM_pre, NULL }, /* SM */
        { man_SM_pre, NULL }, /* SB */
        { man_alt_pre, NULL }, /* BI */


@@ -115,8 +116,12 @@ static     const struct htmlman mans[MAN_MAX] = {
        { man_OP_pre, NULL }, /* OP */
        { man_literal_pre, NULL }, /* EX */
        { man_literal_pre, NULL }, /* EE */
        { man_OP_pre, NULL }, /* OP */
        { man_literal_pre, NULL }, /* EX */
        { man_literal_pre, NULL }, /* EE */

+       { man_UR_pre, NULL }, /* UR */
+       { NULL, NULL }, /* UE */
+       { man_ign_pre, NULL }, /* ll */

 };
 
 };
 

+

 /*
  * Printing leading vertical space before a block.
  * This is used for the paragraph macros.
 /*
  * Printing leading vertical space before a block.
  * This is used for the paragraph macros.


@@ -141,17 +146,17 @@ print_bvspace(struct html *h, const struct man_node *n)
 }
 
 void
 }
 
 void

-html_man(void *arg, const struct man *m)
+html_man(void *arg, const struct man *man)

 {
        struct mhtml     mh;
 
        memset(&mh, 0, sizeof(struct mhtml));
 {
        struct mhtml     mh;
 
        memset(&mh, 0, sizeof(struct mhtml));

-       print_man(man_meta(m), man_node(m), &mh, (struct html *)arg);
+       print_man(man_meta(man), man_node(man), &mh, (struct html *)arg);

        putchar('\n');
 }
 
 static void
        putchar('\n');
 }
 
 static void

-print_man(MAN_ARGS) 
+print_man(MAN_ARGS)

 {
        struct tag      *t, *tt;
        struct htmlpair  tag;
 {
        struct tag      *t, *tt;
        struct htmlpair  tag;


@@ -162,42 +167,38 @@ print_man(MAN_ARGS)
                print_gen_decls(h);
                t = print_otag(h, TAG_HTML, 0, NULL);
                tt = print_otag(h, TAG_HEAD, 0, NULL);
                print_gen_decls(h);
                t = print_otag(h, TAG_HTML, 0, NULL);
                tt = print_otag(h, TAG_HEAD, 0, NULL);

-               print_man_head(m, n, mh, h);
+               print_man_head(man, n, mh, h);

                print_tagq(h, tt);
                print_otag(h, TAG_BODY, 0, NULL);
                print_otag(h, TAG_DIV, 1, &tag);
                print_tagq(h, tt);
                print_otag(h, TAG_BODY, 0, NULL);
                print_otag(h, TAG_DIV, 1, &tag);

-       } else 
+       } else

                t = print_otag(h, TAG_DIV, 1, &tag);
 
                t = print_otag(h, TAG_DIV, 1, &tag);
 

-       print_man_nodelist(m, n, mh, h);
+       print_man_nodelist(man, n, mh, h);

        print_tagq(h, t);
 }
 
        print_tagq(h, t);
 }
 

-
-/* ARGSUSED */

 static void
 print_man_head(MAN_ARGS)
 {
 
        print_gen_head(h);
 static void
 print_man_head(MAN_ARGS)
 {
 
        print_gen_head(h);

-       assert(m->title);
-       assert(m->msec);
-       bufcat_fmt(h, "%s(%s)", m->title, m->msec);
+       assert(man->title);
+       assert(man->msec);
+       bufcat_fmt(h, "%s(%s)", man->title, man->msec);

        print_otag(h, TAG_TITLE, 0, NULL);
        print_text(h, h->buf);
 }
 
        print_otag(h, TAG_TITLE, 0, NULL);
        print_text(h, h->buf);
 }
 

-

 static void
 print_man_nodelist(MAN_ARGS)
 {
 
 static void
 print_man_nodelist(MAN_ARGS)
 {
 

-       print_man_node(m, n, mh, h);
+       print_man_node(man, n, mh, h);

        if (n->next)
        if (n->next)

-               print_man_nodelist(m, n->next, mh, h);
+               print_man_nodelist(man, n->next, mh, h);

 }
 
 }
 

-

 static void
 print_man_node(MAN_ARGS)
 {
 static void
 print_man_node(MAN_ARGS)
 {


@@ -208,10 +209,10 @@ print_man_node(MAN_ARGS)
        t = h->tags.head;
 
        switch (n->type) {
        t = h->tags.head;
 
        switch (n->type) {

-       case (MAN_ROOT):
-               man_root_pre(m, n, mh, h);
+       case MAN_ROOT:
+               man_root_pre(man, n, mh, h);

                break;
                break;

-       case (MAN_TEXT):
+       case MAN_TEXT:

                /*
                 * If we have a blank line, output a vertical space.
                 * If we have a space as the first character, break
                /*
                 * If we have a blank line, output a vertical space.
                 * If we have a space as the first character, break


@@ -229,10 +230,10 @@ print_man_node(MAN_ARGS)
 
                print_text(h, n->string);
                return;
 
                print_text(h, n->string);
                return;

-       case (MAN_EQN):
+       case MAN_EQN:

                print_eqn(h, n->eqn);
                break;
                print_eqn(h, n->eqn);
                break;

-       case (MAN_TBL):
+       case MAN_TBL:

                /*
                 * This will take care of initialising all of the table
                 * state data for the first table, then tearing it down
                /*
                 * This will take care of initialising all of the table
                 * state data for the first table, then tearing it down


@@ -241,7 +242,7 @@ print_man_node(MAN_ARGS)
                print_tbl(h, n->span);
                return;
        default:
                print_tbl(h, n->span);
                return;
        default:

-               /* 
+               /*

                 * Close out scope of font prior to opening a macro
                 * scope.
                 */
                 * Close out scope of font prior to opening a macro
                 * scope.
                 */


@@ -260,30 +261,29 @@ print_man_node(MAN_ARGS)
                        t = h->tags.head;
                }
                if (mans[n->tok].pre)
                        t = h->tags.head;
                }
                if (mans[n->tok].pre)

-                       child = (*mans[n->tok].pre)(m, n, mh, h);
+                       child = (*mans[n->tok].pre)(man, n, mh, h);

                break;
        }
 
        if (child && n->child)
                break;
        }
 
        if (child && n->child)

-               print_man_nodelist(m, n->child, mh, h);
+               print_man_nodelist(man, n->child, mh, h);

 
        /* This will automatically close out any font scope. */
        print_stagq(h, t);
 
        switch (n->type) {
 
        /* This will automatically close out any font scope. */
        print_stagq(h, t);
 
        switch (n->type) {

-       case (MAN_ROOT):
-               man_root_post(m, n, mh, h);
+       case MAN_ROOT:
+               man_root_post(man, n, mh, h);

                break;
                break;

-       case (MAN_EQN):
+       case MAN_EQN:

                break;
        default:
                if (mans[n->tok].post)
                break;
        default:
                if (mans[n->tok].post)

-                       (*mans[n->tok].post)(m, n, mh, h);
+                       (*mans[n->tok].post)(man, n, mh, h);

                break;
        }
 }
 
                break;
        }
 }
 

-

 static int
 a2width(const struct man_node *n, struct roffsu *su)
 {
 static int
 a2width(const struct man_node *n, struct roffsu *su)
 {


@@ -296,22 +296,16 @@ a2width(const struct man_node *n, struct roffsu *su)
        return(0);
 }
 
        return(0);
 }
 

-
-/* ARGSUSED */

 static void
 man_root_pre(MAN_ARGS)
 {
        struct htmlpair  tag[3];
        struct tag      *t, *tt;
 static void
 man_root_pre(MAN_ARGS)
 {
        struct htmlpair  tag[3];
        struct tag      *t, *tt;

-       char             b[BUFSIZ], title[BUFSIZ];
-
-       b[0] = 0;
-       if (m->vol)
-               (void)strlcat(b, m->vol, BUFSIZ);
+       char            *title;

 
 

-       assert(m->title);
-       assert(m->msec);
-       snprintf(title, BUFSIZ - 1, "%s(%s)", m->title, m->msec);
+       assert(man->title);
+       assert(man->msec);
+       mandoc_asprintf(&title, "%s(%s)", man->title, man->msec);

 
        PAIR_SUMMARY_INIT(&tag[0], "Document Header");
        PAIR_CLASS_INIT(&tag[1], "head");
 
        PAIR_SUMMARY_INIT(&tag[0], "Document Header");
        PAIR_CLASS_INIT(&tag[1], "head");


@@ -334,7 +328,8 @@ man_root_pre(MAN_ARGS)
        PAIR_CLASS_INIT(&tag[0], "head-vol");
        PAIR_INIT(&tag[1], ATTR_ALIGN, "center");
        print_otag(h, TAG_TD, 2, tag);
        PAIR_CLASS_INIT(&tag[0], "head-vol");
        PAIR_INIT(&tag[1], ATTR_ALIGN, "center");
        print_otag(h, TAG_TD, 2, tag);

-       print_text(h, b);
+       if (NULL != man->vol)
+               print_text(h, man->vol);

        print_stagq(h, tt);
 
        PAIR_CLASS_INIT(&tag[0], "head-rtitle");
        print_stagq(h, tt);
 
        PAIR_CLASS_INIT(&tag[0], "head-rtitle");


@@ -342,10 +337,9 @@ man_root_pre(MAN_ARGS)
        print_otag(h, TAG_TD, 2, tag);
        print_text(h, title);
        print_tagq(h, t);
        print_otag(h, TAG_TD, 2, tag);
        print_text(h, title);
        print_tagq(h, t);

+       free(title);

 }
 
 }
 

-
-/* ARGSUSED */

 static void
 man_root_post(MAN_ARGS)
 {
 static void
 man_root_post(MAN_ARGS)
 {


@@ -365,21 +359,20 @@ man_root_post(MAN_ARGS)
        PAIR_CLASS_INIT(&tag[0], "foot-date");
        print_otag(h, TAG_TD, 1, tag);
 
        PAIR_CLASS_INIT(&tag[0], "foot-date");
        print_otag(h, TAG_TD, 1, tag);
 

-       assert(m->date);
-       print_text(h, m->date);
+       assert(man->date);
+       print_text(h, man->date);

        print_stagq(h, tt);
 
        PAIR_CLASS_INIT(&tag[0], "foot-os");
        PAIR_INIT(&tag[1], ATTR_ALIGN, "right");
        print_otag(h, TAG_TD, 2, tag);
 
        print_stagq(h, tt);
 
        PAIR_CLASS_INIT(&tag[0], "foot-os");
        PAIR_INIT(&tag[1], ATTR_ALIGN, "right");
        print_otag(h, TAG_TD, 2, tag);
 

-       if (m->source)
-               print_text(h, m->source);
+       if (man->source)
+               print_text(h, man->source);

        print_tagq(h, t);
 }
 
 
        print_tagq(h, t);
 }
 
 

-/* ARGSUSED */

 static int
 man_br_pre(MAN_ARGS)
 {
 static int
 man_br_pre(MAN_ARGS)
 {


@@ -393,7 +386,7 @@ man_br_pre(MAN_ARGS)
                        if ( ! a2roffsu(n->string, &su, SCALE_VS))
                                SCALE_VS_INIT(&su, atoi(n->string));
        } else
                        if ( ! a2roffsu(n->string, &su, SCALE_VS))
                                SCALE_VS_INIT(&su, atoi(n->string));
        } else

-               su.scale = 0;
+               su.scale = 0.0;

 
        bufinit(h);
        bufcat_su(h, "height", &su);
 
        bufinit(h);
        bufcat_su(h, "height", &su);


@@ -406,7 +399,6 @@ man_br_pre(MAN_ARGS)
        return(0);
 }
 
        return(0);
 }
 

-/* ARGSUSED */

 static int
 man_SH_pre(MAN_ARGS)
 {
 static int
 man_SH_pre(MAN_ARGS)
 {


@@ -424,7 +416,6 @@ man_SH_pre(MAN_ARGS)
        return(1);
 }
 
        return(1);
 }
 

-/* ARGSUSED */

 static int
 man_alt_pre(MAN_ARGS)
 {
 static int
 man_alt_pre(MAN_ARGS)
 {


@@ -433,7 +424,7 @@ man_alt_pre(MAN_ARGS)
        enum htmltag     fp;
        struct tag      *t;
 
        enum htmltag     fp;
        struct tag      *t;
 

-       if ((savelit = mh->fl & MANH_LITERAL)) 
+       if ((savelit = mh->fl & MANH_LITERAL))

                print_otag(h, TAG_BR, 0, NULL);
 
        mh->fl &= ~MANH_LITERAL;
                print_otag(h, TAG_BR, 0, NULL);
 
        mh->fl &= ~MANH_LITERAL;


@@ -441,22 +432,22 @@ man_alt_pre(MAN_ARGS)
        for (i = 0, nn = n->child; nn; nn = nn->next, i++) {
                t = NULL;
                switch (n->tok) {
        for (i = 0, nn = n->child; nn; nn = nn->next, i++) {
                t = NULL;
                switch (n->tok) {

-               case (MAN_BI):
+               case MAN_BI:

                        fp = i % 2 ? TAG_I : TAG_B;
                        break;
                        fp = i % 2 ? TAG_I : TAG_B;
                        break;

-               case (MAN_IB):
+               case MAN_IB:

                        fp = i % 2 ? TAG_B : TAG_I;
                        break;
                        fp = i % 2 ? TAG_B : TAG_I;
                        break;

-               case (MAN_RI):
+               case MAN_RI:

                        fp = i % 2 ? TAG_I : TAG_MAX;
                        break;
                        fp = i % 2 ? TAG_I : TAG_MAX;
                        break;

-               case (MAN_IR):
+               case MAN_IR:

                        fp = i % 2 ? TAG_MAX : TAG_I;
                        break;
                        fp = i % 2 ? TAG_MAX : TAG_I;
                        break;

-               case (MAN_BR):
+               case MAN_BR:

                        fp = i % 2 ? TAG_MAX : TAG_B;
                        break;
                        fp = i % 2 ? TAG_MAX : TAG_B;
                        break;

-               case (MAN_RB):
+               case MAN_RB:

                        fp = i % 2 ? TAG_B : TAG_MAX;
                        break;
                default:
                        fp = i % 2 ? TAG_B : TAG_MAX;
                        break;
                default:


@@ -470,7 +461,7 @@ man_alt_pre(MAN_ARGS)
                if (TAG_MAX != fp)
                        t = print_otag(h, fp, 0, NULL);
 
                if (TAG_MAX != fp)
                        t = print_otag(h, fp, 0, NULL);
 

-               print_man_node(m, nn, mh, h);
+               print_man_node(man, nn, mh, h);

 
                if (t)
                        print_tagq(h, t);
 
                if (t)
                        print_tagq(h, t);


@@ -482,18 +473,16 @@ man_alt_pre(MAN_ARGS)
        return(0);
 }
 
        return(0);
 }
 

-/* ARGSUSED */

 static int
 man_SM_pre(MAN_ARGS)
 {
 static int
 man_SM_pre(MAN_ARGS)
 {

-       
+

        print_otag(h, TAG_SMALL, 0, NULL);
        if (MAN_SB == n->tok)
                print_otag(h, TAG_B, 0, NULL);
        return(1);
 }
 
        print_otag(h, TAG_SMALL, 0, NULL);
        if (MAN_SB == n->tok)
                print_otag(h, TAG_B, 0, NULL);
        return(1);
 }
 

-/* ARGSUSED */

 static int
 man_SS_pre(MAN_ARGS)
 {
 static int
 man_SS_pre(MAN_ARGS)
 {


@@ -511,7 +500,6 @@ man_SS_pre(MAN_ARGS)
        return(1);
 }
 
        return(1);
 }
 

-/* ARGSUSED */

 static int
 man_PP_pre(MAN_ARGS)
 {
 static int
 man_PP_pre(MAN_ARGS)
 {


@@ -524,13 +512,12 @@ man_PP_pre(MAN_ARGS)
        return(1);
 }
 
        return(1);
 }
 

-/* ARGSUSED */

 static int
 man_IP_pre(MAN_ARGS)
 {
        const struct man_node   *nn;
 
 static int
 man_IP_pre(MAN_ARGS)
 {
        const struct man_node   *nn;
 

-       if (MAN_BODY == n->type) { 
+       if (MAN_BODY == n->type) {

                print_otag(h, TAG_DD, 0, NULL);
                return(1);
        } else if (MAN_HEAD != n->type) {
                print_otag(h, TAG_DD, 0, NULL);
                return(1);
        } else if (MAN_HEAD != n->type) {


@@ -545,19 +532,23 @@ man_IP_pre(MAN_ARGS)
        /* For IP, only print the first header element. */
 
        if (MAN_IP == n->tok && n->child)
        /* For IP, only print the first header element. */
 
        if (MAN_IP == n->tok && n->child)

-               print_man_node(m, n->child, mh, h);
+               print_man_node(man, n->child, mh, h);

 
        /* For TP, only print next-line header elements. */
 
 
        /* For TP, only print next-line header elements. */
 

-       if (MAN_TP == n->tok)
-               for (nn = n->child; nn; nn = nn->next)
-                       if (nn->line > n->line)
-                               print_man_node(m, nn, mh, h);
+       if (MAN_TP == n->tok) {
+               nn = n->child;
+               while (NULL != nn && 0 == (MAN_LINE & nn->flags))
+                       nn = nn->next;
+               while (NULL != nn) {
+                       print_man_node(man, nn, mh, h);
+                       nn = nn->next;
+               }
+       }

 
        return(0);
 }
 
 
        return(0);
 }
 

-/* ARGSUSED */

 static int
 man_HP_pre(MAN_ARGS)
 {
 static int
 man_HP_pre(MAN_ARGS)
 {


@@ -586,7 +577,6 @@ man_HP_pre(MAN_ARGS)
        return(1);
 }
 
        return(1);
 }
 

-/* ARGSUSED */

 static int
 man_OP_pre(MAN_ARGS)
 {
 static int
 man_OP_pre(MAN_ARGS)
 {


@@ -616,8 +606,6 @@ man_OP_pre(MAN_ARGS)
        return(0);
 }
 
        return(0);
 }
 

-
-/* ARGSUSED */

 static int
 man_B_pre(MAN_ARGS)
 {
 static int
 man_B_pre(MAN_ARGS)
 {


@@ -626,16 +614,14 @@ man_B_pre(MAN_ARGS)
        return(1);
 }
 
        return(1);
 }
 

-/* ARGSUSED */

 static int
 man_I_pre(MAN_ARGS)
 {
 static int
 man_I_pre(MAN_ARGS)
 {

-       
+

        print_otag(h, TAG_I, 0, NULL);
        return(1);
 }
 
        print_otag(h, TAG_I, 0, NULL);
        return(1);
 }
 

-/* ARGSUSED */

 static int
 man_literal_pre(MAN_ARGS)
 {
 static int
 man_literal_pre(MAN_ARGS)
 {


@@ -649,7 +635,6 @@ man_literal_pre(MAN_ARGS)
        return(0);
 }
 
        return(0);
 }
 

-/* ARGSUSED */

 static int
 man_in_pre(MAN_ARGS)
 {
 static int
 man_in_pre(MAN_ARGS)
 {


@@ -658,7 +643,6 @@ man_in_pre(MAN_ARGS)
        return(0);
 }
 
        return(0);
 }
 

-/* ARGSUSED */

 static int
 man_ign_pre(MAN_ARGS)
 {
 static int
 man_ign_pre(MAN_ARGS)
 {


@@ -666,7 +650,6 @@ man_ign_pre(MAN_ARGS)
        return(0);
 }
 
        return(0);
 }
 

-/* ARGSUSED */

 static int
 man_RS_pre(MAN_ARGS)
 {
 static int
 man_RS_pre(MAN_ARGS)
 {


@@ -688,3 +671,26 @@ man_RS_pre(MAN_ARGS)
        print_otag(h, TAG_DIV, 1, &tag);
        return(1);
 }
        print_otag(h, TAG_DIV, 1, &tag);
        return(1);
 }

+
+static int
+man_UR_pre(MAN_ARGS)
+{
+       struct htmlpair          tag[2];
+
+       n = n->child;
+       assert(MAN_HEAD == n->type);
+       if (n->nchild) {
+               assert(MAN_TEXT == n->child->type);
+               PAIR_CLASS_INIT(&tag[0], "link-ext");
+               PAIR_HREF_INIT(&tag[1], n->child->string);
+               print_otag(h, TAG_A, 2, tag);
+       }
+
+       assert(MAN_BODY == n->next->type);
+       if (n->next->nchild)
+               n = n->next;
+
+       print_man_nodelist(man, n->child, mh, h);
+
+       return(0);
+}