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

Diff for /docbook2mdoc/docbook2mdoc.c between version 1.72 and 1.142

version 1.72, 2019/03/25 17:28:32 version 1.142, 2019/04/28 19:05:11
Line 15 
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 "xmalloc.h"
   #include "node.h"
   #include "macro.h"
   #include "format.h"
   
 enum    linestate {  
         LINE_NEW = 0,  
         LINE_TEXT,  
         LINE_MACRO  
 };  
   
 /*  /*
  * 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 */  
         int              level; /* header level, starting at 1 */  
         enum linestate   linestate;  
 };  
   
 struct  node {  static void      pnode_print(struct format *, struct pnode *);
         const char      *name; /* docbook element name */  static void      pnode_printrefentry(struct format *, struct pnode *);
         enum nodeid      node; /* docbook element to generate */  
 };  
   
 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",  
         "class",  
         "close",  
         "id",  
         "linkend",  
         "open",  
         "rep"  
 };  
   
 static  const char *attrvals[ATTRVAL__MAX] = {  
         "monospaced",  
         "norepeat",  
         "opt",  
         "plain",  
         "repeat",  
         "req"  
 };  
   
 static  const struct node nodes[] = {  
         { "acronym",            NODE_ACRONYM },  
         { "affiliation",        NODE_AFFILIATION },  
         { "anchor",             NODE_ANCHOR },  
         { "application",        NODE_APPLICATION },  
         { "arg",                NODE_ARG },  
         { "author",             NODE_AUTHOR },  
         { "authorgroup",        NODE_AUTHORGROUP },  
         { "blockquote",         NODE_BLOCKQUOTE },  
         { "book",               NODE_BOOK },  
         { "bookinfo",           NODE_BOOKINFO },  
         { "caution",            NODE_CAUTION },  
         { "chapter",            NODE_SECTION },  
         { "citerefentry",       NODE_CITEREFENTRY },  
         { "citetitle",          NODE_CITETITLE },  
         { "cmdsynopsis",        NODE_CMDSYNOPSIS },  
         { "code",               NODE_CODE },  
         { "colspec",            NODE_COLSPEC },  
         { "command",            NODE_COMMAND },  
         { "constant",           NODE_CONSTANT },  
         { "copyright",          NODE_COPYRIGHT },  
         { "date",               NODE_DATE },  
         { "editor",             NODE_EDITOR },  
         { "email",              NODE_EMAIL },  
         { "emphasis",           NODE_EMPHASIS },  
         { "entry",              NODE_ENTRY },  
         { "envar",              NODE_ENVAR },  
         { "fieldsynopsis",      NODE_FIELDSYNOPSIS },  
         { "filename",           NODE_FILENAME },  
         { "firstname",          NODE_FIRSTNAME },  
         { "firstterm",          NODE_FIRSTTERM },  
         { "footnote",           NODE_FOOTNOTE },  
         { "funcdef",            NODE_FUNCDEF },  
         { "funcprototype",      NODE_FUNCPROTOTYPE },  
         { "funcsynopsis",       NODE_FUNCSYNOPSIS },  
         { "funcsynopsisinfo",   NODE_FUNCSYNOPSISINFO },  
         { "function",           NODE_FUNCTION },  
         { "glossterm",          NODE_GLOSSTERM },  
         { "group",              NODE_GROUP },  
         { "holder",             NODE_HOLDER },  
         { "index",              NODE_INDEX },  
         { "indexterm",          NODE_INDEXTERM },  
         { "info",               NODE_INFO },  
         { "informalequation",   NODE_INFORMALEQUATION },  
         { "informaltable",      NODE_INFORMALTABLE },  
         { "inlineequation",     NODE_INLINEEQUATION },  
         { "itemizedlist",       NODE_ITEMIZEDLIST },  
         { "keysym",             NODE_KEYSYM },  
         { "legalnotice",        NODE_LEGALNOTICE },  
         { "link",               NODE_LINK },  
         { "listitem",           NODE_LISTITEM },  
         { "literal",            NODE_LITERAL },  
         { "literallayout",      NODE_LITERALLAYOUT },  
         { "manvolnum",          NODE_MANVOLNUM },  
         { "member",             NODE_MEMBER },  
         { "mml:math",           NODE_MML_MATH },  
         { "mml:mfenced",        NODE_MML_MFENCED },  
         { "mml:mfrac",          NODE_MML_MFRAC },  
         { "mml:mi",             NODE_MML_MI },  
         { "mml:mn",             NODE_MML_MN },  
         { "mml:mo",             NODE_MML_MO },  
         { "mml:mrow",           NODE_MML_MROW },  
         { "mml:msub",           NODE_MML_MSUB },  
         { "mml:msup",           NODE_MML_MSUP },  
         { "modifier",           NODE_MODIFIER },  
         { "note",               NODE_NOTE },  
         { "option",             NODE_OPTION },  
         { "orderedlist",        NODE_ORDEREDLIST },  
         { "orgname",            NODE_ORGNAME },  
         { "othername",          NODE_OTHERNAME },  
         { "para",               NODE_PARA },  
         { "paramdef",           NODE_PARAMDEF },  
         { "parameter",          NODE_PARAMETER },  
         { "part",               NODE_SECTION },  
         { "personname",         NODE_PERSONNAME },  
         { "phrase",             NODE_PHRASE },  
         { "preface",            NODE_PREFACE },  
         { "primary",            NODE_PRIMARY },  
         { "programlisting",     NODE_PROGRAMLISTING },  
         { "prompt",             NODE_PROMPT },  
         { "quote",              NODE_QUOTE },  
         { "refclass",           NODE_REFCLASS },  
         { "refdescriptor",      NODE_REFDESCRIPTOR },  
         { "refentry",           NODE_REFENTRY },  
         { "refentryinfo",       NODE_REFENTRYINFO },  
         { "refentrytitle",      NODE_REFENTRYTITLE },  
         { "refmeta",            NODE_REFMETA },  
         { "refmetainfo",        NODE_REFMETAINFO },  
         { "refmiscinfo",        NODE_REFMISCINFO },  
         { "refname",            NODE_REFNAME },  
         { "refnamediv",         NODE_REFNAMEDIV },  
         { "refpurpose",         NODE_REFPURPOSE },  
         { "refsect1",           NODE_SECTION },  
         { "refsect2",           NODE_SECTION },  
         { "refsect3",           NODE_SECTION },  
         { "refsection",         NODE_SECTION },  
         { "refsynopsisdiv",     NODE_REFSYNOPSISDIV },  
         { "releaseinfo",        NODE_RELEASEINFO },  
         { "replaceable",        NODE_REPLACEABLE },  
         { "row",                NODE_ROW },  
         { "sbr",                NODE_SBR },  
         { "screen",             NODE_SCREEN },  
         { "secondary",          NODE_SECONDARY },  
         { "sect1",              NODE_SECTION },  
         { "sect2",              NODE_SECTION },  
         { "section",            NODE_SECTION },  
         { "sgmltag",            NODE_SGMLTAG },  
         { "simplelist",         NODE_SIMPLELIST },  
         { "spanspec",           NODE_SPANSPEC },  
         { "structname",         NODE_STRUCTNAME },  
         { "subtitle",           NODE_SUBTITLE },  
         { "surname",            NODE_SURNAME },  
         { "synopsis",           NODE_SYNOPSIS },  
         { "table",              NODE_TABLE },  
         { "tbody",              NODE_TBODY },  
         { "term",               NODE_TERM },  
         { "tfoot",              NODE_TFOOT },  
         { "tgroup",             NODE_TGROUP },  
         { "thead",              NODE_THEAD },  
         { "tip",                NODE_TIP },  
         { "title",              NODE_TITLE },  
         { "trademark",          NODE_TRADEMARK },  
         { "type",               NODE_TYPE },  
         { "ulink",              NODE_ULINK },  
         { "userinput",          NODE_USERINPUT },  
         { "variablelist",       NODE_VARIABLELIST },  
         { "varlistentry",       NODE_VARLISTENTRY },  
         { "varname",            NODE_VARNAME },  
         { "warning",            NODE_WARNING },  
         { "wordasword",         NODE_WORDASWORD },  
         { "year",               NODE_YEAR },  
         { NULL,                 NODE__MAX }  
 };  
   
 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 || ps->node == NODE_ROOT)          accept_arg = f->flags & FMT_ARG;
                 return;          if (f->linestate == LINE_MACRO && !accept_arg &&
               (n->flags & NFLAG_SPC) == 0) {
         assert(ps->cur != NULL);                  for (;;) {
                           if (*cp == '\0')
         /*                                  return;
          * Are we in the midst of processing text?                          if (strchr("!),.:;?]", *cp) == NULL)
          * If we're not processing text right now, then create a text  
          * node for doing so.  
          * However, don't do so unless we have some non-whitespace to  
          * process: strip out all leading whitespace to be sure.  
          */  
         if (ps->node != NODE_TEXT) {  
                 for (i = 0; i < sz; i++)  
                         if ( ! isspace((unsigned char)p[i]))  
                                 break;                                  break;
                 if (i == sz)                          printf(" %c", *cp++);
                         return;  
                 p += i;  
                 sz -= i;  
                 dat = calloc(1, sizeof(*dat));  
                 if (dat == NULL) {  
                         perror(NULL);  
                         exit(1);  
                 }                  }
                   if (isspace((unsigned char)*cp)) {
                 dat->node = ps->node = NODE_TEXT;                          while (isspace((unsigned char)*cp))
                 dat->parent = ps->cur;                                  cp++;
                 TAILQ_INIT(&dat->childq);                          macro_close(f);
                 TAILQ_INIT(&dat->attrq);                  } else {
                 TAILQ_INSERT_TAIL(&ps->cur->childq, dat, child);                          fputs(" Ns", stdout);
                 ps->cur = dat;                          f->flags &= FMT_IMPL;
                 assert(ps->root != NULL);                          accept_arg = 1;
                   }
         }          }
           if (f->linestate == LINE_MACRO && !accept_arg &&
               (f->flags & (FMT_CHILD | FMT_IMPL)) == 0)
                   macro_close(f);
   
         /* Append to current buffer. */          /*
         assert(sz >= 0);           * Text preceding a macro without intervening whitespace
         ps->cur->b = realloc(ps->cur->b, ps->cur->bsz + sz + 1);           * requires a .Pf macro.
         if (ps->cur->b == NULL) {           * Set the spacing flag to avoid a redundant .Ns macro.
                 perror(NULL);           */
                 exit(1);  
         }  
         memcpy(ps->cur->b + ps->cur->bsz, p, sz);  
         ps->cur->bsz += sz;  
         ps->cur->b[ps->cur->bsz] = '\0';  
         ps->cur->real = ps->cur->b;  
 }  
   
 static void          if (f->linestate != LINE_MACRO &&
 pnode_trim(struct pnode *pn)              (nn = TAILQ_NEXT(n, child)) != NULL &&
 {               (nn->flags & NFLAG_SPC) == 0) {
         assert(pn->node == NODE_TEXT);                  switch (pnode_class(nn->node)) {
         for (; pn->bsz > 0; pn->b[--pn->bsz] = '\0')                  case CLASS_LINE:
                 if ( ! isspace((unsigned char)pn->b[pn->bsz - 1]))                  case CLASS_ENCL:
                           macro_open(f, "Pf");
                           accept_arg = 1;
                           f->flags |= FMT_CHILD;
                           nn->flags |= NFLAG_SPC;
                         break;                          break;
 }                  default:
                           break;
                   }
           }
   
 /*          switch (f->linestate) {
  * Begin an element.          case LINE_NEW:
  * First, look for the element.                  break;
  * If we don't find it and we're not parsing, keep going.          case LINE_TEXT:
  * If we don't find it and we're parsing, puke and exit.                  if (n->flags & NFLAG_SPC) {
  * If we find it but we're not parsing yet (i.e., it's not a refentry                          if (n->flags & NFLAG_LINE &&
  * and thus out of context), keep going.                              pnode_class(n->node) == CLASS_TEXT)
  * If we find it and we're at the root and already have a tree, puke and                                  macro_close(f);
  * exit (FIXME: I don't think this is right?).                          else
  * If we find it but we're parsing a text node, close out the text node,                                  putchar(' ');
  * return to its parent, and keep going.                  }
  * Make sure that the element is in the right context.                  break;
  * Lastly, put the node onto our parse tree and continue.          case LINE_MACRO:
  */                  if (accept_arg == 0)
 static void                          macro_close(f);
 xml_elem_start(void *arg, const XML_Char *name, const XML_Char **atts)                  else if (n->flags & NFLAG_SPC ||
 {                      (f->flags & FMT_ARG) == 0 ||
         struct parse     *ps = arg;                      (nn = TAILQ_PREV(n, pnodeq, child)) == NULL ||
         const struct node *node;                      pnode_class(nn->node) != CLASS_TEXT)
         enum attrkey      key;                          putchar(' ');
         enum attrval      val;                  break;
         struct pnode     *dat;  
         struct pattr     *pattr;  
         const XML_Char  **att;  
   
         /* FIXME: find a better way to ditch other namespaces. */  
         if (ps->stop || strcmp(name, "xi:include") == 0)  
                 return;  
   
         /* Close out text node, if applicable... */  
         if (ps->node == NODE_TEXT) {  
                 pnode_trim(ps->cur);  
                 ps->cur = ps->cur->parent;  
                 ps->node = ps->cur->node;  
         }          }
   
         for (node = nodes; node->name != NULL; node++)          if (n->node == NODE_ESCAPE) {
                 if (strcmp(node->name, name) == 0)                  fputs(n->b, stdout);
                         break;                  if (f->linestate == LINE_NEW)
                           f->linestate = LINE_TEXT;
         if (node->name == NULL) {  
                 if (ps->node == NODE_ROOT)  
                         return;  
                 fprintf(stderr, "%s:%zu:%zu: unknown node \"%s\"\n",  
                         ps->fname, XML_GetCurrentLineNumber(ps->xml),  
                         XML_GetCurrentColumnNumber(ps->xml), name);  
                 ps->stop = 1;  
                 return;                  return;
         } else if (ps->node == NODE_ROOT && ps->root != NULL) {  
                 fprintf(stderr, "%s:%zu:%zu: multiple refentries\n",  
                         ps->fname, XML_GetCurrentLineNumber(ps->xml),  
                         XML_GetCurrentColumnNumber(ps->xml));  
                 ps->stop = 1;  
                 return;  
         }          }
   
         if (node->node == NODE_INLINEEQUATION)          /*
                 ps->flags |= PARSE_EQN;           * Remove the prefix '-' from <option> elements
            * because the arguments of .Fl macros do not need it.
            */
   
         if ((dat = calloc(1, sizeof(*dat))) == NULL) {          if (n->parent != NULL && n->parent->node == NODE_OPTION && *cp == '-')
                 perror(NULL);                  cp++;
                 exit(1);  
         }  
   
         dat->node = ps->node = node->node;          if (f->linestate == LINE_MACRO)
         dat->parent = ps->cur;                  macro_addarg(f, cp, 0);
         TAILQ_INIT(&dat->childq);          else
         TAILQ_INIT(&dat->attrq);                  print_text(f, cp, 0);
   }
   
         if (ps->cur != NULL)  static void
                 TAILQ_INSERT_TAIL(&ps->cur->childq, dat, child);  pnode_printimagedata(struct format *f, struct pnode *n)
   {
           const char      *cp;
   
         ps->cur = dat;          if ((cp = pnode_getattr_raw(n, ATTRKEY_FILEREF, NULL)) == NULL)
         if (ps->root == NULL)                  cp = pnode_getattr_raw(n, ATTRKEY_ENTITYREF, NULL);
                 ps->root = dat;          if (cp != NULL) {
                   print_text(f, "[image:", ARG_SPACE);
                   print_text(f, cp, ARG_SPACE);
                   print_text(f, "]", 0);
           } else
                   print_text(f, "[image]", ARG_SPACE);
   }
   
         /*  static void
          * Process attributes.  pnode_printrefnamediv(struct format *f, struct pnode *n)
          */  {
         for (att = atts; *att != NULL; att += 2) {          struct pnode    *nc, *nn;
                 for (key = 0; key < ATTRKEY__MAX; key++)          int              comma;
                         if (strcmp(*att, attrkeys[key]) == 0)  
                                 break;          f->parastate = PARA_HAVE;
                 if (key == ATTRKEY__MAX) {          macro_line(f, "Sh NAME");
                         if (warn)          f->parastate = PARA_HAVE;
                                 fprintf(stderr, "%s:%zu:%zu: warning: "          comma = 0;
                                         "unknown attribute \"%s\"\n",          TAILQ_FOREACH_SAFE(nc, &n->childq, child, nn) {
                                         ps->fname,                  if (nc->node != NODE_REFNAME)
                                         XML_GetCurrentLineNumber(ps->xml),  
                                         XML_GetCurrentColumnNumber(ps->xml),  
                                         *att);  
                         continue;                          continue;
                 }                  if (comma)
                 for (val = 0; val < ATTRVAL__MAX; val++)                          macro_addarg(f, ",", ARG_SPACE);
                         if (strcmp(att[1], attrvals[val]) == 0)                  macro_open(f, "Nm");
                                 break;                  macro_addnode(f, nc, ARG_SPACE);
                 pattr = calloc(1, sizeof(*pattr));                  pnode_unlink(nc);
                 pattr->key = key;                  comma = 1;
                 pattr->val = val;  
                 if (val == ATTRVAL__MAX)  
                         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 || ps->node == NODE_ROOT)                  if (nc->node == NODE_TITLE)
                 return;                          pnode_unlink(nc);
         else if (strcmp(name, "xi:include") == 0)  
                 return;  
   
         /* Close out text node, if applicable... */          f->parastate = PARA_HAVE;
         if (ps->node == NODE_TEXT) {          macro_line(f, "Sh SYNOPSIS");
                 pnode_trim(ps->cur);          f->parastate = PARA_HAVE;
                 ps->cur = ps->cur->parent;  
                 ps->node = ps->cur->node;  
         }  
   
         if ((ps->cur = ps->cur->parent) == NULL)  
                 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;          int              flags, level;
   
         if (pn == NULL)          if (n->parent == NULL) {
                   pnode_printrefentry(f, n);
                 return;                  return;
           }
   
         while ((pp = TAILQ_FIRST(&pn->childq)) != NULL) {          level = ++f->level;
                 TAILQ_REMOVE(&pn->childq, pp, child);          flags = ARG_SPACE;
                 pnode_free(pp);          switch (n->node) {
           case NODE_SECTION:
           case NODE_APPENDIX:
                   if (level == 1)
                           flags |= ARG_UPPER;
                   break;
           case NODE_SIMPLESECT:
                   if (level < 2)
                           level = 2;
                   break;
           case NODE_NOTE:
                   if (level < 3)
                           level = 3;
                   break;
           default:
                   abort();
         }          }
   
         while ((ap = TAILQ_FIRST(&pn->attrq)) != NULL) {          TAILQ_FOREACH(nc, &n->childq, child)
                 TAILQ_REMOVE(&pn->attrq, ap, child);                  if (nc->node == NODE_TITLE)
                 free(ap->rawval);                          break;
                 free(ap);  
           switch (level) {
           case 1:
                   macro_close(f);
                   f->parastate = PARA_HAVE;
                   macro_open(f, "Sh");
                   break;
           case 2:
                   macro_close(f);
                   f->parastate = PARA_HAVE;
                   macro_open(f, "Ss");
                   break;
           default:
                   if (f->parastate == PARA_MID)
                           f->parastate = PARA_WANT;
                   macro_open(f, "Sy");
                   break;
         }          }
           macro_addnode(f, nc, flags);
           macro_close(f);
   
         free(pn->real);          /*
         free(pn);           * DocBook has no equivalent for -split mode,
 }           * so just switch the default in the AUTHORS section.
            */
   
 /*          if (nc != NULL) {
  * Unlink a node from its parent and pnode_free() it.                  if (level == 1 &&
  */                      (ncc = TAILQ_FIRST(&nc->childq)) != NULL &&
 static void                      ncc->node == NODE_TEXT &&
 pnode_unlink(struct pnode *pn)                      strcasecmp(ncc->b, "AUTHORS") == 0)
 {                          macro_line(f, "An -nosplit");
         if (pn->parent != NULL)                  pnode_unlink(nc);
                 TAILQ_REMOVE(&pn->parent->childq, pn, child);          }
         pnode_free(pn);          f->parastate = level > 2 ? PARA_WANT : PARA_HAVE;
 }  }
   
 /*  /*
  * Unlink all children of a node and pnode_free() them.   * Start a reference, extracting the title and volume.
  */   */
 static void  static void
 pnode_unlinksub(struct pnode *pn)  pnode_printciterefentry(struct format *f, struct pnode *n)
 {  {
           struct pnode    *nc, *title, *manvol;
   
         while ( ! TAILQ_EMPTY(&pn->childq))          title = manvol = NULL;
                 pnode_unlink(TAILQ_FIRST(&pn->childq));          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);
 }  }
   
 /*  /*
  * Retrieve an enumeration attribute from a node.   * The <mml:mfenced> node is a little peculiar.
  * Return ATTRVAL__MAX if the node has no such attribute.   * First, it can have arbitrary open and closing tokens, which default
    * to parentheses.
    * Second, >1 arguments are separated by commas.
  */   */
 enum attrval  static void
 pnode_getattr(struct pnode *pn, enum attrkey key)  pnode_printmathfenced(struct format *f, struct pnode *n)
 {  {
         struct pattr    *ap;          struct pnode    *nc;
   
         TAILQ_FOREACH(ap, &pn->attrq, child)          printf("left %s ", pnode_getattr_raw(n, ATTRKEY_OPEN, "("));
                 if (ap->key == key)  
                         return ap->val;  
         return ATTRVAL__MAX;  
 }  
   
 /*          nc = TAILQ_FIRST(&n->childq);
  * Retrieve an attribute string from a node.          pnode_print(f, nc);
  * Return defval if the node has no such attribute.  
  */  
 const char *  
 pnode_getattr_raw(struct pnode *pn, enum attrkey key, const char *defval)  
 {  
         struct pattr    *ap;  
   
         TAILQ_FOREACH(ap, &pn->attrq, child)          while ((nc = TAILQ_NEXT(nc, child)) != NULL) {
                 if (ap->key == key)                  putchar(',');
                         return ap->val == ATTRVAL__MAX ? ap->rawval :                  pnode_print(f, nc);
                             attrvals[ap->val];          }
         return defval;          printf("right %s ", pnode_getattr_raw(n, ATTRKEY_CLOSE, ")"));
           pnode_unlinksub(n);
 }  }
   
 /*  /*
  * Recursively search and return the first instance of "node".   * 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 struct pnode *  static void
 pnode_findfirst(struct pnode *pn, enum nodeid node)  pnode_printmath(struct format *f, struct pnode *n)
 {  {
         struct pnode    *pp, *res;          struct pnode    *nc;
   
         res = NULL;          nc = TAILQ_FIRST(&n->childq);
         TAILQ_FOREACH(pp, &pn->childq, child) {          pnode_print(f, nc);
                 res = pp->node == node ? pp :  
                         pnode_findfirst(pp, node);  
                 if (res != NULL)  
                         break;  
         }  
   
         return res;          switch (n->node) {
 }          case NODE_MML_MSUP:
                   fputs(" sup ", stdout);
 static void  
 macro_open(struct parse *p, const char *name)  
 {  
         switch (p->linestate) {  
         case LINE_TEXT:  
                 putchar('\n');  
                 /* FALLTHROUGH */  
         case LINE_NEW:  
                 putchar('.');  
                 p->linestate = LINE_MACRO;  
                 break;                  break;
         case LINE_MACRO:          case NODE_MML_MFRAC:
                 putchar(' ');                  fputs(" over ", stdout);
                 break;                  break;
           case NODE_MML_MSUB:
                   fputs(" sub ", stdout);
                   break;
           default:
                   break;
         }          }
         fputs(name, stdout);  
 }  
   
 static void          nc = TAILQ_NEXT(nc, child);
 macro_close(struct parse *p)          pnode_print(f, nc);
 {          pnode_unlinksub(n);
         assert(p->linestate == LINE_MACRO);  
         putchar('\n');  
         p->linestate = LINE_NEW;  
 }  }
   
 static void  static void
 macro_line(struct parse *p, const char *name)  pnode_printfuncprototype(struct format *f, struct pnode *n)
 {  {
         macro_open(p, name);          struct pnode    *fdef, *ftype, *nc, *nn;
         macro_close(p);  
 }  
   
 #define ARG_SPACE       1  /* Insert whitespace before this argument. */          /*
 #define ARG_SINGLE      2  /* Quote argument if it contains whitespace. */           * Extract <funcdef> child and ignore <void> child.
 #define ARG_QUOTED      4  /* We are already in a quoted argument. */           * Leave other children in place, to be treated as parameters.
 #define ARG_UPPER       8  /* Covert argument to upper case. */           */
 /*  
  * Print an argument string on a macro line, collapsing whitespace.  
  */  
 static void  
 macro_addarg(struct parse *p, const char *arg, int flags)  
 {  
         const char      *cp;  
   
         assert(p->linestate == LINE_MACRO);          fdef = NULL;
           TAILQ_FOREACH_SAFE(nc, &n->childq, child, nn) {
         /* Quote if requested and necessary. */                  switch (nc->node) {
                   case NODE_FUNCDEF:
         if ((flags & (ARG_SINGLE | ARG_QUOTED)) == ARG_SINGLE) {                          if (fdef == NULL) {
                 for (cp = arg; *cp != '\0'; cp++)                                  fdef = nc;
                         if (isspace((unsigned char)*cp))                                  TAILQ_REMOVE(&n->childq, nc, child);
                                 break;                                  nc->parent = NULL;
                 if (*cp != '\0') {  
                         if (flags & ARG_SPACE) {  
                                 putchar(' ');  
                                 flags &= ~ ARG_SPACE;  
                         }                          }
                         putchar('"');                          break;
                         flags = ARG_QUOTED;                  case NODE_VOID:
                           pnode_unlink(nc);
                           break;
                   default:
                           break;
                 }                  }
         }          }
   
         for (cp = arg; *cp != '\0'; cp++) {          /*
            * If no children are left, the function is void; use .Fn.
            * Otherwise, use .Fo.
            */
   
                 /* Collapse whitespace. */          nc = TAILQ_FIRST(&n->childq);
           if (fdef != NULL) {
                 if (isspace((unsigned char)*cp)) {                  ftype = TAILQ_FIRST(&fdef->childq);
                         flags |= ARG_SPACE;                  if (ftype != NULL && ftype->node == NODE_TEXT) {
                         continue;                          macro_argline(f, "Ft", ftype->b);
                 } else if (flags & ARG_SPACE) {                          pnode_unlink(ftype);
                         putchar(' ');  
                         flags &= ~ ARG_SPACE;  
                 }                  }
                   if (nc == NULL) {
                           macro_open(f, "Fn");
                           macro_addnode(f, fdef, ARG_SPACE | ARG_SINGLE);
                           macro_addarg(f, "void", ARG_SPACE);
                           macro_close(f);
                   } else
                           macro_nodeline(f, "Fo", fdef, ARG_SINGLE);
                   pnode_unlink(fdef);
           } else if (nc == NULL)
                   macro_line(f, "Fn UNKNOWN void");
           else
                   macro_line(f, "Fo UNKNOWN");
   
                 /* Escape us if we look like a macro. */          if (nc == NULL)
                   return;
   
                 if ((flags & ARG_QUOTED) == 0 &&          while (nc != NULL) {
                     (cp == arg || isspace((unsigned char)cp[-1])) &&                  macro_nodeline(f, "Fa", nc, ARG_SINGLE);
                     isupper((unsigned char)cp[0]) &&                  pnode_unlink(nc);
                     islower((unsigned char)cp[1]) &&                  nc = TAILQ_FIRST(&n->childq);
                     (cp[2] == '\0' || cp[2] == ' ' ||  
                      (islower((unsigned char)cp[2]) &&  
                       (cp[3] == '\0' || cp[3] == ' '))))  
                         fputs("\\&", stdout);  
   
                 if (*cp == '"')  
                         fputs("\\(dq", stdout);  
                 else if (flags & ARG_UPPER)  
                         putchar(toupper((unsigned char)*cp));  
                 else  
                         putchar(*cp);  
                 if (*cp == '\\')  
                         putchar('e');  
         }          }
           macro_line(f, "Fc");
 }  }
   
 static void  
 macro_argline(struct parse *p, const char *name, const char *arg)  
 {  
         macro_open(p, name);  
         macro_addarg(p, arg, ARG_SPACE);  
         macro_close(p);  
 }  
   
 /*  /*
  * Recursively append text from the children of a node to a macro line.   * The <arg> element is more complicated than it should be because text
    * nodes are treated like ".Ar foo", but non-text nodes need to be
    * 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
 macro_addnode(struct parse *p, struct pnode *pn, int flags)  pnode_printarg(struct format *f, struct pnode *n)
 {  {
         int              quote_now;          struct pnode    *nc;
           struct pattr    *a;
           int              isop, isrep, was_impl;
   
         assert(p->linestate == LINE_MACRO);          isop = 1;
           isrep = was_impl = 0;
         /*          TAILQ_FOREACH(a, &n->attrq, child) {
          * If the only child is a text node, just add that text,                  if (a->key == ATTRKEY_CHOICE &&
          * letting macro_addarg() decide about quoting.                      (a->val == ATTRVAL_PLAIN || a->val == ATTRVAL_REQ))
          */                          isop = 0;
                   else if (a->key == ATTRKEY_REP && a->val == ATTRVAL_REPEAT)
         pn = TAILQ_FIRST(&pn->childq);                          isrep = 1;
         if (pn != NULL && pn->node == NODE_TEXT &&  
             TAILQ_NEXT(pn, child) == NULL) {  
                 macro_addarg(p, pn->b, flags);  
                 return;  
         }          }
           if (isop) {
         /*                  if (f->flags & FMT_IMPL) {
          * If we want the argument quoted and are not already                          was_impl = 1;
          * in a quoted context, quote now.                          macro_open(f, "Oo");
          */                  } else {
                           macro_open(f, "Op");
         quote_now = 0;                          f->flags |= FMT_IMPL;
         if (flags & ARG_SINGLE) {  
                 if ((flags & ARG_QUOTED) == 0) {  
                         if (flags & ARG_SPACE) {  
                                 putchar(' ');  
                                 flags &= ~ARG_SPACE;  
                         }  
                         putchar('"');  
                         flags |= ARG_QUOTED;  
                         quote_now = 1;  
                 }                  }
                 flags &= ~ARG_SINGLE;  
         }          }
           TAILQ_FOREACH(nc, &n->childq, child) {
         /*                  if (nc->node == NODE_TEXT)
          * Iterate to child and sibling nodes,                          macro_open(f, "Ar");
          * inserting whitespace between nodes.                  pnode_print(f, nc);
          */          }
           if (isrep && f->linestate == LINE_MACRO)
         while (pn != NULL) {                  macro_addarg(f, "...", ARG_SPACE);
                 if (pn->node == NODE_TEXT)          if (isop) {
                         macro_addarg(p, pn->b, flags);                  if (was_impl)
                           macro_open(f, "Oc");
                 else                  else
                         macro_addnode(p, pn, flags);                          f->flags &= ~FMT_IMPL;
                 pn = TAILQ_NEXT(pn, child);  
                 flags |= ARG_SPACE;  
         }          }
         if (quote_now)          pnode_unlinksub(n);
                 putchar('"');  
 }  }
   
 static void  static void
 macro_nodeline(struct parse *p, const char *name, struct pnode *pn, int flags)  pnode_printgroup(struct format *f, struct pnode *n)
 {  {
         macro_open(p, name);          struct pnode    *nc;
         macro_addnode(p, pn, ARG_SPACE | flags);          struct pattr    *a;
         macro_close(p);          int              bar, isop, isrep, was_impl;
 }  
   
 /*          isop = 1;
  * If the next node is a text node starting with closing punctuation,          isrep = was_impl = 0;
  * emit the closing punctuation as a trailing macro argument.          TAILQ_FOREACH(a, &n->attrq, child) {
  */                  if (a->key == ATTRKEY_CHOICE &&
 static void                      (a->val == ATTRVAL_PLAIN || a->val == ATTRVAL_REQ))
 macro_closepunct(struct parse *p, struct pnode *pn)                          isop = 0;
 {                  else if (a->key == ATTRKEY_REP && a->val == ATTRVAL_REPEAT)
         if ((pn = TAILQ_NEXT(pn, child)) != NULL &&                          isrep = 1;
             pn->node == NODE_TEXT && pn->bsz > 0 &&  
             (pn->b[0] == ',' || pn->b[0] == '.') &&  
             (pn->bsz == 1 || isspace((unsigned char)pn->b[1]))) {  
                 putchar(' ');  
                 putchar(pn->b[0]);  
                 pn->b++;  
                 pn->bsz--;  
         }          }
         macro_close(p);          if (isop) {
 }                  if (f->flags & FMT_IMPL) {
                           was_impl = 1;
 static void                          macro_open(f, "Oo");
 print_text(struct parse *p, const char *word)                  } else {
 {                          macro_open(f, "Op");
         switch (p->linestate) {                          f->flags |= FMT_IMPL;
         case LINE_NEW:                  }
                 break;          } else if (isrep) {
         case LINE_TEXT:                  if (f->flags & FMT_IMPL) {
                 putchar(' ');                          was_impl = 1;
                 break;                          macro_open(f, "Bro");
         case LINE_MACRO:                  } else {
                 macro_close(p);                          macro_open(f, "Brq");
                 break;                          f->flags |= FMT_IMPL;
                   }
         }          }
         fputs(word, stdout);          bar = 0;
         p->linestate = LINE_TEXT;          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);
 }  }
   
 static void  static void
 pnode_printpara(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:
         if ((pp = TAILQ_PREV(pn, pnodeq, child)) == NULL &&  
             (pp = pn->parent) == NULL)  
                 return;  
   
         switch (pp->node) {  
         case NODE_ENTRY:  
         case NODE_LISTITEM:  
                 return;  
         case NODE_PREFACE:  
         case NODE_SECTION:  
                 if (p->level < 3)  
                         return;  
                 break;                  break;
           case ATTRVAL_SYSTEMNAME:
                   macro_open(f, "Pa");
                   break;
           case ATTRVAL_EVENT:
         default:          default:
                   macro_open(f, "Sy");
                 break;                  break;
         }          }
         macro_line(p, "Pp");  
 }  }
   
 /*  
  * If the SYNOPSIS macro has a superfluous title, kill it.  
  */  
 static void  static void
 pnode_printrefsynopsisdiv(struct parse *p, struct pnode *pn)  pnode_printauthor(struct format *f, struct pnode *n)
 {  {
         struct pnode    *pp, *pq;          struct pnode    *nc, *nn;
           int              have_contrib, have_name;
   
         TAILQ_FOREACH_SAFE(pp, &pn->childq, child, pq)          /*
                 if (pp->node == NODE_TITLE)           * Print <contrib> children up front, before the .An scope,
                         pnode_unlink(pp);           * and figure out whether we a name of a person.
            */
   
         macro_line(p, "Sh SYNOPSIS");          have_contrib = have_name = 0;
 }          TAILQ_FOREACH_SAFE(nc, &n->childq, child, nn) {
                   switch (nc->node) {
 /*                  case NODE_CONTRIB:
  * Start a hopefully-named `Sh' section.                          if (have_contrib)
  */                                  print_text(f, ",", 0);
 static void                          print_textnode(f, nc);
 pnode_printrefsect(struct parse *p, struct pnode *pn)                          pnode_unlink(nc);
 {                          have_contrib = 1;
         struct pnode    *pp;  
         const char      *title;  
         int              flags, level;  
   
         if (pn->parent == NULL)  
                 return;  
   
         level = ++p->level;  
         flags = ARG_SPACE;  
         if (level == 1)  
                 flags |= ARG_UPPER;  
         if (level < 3) {  
                 switch (pn->node) {  
                 case NODE_CAUTION:  
                 case NODE_NOTE:  
                 case NODE_TIP:  
                 case NODE_WARNING:  
                         level = 3;  
                         break;                          break;
                   case NODE_PERSONNAME:
                           have_name = 1;
                           break;
                 default:                  default:
                         break;                          break;
                 }                  }
         }          }
           if (TAILQ_FIRST(&n->childq) == NULL)
                   return;
   
         TAILQ_FOREACH(pp, &pn->childq, child)          if (have_contrib)
                 if (pp->node == NODE_TITLE)                  print_text(f, ":", 0);
                         break;  
   
         if (pp == NULL) {          /*
                 switch (pn->node) {           * If we have a name, print it in the .An scope and leave
                 case NODE_PREFACE:           * all other content for child handlers, to print after the
                         title = "Preface";           * scope.  Otherwise, print everything in the scope.
                         break;           */
                 case NODE_CAUTION:  
                         title = "Caution";          macro_open(f, "An");
                         break;          TAILQ_FOREACH_SAFE(nc, &n->childq, child, nn) {
                 case NODE_NOTE:                  if (nc->node == NODE_PERSONNAME || have_name == 0) {
                         title = "Note";                          macro_addnode(f, nc, ARG_SPACE);
                         break;                          pnode_unlink(nc);
                 case NODE_TIP:  
                         title = "Tip";  
                         break;  
                 case NODE_WARNING:  
                         title = "Warning";  
                         break;  
                 default:  
                         title = "Unknown";  
                         break;  
                 }                  }
         }          }
   
         switch (level) {          /*
         case 1:           * If there is an email address,
                 macro_open(p, "Sh");           * print it on the same macro line.
                 break;           */
         case 2:  
                 macro_open(p, "Ss");          if ((nc = pnode_findfirst(n, NODE_EMAIL)) != NULL) {
                 break;                  f->flags |= FMT_CHILD;
         default:                  macro_open(f, "Aq Mt");
                 pnode_printpara(p, pn);                  macro_addnode(f, nc, ARG_SPACE);
                 macro_open(p, "Sy");                  pnode_unlink(nc);
                 break;  
         }          }
   
         if (pp != NULL) {          /*
                 macro_addnode(p, pp, flags);           * If there are still unprinted children, end the scope
                 pnode_unlink(pp);           * with a comma.  Otherwise, leave the scope open in case
         } else           * a text node follows that starts with closing punctuation.
                 macro_addarg(p, title, ARG_SPACE | ARG_QUOTED);           */
         macro_close(p);  
           if (TAILQ_FIRST(&n->childq) != NULL) {
                   macro_addarg(f, ",", ARG_SPACE);
                   macro_close(f);
           }
 }  }
   
 /*  
  * Start a reference, extracting the title and volume.  
  */  
 static void  static void
 pnode_printciterefentry(struct parse *p, struct pnode *pn)  pnode_printxref(struct format *f, struct pnode *n)
 {  {
         struct pnode    *pp, *title, *manvol;          const char      *linkend;
   
         title = manvol = NULL;          linkend = pnode_getattr_raw(n, ATTRKEY_LINKEND, NULL);
         TAILQ_FOREACH(pp, &pn->childq, child) {          if (linkend != NULL) {
                 if (pp->node == NODE_MANVOLNUM)                  macro_open(f, "Sx");
                         manvol = pp;                  macro_addarg(f, linkend, ARG_SPACE);
                 else if (pp->node == NODE_REFENTRYTITLE)  
                         title = pp;  
         }          }
         macro_open(p, "Xr");  
         if (title == NULL)  
                 macro_addarg(p, "unknown", ARG_SPACE);  
         else  
                 macro_addnode(p, title, ARG_SPACE | ARG_SINGLE);  
         if (manvol == NULL)  
                 macro_addarg(p, "1", ARG_SPACE);  
         else  
                 macro_addnode(p, manvol, ARG_SPACE | ARG_SINGLE);  
         macro_close(p);  
         pnode_unlinksub(pn);  
 }  }
   
 static void  static void
 pnode_printrefmeta(struct parse *p, struct pnode *pn)  pnode_printlink(struct format *f, struct pnode *n)
 {  {
         struct pnode    *pp, *title, *manvol;          struct pnode    *nc;
           const char      *uri, *text;
   
         title = manvol = NULL;          uri = pnode_getattr_raw(n, ATTRKEY_LINKEND, NULL);
         TAILQ_FOREACH(pp, &pn->childq, child) {          if (uri != NULL) {
                 if (pp->node == NODE_MANVOLNUM)                  if (TAILQ_FIRST(&n->childq) != NULL) {
                         manvol = pp;                          TAILQ_FOREACH(nc, &n->childq, child)
                 else if (pp->node == NODE_REFENTRYTITLE)                                  pnode_print(f, nc);
                         title = pp;                          text = "";
                   } else if ((text = pnode_getattr_raw(n,
                       ATTRKEY_ENDTERM, NULL)) != NULL) {
                           if (f->linestate == LINE_MACRO && f->flags & FMT_ARG)
                                   macro_addarg(f, text, ARG_SPACE);
                           else
                                   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;
         }          }
         macro_open(p, "Dt");          uri = pnode_getattr_raw(n, ATTRKEY_XLINK_HREF, NULL);
         if (title == NULL)          if (uri == NULL)
                 macro_addarg(p, "UNKNOWN", ARG_SPACE);                  uri = pnode_getattr_raw(n, ATTRKEY_URL, NULL);
         else          if (uri != NULL) {
                 macro_addnode(p, title, ARG_SPACE | ARG_SINGLE | ARG_UPPER);                  macro_open(f, "Lk");
         if (manvol == NULL)                  macro_addarg(f, uri, ARG_SPACE | ARG_SINGLE);
                 macro_addarg(p, "1", ARG_SPACE);                  if (TAILQ_FIRST(&n->childq) != NULL)
         else                          macro_addnode(f, n, ARG_SPACE | ARG_SINGLE);
                 macro_addnode(p, manvol, ARG_SPACE | ARG_SINGLE);                  pnode_unlinksub(n);
         macro_close(p);          }
         pnode_unlink(pn);  
 }  }
   
 static void  static void
 pnode_printfuncdef(struct parse *p, struct pnode *pn)  pnode_printolink(struct format *f, struct pnode *n)
 {  {
         struct pnode    *pp, *ftype, *func;          const char      *uri, *ptr, *local;
   
         ftype = func = NULL;          uri = pnode_getattr_raw(n, ATTRKEY_TARGETDOC, NULL);
         TAILQ_FOREACH(pp, &pn->childq, child) {          ptr = pnode_getattr_raw(n, ATTRKEY_TARGETPTR, NULL);
                 if (pp->node == NODE_TEXT)          local = pnode_getattr_raw(n, ATTRKEY_LOCALINFO, NULL);
                         ftype = pp;          if (uri == NULL) {
                 else if (pp->node == NODE_FUNCTION)                  uri = ptr;
                         func = pp;                  ptr = NULL;
         }          }
         if (ftype != NULL)          if (uri == NULL) {
                 macro_argline(p, "Ft", ftype->b);                  uri = local;
         macro_open(p, "Fo");                  local = NULL;
         if (func == NULL)          }
                 macro_addarg(p, "UNKNOWN", ARG_SPACE);          if (uri == NULL)
         else                  return;
                 macro_addnode(p, func, ARG_SPACE | ARG_SINGLE);  
         macro_close(p);          macro_open(f, "Lk");
           macro_addarg(f, uri, ARG_SPACE | ARG_SINGLE);
           macro_addnode(f, n, ARG_SPACE | ARG_SINGLE);
           if (ptr != NULL || local != NULL) {
                   macro_close(f);
                   macro_open(f, "Pq");
                   if (ptr != NULL)
                           macro_addarg(f, ptr, ARG_SPACE);
                   if (local != NULL)
                           macro_addarg(f, local, ARG_SPACE);
           }
           pnode_unlinksub(n);
 }  }
   
 /*  
  * The <mml:mfenced> node is a little peculiar.  
  * First, it can have arbitrary open and closing tokens, which default  
  * to parentheses.  
  * Second, >1 arguments are separated by commas.  
  */  
 static void  static void
 pnode_printmathfenced(struct parse *p, struct pnode *pn)  pnode_printprologue(struct format *f, struct pnode *root)
 {  {
         struct pnode    *pp;          struct pnode    *name, *nc;
   
         printf("left %s ", pnode_getattr_raw(pn, ATTRKEY_OPEN, "("));          nc = TAILQ_FIRST(&root->childq);
           assert(nc->node == NODE_DATE);
           macro_nodeline(f, "Dd", nc, 0);
           pnode_unlink(nc);
   
         pp = TAILQ_FIRST(&pn->childq);          macro_open(f, "Dt");
         pnode_print(p, pp);          name = TAILQ_FIRST(&root->childq);
           assert(name->node == NODE_REFENTRYTITLE);
           macro_addnode(f, name, ARG_SPACE | ARG_SINGLE | ARG_UPPER);
           TAILQ_REMOVE(&root->childq, name, child);
           name->parent = NULL;
           nc = TAILQ_FIRST(&root->childq);
           assert (nc->node == NODE_MANVOLNUM);
           macro_addnode(f, nc, ARG_SPACE | ARG_SINGLE);
           pnode_unlink(nc);
   
         while ((pp = TAILQ_NEXT(pp, child)) != NULL) {          macro_line(f, "Os");
                 putchar(',');  
                 pnode_print(p, pp);          nc = TAILQ_FIRST(&root->childq);
           if (nc != NULL && nc->node == NODE_TITLE) {
                   macro_line(f, "Sh NAME");
                   macro_nodeline(f, "Nm", name, ARG_SINGLE);
                   macro_nodeline(f, "Nd", nc, 0);
                   pnode_unlink(nc);
         }          }
         printf("right %s ", pnode_getattr_raw(pn, ATTRKEY_CLOSE, ")"));          pnode_unlink(name);
         pnode_unlinksub(pn);          f->parastate = PARA_HAVE;
 }  }
   
 /*  
  * 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;
                   }
                   if (info == NULL)
                           info = pnode_takefirst(n, NODE_INFO);
                   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.
         pnode_unlinksub(pn);           * 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:
         TAILQ_FOREACH(fdef, &pn->childq, child)                  case NODE_REFSYNOPSISDIV:
                 if (fdef->node == NODE_FUNCDEF)                          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 (fdef != NULL)          /*
                 pnode_printfuncdef(p, fdef);           * If no AUTHORS section was found, create one from scratch,
         else           * and insert that at the place selected earlier.
                 macro_line(p, "Fo UNKNOWN");           */
   
         TAILQ_FOREACH(pp, &pn->childq, child)          if (match == NULL) {
                 if (pp->node == NODE_PARAMDEF)                  match = xcalloc(1, sizeof(*match));
                         macro_nodeline(p, "Fa", pp, ARG_SINGLE);                  match->node = NODE_SECTION;
                   match->flags |= NFLAG_SPC;
                   match->parent = n;
                   TAILQ_INIT(&match->childq);
                   TAILQ_INIT(&match->attrq);
                   nc = pnode_alloc(match);
                   nc->node = NODE_TITLE;
                   nc->flags |= NFLAG_SPC;
                   nc = pnode_alloc_text(nc, "AUTHORS");
                   nc->flags |= NFLAG_SPC;
                   if (later == NULL)
                           TAILQ_INSERT_TAIL(&n->childq, match, child);
                   else
                           TAILQ_INSERT_BEFORE(later, match, child);
           }
   
         macro_line(p, "Fc");          /*
         pnode_unlinksub(pn);           * 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, *ncc;
         struct pattr    *ap;          int              comma;
         int              isop, isrep;  
   
         isop = 1;          macro_open(f, "It");
         isrep = 0;          f->parastate = PARA_HAVE;
         TAILQ_FOREACH(ap, &pn->attrq, child) {          f->flags |= FMT_IMPL;
                 if (ap->key == ATTRKEY_CHOICE &&          comma = -1;
                     (ap->val == ATTRVAL_PLAIN || ap->val == ATTRVAL_REQ))          TAILQ_FOREACH_SAFE(nc, &n->childq, child, nn) {
                         isop = 0;                  if (nc->node != NODE_TERM && nc->node != NODE_GLOSSTERM)
                 else if (ap->key == ATTRKEY_REP && ap->val == ATTRVAL_REPEAT)                          continue;
                         isrep = 1;                  if (comma != -1) {
                           switch (f->linestate) {
                           case LINE_NEW:
                                   break;
                           case LINE_TEXT:
                                   print_text(f, ",", 0);
                                   break;
                           case LINE_MACRO:
                                   macro_addarg(f, ",", comma);
                                   break;
                           }
                   }
                   f->parastate = PARA_HAVE;
                   comma = (ncc = TAILQ_FIRST(&nc->childq)) == NULL ||
                       pnode_class(ncc->node) == CLASS_TEXT ? 0 : ARG_SPACE;
                   pnode_print(f, nc);
                   pnode_unlink(nc);
         }          }
         if (isop)          macro_close(f);
                 macro_open(p, "Op");          f->parastate = PARA_HAVE;
           while ((nc = TAILQ_FIRST(&n->childq)) != NULL) {
         TAILQ_FOREACH(pp, &pn->childq, child) {                  pnode_print(f, nc);
                 if (pp->node == NODE_TEXT)                  pnode_unlink(nc);
                         macro_open(p, "Ar");  
                 pnode_print(p, pp);  
                 if (isrep && pp->node == NODE_TEXT)  
                         macro_addarg(p, "...", ARG_SPACE);  
         }          }
         pnode_unlinksub(pn);          macro_close(f);
           f->parastate = PARA_HAVE;
 }  }
   
 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 (ap->key == ATTRKEY_CHOICE &&                          if (f->parastate == PARA_MID)
                     (ap->val == ATTRVAL_PLAIN || ap->val == ATTRVAL_REQ)) {                                  f->parastate = PARA_WANT;
                         isop = 0;                          macro_nodeline(f, "Sy", nc, 0);
                         break;                          pnode_unlink(nc);
                 }                  }
   
         /*  
          * Make sure we're on a macro line.  
          * This will prevent pnode_print() for putting us on a  
          * subsequent line.  
          */  
         sv = p->linestate == LINE_NEW;  
         if (isop)  
                 macro_open(p, "Op");  
         else if (sv)  
                 macro_open(p, "No");  
   
         /*  
          * 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 (np != NULL) {  
                         if (pp->node != np->node)  
                                 break;  
                         macro_addarg(p, "|", ARG_SPACE);  
                         macro_addnode(p, np, ARG_SPACE);  
                         pp = np;  
                         np = TAILQ_NEXT(np, child);  
                 }  
         }          }
         if (sv)  
                 macro_close(p);  
         pnode_unlinksub(pn);  
 }  }
   
 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 = p->root == NULL ? NULL :          macro_line(f, "Bl -dash -compact");
                 pnode_findfirst(p->root, NODE_REFMETA);          TAILQ_FOREACH(nc, &n->childq, child) {
                   macro_line(f, "It");
         macro_line(p, "Dd $Mdocdate" "$");                  pnode_print(f, nc);
         if (pp != NULL)  
                 pnode_printrefmeta(p, pp);  
         else {  
                 macro_open(p, "Dt");  
                 macro_addarg(p,  
                     pnode_getattr_raw(p->root, ATTRKEY_ID, "UNKNOWN"),  
                     ARG_SPACE | ARG_SINGLE | ARG_UPPER);  
                 macro_addarg(p, "1", ARG_SPACE);  
                 macro_close(p);  
         }          }
         macro_line(p, "Os");          macro_line(f, "El");
           pnode_unlink(n);
         if (p->flags & PARSE_EQN) {  
                 macro_line(p, "EQ");  
                 print_text(p, "delim $$");  
                 macro_line(p, "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;  
   
         macro_open(p, "It");          macro_line(f, "Bl -bullet -compact");
         TAILQ_FOREACH(pp, &pn->childq, child) {          while ((nc = pnode_findfirst(n, NODE_ENTRY)) != NULL) {
                 if (pp->node != NODE_TERM)                  macro_line(f, "It");
                         continue;                  f->parastate = PARA_HAVE;
                 if ( ! first)                  pnode_print(f, nc);
                         macro_addarg(p, ",", 0);                  f->parastate = PARA_HAVE;
                 pnode_print(p, pp);                  pnode_unlink(nc);
                 first = 0;  
         }          }
         macro_close(p);          macro_line(f, "El");
         TAILQ_FOREACH(pp, &pn->childq, child)          pnode_unlinksub(n);
                 if (pp->node != NODE_TERM)  
                         pnode_print(p, pp);  
         pnode_unlinksub(pn);  
 }  }
   
 static void  static void
 pnode_printtitle(struct parse *p, struct pnode *pn)  pnode_printtgroup2(struct format *f, struct pnode *n)
 {  {
         struct pnode    *pp, *pq;          struct pnode    *nr, *ne;
   
         TAILQ_FOREACH_SAFE(pp, &pn->childq, child, pq) {          f->parastate = PARA_HAVE;
                 if (pp->node == NODE_TITLE) {          macro_line(f, "Bl -tag -width Ds");
                         pnode_printpara(p, pp);          while ((nr = pnode_findfirst(n, NODE_ROW)) != NULL) {
                         pnode_print(p, pp);                  if ((ne = pnode_findfirst(n, NODE_ENTRY)) == NULL)
                         pnode_unlink(pp);                          break;
                 }                  macro_open(f, "It");
                   f->flags |= FMT_IMPL;
                   f->parastate = PARA_HAVE;
                   pnode_print(f, ne);
                   macro_close(f);
                   pnode_unlink(ne);
                   f->parastate = PARA_HAVE;
                   pnode_print(f, nr);
                   f->parastate = PARA_HAVE;
                   pnode_unlink(nr);
         }          }
           macro_line(f, "El");
           f->parastate = PARA_WANT;
           pnode_unlinksub(n);
 }  }
   
 static void  static void
 pnode_printrow(struct parse *p, struct pnode *pn)  pnode_printtgroup(struct format *f, struct pnode *n)
 {  {
         struct pnode    *pp;          struct pnode    *nc;
   
         macro_line(p, "Bl -dash -compact");          switch (atoi(pnode_getattr_raw(n, ATTRKEY_COLS, "0"))) {
         TAILQ_FOREACH(pp, &pn->childq, child) {          case 1:
                 macro_line(p, "It");                  pnode_printtgroup1(f, n);
                 pnode_print(p, pp);                  return;
           case 2:
                   pnode_printtgroup2(f, n);
                   return;
           default:
                   break;
         }          }
         macro_line(p, "El");  
         pnode_unlink(pn);  
 }  
   
 static void          f->parastate = PARA_HAVE;
 pnode_printtable(struct parse *p, struct pnode *pn)          macro_line(f, "Bl -ohang");
 {          while ((nc = pnode_findfirst(n, NODE_ROW)) != NULL) {
         struct pnode    *pp;                  macro_line(f, "It Table Row");
                   pnode_printrow(f, nc);
         pnode_printtitle(p, pn);  
         macro_line(p, "Bl -ohang");  
         while ((pp = pnode_findfirst(pn, NODE_ROW)) != NULL) {  
                 macro_line(p, "It Table Row");  
                 pnode_printrow(p, pp);  
         }          }
         macro_line(p, "El");          macro_line(f, "El");
         pnode_unlinksub(pn);          f->parastate = PARA_WANT;
           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;
   
         pnode_printtitle(p, pn);          pnode_printtitle(f, n);
         macro_argline(p, "Bl",          f->parastate = PARA_HAVE;
             pn->node == NODE_ORDEREDLIST ? "-enum" : "-bullet");          macro_argline(f, "Bl",
         TAILQ_FOREACH(pp, &pn->childq, child) {              n->node == NODE_ORDEREDLIST ? "-enum" : "-bullet");
                 macro_line(p, "It");          TAILQ_FOREACH(nc, &n->childq, child) {
                 pnode_print(p, pp);                  macro_line(f, "It");
                   f->parastate = PARA_HAVE;
                   pnode_print(f, nc);
                   f->parastate = PARA_HAVE;
         }          }
         macro_line(p, "El");          macro_line(f, "El");
         pnode_unlinksub(pn);          f->parastate = PARA_WANT;
           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;
   
         pnode_printtitle(p, pn);          pnode_printtitle(f, n);
         macro_line(p, "Bl -tag -width Ds");          f->parastate = PARA_HAVE;
         TAILQ_FOREACH(pp, &pn->childq, child) {          macro_line(f, "Bl -tag -width Ds");
                 if (pp->node == NODE_VARLISTENTRY)          TAILQ_FOREACH(nc, &n->childq, child) {
                         pnode_print(p, pp);                  if (nc->node == NODE_VARLISTENTRY)
                           pnode_printvarlistentry(f, nc);
                 else                  else
                         macro_nodeline(p, "It", pp, 0);                          macro_nodeline(f, "It", nc, 0);
         }          }
         macro_line(p, "El");          macro_line(f, "El");
         pnode_unlinksub(pn);          f->parastate = PARA_WANT;
           pnode_unlinksub(n);
 }  }
   
 /*  /*
Line 1243  pnode_printvariablelist(struct parse *p, struct pnode 
Line 1033  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;
         const char      *ccp;          int              was_impl;
         char            *cp;  
         int              last;  
         enum linestate   sv;  
   
         if (pn == NULL)          if (n == NULL)
                 return;                  return;
   
         sv = p->linestate;          was_impl = f->flags & FMT_IMPL;
           if (n->flags & NFLAG_SPC)
                   f->flags &= ~FMT_NOSPC;
           else
                   f->flags |= FMT_NOSPC;
   
         switch (pn->node) {          switch (n->node) {
         case NODE_APPLICATION:  
                 macro_open(p, "Nm");  
                 break;  
         case NODE_ANCHOR:  
                 /* Don't print anything! */  
                 return;  
         case NODE_ARG:          case NODE_ARG:
                 pnode_printarg(p, pn);                  pnode_printarg(f, n);
                 break;                  break;
         case NODE_AUTHOR:          case NODE_AUTHOR:
                 macro_open(p, "An");                  pnode_printauthor(f, n);
                 break;                  break;
         case NODE_AUTHORGROUP:          case NODE_AUTHORGROUP:
                 macro_line(p, "An -split");                  macro_line(f, "An -split");
                 break;                  break;
         case NODE_BOOKINFO:          case NODE_BLOCKQUOTE:
                 macro_line(p, "Sh NAME");                  f->parastate = PARA_HAVE;
                   macro_line(f, "Bd -ragged -offset indent");
                   f->parastate = PARA_HAVE;
                 break;                  break;
         case NODE_CITEREFENTRY:          case NODE_CITEREFENTRY:
                 pnode_printciterefentry(p, pn);                  pnode_printciterefentry(f, n);
                 break;                  break;
         case NODE_CITETITLE:          case NODE_CITETITLE:
                 macro_open(p, "%T");                  macro_open(f, "%T");
                 break;                  break;
         case NODE_CODE:  
                 macro_open(p, "Li");  
                 break;  
         case NODE_COMMAND:          case NODE_COMMAND:
                 macro_open(p, "Nm");                  macro_open(f, "Nm");
                 break;                  break;
         case NODE_CONSTANT:          case NODE_CONSTANT:
                 macro_open(p, "Dv");                  macro_open(f, "Dv");
                 break;                  break;
           case NODE_COPYRIGHT:
                   print_text(f, "Copyright", ARG_SPACE);
                   fputs(" \\(co", stdout);
                   break;
         case NODE_EDITOR:          case NODE_EDITOR:
                 print_text(p, "editor:");                  print_text(f, "editor:", ARG_SPACE);
                 macro_open(p, "An");                  pnode_printauthor(f, n);
                 break;                  break;
         case NODE_EMAIL:          case NODE_EMAIL:
                 macro_open(p, "Aq Mt");                  if (was_impl)
                           macro_open(f, "Ao Mt");
                   else {
                           macro_open(f, "Aq Mt");
                           f->flags |= FMT_IMPL;
                   }
                 break;                  break;
         case NODE_EMPHASIS:          case NODE_EMPHASIS:
         case NODE_FIRSTTERM:          case NODE_FIRSTTERM:
                 macro_open(p, "Em");          case NODE_GLOSSTERM:
                   if ((nc = TAILQ_FIRST(&n->childq)) != NULL &&
                       pnode_class(nc->node) < CLASS_LINE)
                           macro_open(f, "Em");
                   if (n->node == NODE_GLOSSTERM)
                           f->parastate = PARA_HAVE;
                 break;                  break;
         case NODE_ENVAR:          case NODE_ENVAR:
                 macro_open(p, "Ev");                  macro_open(f, "Ev");
                 break;                  break;
           case NODE_ERRORNAME:
                   macro_open(f, "Er");
                   break;
         case NODE_FILENAME:          case NODE_FILENAME:
                 macro_open(p, "Pa");                  macro_open(f, "Pa");
                 break;                  break;
           case NODE_FOOTNOTE:
                   macro_line(f, "Bo");
                   f->parastate = PARA_HAVE;
                   break;
         case NODE_FUNCTION:          case NODE_FUNCTION:
                 macro_open(p, "Fn");                  macro_open(f, "Fn");
                 break;                  break;
         case NODE_FUNCPROTOTYPE:          case NODE_FUNCPROTOTYPE:
                 pnode_printfuncprototype(p, pn);                  pnode_printfuncprototype(f, n);
                 break;                  break;
         case NODE_FUNCSYNOPSISINFO:          case NODE_FUNCSYNOPSISINFO:
                 macro_open(p, "Fd");                  macro_open(f, "Fd");
                 break;                  break;
         case NODE_INDEXTERM:          case NODE_IMAGEDATA:
                 return;                  pnode_printimagedata(f, n);
         case NODE_INFORMALEQUATION:  
                 macro_line(p, "EQ");  
                 break;                  break;
           case NODE_INFORMALEQUATION:
                   f->parastate = PARA_HAVE;
                   macro_line(f, "Bd -ragged -offset indent");
                   f->parastate = PARA_HAVE;
                   /* FALLTHROUGH */
         case NODE_INLINEEQUATION:          case NODE_INLINEEQUATION:
                 if (p->linestate == LINE_NEW)                  macro_line(f, "EQ");
                         p->linestate = LINE_TEXT;  
                 putchar('$');  
                 break;                  break;
         case NODE_ITEMIZEDLIST:          case NODE_ITEMIZEDLIST:
                 pnode_printlist(p, pn);                  pnode_printlist(f, n);
                 break;                  break;
         case NODE_GROUP:          case NODE_GROUP:
                 pnode_printgroup(p, pn);                  pnode_printgroup(f, n);
                 break;                  break;
         case NODE_KEYSYM:          case NODE_KEYSYM:
                 macro_open(p, "Sy");          case NODE_PRODUCTNAME:
                   macro_open(f, "Sy");
                 break;                  break;
         case NODE_LEGALNOTICE:  
                 macro_line(p, "Sh LEGAL NOTICE");  
                 break;  
         case NODE_LINK:          case NODE_LINK:
                 ccp = pnode_getattr_raw(pn, ATTRKEY_LINKEND, NULL);                  pnode_printlink(f, n);
                 if (ccp == NULL)                  break;
                         break;  
                 macro_argline(p, "Sx", ccp);  
                 return;  
         case NODE_LITERAL:          case NODE_LITERAL:
                 macro_open(p, "Li");                  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;                  break;
         case NODE_LITERALLAYOUT:          case NODE_LITERALLAYOUT:
                 macro_argline(p, "Bd", pnode_getattr(pn, ATTRKEY_CLASS) ==                  macro_close(f);
                   f->parastate = PARA_HAVE;
                   macro_argline(f, "Bd", pnode_getattr(n, ATTRKEY_CLASS) ==
                     ATTRVAL_MONOSPACED ? "-literal" : "-unfilled");                      ATTRVAL_MONOSPACED ? "-literal" : "-unfilled");
                   f->parastate = PARA_HAVE;
                 break;                  break;
           case NODE_MARKUP:
                   macro_open(f, "Ic");
                   break;
         case NODE_MML_MFENCED:          case NODE_MML_MFENCED:
                 pnode_printmathfenced(p, pn);                  pnode_printmathfenced(f, n);
                 break;                  break;
         case NODE_MML_MROW:          case NODE_MML_MROW:
         case NODE_MML_MI:          case NODE_MML_MI:
         case NODE_MML_MN:          case NODE_MML_MN:
         case NODE_MML_MO:          case NODE_MML_MO:
                 if (TAILQ_EMPTY(&pn->childq))                  if (TAILQ_EMPTY(&n->childq))
                         break;                          break;
                 fputs(" { ", stdout);                  fputs(" { ", stdout);
                 break;                  break;
         case NODE_MML_MFRAC:          case NODE_MML_MFRAC:
         case NODE_MML_MSUB:          case NODE_MML_MSUB:
         case NODE_MML_MSUP:          case NODE_MML_MSUP:
                 pnode_printmath(p, pn);                  pnode_printmath(f, n);
                 break;                  break;
           case NODE_OLINK:
                   pnode_printolink(f, n);
                   break;
         case NODE_OPTION:          case NODE_OPTION:
                 macro_open(p, "Fl");                  if ((nc = TAILQ_FIRST(&n->childq)) != NULL &&
                       pnode_class(nc->node) < CLASS_LINE)
                           macro_open(f, "Fl");
                 break;                  break;
         case NODE_ORDEREDLIST:          case NODE_ORDEREDLIST:
                 pnode_printlist(p, pn);                  pnode_printlist(f, n);
                 break;                  break;
         case NODE_PARA:          case NODE_PARA:
                 pnode_printpara(p, pn);                  if (f->parastate == PARA_MID)
                           f->parastate = PARA_WANT;
                 break;                  break;
           case NODE_PARAMDEF:
         case NODE_PARAMETER:          case NODE_PARAMETER:
                 macro_nodeline(p, "Fa", pn, ARG_SINGLE);                  /* More often, these appear inside NODE_FUNCPROTOTYPE. */
                 pnode_unlinksub(pn);                  macro_open(f, "Fa");
                   macro_addnode(f, n, ARG_SPACE | ARG_SINGLE);
                   pnode_unlinksub(n);
                 break;                  break;
         case NODE_QUOTE:          case NODE_QUOTE:
                 macro_open(p, "Qo");                  if ((nc = TAILQ_FIRST(&n->childq)) != NULL &&
                       nc->node == NODE_FILENAME &&
                       TAILQ_NEXT(nc, child) == NULL) {
                           if (n->flags & NFLAG_SPC)
                                   nc->flags |= NFLAG_SPC;
                   } else if (was_impl)
                           macro_open(f, "Do");
                   else {
                           macro_open(f, "Dq");
                           f->flags |= FMT_IMPL;
                   }
                 break;                  break;
         case NODE_PROGRAMLISTING:          case NODE_PROGRAMLISTING:
         case NODE_SCREEN:          case NODE_SCREEN:
                 macro_line(p, "Bd -literal");          case NODE_SYNOPSIS:
                   f->parastate = PARA_HAVE;
                   macro_line(f, "Bd -literal");
                   f->parastate = PARA_HAVE;
                 break;                  break;
         case NODE_REFENTRYINFO:          case NODE_SYSTEMITEM:
                 /* Suppress. */                  pnode_printsystemitem(f, n);
                 pnode_unlinksub(pn);  
                 break;                  break;
         case NODE_REFMETA:          case NODE_REFENTRY:
                 abort();                  pnode_printrefentry(f, n);
                 break;                  break;
         case NODE_REFNAME:          case NODE_REFNAME:
                 /* Suppress non-text children... */                  /* More often, these appear inside NODE_REFNAMEDIV. */
                 macro_open(p, "Nm");                  macro_open(f, "Nm");
                 macro_addnode(p, pn, ARG_SPACE | ARG_SINGLE);  
                 pnode_unlinksub(pn);  
                 break;                  break;
         case NODE_REFNAMEDIV:          case NODE_REFNAMEDIV:
                 macro_line(p, "Sh NAME");                  pnode_printrefnamediv(f, n);
                 break;                  break;
         case NODE_REFPURPOSE:          case NODE_REFPURPOSE:
                 macro_open(p, "Nd");                  macro_open(f, "Nd");
                 break;                  break;
         case NODE_REFSYNOPSISDIV:          case NODE_REFSYNOPSISDIV:
                 pnode_printrefsynopsisdiv(p, pn);                  pnode_printrefsynopsisdiv(f, n);
                 break;                  break;
         case NODE_PREFACE:  
         case NODE_SECTION:          case NODE_SECTION:
           case NODE_SIMPLESECT:
           case NODE_APPENDIX:
         case NODE_NOTE:          case NODE_NOTE:
         case NODE_TIP:                  pnode_printsection(f, n);
         case NODE_CAUTION:  
         case NODE_WARNING:  
                 pnode_printrefsect(p, pn);  
                 break;                  break;
         case NODE_REPLACEABLE:          case NODE_REPLACEABLE:
                 macro_open(p, "Ar");                  macro_open(f, "Ar");
                 break;                  break;
         case NODE_SBR:          case NODE_SBR:
                 macro_line(p, "br");                  if (f->parastate == PARA_MID)
                           macro_line(f, "br");
                 break;                  break;
         case NODE_SGMLTAG:          case NODE_SUBSCRIPT:
                 macro_open(p, "Li");                  if (f->linestate == LINE_MACRO)
                           macro_addarg(f, "_", 0);
                   else
                           print_text(f, "_", 0);
                   if ((nc = TAILQ_FIRST(&n->childq)) != NULL)
                           nc->flags &= ~(NFLAG_LINE | NFLAG_SPC);
                 break;                  break;
         case NODE_STRUCTNAME:          case NODE_SUPERSCRIPT:
                 macro_open(p, "Vt");                  fputs("\\(ha", stdout);
                   if ((nc = TAILQ_FIRST(&n->childq)) != NULL)
                           nc->flags &= ~(NFLAG_LINE | NFLAG_SPC);
                 break;                  break;
         case NODE_TABLE:  
         case NODE_INFORMALTABLE:  
                 pnode_printtable(p, pn);  
                 break;  
         case NODE_TEXT:          case NODE_TEXT:
                 if (pn->bsz == 0) {          case NODE_ESCAPE:
                         assert(pn->real != pn->b);                  pnode_printtext(f, n);
                         break;  
                 }  
                 if (p->linestate == LINE_NEW)  
                         p->linestate = LINE_TEXT;  
                 else  
                         putchar(' ');  
   
                 /*  
                  * Output all characters, squeezing out whitespace  
                  * between newlines.  
                  * XXX: all whitespace, including tabs (?).  
                  * Remember to escape control characters and escapes.  
                  */  
                 cp = pn->b;  
   
                 /*  
                  * There's often a superfluous "-" in its <option> tags  
                  * before the actual flags themselves.  
                  * "Fl" does this for us, so remove it.  
                  */  
                 if (pn->parent != NULL &&  
                     pn->parent->node == NODE_OPTION &&  
                     *cp == '-')  
                         cp++;  
                 for (last = '\n'; *cp != '\0'; ) {  
                         if (last == '\n') {  
                                 /* Consume all whitespace. */  
                                 if (isspace((unsigned char)*cp)) {  
                                         while (isspace((unsigned char)*cp))  
                                                 cp++;  
                                         continue;  
                                 } else if (*cp == '\'' || *cp == '.')  
                                         fputs("\\&", stdout);  
                         }  
                         putchar(last = *cp++);  
                         /* If we're a character escape, escape us. */  
                         if (last == '\\')  
                                 putchar('e');  
                 }  
                 break;                  break;
           case NODE_TGROUP:
                   pnode_printtgroup(f, n);
                   break;
         case NODE_TITLE:          case NODE_TITLE:
                 if (pn->parent->node == NODE_BOOKINFO)          case NODE_SUBTITLE:
                         macro_open(p, "Nd");                  if (f->parastate == PARA_MID)
                           f->parastate = PARA_WANT;
                   macro_nodeline(f, "Sy", n, 0);
                   pnode_unlinksub(n);
                 break;                  break;
         case NODE_TYPE:          case NODE_TYPE:
                 macro_open(p, "Vt");                  macro_open(f, "Vt");
                 break;                  break;
         case NODE_USERINPUT:  
                 macro_open(p, "Li");  
                 break;  
         case NODE_VARIABLELIST:          case NODE_VARIABLELIST:
                 pnode_printvariablelist(p, pn);                  pnode_printvariablelist(f, n);
                 break;                  break;
         case NODE_VARLISTENTRY:  
                 pnode_printvarlistentry(p, pn);  
                 break;  
         case NODE_VARNAME:          case NODE_VARNAME:
                 macro_open(p, "Va");                  macro_open(f, "Va");
                 break;                  break;
           case NODE_VOID:
                   print_text(f, "void", ARG_SPACE);
                   break;
           case NODE_XREF:
                   pnode_printxref(f, n);
                   break;
           case NODE_CAUTION:
           case NODE_LEGALNOTICE:
           case NODE_PREFACE:
           case NODE_TIP:
           case NODE_WARNING:
                   abort();
         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_EMAIL:
                   if (was_impl) {
                           f->flags &= ~FMT_NOSPC;
                           macro_open(f, "Ac");
                   } else
                           f->flags &= ~FMT_IMPL;
                   break;
           case NODE_ESCAPE:
           case NODE_TERM:
           case NODE_TEXT:
                   /* Accept more arguments to the previous macro. */
                   return;
           case NODE_FOOTNOTE:
                   f->parastate = PARA_HAVE;
                   macro_line(f, "Bc");
                   break;
           case NODE_GLOSSTERM:
                   f->parastate = PARA_HAVE;
                   break;
         case NODE_INFORMALEQUATION:          case NODE_INFORMALEQUATION:
                 macro_line(p, "EN");                  macro_line(f, "EN");
                   macro_line(f, "Ed");
                 break;                  break;
         case NODE_INLINEEQUATION:          case NODE_INLINEEQUATION:
                 fputs("$ ", stdout);                  macro_line(f, "EN");
                 p->linestate = sv;  
                 break;                  break;
           case NODE_LITERAL:
                   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;
                   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_MROW:
         case NODE_MML_MI:          case NODE_MML_MI:
         case NODE_MML_MN:          case NODE_MML_MN:
         case NODE_MML_MO:          case NODE_MML_MO:
                 if (TAILQ_EMPTY(&pn->childq))                  if (TAILQ_EMPTY(&n->childq))
                         break;                          break;
                 fputs(" } ", stdout);                  fputs(" } ", stdout);
                 break;                  break;
         case NODE_APPLICATION:          case NODE_PARA:
         case NODE_ARG:                  if (f->parastate == PARA_MID)
         case NODE_AUTHOR:                          f->parastate = PARA_WANT;
         case NODE_CITEREFENTRY:  
         case NODE_CITETITLE:  
         case NODE_CODE:  
         case NODE_COMMAND:  
         case NODE_CONSTANT:  
         case NODE_EDITOR:  
         case NODE_EMAIL:  
         case NODE_EMPHASIS:  
         case NODE_ENVAR:  
         case NODE_FILENAME:  
         case NODE_FIRSTTERM:  
         case NODE_FUNCTION:  
         case NODE_FUNCSYNOPSISINFO:  
         case NODE_KEYSYM:  
         case NODE_LITERAL:  
         case NODE_OPTION:  
         case NODE_PARAMETER:  
         case NODE_REPLACEABLE:  
         case NODE_REFPURPOSE:  
         case NODE_SGMLTAG:  
         case NODE_STRUCTNAME:  
         case NODE_TYPE:  
         case NODE_USERINPUT:  
         case NODE_VARNAME:  
                 if (sv != LINE_MACRO && p->linestate == LINE_MACRO)  
                         macro_closepunct(p, pn);  
                 break;                  break;
         case NODE_QUOTE:          case NODE_QUOTE:
                 if (sv == LINE_NEW)                  if ((nc = TAILQ_FIRST(&n->childq)) != NULL &&
                         macro_close(p);                      nc->node == NODE_FILENAME &&
                 sv = p->linestate;                      TAILQ_NEXT(nc, child) == NULL)
                 macro_open(p, "Qc");                          /* nothing */;
                 if (sv == LINE_NEW)                  else if (was_impl) {
                         macro_close(p);                          f->flags &= ~FMT_NOSPC;
                           macro_open(f, "Dc");
                   } else
                           f->flags &= ~FMT_IMPL;
                 break;                  break;
         case NODE_REFNAME:  
                 /*  
                  * If we're in the NAME macro and we have multiple  
                  * <refname> macros in sequence, then print out a  
                  * trailing comma before the newline.  
                  */  
                 if (pn->parent != NULL &&  
                     pn->parent->node == NODE_REFNAMEDIV &&  
                     TAILQ_NEXT(pn, child) != NULL &&  
                     TAILQ_NEXT(pn, child)->node == NODE_REFNAME)  
                         macro_addarg(p, ",", ARG_SPACE);  
                 if (sv == LINE_NEW)  
                         macro_close(p);  
                 break;  
         case NODE_PREFACE:  
         case NODE_SECTION:          case NODE_SECTION:
           case NODE_SIMPLESECT:
           case NODE_APPENDIX:
         case NODE_NOTE:          case NODE_NOTE:
         case NODE_TIP:                  f->level--;
         case NODE_CAUTION:  
         case NODE_WARNING:  
                 p->level--;  
                 break;                  break;
           case NODE_BLOCKQUOTE:
         case NODE_LITERALLAYOUT:          case NODE_LITERALLAYOUT:
         case NODE_PROGRAMLISTING:          case NODE_PROGRAMLISTING:
         case NODE_SCREEN:          case NODE_SCREEN:
                 macro_line(p, "Ed");          case NODE_SYNOPSIS:
                   f->parastate = PARA_HAVE;
                   macro_line(f, "Ed");
                   f->parastate = PARA_WANT;
                 break;                  break;
         case NODE_TITLE:          case NODE_TITLE:
                 if (pn->parent->node == NODE_BOOKINFO)          case NODE_SUBTITLE:
                         macro_line(p, "Sh AUTHORS");                  f->parastate = PARA_WANT;
                 break;                  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.fname = fn;          formatter.parastate = PARA_HAVE;
         p.xml = xp;          pnode_printprologue(&formatter, tree->root);
           pnode_print(&formatter, tree->root);
         XML_SetCharacterDataHandler(xp, xml_char);          if (formatter.linestate != LINE_NEW)
         XML_SetElementHandler(xp, xml_elem_start, xml_elem_end);                  putchar('\n');
         XML_SetUserData(xp, &p);  
   
         while ((ssz = read(fd, b, bsz)) >= 0) {  
                 if ((rc = XML_Parse(xp, b, ssz, 0 == ssz)) == 0)  
                         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.linestate = LINE_NEW;  
                 pnode_printprologue(&p, p.root);  
                 pnode_print(&p, p.root);  
                 if (p.linestate != LINE_NEW)  
                         putchar('\n');  
                 pnode_free(p.root);  
                 return rc != 0 && p.stop == 0;  
         }  
   
         /* Read error has occured. */  
         perror(fn);  
         pnode_free(p.root);  
         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 = 1;  
   
         while ((ch = getopt(argc, argv, "W")) != -1)  
                 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 = strcmp(fname, "-") == 0 ?  
                 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 (fd == -1)  
                 perror(fname);  
         else if ((buf = malloc(4096)) == NULL)  
                 perror(NULL);  
         else if ((xp = XML_ParserCreate(NULL)) == NULL)  
                 perror(NULL);  
         else if (readfile(xp, fd, buf, 4096, fname))  
                 rc = 0;  
   
         XML_ParserFree(xp);  
         free(buf);  
         if (fd != STDIN_FILENO)  
                 close(fd);  
         return rc;  
   
 usage:  
         fprintf(stderr, "usage: %s [-W] [input_filename]\n", progname);  
         return 1;  
 }  }
Legend:
Removed from v.1.72  
changed lines
  Added in v.1.142
CVSweb