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

Diff for /docbook2mdoc/docbook2mdoc.c between version 1.45 and 1.124

version 1.45, 2019/03/08 10:04:01 version 1.124, 2019/04/14 20:13:25
Line 1 
Line 1 
 /*      $Id$ */  /* $Id$ */
 /*  /*
  * Copyright (c) 2014 Kristaps Dzonsons <kristaps@bsd.lv>   * Copyright (c) 2014 Kristaps Dzonsons <kristaps@bsd.lv>
    * Copyright (c) 2019 Ingo Schwarze <schwarze@openbsd.org>
  *   *
  * 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 above   * purpose with or without fee is hereby granted, provided that the above
Line 14 
Line 15 
  * 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.
  */   */
 #include <sys/queue.h>  
   
 #include <assert.h>  #include <assert.h>
 #include <ctype.h>  #include <ctype.h>
 #include <expat.h>  
 #include <fcntl.h>  
 #include <getopt.h>  
 #include <stdio.h>  #include <stdio.h>
 #include <stdlib.h>  #include <stdlib.h>
 #include <string.h>  #include <string.h>
 #include <unistd.h>  
   
 #include "extern.h"  #include "node.h"
   #include "macro.h"
   #include "format.h"
   
 /*  /*
  * Global parse state.   * The implementation of the mdoc(7) formatter.
  * Keep this as simple and small as possible.  
  */   */
 struct  parse {  
         XML_Parser       xml;  
         enum nodeid      node; /* current (NODE_ROOT if pre-tree) */  
         const char      *fname; /* filename */  
         int              stop; /* should we stop now? */  
 #define PARSE_EQN        1  
         unsigned int     flags; /* document-wide flags */  
         struct pnode    *root; /* root of parse tree */  
         struct pnode    *cur; /* current node in tree */  
         char            *b; /* nil-terminated buffer for pre-print */  
         size_t           bsz; /* current length of b */  
         size_t           mbsz; /* max bsz allocation */  
         int              newln; /* output: are we on a fresh line */  
 };  
   
 struct  node {  static void      pnode_print(struct format *, struct pnode *);
         const char      *name; /* docbook element name */  static void      pnode_printrefentry(struct format *, struct pnode *);
         unsigned int     flags;  
 #define NODE_IGNTEXT     1 /* ignore all contained text */  
 };  
   
 TAILQ_HEAD(pnodeq, pnode);  
 TAILQ_HEAD(pattrq, pattr);  
   
 struct  pattr {  
         enum attrkey     key;  
         enum attrval     val;  
         char            *rawval;  
         TAILQ_ENTRY(pattr) child;  
 };  
   
 struct  pnode {  
         enum nodeid      node; /* node type */  
         char            *b; /* binary data buffer */  
         char            *real; /* store for "b" */  
         size_t           bsz; /* data buffer size */  
         struct pnode    *parent; /* parent (or NULL if top) */  
         struct pnodeq    childq; /* queue of children */  
         struct pattrq    attrq; /* attributes of node */  
         TAILQ_ENTRY(pnode) child;  
 };  
   
 static  const char *attrkeys[ATTRKEY__MAX] = {  
         "choice",  
         "close",  
         "id",  
         "open",  
         "rep"  
 };  
   
 static  const char *attrvals[ATTRVAL__MAX] = {  
         "norepeat",  
         "opt",  
         "plain",  
         "repeat",  
         "req"  
 };  
   
 static  const struct node nodes[NODE__MAX] = {  
         { NULL, 0 },  
         { "acronym", 0 },  
         { "anchor", NODE_IGNTEXT },  
         { "application", 0 },  
         { "arg", 0 },  
         { "caution", NODE_IGNTEXT },  
         { "citerefentry", NODE_IGNTEXT },  
         { "cmdsynopsis", NODE_IGNTEXT },  
         { "code", 0 },  
         { "colspec", NODE_IGNTEXT },  
         { "command", 0 },  
         { "constant", 0 },  
         { "copyright", NODE_IGNTEXT },  
         { "date", 0 },  
         { "emphasis", 0 },  
         { "entry", 0 },  
         { "envar", 0 },  
         { "fieldsynopsis", NODE_IGNTEXT },  
         { "filename", 0 },  
         { "funcdef", 0 },  
         { "funcprototype", NODE_IGNTEXT },  
         { "funcsynopsis", NODE_IGNTEXT },  
         { "funcsynopsisinfo", 0 },  
         { "function", 0 },  
         { "group", NODE_IGNTEXT },  
         { "holder", NODE_IGNTEXT },  
         { "info", NODE_IGNTEXT },  
         { "informalequation", NODE_IGNTEXT },  
         { "informaltable", NODE_IGNTEXT },  
         { "inlineequation", NODE_IGNTEXT },  
         { "itemizedlist", NODE_IGNTEXT },  
         { "link", 0 },  
         { "listitem", NODE_IGNTEXT },  
         { "literal", 0 },  
         { "manvolnum", 0 },  
         { "mml:math", NODE_IGNTEXT },  
         { "mml:mfenced", 0 },  
         { "mml:mfrac", 0 },  
         { "mml:mi", 0 },  
         { "mml:mn", 0 },  
         { "mml:mo", 0 },  
         { "mml:mrow", 0 },  
         { "mml:msub", 0 },  
         { "mml:msup", 0 },  
         { "modifier", 0 },  
         { "note", NODE_IGNTEXT },  
         { "option", 0 },  
         { "orderedlist", NODE_IGNTEXT },  
         { "para", 0 },  
         { "paramdef", 0 },  
         { "parameter", 0 },  
         { "programlisting", 0 },  
         { "prompt", 0 },  
         { "quote", 0 },  
         { "refclass", NODE_IGNTEXT },  
         { "refdescriptor", NODE_IGNTEXT },  
         { "refentry", NODE_IGNTEXT },  
         { "refentryinfo", NODE_IGNTEXT },  
         { "refentrytitle", 0 },  
         { "refmeta", NODE_IGNTEXT },  
         { "refmetainfo", NODE_IGNTEXT },  
         { "refmiscinfo", NODE_IGNTEXT },  
         { "refname", 0 },  
         { "refnamediv", NODE_IGNTEXT },  
         { "refpurpose", 0 },  
         { "refsect1", NODE_IGNTEXT },  
         { "refsect2", NODE_IGNTEXT },  
         { "refsect3", NODE_IGNTEXT },  
         { "refsection", NODE_IGNTEXT },  
         { "refsynopsisdiv", NODE_IGNTEXT },  
         { "replaceable", 0 },  
         { "row", NODE_IGNTEXT },  
         { "sbr", NODE_IGNTEXT },  
         { "screen", NODE_IGNTEXT },  
         { "sgmltag", 0 },  
         { "structname", 0 },  
         { "synopsis", 0 },  
         { "table", NODE_IGNTEXT },  
         { "tbody", NODE_IGNTEXT },  
         { "term", 0 },  
         { NULL, 0 },  
         { "tfoot", NODE_IGNTEXT },  
         { "tgroup", NODE_IGNTEXT },  
         { "thead", NODE_IGNTEXT },  
         { "tip", NODE_IGNTEXT },  
         { "title", 0 },  
         { "trademark", 0 },  
         { "type", 0 },  
         { "ulink", 0 },  
         { "userinput", 0 },  
         { "variablelist", NODE_IGNTEXT },  
         { "varlistentry", NODE_IGNTEXT },  
         { "varname", 0 },  
         { "warning", NODE_IGNTEXT },  
         { "wordasword", 0 },  
         { "year", NODE_IGNTEXT },  
 };  
   
 static  int warn = 0;  
   
 static void  static void
 pnode_print(struct parse *p, struct pnode *pn);  pnode_printtext(struct format *f, struct pnode *n)
   
 /*  
  * Process a stream of characters.  
  * We store text as nodes in and of themselves.  
  * If a text node is already open, append to it.  
  * If it's not open, open one under the current context.  
  */  
 static void  
 xml_char(void *arg, const XML_Char *p, int sz)  
 {  {
         struct parse    *ps = arg;          struct pnode    *nn;
         struct pnode    *dat;          char            *cp;
         int              i;          int              accept_arg;
   
         /* Stopped or no tree yet. */          cp = n->b;
         if (ps->stop || NODE_ROOT == ps->node)          accept_arg = f->flags & FMT_ARG;
                 return;          if (f->linestate == LINE_MACRO && !n->spc && !accept_arg) {
                   for (;;) {
                           if (*cp == '\0')
                                   return;
                           if (strchr("!),.:;?]", *cp) == NULL)
                                   break;
                           printf(" %c", *cp++);
                   }
                   if (isspace((unsigned char)*cp)) {
                           while (isspace((unsigned char)*cp))
                                   cp++;
                           macro_close(f);
                   } else {
                           fputs(" Ns", stdout);
                           f->flags &= FMT_IMPL;
                           accept_arg = 1;
                   }
           }
           if (f->linestate == LINE_MACRO && !accept_arg &&
               (f->flags & (FMT_CHILD | FMT_IMPL)) == 0)
                   macro_close(f);
   
         /* Not supposed to be collecting text. */  
         assert(NULL != ps->cur);  
         if (NODE_IGNTEXT & nodes[ps->node].flags)  
                 return;  
   
         /*          /*
          * Are we in the midst of processing text?           * Text preceding a macro without intervening whitespace
          * If we're not processing text right now, then create a text           * requires a .Pf macro.
          * node for doing so.           * Set the spacing flag to avoid a redundant .Ns macro.
          * However, don't do so unless we have some non-whitespace to  
          * process: strip out all leading whitespace to be sure.  
          */           */
         if (NODE_TEXT != ps->node) {  
                 for (i = 0; i < sz; i++)          if (f->linestate != LINE_MACRO &&
                         if ( ! isspace((int)p[i]))              (nn = TAILQ_NEXT(n, child)) != NULL && nn->spc == 0) {
                                 break;                  switch (pnode_class(nn->node)) {
                 if (i == sz)                  case CLASS_LINE:
                         return;                  case CLASS_ENCL:
                 p += i;                          macro_open(f, "Pf");
                 sz -= i;                          accept_arg = 1;
                 dat = calloc(1, sizeof(struct pnode));                          f->flags |= FMT_CHILD;
                 if (NULL == dat) {                          nn->spc = 1;
                         perror(NULL);                          break;
                         exit(EXIT_FAILURE);                  default:
                           break;
                 }                  }
           }
   
                 dat->node = ps->node = NODE_TEXT;          switch (f->linestate) {
                 dat->parent = ps->cur;          case LINE_NEW:
                 TAILQ_INIT(&dat->childq);                  break;
                 TAILQ_INIT(&dat->attrq);          case LINE_TEXT:
                 TAILQ_INSERT_TAIL(&ps->cur->childq, dat, child);                  if (n->spc) {
                 ps->cur = dat;                          if (n->node == NODE_TEXT)
                 assert(NULL != ps->root);                                  macro_close(f);
                           else
                                   putchar(' ');
                   }
                   break;
           case LINE_MACRO:
                   if (accept_arg)
                           putchar(' ');
                   else
                           macro_close(f);
                   break;
         }          }
   
         /* Append to current buffer. */          if (n->node == NODE_ESCAPE) {
         assert(sz >= 0);                  fputs(n->b, stdout);
         ps->cur->b = realloc(ps->cur->b,                  if (f->linestate == LINE_NEW)
                 ps->cur->bsz + (size_t)sz);                          f->linestate = LINE_TEXT;
         if (NULL == ps->cur->b) {                  return;
                 perror(NULL);  
                 exit(EXIT_FAILURE);  
         }          }
         memcpy(ps->cur->b + ps->cur->bsz, p, sz);  
         ps->cur->bsz += (size_t)sz;  
         ps->cur->real = ps->cur->b;  
 }  
   
 static void          /*
 pnode_trim(struct pnode *pn)           * Remove the prefix '-' from <option> elements
 {           * because the arguments of .Fl macros do not need it.
            */
   
         assert(NODE_TEXT == pn->node);          if (n->parent != NULL && n->parent->node == NODE_OPTION && *cp == '-')
         for ( ; pn->bsz > 0; pn->bsz--)                  cp++;
                 if ( ! isspace((int)pn->b[pn->bsz - 1]))  
                         break;          if (f->linestate == LINE_MACRO)
                   macro_addarg(f, cp, 0);
           else
                   print_text(f, cp, 0);
 }  }
   
 /*  
  * Begin an element.  
  * First, look for the element.  
  * If we don't find it and we're not parsing, keep going.  
  * If we don't find it and we're parsing, puke and exit.  
  * If we find it but we're not parsing yet (i.e., it's not a refentry  
  * and thus out of context), keep going.  
  * If we find it and we're at the root and already have a tree, puke and  
  * exit (FIXME: I don't think this is right?).  
  * If we find it but we're parsing a text node, close out the text node,  
  * return to its parent, and keep going.  
  * Make sure that the element is in the right context.  
  * Lastly, put the node onto our parse tree and continue.  
  */  
 static void  static void
 xml_elem_start(void *arg, const XML_Char *name, const XML_Char **atts)  pnode_printpara(struct format *f, struct pnode *n)
 {  {
         struct parse     *ps = arg;          struct pnode    *np;
         enum nodeid       node;  
         enum attrkey      key;  
         enum attrval      val;  
         struct pnode     *dat;  
         struct pattr     *pattr;  
         const XML_Char  **att;  
   
         /* FIXME: find a better way to ditch other namespaces. */          if (n->parent == NULL)
         if (ps->stop || 0 == strcmp(name, "xi:include"))  
                 return;                  return;
   
         /* Close out text node, if applicable... */          if ((np = TAILQ_PREV(n, pnodeq, child)) == NULL)
         if (NODE_TEXT == ps->node) {              np = n->parent;
                 assert(NULL != ps->cur);  
                 pnode_trim(ps->cur);  
                 ps->cur = ps->cur->parent;  
                 assert(NULL != ps->cur);  
                 ps->node = ps->cur->node;  
         }  
   
         for (node = 0; node < NODE__MAX; node++)          f->flags = 0;
                 if (NULL == nodes[node].name)  
                         continue;  
                 else if (0 == strcmp(nodes[node].name, name))  
                         break;  
   
         if (NODE__MAX == node && NODE_ROOT == ps->node) {          switch (np->node) {
           case NODE_ENTRY:
           case NODE_GLOSSTERM:
           case NODE_LISTITEM:
           case NODE_TERM:
                 return;                  return;
         } else if (NODE__MAX == node) {          case NODE_APPENDIX:
                 fprintf(stderr, "%s:%zu:%zu: unknown node \"%s\"\n",          case NODE_LEGALNOTICE:
                         ps->fname, XML_GetCurrentLineNumber(ps->xml),          case NODE_PREFACE:
                         XML_GetCurrentColumnNumber(ps->xml), name);          case NODE_SECTION:
                 ps->stop = 1;                  if (f->level < 3)
                 return;                          return;
         } else if (NODE_ROOT == ps->node && NULL != ps->root) {                  break;
                 fprintf(stderr, "%s:%zu:%zu: multiple refentries\n",          default:
                         ps->fname, XML_GetCurrentLineNumber(ps->xml),                  break;
                         XML_GetCurrentColumnNumber(ps->xml));  
                 ps->stop = 1;  
                 return;  
         } else if (NODE_ROOT == ps->node && NODE_REFENTRY != node) {  
                 return;  
         } else if ( ! isparent(node, ps->node)) {  
                 fprintf(stderr, "%s:%zu:%zu: bad parent \"%s\" "  
                         "of node \"%s\"\n",  
                         ps->fname, XML_GetCurrentLineNumber(ps->xml),  
                         XML_GetCurrentColumnNumber(ps->xml),  
                         NULL == nodes[ps->node].name ?  
                         "(none)" : nodes[ps->node].name,  
                         NULL == nodes[node].name ?  
                         "(none)" : nodes[node].name);  
                 ps->stop = 1;  
                 return;  
         }          }
           macro_line(f, "Pp");
   }
   
         if (NODE_INLINEEQUATION == node)  static void
                 ps->flags |= PARSE_EQN;  pnode_printrefnamediv(struct format *f, struct pnode *n)
   {
           struct pnode    *nc, *nn;
           int              comma;
   
         if (NULL == (dat = calloc(1, sizeof(struct pnode)))) {          macro_line(f, "Sh NAME");
                 perror(NULL);          comma = 0;
                 exit(EXIT_FAILURE);          TAILQ_FOREACH_SAFE(nc, &n->childq, child, nn) {
         }                  if (nc->node != NODE_REFNAME)
   
         dat->node = ps->node = node;  
         dat->parent = ps->cur;  
         TAILQ_INIT(&dat->childq);  
         TAILQ_INIT(&dat->attrq);  
   
         if (NULL != ps->cur)  
                 TAILQ_INSERT_TAIL(&ps->cur->childq, dat, child);  
   
         ps->cur = dat;  
         if (NULL == ps->root)  
                 ps->root = dat;  
   
         /*  
          * Process attributes.  
          */  
         for (att = atts; NULL != *att; att += 2) {  
                 for (key = 0; key < ATTRKEY__MAX; key++)  
                         if (0 == strcmp(*att, attrkeys[key]))  
                                 break;  
                 if (ATTRKEY__MAX == key) {  
                         if (warn)  
                                 fprintf(stderr, "%s:%zu:%zu: warning: "  
                                         "unknown attribute \"%s\"\n",  
                                         ps->fname,  
                                         XML_GetCurrentLineNumber(ps->xml),  
                                         XML_GetCurrentColumnNumber(ps->xml),  
                                         *att);  
                         continue;                          continue;
                 } else if ( ! isattrkey(node, key)) {                  if (comma)
                         if (warn)                          macro_addarg(f, ",", ARG_SPACE);
                                 fprintf(stderr, "%s:%zu:%zu: warning: "                  macro_open(f, "Nm");
                                         "bad attribute \"%s\"\n",                  macro_addnode(f, nc, ARG_SPACE);
                                         ps->fname,                  pnode_unlink(nc);
                                         XML_GetCurrentLineNumber(ps->xml),                  comma = 1;
                                         XML_GetCurrentColumnNumber(ps->xml),  
                                         *att);  
                         continue;  
                 }  
                 for (val = 0; val < ATTRVAL__MAX; val++)  
                         if (0 == strcmp(*(att + 1), attrvals[val]))  
                                 break;  
                 if (ATTRVAL__MAX != val && ! isattrval(key, val)) {  
                         if (warn)  
                                 fprintf(stderr, "%s:%zu:%zu: warning: "  
                                         "bad attribute value \"%s\"\n",  
                                         ps->fname,  
                                         XML_GetCurrentLineNumber(ps->xml),  
                                         XML_GetCurrentColumnNumber(ps->xml),  
                                         *(att + 1));  
                         continue;  
                 }  
                 pattr = calloc(1, sizeof(struct pattr));  
                 pattr->key = key;  
                 pattr->val = val;  
                 if (ATTRVAL__MAX == val)  
                         pattr->rawval = strdup(*(att + 1));  
                 TAILQ_INSERT_TAIL(&dat->attrq, pattr, child);  
         }          }
           macro_close(f);
 }  }
   
 /*  /*
  * Roll up the parse tree.   * If the SYNOPSIS macro has a superfluous title, kill it.
  * If we're at a text node, roll that one up first.  
  * If we hit the root, then assign ourselves as the NODE_ROOT.  
  */   */
 static void  static void
 xml_elem_end(void *arg, const XML_Char *name)  pnode_printrefsynopsisdiv(struct format *f, struct pnode *n)
 {  {
         struct parse    *ps = arg;          struct pnode    *nc, *nn;
   
         /* FIXME: find a better way to ditch other namespaces. */          TAILQ_FOREACH_SAFE(nc, &n->childq, child, nn)
         if (ps->stop || NODE_ROOT == ps->node)                  if (nc->node == NODE_TITLE)
                 return;                          pnode_unlink(nc);
         else if (0 == strcmp(name, "xi:include"))  
                 return;  
   
         /* Close out text node, if applicable... */          macro_line(f, "Sh SYNOPSIS");
         if (NODE_TEXT == ps->node) {  
                 assert(NULL != ps->cur);  
                 pnode_trim(ps->cur);  
                 ps->cur = ps->cur->parent;  
                 assert(NULL != ps->cur);  
                 ps->node = ps->cur->node;  
         }  
   
         if (NULL == (ps->cur = ps->cur->parent))  
                 ps->node = NODE_ROOT;  
         else  
                 ps->node = ps->cur->node;  
 }  }
   
 /*  /*
  * Recursively free a node (NULL is ok).   * Start a hopefully-named `Sh' section.
  */   */
 static void  static void
 pnode_free(struct pnode *pn)  pnode_printsection(struct format *f, struct pnode *n)
 {  {
         struct pnode    *pp;          struct pnode    *nc, *ncc;
         struct pattr    *ap;          const char      *title;
           int              flags, level;
   
         if (NULL == pn)          if (n->parent == NULL) {
                   pnode_printrefentry(f, n);
                 return;                  return;
   
         while (NULL != (pp = TAILQ_FIRST(&pn->childq))) {  
                 TAILQ_REMOVE(&pn->childq, pp, child);  
                 pnode_free(pp);  
         }          }
   
         while (NULL != (ap = TAILQ_FIRST(&pn->attrq))) {          level = ++f->level;
                 TAILQ_REMOVE(&pn->attrq, ap, child);          flags = ARG_SPACE;
                 free(ap->rawval);          switch (n->node) {
                 free(ap);          case NODE_PREFACE:
           case NODE_SECTION:
           case NODE_APPENDIX:
                   if (level == 1)
                           flags |= ARG_UPPER;
                   break;
           case NODE_SIMPLESECT:
           case NODE_LEGALNOTICE:
                   if (level < 2)
                           level = 2;
                   break;
           default:
                   if (level < 3)
                           level = 3;
                   break;
         }          }
   
         free(pn->real);          TAILQ_FOREACH(nc, &n->childq, child)
         free(pn);                  if (nc->node == NODE_TITLE)
 }                          break;
   
 /*          if (nc == NULL) {
  * Unlink a node from its parent and pnode_free() it.                  switch (n->node) {
  */                  case NODE_PREFACE:
 static void                          title = "Preface";
 pnode_unlink(struct pnode *pn)                          break;
 {                  case NODE_APPENDIX:
                           title = "Appendix";
                           break;
                   case NODE_LEGALNOTICE:
                           title = "Legal Notice";
                           break;
                   case NODE_CAUTION:
                           title = "Caution";
                           break;
                   case NODE_NOTE:
                           title = "Note";
                           break;
                   case NODE_TIP:
                           title = "Tip";
                           break;
                   case NODE_WARNING:
                           title = "Warning";
                           break;
                   default:
                           title = "Unknown";
                           break;
                   }
           }
   
         if (NULL != pn->parent)          switch (level) {
                 TAILQ_REMOVE(&pn->parent->childq, pn, child);          case 1:
         pnode_free(pn);                  macro_close(f);
 }                  macro_open(f, "Sh");
                   break;
           case 2:
                   macro_close(f);
                   macro_open(f, "Ss");
                   break;
           default:
                   pnode_printpara(f, n);
                   macro_open(f, "Sy");
                   break;
           }
   
 /*          if (nc != NULL)
  * Unlink all children of a node and pnode_free() them.                  macro_addnode(f, nc, flags);
  */          else
 static void                  macro_addarg(f, title, flags | ARG_QUOTED);
 pnode_unlinksub(struct pnode *pn)          macro_close(f);
 {  
   
         while ( ! TAILQ_EMPTY(&pn->childq))          /*
                 pnode_unlink(TAILQ_FIRST(&pn->childq));           * DocBook has no equivalent for -split mode,
            * so just switch the default in the AUTHORS section.
            */
   
           if (nc != NULL) {
                   ncc = TAILQ_FIRST(&nc->childq);
                   if (ncc != NULL && ncc->node == NODE_TEXT &&
                       strcasecmp(ncc->b, "AUTHORS") == 0)
                           macro_line(f, "An -nosplit");
                   pnode_unlink(nc);
           }
 }  }
   
 /*  /*
  * Reset the lookaside buffer.   * Start a reference, extracting the title and volume.
  */   */
 static void  static void
 bufclear(struct parse *p)  pnode_printciterefentry(struct format *f, struct pnode *n)
 {  {
           struct pnode    *nc, *title, *manvol;
   
         p->b[p->bsz = 0] = '\0';          title = manvol = NULL;
           TAILQ_FOREACH(nc, &n->childq, child) {
                   if (nc->node == NODE_MANVOLNUM)
                           manvol = nc;
                   else if (nc->node == NODE_REFENTRYTITLE)
                           title = nc;
           }
           macro_open(f, "Xr");
           if (title == NULL)
                   macro_addarg(f, "unknown", ARG_SPACE);
           else
                   macro_addnode(f, title, ARG_SPACE | ARG_SINGLE);
           if (manvol == NULL)
                   macro_addarg(f, "1", ARG_SPACE);
           else
                   macro_addnode(f, manvol, ARG_SPACE | ARG_SINGLE);
           pnode_unlinksub(n);
 }  }
   
 /*  
  * Append NODE_TEXT contents to the current buffer, reallocating its  
  * size if necessary.  
  * The buffer is ALWAYS nil-terminated.  
  */  
 static void  static void
 bufappend(struct parse *p, struct pnode *pn)  pnode_printfuncdef(struct format *f, struct pnode *n)
 {  {
           struct pnode    *nc;
   
         assert(NODE_TEXT == pn->node);          nc = TAILQ_FIRST(&n->childq);
         if (p->bsz + pn->bsz + 1 > p->mbsz) {          if (nc != NULL && nc->node == NODE_TEXT) {
                 p->mbsz = p->bsz + pn->bsz + 1;                  macro_argline(f, "Ft", nc->b);
                 if (NULL == (p->b = realloc(p->b, p->mbsz))) {                  pnode_unlink(nc);
                         perror(NULL);  
                         exit(EXIT_FAILURE);  
                 }  
         }          }
         memcpy(p->b + p->bsz, pn->b, pn->bsz);          macro_nodeline(f, "Fo", n, ARG_SINGLE);
         p->bsz += pn->bsz;          pnode_unlinksub(n);
         p->b[p->bsz] = '\0';  
 }  }
   
 /*  /*
  * Recursively append all NODE_TEXT nodes to the buffer.   * The <mml:mfenced> node is a little peculiar.
  * This descends into non-text nodes, but doesn't do anything beyond   * First, it can have arbitrary open and closing tokens, which default
  * them.   * to parentheses.
  * In other words, this is a recursive text grok.   * Second, >1 arguments are separated by commas.
  */   */
 static void  static void
 bufappend_r(struct parse *p, struct pnode *pn)  pnode_printmathfenced(struct format *f, struct pnode *n)
 {  {
         struct pnode    *pp;          struct pnode    *nc;
   
         if (NODE_TEXT == pn->node)          printf("left %s ", pnode_getattr_raw(n, ATTRKEY_OPEN, "("));
                 bufappend(p, pn);  
         TAILQ_FOREACH(pp, &pn->childq, child)  
                 bufappend_r(p, pp);  
 }  
   
 /*          nc = TAILQ_FIRST(&n->childq);
  * Recursively search and return the first instance of "node".          pnode_print(f, nc);
  */  
 static struct pnode *  
 pnode_findfirst(struct pnode *pn, enum nodeid node)  
 {  
         struct pnode    *pp, *res;  
   
         res = NULL;          while ((nc = TAILQ_NEXT(nc, child)) != NULL) {
         TAILQ_FOREACH(pp, &pn->childq, child) {                  putchar(',');
                 res = pp->node == node ? pp :                  pnode_print(f, nc);
                         pnode_findfirst(pp, node);  
                 if (NULL != res)  
                         break;  
         }          }
           printf("right %s ", pnode_getattr_raw(n, ATTRKEY_CLOSE, ")"));
         return(res);          pnode_unlinksub(n);
 }  }
   
 #define MACROLINE_NORM  0  
 #define MACROLINE_UPPER 1  
 #define MACROLINE_NOWS 2  
 /*  /*
  * Recursively print text presumably on a macro line.   * These math nodes require special handling because they have infix
  * Convert all whitespace to regular spaces.   * syntax, instead of the usual prefix or prefix.
    * So we need to break up the first and second child node with a
    * particular eqn(7) word.
  */   */
 static void  static void
 pnode_printmacrolinetext(struct parse *p, struct pnode *pn, int fl)  pnode_printmath(struct format *f, struct pnode *n)
 {  {
         char            *cp;          struct pnode    *nc;
   
         if (0 == p->newln && ! (MACROLINE_NOWS & fl))          nc = TAILQ_FIRST(&n->childq);
                 putchar(' ');          pnode_print(f, nc);
   
         bufclear(p);          switch (n->node) {
         bufappend_r(p, pn);          case NODE_MML_MSUP:
                   fputs(" sup ", stdout);
         /* Convert all space to spaces. */                  break;
         for (cp = p->b; '\0' != *cp; cp++)          case NODE_MML_MFRAC:
                 if (isspace((int)*cp))                  fputs(" over ", stdout);
                         *cp = ' ';                  break;
           case NODE_MML_MSUB:
         for (cp = p->b; isspace((int)*cp); cp++)                  fputs(" sub ", stdout);
                 /* Spin past whitespace (XXX: necessary?) */ ;                  break;
         for ( ; '\0' != *cp; cp++) {          default:
                 /* Escape us if we look like a macro. */                  break;
                 if ((cp == p->b || ' ' == *(cp - 1)) &&  
                         isupper((int)*cp) &&  
                         '\0' != *(cp + 1) &&  
                         islower((int)*(cp + 1)) &&  
                         ('\0' == *(cp + 2) ||  
                          ' ' == *(cp + 2) ||  
                          (islower((int)*(cp + 2)) &&  
                           ('\0' == *(cp + 3) ||  
                            ' ' == *(cp + 3)))))  
                         fputs("\\&", stdout);  
                 if (MACROLINE_UPPER & fl)  
                         putchar(toupper((int)*cp));  
                 else  
                         putchar((int)*cp);  
                 /* If we're a character escape, escape us. */  
                 if ('\\' == *cp)  
                         putchar('e');  
         }          }
 }  
   
 static void          nc = TAILQ_NEXT(nc, child);
 pnode_printmacrolinepart(struct parse *p, struct pnode *pn)          pnode_print(f, nc);
 {          pnode_unlinksub(n);
   
         pnode_printmacrolinetext(p, pn, 0);  
 }  }
   
 /*  
  * Just pnode_printmacrolinepart() but with a newline.  
  * If no text, just the newline.  
  */  
 static void  static void
 pnode_printmacroline(struct parse *p, struct pnode *pn)  pnode_printfuncprototype(struct format *f, struct pnode *n)
 {  {
           struct pnode    *nc, *fdef;
   
         assert(0 == p->newln);          TAILQ_FOREACH(fdef, &n->childq, child)
         pnode_printmacrolinetext(p, pn, 0);                  if (fdef->node == NODE_FUNCDEF)
         putchar('\n');                          break;
         p->newln = 1;  
 }  
   
 static void          if (fdef != NULL) {
 pnode_printmopen(struct parse *p)                  pnode_printfuncdef(f, fdef);
 {                  pnode_unlink(fdef);
         if (p->newln) {  
                 putchar('.');  
                 p->newln = 0;  
         } else          } else
                 putchar(' ');                  macro_line(f, "Fo UNKNOWN");
 }  
   
 static void          TAILQ_FOREACH(nc, &n->childq, child)
 pnode_printmclose(struct parse *p, int sv)                  macro_nodeline(f, "Fa", nc, ARG_SINGLE);
 {  
   
         if (sv && ! p->newln) {          macro_line(f, "Fc");
                 putchar('\n');          pnode_unlinksub(n);
                 p->newln = 1;  
         }  
 }  }
   
 /*  /*
  * Like pnode_printmclose() except we look to the next node, and, if   * The <arg> element is more complicated than it should be because text
  * found, see if it starts with punctuation.   * nodes are treated like ".Ar foo", but non-text nodes need to be
  * If it does, then we print that punctuation before the newline.   * re-sent into the printer (i.e., without the preceding ".Ar").
    * This also handles the case of "repetition" (or in other words, the
    * ellipsis following an argument) and optionality.
  */   */
 static void  static void
 pnode_printmclosepunct(struct parse *p, struct pnode *pn, int sv)  pnode_printarg(struct format *f, struct pnode *n)
 {  {
         /* We wouldn't have done anything anyway. */          struct pnode    *nc;
         if ( ! (sv && ! p->newln))          struct pattr    *a;
                 return;          int              isop, isrep, was_impl;
   
         /* No next node or it's not text. */          isop = 1;
         if (NULL == (pn = TAILQ_NEXT(pn, child))) {          isrep = was_impl = 0;
                 pnode_printmclose(p, sv);          TAILQ_FOREACH(a, &n->attrq, child) {
                 return;                  if (a->key == ATTRKEY_CHOICE &&
         } else if (NODE_TEXT != pn->node) {                      (a->val == ATTRVAL_PLAIN || a->val == ATTRVAL_REQ))
                 pnode_printmclose(p, sv);                          isop = 0;
                 return;                  else if (a->key == ATTRKEY_REP && a->val == ATTRVAL_REPEAT)
                           isrep = 1;
         }          }
           if (isop) {
         /* Only do this for the comma/period. */                  if (f->flags & FMT_IMPL) {
         if (pn->bsz > 0 &&                          was_impl = 1;
                 (',' == pn->b[0] || '.' == pn->b[0]) &&                          macro_open(f, "Oo");
                 (1 == pn->bsz || isspace((int)pn->b[1]))) {                  } else {
                 putchar(' ');                          macro_open(f, "Op");
                 putchar(pn->b[0]);                          f->flags |= FMT_IMPL;
                 pn->b++;                  }
                 pn->bsz--;  
         }          }
           TAILQ_FOREACH(nc, &n->childq, child) {
         putchar('\n');                  if (nc->node == NODE_TEXT)
         p->newln = 1;                          macro_open(f, "Ar");
                   pnode_print(f, nc);
           }
           if (isrep && f->linestate == LINE_MACRO)
                   macro_addarg(f, "...", ARG_SPACE);
           if (isop) {
                   if (was_impl)
                           macro_open(f, "Oc");
                   else
                           f->flags &= ~FMT_IMPL;
           }
           pnode_unlinksub(n);
 }  }
   
 /*  
  * If the SYNOPSIS macro has a superfluous title, kill it.  
  */  
 static void  static void
 pnode_printrefsynopsisdiv(struct parse *p, struct pnode *pn)  pnode_printgroup(struct format *f, struct pnode *n)
 {  {
         struct pnode    *pp;          struct pnode    *nc;
           struct pattr    *a;
           int              bar, isop, isrep, was_impl;
   
         TAILQ_FOREACH(pp, &pn->childq, child)          isop = 1;
                 if (NODE_TITLE == pp->node) {          isrep = was_impl = 0;
                         pnode_unlink(pp);          TAILQ_FOREACH(a, &n->attrq, child) {
                         return;                  if (a->key == ATTRKEY_CHOICE &&
                       (a->val == ATTRVAL_PLAIN || a->val == ATTRVAL_REQ))
                           isop = 0;
                   else if (a->key == ATTRKEY_REP && a->val == ATTRVAL_REPEAT)
                           isrep = 1;
           }
           if (isop) {
                   if (f->flags & FMT_IMPL) {
                           was_impl = 1;
                           macro_open(f, "Oo");
                   } else {
                           macro_open(f, "Op");
                           f->flags |= FMT_IMPL;
                 }                  }
           } else if (isrep) {
                   if (f->flags & FMT_IMPL) {
                           was_impl = 1;
                           macro_open(f, "Bro");
                   } else {
                           macro_open(f, "Brq");
                           f->flags |= FMT_IMPL;
                   }
           }
           bar = 0;
           TAILQ_FOREACH(nc, &n->childq, child) {
                   if (bar && f->linestate == LINE_MACRO)
                           macro_addarg(f, "|", ARG_SPACE);
                   pnode_print(f, nc);
                   bar = 1;
           }
           if (isop) {
                   if (was_impl)
                           macro_open(f, "Oc");
                   else
                           f->flags &= ~FMT_IMPL;
           } else if (isrep) {
                   if (was_impl)
                           macro_open(f, "Brc");
                   else
                           f->flags &= ~FMT_IMPL;
           }
           if (isrep && f->linestate == LINE_MACRO)
                   macro_addarg(f, "...", ARG_SPACE);
           pnode_unlinksub(n);
 }  }
   
 /*  
  * Start a hopefully-named `Sh' section.  
  */  
 static void  static void
 pnode_printrefsect(struct parse *p, struct pnode *pn)  pnode_printsystemitem(struct format *f, struct pnode *n)
 {  {
         struct pnode    *pp;          switch (pnode_getattr(n, ATTRKEY_CLASS)) {
           case ATTRVAL_IPADDRESS:
         TAILQ_FOREACH(pp, &pn->childq, child)  
                 if (NODE_TITLE == pp->node)  
                         break;  
   
         switch (pn->node) {  
         case (NODE_REFSECT1):  
                 fputs(".Sh", stdout);  
                 break;                  break;
         case (NODE_REFSECT2):          case ATTRVAL_SYSTEMNAME:
                 fputs(".Ss", stdout);                  macro_open(f, "Pa");
                 break;                  break;
         case (NODE_REFSECT3):          case ATTRVAL_EVENT:
                 puts(".Pp");  
                 fputs(".Sy", stdout);  
                 break;  
         case (NODE_NOTE):  
                 /* FALLTHROUGH */  
         case (NODE_REFSECTION):  
                 /* FALLTHROUGH */  
         case (NODE_TIP):  
                 /* FALLTHROUGH */  
         case (NODE_CAUTION):  
                 /* FALLTHROUGH */  
         case (NODE_WARNING):  
                 puts(".Pp");  
                 if (NULL == pp)  
                         return;  
                 fputs(".Em", stdout);  
                 break;  
         default:          default:
                   macro_open(f, "Sy");
                 break;                  break;
         }          }
   
         p->newln = 0;  
   
         if (NULL != pp) {  
                 pnode_printmacrolinetext(p, pp,  
                         NODE_REFSECT1 == pn->node ?  
                         MACROLINE_UPPER : 0);  
                 pnode_printmclose(p, 1);  
                 pnode_unlink(pp);  
         } else {  
                 puts(NODE_REFSECT1 == pn->node ?  
                         "UNKNOWN" : "unknown");  
                 p->newln = 1;  
         }  
 }  }
   
 /*  
  * Start a reference, extracting the title and volume.  
  */  
 static void  static void
 pnode_printciterefentry(struct parse *p, struct pnode *pn)  pnode_printauthor(struct format *f, struct pnode *n)
 {  {
         struct pnode    *pp, *title, *manvol;          struct pnode    *nc, *nn;
           int              have_contrib, have_name;
   
         title = manvol = NULL;          /*
         TAILQ_FOREACH(pp, &pn->childq, child)           * Print <contrib> children up front, before the .An scope,
                 if (NODE_MANVOLNUM == pp->node)           * and figure out whether we a name of a person.
                         manvol = pp;           */
                 else if (NODE_REFENTRYTITLE == pp->node)  
                         title = pp;  
   
         if (NULL != title) {          have_contrib = have_name = 0;
                 pnode_printmacrolinepart(p, title);          TAILQ_FOREACH_SAFE(nc, &n->childq, child, nn) {
         } else                  switch (nc->node) {
                 fputs(" unknown ", stdout);                  case NODE_CONTRIB:
                           if (have_contrib)
                                   print_text(f, ",", 0);
                           print_textnode(f, nc);
                           pnode_unlink(nc);
                           have_contrib = 1;
                           break;
                   case NODE_PERSONNAME:
                           have_name = 1;
                           break;
                   default:
                           break;
                   }
           }
           if (TAILQ_FIRST(&n->childq) == NULL)
                   return;
   
         if (NULL == manvol) {          if (have_contrib)
                 puts(" 1");                  print_text(f, ":", 0);
                 p->newln = 1;  
         } else  
                 pnode_printmacrolinepart(p, manvol);  
 }  
   
 static void          /*
 pnode_printrefmeta(struct parse *p, struct pnode *pn)           * If we have a name, print it in the .An scope and leave
 {           * all other content for child handlers, to print after the
         struct pnode    *pp, *title, *manvol;           * scope.  Otherwise, print everything in the scope.
            */
   
         title = manvol = NULL;          macro_open(f, "An");
         assert(p->newln);          TAILQ_FOREACH_SAFE(nc, &n->childq, child, nn) {
         TAILQ_FOREACH(pp, &pn->childq, child)                  if (nc->node == NODE_PERSONNAME || have_name == 0) {
                 if (NODE_MANVOLNUM == pp->node)                          macro_addnode(f, nc, ARG_SPACE);
                         manvol = pp;                          pnode_unlink(nc);
                 else if (NODE_REFENTRYTITLE == pp->node)                  }
                         title = pp;          }
   
         puts(".Dd $Mdocdate" "$");          /*
         fputs(".Dt", stdout);           * If there is an email address,
         p->newln = 0;           * print it on the same macro line.
            */
   
         if (NULL != title)          if ((nc = pnode_findfirst(n, NODE_EMAIL)) != NULL) {
                 pnode_printmacrolinetext(p, title, MACROLINE_UPPER);                  f->flags |= FMT_CHILD;
         else                  macro_open(f, "Aq Mt");
                 fputs(" UNKNOWN ", stdout);                  macro_addnode(f, nc, ARG_SPACE);
                   pnode_unlink(nc);
           }
   
         if (NULL == manvol) {          /*
                 puts(" 1");           * If there are still unprinted children, end the scope
                 p->newln = 1;           * with a comma.  Otherwise, leave the scope open in case
         } else           * a text node follows that starts with closing punctuation.
                 pnode_printmacroline(p, manvol);           */
   
         puts(".Os");          if (TAILQ_FIRST(&n->childq) != NULL) {
                   macro_addarg(f, ",", ARG_SPACE);
                   macro_close(f);
           }
 }  }
   
 static void  static void
 pnode_printfuncdef(struct parse *p, struct pnode *pn)  pnode_printlink(struct format *f, struct pnode *n)
 {  {
         struct pnode    *pp, *ftype, *func;          struct pnode    *nc;
           const char      *uri, *text;
   
         assert(p->newln);          uri = pnode_getattr_raw(n, ATTRKEY_LINKEND, NULL);
         ftype = func = NULL;          if (uri != NULL) {
         TAILQ_FOREACH(pp, &pn->childq, child)                  if (TAILQ_FIRST(&n->childq) != NULL) {
                 if (NODE_TEXT == pp->node)                          TAILQ_FOREACH(nc, &n->childq, child)
                         ftype = pp;                                  pnode_print(f, nc);
                 else if (NODE_FUNCTION == pp->node)                          text = "";
                         func = pp;                  } else if ((text = pnode_getattr_raw(n,
                       ATTRKEY_ENDTERM, NULL)) != NULL) {
         if (NULL != ftype) {                          if (f->linestate == LINE_MACRO && f->flags & FMT_ARG)
                 fputs(".Ft", stdout);                                  macro_addarg(f, text, ARG_SPACE);
                 p->newln = 0;                          else
                 pnode_printmacroline(p, ftype);                                  print_text(f, text, ARG_SPACE);
                   }
                   if (text != NULL) {
                           if (f->flags & FMT_IMPL)
                                   macro_open(f, "Po");
                           else {
                                   macro_open(f, "Pq");
                                   f->flags |= FMT_CHILD;
                           }
                   }
                   macro_open(f, "Sx");
                   macro_addarg(f, uri, ARG_SPACE);
                   if (text != NULL && f->flags & FMT_IMPL)
                           macro_open(f, "Pc");
                   pnode_unlinksub(n);
                   return;
         }          }
           uri = pnode_getattr_raw(n, ATTRKEY_XLINK_HREF, NULL);
         if (NULL != func) {          if (uri == NULL)
                 fputs(".Fo", stdout);                  uri = pnode_getattr_raw(n, ATTRKEY_URL, NULL);
                 p->newln = 0;          if (uri != NULL) {
                 pnode_printmacroline(p, func);                  macro_open(f, "Lk");
         } else {                  macro_addarg(f, uri, ARG_SPACE | ARG_SINGLE);
                 puts(".Fo UNKNOWN");                  if (TAILQ_FIRST(&n->childq) != NULL)
                 p->newln = 1;                          macro_addnode(f, n, ARG_SPACE | ARG_SINGLE);
                   pnode_unlinksub(n);
                   return;
         }          }
 }  }
   
 static void  static void
 pnode_printparamdef(struct parse *p, struct pnode *pn)  pnode_printprologue(struct format *f, struct pnode *root)
 {  {
         struct pnode    *pp, *ptype, *param;          struct pnode    *date, *refmeta, *name, *vol, *descr, *nc, *nn;
           const char      *sname;
   
         assert(p->newln);          /* Collect information. */
         ptype = param = NULL;  
         TAILQ_FOREACH(pp, &pn->childq, child)  
                 if (NODE_TEXT == pp->node)  
                         ptype = pp;  
                 else if (NODE_PARAMETER == pp->node)  
                         param = pp;  
   
         fputs(".Fa \"", stdout);          if ((date = pnode_takefirst(root, NODE_PUBDATE)) == NULL)
         p->newln = 0;                  date = pnode_takefirst(root, NODE_DATE);
         if (NULL != ptype) {  
                 pnode_printmacrolinetext(p, ptype, MACROLINE_NOWS);          name = vol = NULL;
                 putchar(' ');          if ((refmeta = pnode_findfirst(root, NODE_REFMETA)) != NULL) {
                   TAILQ_FOREACH_SAFE(nc, &refmeta->childq, child, nn) {
                           switch (nc->node) {
                           case NODE_REFENTRYTITLE:
                                   name = nc;
                                   break;
                           case NODE_MANVOLNUM:
                                   vol = nc;
                                   break;
                           default:
                                   continue;
                           }
                           TAILQ_REMOVE(&refmeta->childq, nc, child);
                   }
         }          }
   
         if (NULL != param)          if (pnode_findfirst(root, NODE_REFNAMEDIV) == NULL &&
                 pnode_printmacrolinepart(p, param);              ((nc = pnode_findfirst(root, NODE_BOOKINFO)) != NULL ||
                (nc = pnode_findfirst(root, NODE_REFENTRYINFO)) != NULL))
                   descr = pnode_takefirst(nc, NODE_TITLE);
           else
                   descr = NULL;
   
         puts("\"");          /* Print prologue. */
         p->newln = 1;  
 }  
   
 /*          if (date == NULL)
  * The <mml:mfenced> node is a little peculiar.                  macro_line(f, "Dd $Mdocdate" "$");
  * First, it can have arbitrary open and closing tokens, which default          else
  * to parentheses.                  macro_nodeline(f, "Dd", date, 0);
  * Second, >1 arguments are separated by commas.  
  */  
 static void  
 pnode_printmathfenced(struct parse *p, struct pnode *pn)  
 {  
         struct pnode    *pp;  
         struct pattr    *ap;  
   
         TAILQ_FOREACH(ap, &pn->attrq, child)          macro_open(f, "Dt");
                 if (ATTRKEY_OPEN == ap->key) {          if (name == NULL) {
                         printf("left %s ", ap->rawval);                  sname = pnode_getattr_raw(root, ATTRKEY_ID, "UNKNOWN");
                         break;                  macro_addarg(f, sname, ARG_SPACE | ARG_SINGLE | ARG_UPPER);
                 }          } else
         if (NULL == ap)                  macro_addnode(f, name, ARG_SPACE | ARG_SINGLE | ARG_UPPER);
                 printf("left ( ");          if (vol == NULL)
                   macro_addarg(f, "1", ARG_SPACE);
           else
                   macro_addnode(f, vol, ARG_SPACE | ARG_SINGLE);
   
         pp = TAILQ_FIRST(&pn->childq);          macro_line(f, "Os");
         pnode_print(p, pp);  
   
         while (NULL != (pp = TAILQ_NEXT(pp, child))) {          if (descr != NULL) {
                 putchar(',');                  macro_line(f, "Sh NAME");
                 pnode_print(p, pp);                  if (name == NULL)
                           macro_argline(f, "Nm", sname);
                   else
                           macro_nodeline(f, "Nm", name, ARG_SINGLE);
                   macro_nodeline(f, "Nd", descr, 0);
         }          }
   
         TAILQ_FOREACH(ap, &pn->attrq, child)          /* Clean up. */
                 if (ATTRKEY_CLOSE == ap->key) {  
                         printf("right %s ", ap->rawval);          pnode_unlink(date);
                         break;          pnode_unlink(name);
                 }          pnode_unlink(vol);
         if (NULL == ap)          pnode_unlink(descr);
                 printf("right ) ");  
 }  }
   
 /*  
  * These math nodes require special handling because they have infix  
  * syntax, instead of the usual prefix or prefix.  
  * So we need to break up the first and second child node with a  
  * particular eqn(7) word.  
  */  
 static void  static void
 pnode_printmath(struct parse *p, struct pnode *pn)  pnode_printrefentry(struct format *f, struct pnode *n)
 {  {
         struct pnode    *pp;          struct pnode    *info, *meta, *nc, *title;
           struct pnode    *match, *later;
   
         pp = TAILQ_FIRST(&pn->childq);          /* Collect nodes that remained behind when writing the prologue. */
         pnode_print(p, pp);  
   
         switch (pn->node) {          meta = NULL;
         case (NODE_MML_MSUP):          info = pnode_takefirst(n, NODE_BOOKINFO);
                 fputs(" sup ", stdout);          if (info != NULL && TAILQ_FIRST(&info->childq) == NULL) {
                 break;                  pnode_unlink(info);
         case (NODE_MML_MFRAC):                  info = NULL;
                 fputs(" over ", stdout);  
                 break;  
         case (NODE_MML_MSUB):  
                 fputs(" sub ", stdout);  
                 break;  
         default:  
                 break;  
         }          }
           if (info == NULL) {
                   info = pnode_takefirst(n, NODE_REFENTRYINFO);
                   if (info != NULL && TAILQ_FIRST(&info->childq) == NULL) {
                           pnode_unlink(info);
                           info = NULL;
                   }
                   meta = pnode_takefirst(n, NODE_REFMETA);
                   if (meta != NULL && TAILQ_FIRST(&meta->childq) == NULL) {
                           pnode_unlink(meta);
                           meta = NULL;
                   }
           }
           if (info == NULL && meta == NULL)
                   return;
   
         pp = TAILQ_NEXT(pp, child);          /*
         pnode_print(p, pp);           * Find the best place to put this information.
 }           * Use the last existing AUTHORS node, if any.
            * Otherwise, put it behind all standard sections that
            * conventionally precede AUTHORS, and also behind any
            * non-standard sections that follow the last of these,
            * but before the next standard section.
            */
   
 static void          match = later = NULL;
 pnode_printfuncprototype(struct parse *p, struct pnode *pn)          TAILQ_FOREACH(nc, &n->childq, child) {
 {                  switch (nc->node) {
         struct pnode    *pp, *fdef;                  case NODE_REFENTRY:
                   case NODE_REFNAMEDIV:
         assert(p->newln);                  case NODE_REFSYNOPSISDIV:
         TAILQ_FOREACH(fdef, &pn->childq, child)                  case NODE_PREFACE:
                 if (NODE_FUNCDEF == fdef->node)                          later = NULL;
                           continue;
                   case NODE_APPENDIX:
                   case NODE_INDEX:
                           if (later == NULL)
                                   later = nc;
                           continue;
                   default:
                         break;                          break;
                   }
                   if ((title = pnode_findfirst(nc, NODE_TITLE)) == NULL ||
                       (title = TAILQ_FIRST(&title->childq)) == NULL ||
                       title->node != NODE_TEXT)
                           continue;
                   if (strcasecmp(title->b, "AUTHORS") == 0 ||
                       strcasecmp(title->b, "AUTHOR") == 0)
                           match = nc;
                   else if (strcasecmp(title->b, "NAME") == 0 ||
                       strcasecmp(title->b, "SYNOPSIS") == 0 ||
                       strcasecmp(title->b, "DESCRIPTION") == 0 ||
                       strcasecmp(title->b, "RETURN VALUES") == 0 ||
                       strcasecmp(title->b, "ENVIRONMENT") == 0 ||
                       strcasecmp(title->b, "FILES") == 0 ||
                       strcasecmp(title->b, "EXIT STATUS") == 0 ||
                       strcasecmp(title->b, "EXAMPLES") == 0 ||
                       strcasecmp(title->b, "DIAGNOSTICS") == 0 ||
                       strcasecmp(title->b, "ERRORS") == 0 ||
                       strcasecmp(title->b, "SEE ALSO") == 0 ||
                       strcasecmp(title->b, "STANDARDS") == 0 ||
                       strcasecmp(title->b, "HISTORY") == 0)
                           later = NULL;
                   else if ((strcasecmp(title->b, "CAVEATS") == 0 ||
                       strcasecmp(title->b, "BUGS") == 0) &&
                       later == NULL)
                           later = nc;
           }
   
         if (NULL != fdef)          /*
                 pnode_printfuncdef(p, fdef);           * If no AUTHORS section was found, create one from scratch,
         else           * and insert that at the place selected earlier.
                 puts(".Fo UNKNOWN");           */
   
         TAILQ_FOREACH(pp, &pn->childq, child)          if (match == NULL) {
                 if (NODE_PARAMDEF == pp->node)                  if ((match = calloc(1, sizeof(*match))) == NULL) {
                         pnode_printparamdef(p, pp);                          perror(NULL);
                           exit(1);
                   }
                   match->node = NODE_SECTION;
                   match->spc = 1;
                   match->parent = n;
                   TAILQ_INIT(&match->childq);
                   TAILQ_INIT(&match->attrq);
                   if ((nc = pnode_alloc(match)) == NULL) {
                           perror(NULL);
                           exit(1);
                   }
                   nc->node = NODE_TITLE;
                   nc->spc = 1;
                   if ((nc = pnode_alloc(nc)) == NULL) {
                           perror(NULL);
                           exit(1);
                   }
                   nc->node = NODE_TEXT;
                   if ((nc->b = strdup("AUTHORS")) == NULL) {
                           perror(NULL);
                           exit(1);
                   }
                   nc->spc = 1;
                   if (later == NULL)
                           TAILQ_INSERT_TAIL(&n->childq, match, child);
                   else
                           TAILQ_INSERT_BEFORE(later, match, child);
           }
   
         puts(".Fc");          /*
         p->newln = 1;           * Dump the stuff excised at the beginning
            * into this AUTHORS section.
            */
   
           if (info != NULL)
                   TAILQ_INSERT_TAIL(&match->childq, info, child);
           if (meta != NULL)
                   TAILQ_INSERT_TAIL(&match->childq, meta, child);
 }  }
   
 /*  /*
  * The <arg> element is more complicated than it should be because text   * We can have multiple <term> elements within a <varlistentry>, which
  * nodes are treated like ".Ar foo", but non-text nodes need to be   * we should comma-separate as list headers.
  * re-sent into the printer (i.e., without the preceding ".Ar").  
  * This also handles the case of "repetition" (or in other words, the  
  * ellipsis following an argument) and optionality.  
  */   */
 static void  static void
 pnode_printarg(struct parse *p, struct pnode *pn)  pnode_printvarlistentry(struct format *f, struct pnode *n)
 {  {
         struct pnode    *pp;          struct pnode    *nc, *nn;
         struct pattr    *ap;          int              first = 1;
         int              isop, isrep;  
   
         isop = 1;          macro_open(f, "It");
         isrep = 0;          f->flags |= FMT_IMPL;
         TAILQ_FOREACH(ap, &pn->attrq, child)          TAILQ_FOREACH_SAFE(nc, &n->childq, child, nn) {
                 if (ATTRKEY_CHOICE == ap->key &&                  if (nc->node != NODE_TERM && nc->node != NODE_GLOSSTERM)
                         (ATTRVAL_PLAIN == ap->val ||                          continue;
                          ATTRVAL_REQ == ap->val))                  if (first == 0) {
                         isop = 0;                          switch (f->linestate) {
                 else if (ATTRKEY_REP == ap->key &&                          case LINE_NEW:
                         (ATTRVAL_REPEAT == ap->val))                                  break;
                         isrep = 1;                          case LINE_TEXT:
                                   print_text(f, ",", 0);
         if (isop) {                                  break;
                 pnode_printmopen(p);                          case LINE_MACRO:
                 fputs("Op", stdout);                                  macro_addarg(f, ",", 0);
         }                                  break;
                           }
         TAILQ_FOREACH(pp, &pn->childq, child) {  
                 if (NODE_TEXT == pp->node) {  
                         pnode_printmopen(p);  
                         fputs("Ar", stdout);  
                 }                  }
                 pnode_print(p, pp);                  pnode_print(f, nc);
                 if (NODE_TEXT == pp->node && isrep)                  pnode_unlink(nc);
                         fputs("...", stdout);                  first = 0;
         }          }
           macro_close(f);
           while ((nc = TAILQ_FIRST(&n->childq)) != NULL) {
                   pnode_print(f, nc);
                   pnode_unlink(nc);
           }
           macro_close(f);
 }  }
   
 static void  static void
 pnode_printgroup(struct parse *p, struct pnode *pn)  pnode_printtitle(struct format *f, struct pnode *n)
 {  {
         struct pnode    *pp, *np;          struct pnode    *nc, *nn;
         struct pattr    *ap;  
         int              isop, sv;  
   
         isop = 1;          TAILQ_FOREACH_SAFE(nc, &n->childq, child, nn) {
         TAILQ_FOREACH(ap, &pn->attrq, child)                  if (nc->node == NODE_TITLE) {
                 if (ATTRKEY_CHOICE == ap->key &&                          pnode_printpara(f, nc);
                         (ATTRVAL_PLAIN == ap->val ||                          pnode_print(f, nc);
                          ATTRVAL_REQ == ap->val)) {                          pnode_unlink(nc);
                         isop = 0;  
                         break;  
                 }                  }
   
         /*  
          * Make sure we're on a macro line.  
          * This will prevent pnode_print() for putting us on a  
          * subsequent line.  
          */  
         sv = p->newln;  
         pnode_printmopen(p);  
         if (isop)  
                 fputs("Op", stdout);  
         else if (sv)  
                 fputs("No", stdout);  
   
         /*  
          * Keep on printing text separated by the vertical bar as long  
          * as we're within the same origin node as the group.  
          * This is kind of a nightmare.  
          * Eh, DocBook...  
          * FIXME: if there's a "Fl", we don't cut off the leading "-"  
          * like we do in pnode_print().  
          */  
         TAILQ_FOREACH(pp, &pn->childq, child) {  
                 pnode_print(p, pp);  
                 np = TAILQ_NEXT(pp, child);  
                 while (NULL != np) {  
                         if (pp->node != np->node)  
                                 break;  
                         fputs(" |", stdout);  
                         pnode_printmacrolinepart(p, np);  
                         pp = np;  
                         np = TAILQ_NEXT(np, child);  
                 }  
         }          }
   
         pnode_printmclose(p, sv);  
 }  }
   
 static void  static void
 pnode_printprologue(struct parse *p, struct pnode *pn)  pnode_printrow(struct format *f, struct pnode *n)
 {  {
         struct pnode    *pp;          struct pnode    *nc;
   
         pp = NULL == p->root ? NULL :          macro_line(f, "Bl -dash -compact");
                 pnode_findfirst(p->root, NODE_REFMETA);          TAILQ_FOREACH(nc, &n->childq, child) {
                   macro_line(f, "It");
         if (NULL != pp) {                  pnode_print(f, nc);
                 pnode_printrefmeta(p, pp);  
                 pnode_unlink(pp);  
         } else {  
                 puts(".\\\" Supplying bogus prologue...");  
                 puts(".Dd $Mdocdate" "$");  
                 puts(".Dt UNKNOWN 1");  
                 puts(".Os");  
         }          }
           macro_line(f, "El");
         if (PARSE_EQN & p->flags) {          pnode_unlink(n);
                 puts(".EQ");  
                 puts("delim $$");  
                 puts(".EN");  
         }  
 }  }
   
 /*  
  * We can have multiple <term> elements within a <varlistentry>, which  
  * we should comma-separate as list headers.  
  */  
 static void  static void
 pnode_printvarlistentry(struct parse *p, struct pnode *pn)  pnode_printtgroup1(struct format *f, struct pnode *n)
 {  {
         struct pnode    *pp;          struct pnode    *nc;
         int              first = 1;  
   
         assert(p->newln);          macro_line(f, "Bl -bullet -compact");
         fputs(".It", stdout);          while ((nc = pnode_findfirst(n, NODE_ENTRY)) != NULL) {
         p->newln = 0;                  macro_line(f, "It");
                   pnode_print(f, nc);
         TAILQ_FOREACH(pp, &pn->childq, child)                  pnode_unlink(nc);
                 if (NODE_TERM == pp->node) {          }
                         if ( ! first)          macro_line(f, "El");
                                 putchar(',');          pnode_unlinksub(n);
                         pnode_print(p, pp);  
                         pnode_unlink(pp);  
                         first = 0;  
                 } else  
                         break;  
   
         putchar('\n');  
         p->newln = 1;  
 }  }
   
 static void  static void
 pnode_printrow(struct parse *p, struct pnode *pn)  pnode_printtgroup2(struct format *f, struct pnode *n)
 {  {
         struct pnode    *pp;          struct pnode    *nr, *ne;
   
         puts(".Bl -dash -compact");          macro_line(f, "Bl -tag -width Ds");
           while ((nr = pnode_findfirst(n, NODE_ROW)) != NULL) {
         TAILQ_FOREACH(pp, &pn->childq, child) {                  if ((ne = pnode_findfirst(n, NODE_ENTRY)) == NULL)
                 assert(p->newln);                          break;
                 puts(".It");                  macro_open(f, "It");
                 pnode_print(p, pp);                  f->flags |= FMT_IMPL;
                 pnode_printmclose(p, 1);                  pnode_print(f, ne);
                   macro_close(f);
                   pnode_unlink(ne);
                   pnode_print(f, nr);
                   pnode_unlink(nr);
         }          }
         assert(p->newln);          macro_line(f, "El");
         puts(".El");          pnode_unlinksub(n);
 }  }
   
 static void  static void
 pnode_printtable(struct parse *p, struct pnode *pn)  pnode_printtgroup(struct format *f, struct pnode *n)
 {  {
         struct pnode    *pp;          struct pnode    *nc;
   
         assert(p->newln);          switch (atoi(pnode_getattr_raw(n, ATTRKEY_COLS, "0"))) {
         TAILQ_FOREACH(pp, &pn->childq, child)          case 1:
                 if (NODE_TITLE == pp->node) {                  pnode_printtgroup1(f, n);
                         puts(".Pp");                  return;
                         pnode_print(p, pp);          case 2:
                         pnode_unlink(pp);                  pnode_printtgroup2(f, n);
                 }                  return;
         assert(p->newln);          default:
         puts(".Bl -ohang");                  break;
         while (NULL != (pp = pnode_findfirst(pn, NODE_ROW))) {  
                 puts(".It Table Row");  
                 pnode_printrow(p, pp);  
                 pnode_printmclose(p, 1);  
                 pnode_unlink(pp);  
         }          }
         assert(p->newln);  
         puts(".El");          macro_line(f, "Bl -ohang");
           while ((nc = pnode_findfirst(n, NODE_ROW)) != NULL) {
                   macro_line(f, "It Table Row");
                   pnode_printrow(f, nc);
           }
           macro_line(f, "El");
           pnode_unlinksub(n);
 }  }
   
 static void  static void
 pnode_printlist(struct parse *p, struct pnode *pn)  pnode_printlist(struct format *f, struct pnode *n)
 {  {
         struct pnode    *pp;          struct pnode    *nc;
   
         assert(p->newln);          pnode_printtitle(f, n);
         TAILQ_FOREACH(pp, &pn->childq, child)          macro_argline(f, "Bl",
                 if (NODE_TITLE == pp->node) {              n->node == NODE_ORDEREDLIST ? "-enum" : "-bullet");
                         puts(".Pp");          TAILQ_FOREACH(nc, &n->childq, child) {
                         pnode_print(p, pp);                  macro_line(f, "It");
                         pnode_unlink(pp);                  pnode_print(f, nc);
                 }  
         assert(p->newln);  
   
         if (NODE_ORDEREDLIST == pn->node)  
                 puts(".Bl -enum");  
         else  
                 puts(".Bl -item");  
   
         TAILQ_FOREACH(pp, &pn->childq, child) {  
                 assert(p->newln);  
                 puts(".It");  
                 pnode_print(p, pp);  
                 pnode_printmclose(p, 1);  
         }          }
         assert(p->newln);          macro_line(f, "El");
         puts(".El");          pnode_unlinksub(n);
 }  }
   
 static void  static void
 pnode_printvariablelist(struct parse *p, struct pnode *pn)  pnode_printvariablelist(struct format *f, struct pnode *n)
 {  {
         struct pnode    *pp;          struct pnode    *nc;
   
         assert(p->newln);          pnode_printtitle(f, n);
         TAILQ_FOREACH(pp, &pn->childq, child)          macro_line(f, "Bl -tag -width Ds");
                 if (NODE_TITLE == pp->node) {          TAILQ_FOREACH(nc, &n->childq, child) {
                         puts(".Pp");                  if (nc->node == NODE_VARLISTENTRY)
                         pnode_print(p, pp);                          pnode_printvarlistentry(f, nc);
                         pnode_unlink(pp);                  else
                 }                          macro_nodeline(f, "It", nc, 0);
           }
         assert(p->newln);          macro_line(f, "El");
         puts(".Bl -tag -width Ds");          pnode_unlinksub(n);
         TAILQ_FOREACH(pp, &pn->childq, child)  
                 if (NODE_VARLISTENTRY != pp->node) {  
                         assert(p->newln);  
                         fputs(".It", stdout);  
                         pnode_printmacroline(p, pp);  
                 } else {  
                         assert(p->newln);  
                         pnode_print(p, pp);  
                 }  
         assert(p->newln);  
         puts(".El");  
 }  }
   
 /*  /*
Line 1211  pnode_printvariablelist(struct parse *p, struct pnode 
Line 1025  pnode_printvariablelist(struct parse *p, struct pnode 
  * whatever), don't print inline macros.   * whatever), don't print inline macros.
  */   */
 static void  static void
 pnode_print(struct parse *p, struct pnode *pn)  pnode_print(struct format *f, struct pnode *n)
 {  {
         struct pnode    *pp;          struct pnode    *nc, *nn;
         char            *cp;          int              was_impl;
         int              last, sv;  
   
         if (NULL == pn)          if (n == NULL)
                 return;                  return;
   
         sv = p->newln;          was_impl = f->flags & FMT_IMPL;
           if (n->spc)
                   f->flags &= ~FMT_NOSPC;
           else
                   f->flags |= FMT_NOSPC;
   
         switch (pn->node) {          switch (n->node) {
         case (NODE_APPLICATION):          case NODE_ARG:
                 pnode_printmopen(p);                  pnode_printarg(f, n);
                 fputs("Nm", stdout);  
                 break;                  break;
         case (NODE_ANCHOR):          case NODE_AUTHOR:
                 /* Don't print anything! */                  pnode_printauthor(f, n);
                 return;  
         case (NODE_ARG):  
                 pnode_printarg(p, pn);  
                 pnode_unlinksub(pn);  
                 break;                  break;
         case (NODE_CITEREFENTRY):          case NODE_AUTHORGROUP:
                 pnode_printmopen(p);                  macro_line(f, "An -split");
                 fputs("Xr", stdout);  
                 pnode_printciterefentry(p, pn);  
                 pnode_unlinksub(pn);  
                 break;                  break;
         case (NODE_CODE):          case NODE_BLOCKQUOTE:
                 pnode_printmopen(p);                  macro_line(f, "Bd -ragged -offset indent");
                 fputs("Li", stdout);  
                 break;                  break;
         case (NODE_COMMAND):          case NODE_CITEREFENTRY:
                 pnode_printmopen(p);                  pnode_printciterefentry(f, n);
                 fputs("Nm", stdout);  
                 break;                  break;
         case (NODE_CONSTANT):          case NODE_CITETITLE:
                 pnode_printmopen(p);                  macro_open(f, "%T");
                 fputs("Dv", stdout);  
                 break;                  break;
         case (NODE_EMPHASIS):          case NODE_COMMAND:
                 pnode_printmopen(p);                  macro_open(f, "Nm");
                 fputs("Em", stdout);  
                 break;                  break;
         case (NODE_ENVAR):          case NODE_CONSTANT:
                 pnode_printmopen(p);                  macro_open(f, "Dv");
                 fputs("Ev", stdout);  
                 break;                  break;
         case (NODE_FILENAME):          case NODE_COPYRIGHT:
                 pnode_printmopen(p);                  print_text(f, "Copyright", ARG_SPACE);
                 fputs("Pa", stdout);                  fputs(" \\(co", stdout);
                 break;                  break;
         case (NODE_FUNCTION):          case NODE_EDITOR:
                 pnode_printmopen(p);                  print_text(f, "editor:", ARG_SPACE);
                 fputs("Fn", stdout);                  pnode_printauthor(f, n);
                 break;                  break;
         case (NODE_FUNCPROTOTYPE):          case NODE_EMAIL:
                 assert(p->newln);                  if (was_impl)
                 pnode_printfuncprototype(p, pn);                          macro_open(f, "Ao Mt");
                 pnode_unlinksub(pn);                  else {
                           macro_open(f, "Aq Mt");
                           f->flags |= FMT_IMPL;
                   }
                 break;                  break;
         case (NODE_FUNCSYNOPSISINFO):          case NODE_EMPHASIS:
                 pnode_printmopen(p);          case NODE_FIRSTTERM:
                 fputs("Fd", stdout);          case NODE_GLOSSTERM:
                   if ((nc = TAILQ_FIRST(&n->childq)) != NULL &&
                       pnode_class(nc->node) < CLASS_LINE)
                           macro_open(f, "Em");
                 break;                  break;
         case (NODE_INFORMALEQUATION):          case NODE_ENVAR:
                 if ( ! p->newln)                  macro_open(f, "Ev");
                         putchar('\n');  
                 puts(".EQ");  
                 p->newln = 0;  
                 break;                  break;
         case (NODE_INLINEEQUATION):          case NODE_ERRORNAME:
                 fputc('$', stdout);                  macro_open(f, "Er");
                 p->newln = 0;  
                 break;                  break;
         case (NODE_ITEMIZEDLIST):          case NODE_FILENAME:
                 assert(p->newln);                  macro_open(f, "Pa");
                 pnode_printlist(p, pn);  
                 pnode_unlinksub(pn);  
                 break;                  break;
         case (NODE_GROUP):          case NODE_FUNCTION:
                 pnode_printgroup(p, pn);                  macro_open(f, "Fn");
                 pnode_unlinksub(pn);  
                 break;                  break;
         case (NODE_LITERAL):          case NODE_FUNCPROTOTYPE:
                 pnode_printmopen(p);                  pnode_printfuncprototype(f, n);
                 fputs("Li", stdout);  
                 break;                  break;
         case (NODE_MML_MFENCED):          case NODE_FUNCSYNOPSISINFO:
                 pnode_printmathfenced(p, pn);                  macro_open(f, "Fd");
                 pnode_unlinksub(pn);  
                 break;                  break;
         case (NODE_MML_MROW):          case NODE_INFORMALEQUATION:
         case (NODE_MML_MI):                  macro_line(f, "Bd -ragged -offset indent");
         case (NODE_MML_MN):                  /* FALLTHROUGH */
         case (NODE_MML_MO):          case NODE_INLINEEQUATION:
                 if (TAILQ_EMPTY(&pn->childq))                  macro_line(f, "EQ");
                         break;  
                 fputs(" { ", stdout);  
                 break;                  break;
         case (NODE_MML_MFRAC):          case NODE_ITEMIZEDLIST:
         case (NODE_MML_MSUB):                  pnode_printlist(f, n);
         case (NODE_MML_MSUP):  
                 pnode_printmath(p, pn);  
                 pnode_unlinksub(pn);  
                 break;                  break;
         case (NODE_OPTION):          case NODE_GROUP:
                 pnode_printmopen(p);                  pnode_printgroup(f, n);
                 fputs("Fl", stdout);  
                 break;                  break;
         case (NODE_ORDEREDLIST):          case NODE_KEYSYM:
                 assert(p->newln);                  macro_open(f, "Sy");
                 pnode_printlist(p, pn);  
                 pnode_unlinksub(pn);  
                 break;                  break;
         case (NODE_PARA):          case NODE_LINK:
                 assert(p->newln);                  pnode_printlink(f, n);
                 if (NULL != pn->parent &&                  break;
                         NODE_LISTITEM == pn->parent->node)          case NODE_LITERAL:
                   if (n->parent != NULL && n->parent->node == NODE_QUOTE)
                           macro_open(f, "Li");
                   else if (was_impl)
                           macro_open(f, "So Li");
                   else {
                           macro_open(f, "Ql");
                           f->flags |= FMT_IMPL;
                   }
                   break;
           case NODE_LITERALLAYOUT:
                   macro_close(f);
                   macro_argline(f, "Bd", pnode_getattr(n, ATTRKEY_CLASS) ==
                       ATTRVAL_MONOSPACED ? "-literal" : "-unfilled");
                   break;
           case NODE_MARKUP:
                   macro_open(f, "Ic");
                   break;
           case NODE_MML_MFENCED:
                   pnode_printmathfenced(f, n);
                   break;
           case NODE_MML_MROW:
           case NODE_MML_MI:
           case NODE_MML_MN:
           case NODE_MML_MO:
                   if (TAILQ_EMPTY(&n->childq))
                         break;                          break;
                 puts(".Pp");                  fputs(" { ", stdout);
                 break;                  break;
         case (NODE_PARAMETER):          case NODE_MML_MFRAC:
                 /* Suppress non-text children... */          case NODE_MML_MSUB:
                 pnode_printmopen(p);          case NODE_MML_MSUP:
                 fputs("Fa \"", stdout);                  pnode_printmath(f, n);
                 pnode_printmacrolinetext(p, pn, MACROLINE_NOWS);  
                 fputs("\"", stdout);  
                 pnode_unlinksub(pn);  
                 break;                  break;
         case (NODE_QUOTE):          case NODE_OPTION:
                 pnode_printmopen(p);                  if ((nc = TAILQ_FIRST(&n->childq)) != NULL &&
                 fputs("Qo", stdout);                      pnode_class(nc->node) < CLASS_LINE)
                           macro_open(f, "Fl");
                 break;                  break;
         case (NODE_PROGRAMLISTING):          case NODE_ORDEREDLIST:
                 /* FALLTHROUGH */                  pnode_printlist(f, n);
         case (NODE_SCREEN):  
                 assert(p->newln);  
                 puts(".Bd -literal");  
                 break;                  break;
         case (NODE_REFENTRYINFO):          case NODE_PARA:
                 /* Suppress. */                  pnode_printpara(f, n);
                 pnode_unlinksub(pn);  
                 break;                  break;
         case (NODE_REFMETA):          case NODE_PARAMDEF:
                 abort();          case NODE_PARAMETER:
                   /* More often, these appear inside NODE_FUNCPROTOTYPE. */
                   macro_open(f, "Fa");
                   macro_addnode(f, n, ARG_SPACE | ARG_SINGLE);
                   pnode_unlinksub(n);
                 break;                  break;
         case (NODE_REFNAME):          case NODE_QUOTE:
                 /* Suppress non-text children... */                  if (was_impl)
                 pnode_printmopen(p);                          macro_open(f, "Do");
                 fputs("Nm", stdout);                  else {
                 p->newln = 0;                          macro_open(f, "Dq");
                 pnode_printmacrolinepart(p, pn);                          f->flags |= FMT_IMPL;
                 pnode_unlinksub(pn);                  }
                 break;                  break;
         case (NODE_REFNAMEDIV):          case NODE_PROGRAMLISTING:
                 assert(p->newln);          case NODE_SCREEN:
                 puts(".Sh NAME");          case NODE_SYNOPSIS:
                   macro_line(f, "Bd -literal");
                 break;                  break;
         case (NODE_REFPURPOSE):          case NODE_SYSTEMITEM:
                 assert(p->newln);                  pnode_printsystemitem(f, n);
                 pnode_printmopen(p);  
                 fputs("Nd", stdout);  
                 break;                  break;
         case (NODE_REFSYNOPSISDIV):          case NODE_REFENTRY:
                 assert(p->newln);                  pnode_printrefentry(f, n);
                 pnode_printrefsynopsisdiv(p, pn);  
                 puts(".Sh SYNOPSIS");  
                 break;                  break;
         case (NODE_REFSECT1):          case NODE_REFNAME:
                 /* FALLTHROUGH */                  /* More often, these appear inside NODE_REFNAMEDIV. */
         case (NODE_REFSECT2):                  macro_open(f, "Nm");
                 /* FALLTHROUGH */  
         case (NODE_REFSECT3):  
                 /* FALLTHROUGH */  
         case (NODE_REFSECTION):  
                 /* FALLTHROUGH */  
         case (NODE_NOTE):  
                 /* FALLTHROUGH */  
         case (NODE_TIP):  
                 /* FALLTHROUGH */  
         case (NODE_CAUTION):  
                 /* FALLTHROUGH */  
         case (NODE_WARNING):  
                 assert(p->newln);  
                 pnode_printrefsect(p, pn);  
                 break;                  break;
         case (NODE_REPLACEABLE):          case NODE_REFNAMEDIV:
                 pnode_printmopen(p);                  pnode_printrefnamediv(f, n);
                 fputs("Ar", stdout);  
                 break;                  break;
         case (NODE_SBR):          case NODE_REFPURPOSE:
                 assert(p->newln);                  macro_open(f, "Nd");
                 puts(".br");  
                 break;                  break;
         case (NODE_SGMLTAG):          case NODE_REFSYNOPSISDIV:
                 pnode_printmopen(p);                  pnode_printrefsynopsisdiv(f, n);
                 fputs("Li", stdout);  
                 break;                  break;
         case (NODE_STRUCTNAME):          case NODE_PREFACE:
                 pnode_printmopen(p);          case NODE_SECTION:
                 fputs("Vt", stdout);          case NODE_SIMPLESECT:
           case NODE_APPENDIX:
           case NODE_LEGALNOTICE:
           case NODE_NOTE:
           case NODE_TIP:
           case NODE_CAUTION:
           case NODE_WARNING:
                   pnode_printsection(f, n);
                 break;                  break;
         case (NODE_TABLE):          case NODE_REPLACEABLE:
                 /* FALLTHROUGH */                  macro_open(f, "Ar");
         case (NODE_INFORMALTABLE):  
                 assert(p->newln);  
                 pnode_printtable(p, pn);  
                 pnode_unlinksub(pn);  
                 break;                  break;
         case (NODE_TEXT):          case NODE_SBR:
                 if (0 == p->newln)                  macro_line(f, "br");
                         putchar(' ');  
   
                 bufclear(p);  
                 bufappend(p, pn);  
   
                 if (0 == p->bsz) {  
                         assert(pn->real != pn->b);  
                         break;  
                 }  
   
                 /*  
                  * Output all characters, squeezing out whitespace  
                  * between newlines.  
                  * XXX: all whitespace, including tabs (?).  
                  * Remember to escape control characters and escapes.  
                  */  
                 assert(p->bsz);  
                 cp = p->b;  
   
                 /*  
                  * There's often a superfluous "-" in its <option> tags  
                  * before the actual flags themselves.  
                  * "Fl" does this for us, so remove it.  
                  */  
                 if (NULL != pn->parent &&  
                         NODE_OPTION == pn->parent->node &&  
                         '-' == *cp)  
                         cp++;  
                 for (last = '\n'; '\0' != *cp; ) {  
                         if ('\n' == last) {  
                                 /* Consume all whitespace. */  
                                 if (isspace((int)*cp)) {  
                                         while (isspace((int)*cp))  
                                                 cp++;  
                                         continue;  
                                 } else if ('\'' == *cp || '.' == *cp)  
                                         fputs("\\&", stdout);  
                         }  
                         putchar(last = *cp++);  
                         /* If we're a character escape, escape us. */  
                         if ('\\' == last)  
                                 putchar('e');  
                 }  
                 p->newln = 0;  
                 break;                  break;
         case (NODE_TYPE):          case NODE_SUBSCRIPT:
                 pnode_printmopen(p);                  if (f->linestate == LINE_MACRO)
                 fputs("Vt", stdout);                          macro_addarg(f, "_", 0);
                   else
                           print_text(f, "_", 0);
                   if ((nc = TAILQ_FIRST(&n->childq)) != NULL)
                           nc->spc = 0;
                 break;                  break;
         case (NODE_USERINPUT):          case NODE_SUPERSCRIPT:
                 pnode_printmopen(p);                  fputs("\\(ha", stdout);
                 fputs("Li", stdout);                  if ((nc = TAILQ_FIRST(&n->childq)) != NULL)
                           nc->spc = 0;
                 break;                  break;
         case (NODE_VARIABLELIST):          case NODE_TEXT:
                 assert(p->newln);          case NODE_ESCAPE:
                 pnode_printvariablelist(p, pn);                  pnode_printtext(f, n);
                 pnode_unlinksub(pn);  
                 break;                  break;
         case (NODE_VARLISTENTRY):          case NODE_TGROUP:
                 assert(p->newln);                  pnode_printtgroup(f, n);
                 pnode_printvarlistentry(p, pn);  
                 break;                  break;
         case (NODE_VARNAME):          case NODE_TITLE:
                 pnode_printmopen(p);          case NODE_SUBTITLE:
                 fputs("Va", stdout);                  pnode_printpara(f, n);
                   macro_nodeline(f, "Sy", n, 0);
                   pnode_unlinksub(n);
                 break;                  break;
           case NODE_TYPE:
                   macro_open(f, "Vt");
                   break;
           case NODE_VARIABLELIST:
                   pnode_printvariablelist(f, n);
                   break;
           case NODE_VARNAME:
                   macro_open(f, "Va");
                   break;
         default:          default:
                 break;                  break;
         }          }
   
         TAILQ_FOREACH(pp, &pn->childq, child)          TAILQ_FOREACH(nc, &n->childq, child)
                 pnode_print(p, pp);                  pnode_print(f, nc);
   
         switch (pn->node) {          switch (n->node) {
         case (NODE_INFORMALEQUATION):          case NODE_EMAIL:
                 if ( ! p->newln)                  if (was_impl) {
                         putchar('\n');                          f->flags &= ~FMT_NOSPC;
                 puts(".EN");                          macro_open(f, "Ac");
                 p->newln = 1;                  } else
                           f->flags &= ~FMT_IMPL;
                 break;                  break;
         case (NODE_INLINEEQUATION):          case NODE_ESCAPE:
                 fputs("$ ", stdout);          case NODE_TERM:
                 p->newln = sv;          case NODE_TEXT:
                   /* Accept more arguments to the previous macro. */
                   return;
           case NODE_INFORMALEQUATION:
                   macro_line(f, "EN");
                   macro_line(f, "Ed");
                 break;                  break;
         case (NODE_MML_MROW):          case NODE_INLINEEQUATION:
         case (NODE_MML_MI):                  macro_line(f, "EN");
         case (NODE_MML_MN):                  break;
         case (NODE_MML_MO):          case NODE_LITERAL:
                 if (TAILQ_EMPTY(&pn->childq))                  if (n->parent != NULL && n->parent->node == NODE_QUOTE)
                           /* nothing */;
                   else if (was_impl) {
                           f->flags &= ~FMT_NOSPC;
                           macro_open(f, "Sc");
                   } else
                           f->flags &= ~FMT_IMPL;
                   break;
           case NODE_MEMBER:
                   if ((nn = TAILQ_NEXT(n, child)) != NULL &&
                       nn->node != NODE_MEMBER)
                           nn = NULL;
                   switch (f->linestate) {
                   case LINE_TEXT:
                           if (nn != NULL)
                                   print_text(f, ",", 0);
                         break;                          break;
                   case LINE_MACRO:
                           if (nn != NULL)
                                   macro_addarg(f, ",", ARG_SPACE);
                           macro_close(f);
                           break;
                   case LINE_NEW:
                           break;
                   }
                   break;
           case NODE_MML_MROW:
           case NODE_MML_MI:
           case NODE_MML_MN:
           case NODE_MML_MO:
                   if (TAILQ_EMPTY(&n->childq))
                           break;
                 fputs(" } ", stdout);                  fputs(" } ", stdout);
                 break;                  break;
         case (NODE_APPLICATION):          case NODE_QUOTE:
         case (NODE_ARG):                  if (was_impl) {
         case (NODE_CITEREFENTRY):                          f->flags &= ~FMT_NOSPC;
         case (NODE_CODE):                          macro_open(f, "Dc");
         case (NODE_COMMAND):                  } else
         case (NODE_CONSTANT):                          f->flags &= ~FMT_IMPL;
         case (NODE_EMPHASIS):  
         case (NODE_ENVAR):  
         case (NODE_FILENAME):  
         case (NODE_FUNCTION):  
         case (NODE_FUNCSYNOPSISINFO):  
         case (NODE_LITERAL):  
         case (NODE_OPTION):  
         case (NODE_PARAMETER):  
         case (NODE_REPLACEABLE):  
         case (NODE_REFPURPOSE):  
         case (NODE_SGMLTAG):  
         case (NODE_STRUCTNAME):  
         case (NODE_TEXT):  
         case (NODE_TYPE):  
         case (NODE_USERINPUT):  
         case (NODE_VARNAME):  
                 pnode_printmclosepunct(p, pn, sv);  
                 break;                  break;
         case (NODE_QUOTE):          case NODE_PREFACE:
                 pnode_printmclose(p, sv);          case NODE_SECTION:
                 sv = p->newln;          case NODE_APPENDIX:
                 pnode_printmopen(p);          case NODE_LEGALNOTICE:
                 fputs("Qc", stdout);          case NODE_NOTE:
                 pnode_printmclose(p, sv);          case NODE_TIP:
           case NODE_CAUTION:
           case NODE_WARNING:
                   f->level--;
                 break;                  break;
         case (NODE_REFNAME):          case NODE_BLOCKQUOTE:
                 /*          case NODE_LITERALLAYOUT:
                  * If we're in the NAME macro and we have multiple          case NODE_PROGRAMLISTING:
                  * <refname> macros in sequence, then print out a          case NODE_SCREEN:
                  * trailing comma before the newline.          case NODE_SYNOPSIS:
                  */                  macro_line(f, "Ed");
                 if (NULL != pn->parent &&  
                         NODE_REFNAMEDIV == pn->parent->node &&  
                         NULL != TAILQ_NEXT(pn, child) &&  
                         NODE_REFNAME == TAILQ_NEXT(pn, child)->node)  
                         fputs(" ,", stdout);  
                 pnode_printmclose(p, sv);  
                 break;                  break;
         case (NODE_PROGRAMLISTING):  
                 /* FALLTHROUGH */  
         case (NODE_SCREEN):  
                 assert(p->newln);  
                 puts(".Ed");  
                 p->newln = 1;  
                 break;  
         default:          default:
                 break;                  break;
         }          }
           f->flags &= ~FMT_ARG;
 }  }
   
 /*  void
  * Loop around the read buffer until we've drained it of all data.  ptree_print_mdoc(struct ptree *tree)
  * Invoke the parser context with each buffer fill.  
  */  
 static int  
 readfile(XML_Parser xp, int fd,  
         char *b, size_t bsz, const char *fn)  
 {  {
         struct parse     p;          struct format    formatter;
         int              rc;  
         ssize_t          ssz;  
   
         memset(&p, 0, sizeof(struct parse));          formatter.level = 0;
           formatter.linestate = LINE_NEW;
         p.b = malloc(p.bsz = p.mbsz = 1024);          pnode_printprologue(&formatter, tree->root);
         p.fname = fn;          pnode_print(&formatter, tree->root);
         p.xml = xp;          if (formatter.linestate != LINE_NEW)
                   putchar('\n');
         XML_SetCharacterDataHandler(xp, xml_char);  
         XML_SetElementHandler(xp, xml_elem_start, xml_elem_end);  
         XML_SetUserData(xp, &p);  
   
         while ((ssz = read(fd, b, bsz)) >= 0) {  
                 if (0 == (rc = XML_Parse(xp, b, ssz, 0 == ssz)))  
                         fprintf(stderr, "%s:%zu:%zu: %s\n", fn,  
                                 XML_GetCurrentLineNumber(xp),  
                                 XML_GetCurrentColumnNumber(xp),  
                                 XML_ErrorString  
                                 (XML_GetErrorCode(xp)));  
                 else if ( ! p.stop && ssz > 0)  
                         continue;  
                 /*  
                  * Exit when we've read all or errors have occured  
                  * during the parse sequence.  
                  */  
                 p.newln = 1;  
                 pnode_printprologue(&p, p.root);  
                 pnode_print(&p, p.root);  
                 pnode_free(p.root);  
                 free(p.b);  
                 return(0 != rc && ! p.stop);  
         }  
   
         /* Read error has occured. */  
         perror(fn);  
         pnode_free(p.root);  
         free(p.b);  
         return(0);  
 }  
   
 int  
 main(int argc, char *argv[])  
 {  
         XML_Parser       xp;  
         const char      *fname;  
         char            *buf;  
         int              fd, rc, ch;  
         const char      *progname;  
   
         progname = strrchr(argv[0], '/');  
         if (progname == NULL)  
                 progname = argv[0];  
         else  
                 ++progname;  
   
         fname = "-";  
         xp = NULL;  
         buf = NULL;  
         rc = 0;  
   
         while (-1 != (ch = getopt(argc, argv, "W")))  
                 switch (ch) {  
                 case ('W'):  
                         warn = 1;  
                         break;  
                 default:  
                         goto usage;  
                 }  
   
         argc -= optind;  
         argv += optind;  
   
         if (argc > 1) {  
                 fprintf(stderr, "%s: Too many arguments\n", argv[1]);  
                 goto usage;  
         } else if (argc > 0)  
                 fname = argv[0];  
   
         /* Read from stdin or a file. */  
         fd = 0 == strcmp(fname, "-") ?  
                 STDIN_FILENO : open(fname, O_RDONLY, 0);  
   
         /*  
          * Open file for reading.  
          * Allocate a read buffer.  
          * Create the parser context.  
          * Dive directly into the parse.  
          */  
         if (-1 == fd)  
                 perror(fname);  
         else if (NULL == (buf = malloc(4096)))  
                 perror(NULL);  
         else if (NULL == (xp = XML_ParserCreate(NULL)))  
                 perror(NULL);  
         else if ( ! readfile(xp, fd, buf, 4096, fname))  
                 rc = 1;  
   
         XML_ParserFree(xp);  
         free(buf);  
         if (STDIN_FILENO != fd)  
                 close(fd);  
         return(rc ? EXIT_SUCCESS : EXIT_FAILURE);  
   
 usage:  
         fprintf(stderr, "usage: %s [-W] [input_filename]\n", progname);  
         return(EXIT_FAILURE);  
 }  }
Legend:
Removed from v.1.45  
changed lines
  Added in v.1.124
CVSweb