]> git.cameronkatri.com Git - mandoc.git/blobdiff - term.c
-inset and -diag lists now supported.
[mandoc.git] / term.c
diff --git a/term.c b/term.c
index c5f0edb57615579d0f77c6758e81cf57ccf88be5..1d552adfa5c0b42fa8385824b745c5718c3b4f49 100644 (file)
--- a/term.c
+++ b/term.c
@@ -1,6 +1,6 @@
-/* $Id: term.c,v 1.3 2009/02/21 14:56:58 kristaps Exp $ */
+/* $Id: term.c,v 1.37 2009/03/03 22:17:19 kristaps Exp $ */
 /*
- * Copyright (c) 2008 Kristaps Dzonsons <kristaps@kth.se>
+ * Copyright (c) 2009 Kristaps Dzonsons <kristaps@kth.se>
  *
  * Permission to use, copy, modify, and distribute this software for any
  * purpose with or without fee is hereby granted, provided that the
  */
 #include <assert.h>
 #include <ctype.h>
-#include <curses.h>
 #include <err.h>
-#include <stdlib.h>
 #include <stdio.h>
+#include <stdlib.h>
 #include <string.h>
-#include <term.h>
-#include <unistd.h>
 
-#include "private.h"
+#include "term.h"
 
-enum   termesc {
-       ESC_CLEAR,
-       ESC_BOLD,
-       ESC_UNDERLINE
-};
+/*
+ * Performs actions on nodes of the abstract syntax tree.  Both pre- and
+ * post-fix operations are defined here.
+ */
 
-struct termp {
-       size_t            rmargin;
-       size_t            maxrmargin;
-       size_t            maxcols;
-       size_t            offset;
-       size_t            col;
-       int               flags;
-#define        TERMP_BOLD       (1 << 0)       /* Embolden words. */
-#define        TERMP_UNDERLINE  (1 << 1)       /* Underline words. */
-#define        TERMP_NOSPACE    (1 << 2)       /* No space before words. */
-#define        TERMP_NOLPAD     (1 << 3)       /* No left-padding. */
-#define        TERMP_NOBREAK    (1 << 4)       /* No break after line */
-       char             *buf;
-};
+/* FIXME: macro arguments can be escaped. */
+
+#define        TTYPE_PROG        0
+#define        TTYPE_CMD_FLAG    1
+#define        TTYPE_CMD_ARG     2
+#define        TTYPE_SECTION     3
+#define        TTYPE_FUNC_DECL   4
+#define        TTYPE_VAR_DECL    5
+#define        TTYPE_FUNC_TYPE   6
+#define        TTYPE_FUNC_NAME   7
+#define        TTYPE_FUNC_ARG    8
+#define        TTYPE_LINK        9
+#define        TTYPE_SSECTION    10
+#define        TTYPE_FILE        11
+#define        TTYPE_EMPH        12
+#define        TTYPE_CONFIG      13
+#define        TTYPE_CMD         14
+#define        TTYPE_INCLUDE     15
+#define        TTYPE_SYMB        16
+#define        TTYPE_SYMBOL      17
+#define        TTYPE_DIAG        18
+#define        TTYPE_NMAX        19
+
+/* 
+ * These define "styles" for element types, like command arguments or
+ * executable names.  This is useful when multiple macros must decorate
+ * the same thing (like .Ex -std cmd and .Nm cmd). 
+ */
 
-struct termact {
-       int             (*pre)(struct termp *,
-                               const struct mdoc_meta *,
-                               const struct mdoc_node *);
-       int             (*post)(struct termp *,
-                               const struct mdoc_meta *,
-                               const struct mdoc_node *);
+/* TODO: abstract this into mdocterm.c. */
+
+const  int ttypes[TTYPE_NMAX] = {
+       TERMP_BOLD,             /* TTYPE_PROG */
+       TERMP_BOLD,             /* TTYPE_CMD_FLAG */
+       TERMP_UNDERLINE,        /* TTYPE_CMD_ARG */
+       TERMP_BOLD,             /* TTYPE_SECTION */
+       TERMP_BOLD,             /* TTYPE_FUNC_DECL */
+       TERMP_UNDERLINE,        /* TTYPE_VAR_DECL */
+       TERMP_UNDERLINE,        /* TTYPE_FUNC_TYPE */
+       TERMP_BOLD,             /* TTYPE_FUNC_NAME */
+       TERMP_UNDERLINE,        /* TTYPE_FUNC_ARG */
+       TERMP_UNDERLINE,        /* TTYPE_LINK */
+       TERMP_BOLD,             /* TTYPE_SSECTION */
+       TERMP_UNDERLINE,        /* TTYPE_FILE */
+       TERMP_UNDERLINE,        /* TTYPE_EMPH */
+       TERMP_BOLD,             /* TTYPE_CONFIG */
+       TERMP_BOLD,             /* TTYPE_CMD */
+       TERMP_BOLD,             /* TTYPE_INCLUDE */
+       TERMP_BOLD,             /* TTYPE_SYMB */
+       TERMP_BOLD,             /* TTYPE_SYMBOL */
+       TERMP_BOLD              /* TTYPE_DIAG */
 };
 
-static void              termprint_r(struct termp *,
-                               const struct mdoc_meta *,
-                               const struct mdoc_node *);
-static void              termprint_header(struct termp *,
-                               const struct mdoc_meta *);
-static void              termprint_footer(struct termp *,
-                               const struct mdoc_meta *);
-
 static int               arg_hasattr(int, size_t, 
                                const struct mdoc_arg *);
 static int               arg_getattr(int, size_t, 
                                const struct mdoc_arg *);
+static size_t            arg_offset(const struct mdoc_arg *);
+static size_t            arg_width(const struct mdoc_arg *);
 
-static void              newln(struct termp *);
-static void              vspace(struct termp *);
-static void              pword(struct termp *, const char *, size_t);
-static void              word(struct termp *, const char *);
-
-#define        decl_prepost(name, suffix) \
-static int               name##_##suffix(struct termp *, \
-                               const struct mdoc_meta *, \
-                               const struct mdoc_node *)
-
-#define        decl_pre(name)    decl_prepost(name, pre)
-#define        decl_post(name)   decl_prepost(name, post)
-
-decl_pre(termp_fl);
-decl_pre(termp_it);
-decl_pre(termp_nd);
-decl_pre(termp_ns);
-decl_pre(termp_op);
-decl_pre(termp_pp);
-decl_pre(termp_sh);
-
-decl_post(termp_bl);
-decl_post(termp_it);
-decl_post(termp_op);
-decl_post(termp_sh);
-
-decl_pre(termp_bold);
-decl_pre(termp_under);
-
-decl_post(termp_bold);
-decl_post(termp_under);
+/*
+ * What follows describes prefix and postfix operations for the abstract
+ * syntax tree descent.
+ */
 
-const  struct termact termacts[MDOC_MAX] = {
+#define        DECL_ARGS \
+       struct termp *p, \
+       struct termpair *pair, \
+       const struct mdoc_meta *meta, \
+       const struct mdoc_node *node
+
+#define        DECL_PRE(name) \
+static int               name##_pre(DECL_ARGS)
+#define        DECL_POST(name) \
+static void              name##_post(DECL_ARGS)
+#define        DECL_PREPOST(name) \
+DECL_PRE(name); \
+DECL_POST(name);
+
+DECL_PREPOST(termp__t);
+DECL_PREPOST(termp_aq);
+DECL_PREPOST(termp_bd);
+DECL_PREPOST(termp_bq);
+DECL_PREPOST(termp_d1);
+DECL_PREPOST(termp_dq);
+DECL_PREPOST(termp_fd);
+DECL_PREPOST(termp_fn);
+DECL_PREPOST(termp_fo);
+DECL_PREPOST(termp_ft);
+DECL_PREPOST(termp_in);
+DECL_PREPOST(termp_it);
+DECL_PREPOST(termp_op);
+DECL_PREPOST(termp_pf);
+DECL_PREPOST(termp_pq);
+DECL_PREPOST(termp_qq);
+DECL_PREPOST(termp_sh);
+DECL_PREPOST(termp_ss);
+DECL_PREPOST(termp_sq);
+DECL_PREPOST(termp_vt);
+
+DECL_PRE(termp_ar);
+DECL_PRE(termp_at);
+DECL_PRE(termp_bf);
+DECL_PRE(termp_bsx);
+DECL_PRE(termp_bt);
+DECL_PRE(termp_cd);
+DECL_PRE(termp_cm);
+DECL_PRE(termp_em);
+DECL_PRE(termp_ex);
+DECL_PRE(termp_fa);
+DECL_PRE(termp_fl);
+DECL_PRE(termp_fx);
+DECL_PRE(termp_ic);
+DECL_PRE(termp_ms);
+DECL_PRE(termp_nd);
+DECL_PRE(termp_nm);
+DECL_PRE(termp_ns);
+DECL_PRE(termp_nx);
+DECL_PRE(termp_ox);
+DECL_PRE(termp_pa);
+DECL_PRE(termp_pp);
+DECL_PRE(termp_rs);
+DECL_PRE(termp_rv);
+DECL_PRE(termp_sm);
+DECL_PRE(termp_st);
+DECL_PRE(termp_sx);
+DECL_PRE(termp_sy);
+DECL_PRE(termp_ud);
+DECL_PRE(termp_ux);
+DECL_PRE(termp_va);
+DECL_PRE(termp_xr);
+
+DECL_POST(termp___);
+DECL_POST(termp_bl);
+DECL_POST(termp_bx);
+
+const  struct termact __termacts[MDOC_MAX] = {
        { NULL, NULL }, /* \" */
        { NULL, NULL }, /* Dd */
        { NULL, NULL }, /* Dt */
        { NULL, NULL }, /* Os */
        { termp_sh_pre, termp_sh_post }, /* Sh */
-       { NULL, NULL }, /* Ss */ 
+       { termp_ss_pre, termp_ss_post }, /* Ss */ 
        { termp_pp_pre, NULL }, /* Pp */ 
-       { NULL, NULL }, /* D1 */
-       { NULL, NULL }, /* Dl */
-       { NULL, NULL }, /* Bd */
+       { termp_d1_pre, termp_d1_post }, /* D1 */
+       { termp_d1_pre, termp_d1_post }, /* Dl */
+       { termp_bd_pre, termp_bd_post }, /* Bd */
        { NULL, NULL }, /* Ed */
        { NULL, termp_bl_post }, /* Bl */
        { NULL, NULL }, /* El */
        { termp_it_pre, termp_it_post }, /* It */
        { NULL, NULL }, /* Ad */ 
        { NULL, NULL }, /* An */
-       { termp_under_pre, termp_under_post }, /* Ar */
-       { NULL, NULL }, /* Cd */
-       { NULL, NULL }, /* Cm */
+       { termp_ar_pre, NULL }, /* Ar */
+       { termp_cd_pre, NULL }, /* Cd */
+       { termp_cm_pre, NULL }, /* Cm */
        { NULL, NULL }, /* Dv */ 
        { NULL, NULL }, /* Er */ 
        { NULL, NULL }, /* Ev */ 
-       { NULL, NULL }, /* Ex */
-       { NULL, NULL }, /* Fa */ 
-       { NULL, NULL }, /* Fd */ 
-       { termp_fl_pre, termp_bold_post }, /* Fl */
-       { NULL, NULL }, /* Fn */ 
-       { NULL, NULL }, /* Ft */ 
-       { NULL, NULL }, /* Ic */ 
-       { NULL, NULL }, /* In */ 
+       { termp_ex_pre, NULL }, /* Ex */
+       { termp_fa_pre, NULL }, /* Fa */ 
+       { termp_fd_pre, termp_fd_post }, /* Fd */ 
+       { termp_fl_pre, NULL }, /* Fl */
+       { termp_fn_pre, termp_fn_post }, /* Fn */ 
+       { termp_ft_pre, termp_ft_post }, /* Ft */ 
+       { termp_ic_pre, NULL }, /* Ic */ 
+       { termp_in_pre, termp_in_post }, /* In */ 
        { NULL, NULL }, /* Li */
        { termp_nd_pre, NULL }, /* Nd */ 
-       { termp_bold_pre, termp_bold_post }, /* Nm */ 
+       { termp_nm_pre, NULL }, /* Nm */ 
        { termp_op_pre, termp_op_post }, /* Op */
        { NULL, NULL }, /* Ot */
-       { NULL, NULL }, /* Pa */
-       { NULL, NULL }, /* Rv */
-       { NULL, NULL }, /* St */ 
-       { NULL, NULL }, /* Va */
-       { NULL, NULL }, /* Vt */ 
-       { NULL, NULL }, /* Xr */
-       { NULL, NULL }, /* %A */
-       { NULL, NULL }, /* %B */
-       { NULL, NULL }, /* %D */
-       { NULL, NULL }, /* %I */
-       { NULL, NULL }, /* %J */
-       { NULL, NULL }, /* %N */
-       { NULL, NULL }, /* %O */
-       { NULL, NULL }, /* %P */
-       { NULL, NULL }, /* %R */
-       { NULL, NULL }, /* %T */
-       { NULL, NULL }, /* %V */
+       { termp_pa_pre, NULL }, /* Pa */
+       { termp_rv_pre, NULL }, /* Rv */
+       { termp_st_pre, NULL }, /* St */ 
+       { termp_va_pre, NULL }, /* Va */
+       { termp_vt_pre, termp_vt_post }, /* Vt */ 
+       { termp_xr_pre, NULL }, /* Xr */
+       { NULL, termp____post }, /* %A */
+       { NULL, termp____post }, /* %B */
+       { NULL, termp____post }, /* %D */
+       { NULL, termp____post }, /* %I */
+       { NULL, termp____post }, /* %J */
+       { NULL, termp____post }, /* %N */
+       { NULL, termp____post }, /* %O */
+       { NULL, termp____post }, /* %P */
+       { NULL, termp____post }, /* %R */
+       { termp__t_pre, termp__t_post }, /* %T */
+       { NULL, termp____post }, /* %V */
        { NULL, NULL }, /* Ac */
-       { NULL, NULL }, /* Ao */
-       { NULL, NULL }, /* Aq */
-       { NULL, NULL }, /* At */
+       { termp_aq_pre, termp_aq_post }, /* Ao */
+       { termp_aq_pre, termp_aq_post }, /* Aq */
+       { termp_at_pre, NULL }, /* At */
        { NULL, NULL }, /* Bc */
-       { NULL, NULL }, /* Bf */ 
-       { NULL, NULL }, /* Bo */
-       { NULL, NULL }, /* Bq */
-       { NULL, NULL }, /* Bsx */
-       { NULL, NULL }, /* Bx */
+       { termp_bf_pre, NULL }, /* Bf */ 
+       { termp_bq_pre, termp_bq_post }, /* Bo */
+       { termp_bq_pre, termp_bq_post }, /* Bq */
+       { termp_bsx_pre, NULL }, /* Bsx */
+       { NULL, termp_bx_post }, /* Bx */
        { NULL, NULL }, /* Db */
        { NULL, NULL }, /* Dc */
-       { NULL, NULL }, /* Do */
-       { NULL, NULL }, /* Dq */
+       { termp_dq_pre, termp_dq_post }, /* Do */
+       { termp_dq_pre, termp_dq_post }, /* Dq */
        { NULL, NULL }, /* Ec */
        { NULL, NULL }, /* Ef */
-       { NULL, NULL }, /* Em */ 
+       { termp_em_pre, NULL }, /* Em */ 
        { NULL, NULL }, /* Eo */
-       { NULL, NULL }, /* Fx */
-       { NULL, NULL }, /* Ms */
+       { termp_fx_pre, NULL }, /* Fx */
+       { termp_ms_pre, NULL }, /* Ms */
        { NULL, NULL }, /* No */
        { termp_ns_pre, NULL }, /* Ns */
-       { NULL, NULL }, /* Nx */
-       { NULL, NULL }, /* Ox */
+       { termp_nx_pre, NULL }, /* Nx */
+       { termp_ox_pre, NULL }, /* Ox */
        { NULL, NULL }, /* Pc */
-       { NULL, NULL }, /* Pf */
-       { NULL, NULL }, /* Po */
-       { NULL, NULL }, /* Pq */
+       { termp_pf_pre, termp_pf_post }, /* Pf */
+       { termp_pq_pre, termp_pq_post }, /* Po */
+       { termp_pq_pre, termp_pq_post }, /* Pq */
        { NULL, NULL }, /* Qc */
-       { NULL, NULL }, /* Ql */
-       { NULL, NULL }, /* Qo */
-       { NULL, NULL }, /* Qq */
+       { termp_sq_pre, termp_sq_post }, /* Ql */
+       { termp_qq_pre, termp_qq_post }, /* Qo */
+       { termp_qq_pre, termp_qq_post }, /* Qq */
        { NULL, NULL }, /* Re */
-       { NULL, NULL }, /* Rs */
+       { termp_rs_pre, NULL }, /* Rs */
        { NULL, NULL }, /* Sc */
-       { NULL, NULL }, /* So */
-       { NULL, NULL }, /* Sq */
-       { NULL, NULL }, /* Sm */
-       { NULL, NULL }, /* Sx */
-       { NULL, NULL }, /* Sy */
+       { termp_sq_pre, termp_sq_post }, /* So */
+       { termp_sq_pre, termp_sq_post }, /* Sq */
+       { termp_sm_pre, NULL }, /* Sm */
+       { termp_sx_pre, NULL }, /* Sx */
+       { termp_sy_pre, NULL }, /* Sy */
        { NULL, NULL }, /* Tn */
-       { NULL, NULL }, /* Ux */
+       { termp_ux_pre, NULL }, /* Ux */
        { NULL, NULL }, /* Xc */
        { NULL, NULL }, /* Xo */
-       { NULL, NULL }, /* Fo */ 
+       { termp_fo_pre, termp_fo_post }, /* Fo */ 
        { NULL, NULL }, /* Fc */ 
-       { NULL, NULL }, /* Oo */
+       { termp_op_pre, termp_op_post }, /* Oo */
        { NULL, NULL }, /* Oc */
        { NULL, NULL }, /* Bk */
        { NULL, NULL }, /* Ek */
-       { NULL, NULL }, /* Bt */
+       { termp_bt_pre, NULL }, /* Bt */
        { NULL, NULL }, /* Hf */
        { NULL, NULL }, /* Fr */
-       { NULL, NULL }, /* Ud */
+       { termp_ud_pre, NULL }, /* Ud */
 };
 
-
-static int
-arg_hasattr(int arg, size_t argc, const struct mdoc_arg *argv)
-{
-
-       return(-1 != arg_getattr(arg, argc, argv));
-}
-
-
-static int
-arg_getattr(int arg, size_t argc, const struct mdoc_arg *argv)
-{
-       int              i;
-
-       for (i = 0; i < (int)argc; i++) 
-               if (argv[i].arg == arg)
-                       return(i);
-       return(-1);
-}
+const struct termact *termacts = __termacts;
 
 
-static void
-flushln(struct termp *p)
+static size_t
+arg_width(const struct mdoc_arg *arg)
 {
-       size_t           i, j, vsz, vis, maxvis;
+       size_t           v;
+       int              i, len;
 
-       /*
-        * First, establish the maximum columns of "visible" content.
-        * This is usually the difference between the right-margin and
-        * an indentation, but can be, for tagged lists or columns, a
-        * small set of values.
-        */
+       assert(*arg->value);
+       if (0 == strcmp(*arg->value, "indent"))
+               return(INDENT);
+       if (0 == strcmp(*arg->value, "indent-two"))
+               return(INDENT * 2);
 
-       assert(p->offset < p->rmargin);
-       maxvis = p->rmargin - p->offset;
-       vis = 0;
+       len = (int)strlen(*arg->value);
+       assert(len > 0);
 
-       /*
-        * If in the standard case (left-justified), then begin with our
-        * indentation, otherwise (columns, etc.) just start spitting
-        * out text.
-        */
+       for (i = 0; i < len - 1; i++) 
+               if ( ! isdigit((int)(*arg->value)[i]))
+                       break;
 
-       if ( ! (p->flags & TERMP_NOLPAD))
-               /* LINTED */
-               for (j = 0; j < p->offset; j++)
-                       putchar(' ');
-
-       for (i = 0; i < p->col; i++) {
-               /*
-                * Count up visible word characters.  Control sequences
-                * (starting with the CSI) aren't counted. 
-                */
-               assert( ! isspace(p->buf[i]));
-
-               /* LINTED */
-               for (j = i, vsz = 0; j < p->col; j++) {
-                       if (isspace(p->buf[j]))
-                               break;
-                       else if (27 == p->buf[j]) {
-                               assert(j + 4 <= p->col);
-                               j += 3;
-                       } else
-                               vsz++;
+       if (i == len - 1) {
+               if ('n' == (*arg->value)[len - 1]) {
+                       v = (size_t)atoi(*arg->value);
+                       return(v);
                }
-               assert(vsz > 0);
-
-               /*
-                * If a word is too long and we're within a line, put it
-                * on the next line.  Puke if we're being asked to write
-                * something that will exceed the right margin (i.e.,
-                * from a fresh line or when we're not allowed to break
-                * the line with TERMP_NOBREAK).
-                */
-
-               if (vis && vis + vsz >= maxvis) {
-                       /* FIXME */
-                       if (p->flags & TERMP_NOBREAK)
-                               errx(1, "word breaks right margin");
-                       putchar('\n');
-                       for (j = 0; j < p->offset; j++)
-                               putchar(' ');
-                       vis = 0;
-               } else if (vis + vsz >= maxvis) {
-                       /* FIXME */
-                       errx(1, "word breaks right margin");
-               }
-
-               /* 
-                * Write out the word and a trailing space.  Omit the
-                * space if we're the last word in the line.
-                */
 
-               for ( ; i < p->col; i++) {
-                       if (isspace(p->buf[i]))
-                               break;
-                       putchar(p->buf[i]);
-               }
-               vis += vsz;
-               if (i < p->col) {
-                       putchar(' ');
-                       vis++;
-               }
        }
-
-       /*
-        * If we're not to right-marginalise it (newline), then instead
-        * pad to the right margin and stay off.
-        */
-
-       if (p->flags & TERMP_NOBREAK) {
-               for ( ; vis <= maxvis; vis++)
-                       putchar(' ');
-       } else
-               putchar('\n');
-
-       p->col = 0;
+       return(strlen(*arg->value) + 1);
 }
 
 
-static void
-newln(struct termp *p)
-{
-
-       /* 
-        * A newline only breaks an existing line; it won't assert
-        * vertical space.
-        */
-       p->flags |= TERMP_NOSPACE;
-       if (0 == p->col) 
-               return;
-       flushln(p);
-}
-
-
-static void
-vspace(struct termp *p)
+static size_t
+arg_offset(const struct mdoc_arg *arg)
 {
 
-       /*
-        * Asserts a vertical space (a full, empty line-break between
-        * lines).
-        */
-       newln(p);
-       putchar('\n');
+       /* TODO */
+       assert(*arg->value);
+       if (0 == strcmp(*arg->value, "indent"))
+               return(INDENT);
+       if (0 == strcmp(*arg->value, "indent-two"))
+               return(INDENT * 2);
+       return(strlen(*arg->value));
 }
 
 
-static void
-chara(struct termp *p, char c)
+static int
+arg_hasattr(int arg, size_t argc, const struct mdoc_arg *argv)
 {
 
-       /* TODO: dynamically expand the buffer. */
-       if (p->col + 1 >= p->maxcols)
-               errx(1, "line overrun");
-       p->buf[(p->col)++] = c;
+       return(-1 != arg_getattr(arg, argc, argv));
 }
 
 
-static void
-escape(struct termp *p, enum termesc esc)
+static int
+arg_getattr(int arg, size_t argc, const struct mdoc_arg *argv)
 {
+       int              i;
 
-       if (p->col + 4 >= p->maxcols)
-               errx(1, "line overrun");
-
-       p->buf[(p->col)++] = 27;
-       p->buf[(p->col)++] = '[';
-       switch (esc) {
-       case (ESC_CLEAR):
-               p->buf[(p->col)++] = '0';
-               break;
-       case (ESC_BOLD):
-               p->buf[(p->col)++] = '1';
-               break;
-       case (ESC_UNDERLINE):
-               p->buf[(p->col)++] = '4';
-               break;
-       default:
-               abort();
-               /* NOTREACHED */
-       }
-       p->buf[(p->col)++] = 'm';
+       for (i = 0; i < (int)argc; i++) 
+               if (argv[i].arg == arg)
+                       return(i);
+       return(-1);
 }
 
 
-static void
-pword(struct termp *p, const char *word, size_t len)
+/* ARGSUSED */
+static int
+termp_dq_pre(DECL_ARGS)
 {
-       size_t           i;
-
-       assert(len > 0);
-
-       if ( ! (p->flags & TERMP_NOSPACE))
-               chara(p, ' ');
-
-       p->flags &= ~TERMP_NOSPACE;
-
-       if (p->flags & TERMP_BOLD)
-               escape(p, ESC_BOLD);
-       if (p->flags & TERMP_UNDERLINE)
-               escape(p, ESC_UNDERLINE);
-
-       /* TODO: escape patterns. */
 
-       for (i = 0; i < len; i++) 
-               chara(p, word[i]);
+       if (MDOC_BODY != node->type)
+               return(1);
 
-       if (p->flags & TERMP_BOLD ||
-                       p->flags & TERMP_UNDERLINE)
-               escape(p, ESC_CLEAR);
+       word(p, "``");
+       p->flags |= TERMP_NOSPACE;
+       return(1);
 }
 
 
+/* ARGSUSED */
 static void
-word(struct termp *p, const char *word)
+termp_dq_post(DECL_ARGS)
 {
-       size_t           i, j, len;
 
-       if (mdoc_isdelim(word))
-               p->flags |= TERMP_NOSPACE;
-
-       len = strlen(word);
-       assert(len > 0);
+       if (MDOC_BODY != node->type)
+               return;
 
-       /* LINTED */
-       for (j = i = 0; i < len; i++) {
-               if ( ! isspace(word[i])) {
-                       j++;
-                       continue;
-               }
-               if (0 == j)
-                       continue;
-               assert(i >= j);
-               pword(p, &word[i - j], j);
-               j = 0;
-       }
-       if (j > 0) {
-               assert(i >= j);
-               pword(p, &word[i - j], j);
-       }
+       p->flags |= TERMP_NOSPACE;
+       word(p, "''");
 }
 
 
 /* ARGSUSED */
 static int
-termp_it_post(struct termp *p, const struct mdoc_meta *meta,
-               const struct mdoc_node *node)
+termp_it_pre(DECL_ARGS)
 {
        const struct mdoc_node *n, *it;
        const struct mdoc_block *bl;
-       int              i;
-       size_t           width;
+       char             buf[7], *tp;
+       int              i, type;
+       size_t           width, offset;
 
        switch (node->type) {
        case (MDOC_BODY):
                /* FALLTHROUGH */
        case (MDOC_HEAD):
+               it = node->parent;
+               break;
+       case (MDOC_BLOCK):
+               it = node;
                break;
        default:
                return(1);
        }
 
-       it = node->parent;
-       assert(MDOC_BLOCK == it->type);
-       assert(MDOC_It == it->tok);
-
-       n = it->parent;
-       assert(MDOC_BODY == n->type);
-       assert(MDOC_Bl == n->tok);
-       n = n->parent;
+       n = it->parent->parent;
        bl = &n->data.block;
 
-       /* If `-tag', adjust our margins accordingly. */
+       if (MDOC_BLOCK == node->type) {
+               newln(p);
+               if ( ! arg_hasattr(MDOC_Compact, bl->argc, bl->argv))
+                       if (node->prev || n->prev)
+                               vspace(p);
+               return(1);
+       }
 
-       if (arg_hasattr(MDOC_Tag, bl->argc, bl->argv)) {
-               i = arg_getattr(MDOC_Width, bl->argc, bl->argv);
-               assert(i >= 0);
-               assert(1 == bl->argv[i].sz);
-               width = strlen(*bl->argv[i].value); /* XXX */
+       /* Get our list type. */
 
-               if (MDOC_HEAD == node->type) {
-                       flushln(p);
-                       /* FIXME: nested lists. */
-                       p->rmargin = p->maxrmargin;
-                       p->flags &= ~TERMP_NOBREAK;
-               } else {
-                       flushln(p);
-                       p->offset -= width + 1;
-                       p->flags &= ~TERMP_NOLPAD;
+       for (type = -1, i = 0; i < (int)bl->argc; i++) 
+               switch (bl->argv[i].arg) {
+               case (MDOC_Bullet):
+                       /* FALLTHROUGH */
+               case (MDOC_Dash):
+                       /* FALLTHROUGH */
+               case (MDOC_Enum):
+                       /* FALLTHROUGH */
+               case (MDOC_Hyphen):
+                       /* FALLTHROUGH */
+               case (MDOC_Tag):
+                       /* FALLTHROUGH */
+               case (MDOC_Inset):
+                       /* FALLTHROUGH */
+               case (MDOC_Diag):
+                       /* FALLTHROUGH */
+               case (MDOC_Ohang):
+                       type = bl->argv[i].arg;
+                       i = (int)bl->argc;
+                       break;
+               default:
+                       errx(1, "list type not supported");
+                       /* NOTREACHED */
                }
-       }
 
-       return(1);
-}
+       assert(-1 != type);
 
+       /* Save our existing (inherited) margin and offset. */
 
-/* ARGSUSED */
-static int
-termp_it_pre(struct termp *p, const struct mdoc_meta *meta,
-               const struct mdoc_node *node)
-{
-       const struct mdoc_node *n, *it;
-       const struct mdoc_block *bl;
-       int              i;
-       size_t           width;
+       pair->offset = p->offset;
+       pair->rmargin = p->rmargin;
 
-       switch (node->type) {
-       case (MDOC_BODY):
+       /* Get list width and offset. */
+
+       i = arg_getattr(MDOC_Width, bl->argc, bl->argv);
+       width = i >= 0 ? arg_width(&bl->argv[i]) : 0;
+
+       i = arg_getattr(MDOC_Offset, bl->argc, bl->argv);
+       offset = i >= 0 ? arg_offset(&bl->argv[i]) : 0;
+
+       /* Override the width. */
+
+       switch (type) {
+       case (MDOC_Bullet):
                /* FALLTHROUGH */
-       case (MDOC_HEAD):
-               it = node->parent;
+       case (MDOC_Dash):
+               /* FALLTHROUGH */
+       case (MDOC_Enum):
+               /* FALLTHROUGH */
+       case (MDOC_Hyphen):
+               width = width > 6 ? width : 6;
                break;
-       case (MDOC_BLOCK):
-               it = node;
+       case (MDOC_Tag):
+               if (0 == width)
+                       errx(1, "need non-zero -width");
                break;
        default:
-               return(1);
+               break;
        }
 
-       assert(MDOC_BLOCK == it->type);
-       assert(MDOC_It == it->tok);
+       /* Word-wrap control. */
 
-       n = it->parent;
-       assert(MDOC_BODY == n->type);
-       assert(MDOC_Bl == n->tok);
-       n = n->parent;
-       bl = &n->data.block;
+       switch (type) {
+       case (MDOC_Diag):
+               if (MDOC_HEAD == node->type)
+                       TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_DIAG]);
+               /* FALLTHROUGH */
+       case (MDOC_Inset):
+               if (MDOC_HEAD == node->type)
+                       p->flags |= TERMP_NOSPACE;
+               break;
+       case (MDOC_Bullet):
+               /* FALLTHROUGH */
+       case (MDOC_Dash):
+               /* FALLTHROUGH */
+       case (MDOC_Enum):
+               /* FALLTHROUGH */
+       case (MDOC_Hyphen):
+               /* FALLTHROUGH */
+       case (MDOC_Tag):
+               p->flags |= TERMP_NOSPACE;
+               if (MDOC_HEAD == node->type)
+                       p->flags |= TERMP_NOBREAK;
+               else if (MDOC_BODY == node->type)
+                       p->flags |= TERMP_NOLPAD;
+               break;
+       default:
+               break;
+       }
 
-       /* If `-compact', don't assert vertical space. */
+       /* 
+        * Get a token to use as the HEAD lead-in.  If NULL, we use the
+        * HEAD child. 
+        */
 
-       if (MDOC_BLOCK == node->type) {
-               if (arg_hasattr(MDOC_Compact, bl->argc, bl->argv))
-                       newln(p);
-               else
-                       vspace(p);
-               return(1);
+       tp = NULL;
+
+       if (MDOC_HEAD == node->type) {
+               if (arg_hasattr(MDOC_Bullet, bl->argc, bl->argv))
+                       tp = "\\[bu]";
+               if (arg_hasattr(MDOC_Dash, bl->argc, bl->argv))
+                       tp = "\\-";
+               if (arg_hasattr(MDOC_Enum, bl->argc, bl->argv)) {
+                       (pair->ppair->ppair->count)++;
+                       (void)snprintf(buf, sizeof(buf), "%d.", 
+                                       pair->ppair->ppair->count);
+                       tp = buf;
+               }
+               if (arg_hasattr(MDOC_Hyphen, bl->argc, bl->argv))
+                       tp = "\\-";
        }
 
-       assert(MDOC_HEAD == node->type 
-                       || MDOC_BODY == node->type);
+       /* Margin control. */
 
-       /* If `-tag', adjust our margins accordingly. */
+       p->offset += offset;
 
-       if (arg_hasattr(MDOC_Tag, bl->argc, bl->argv)) {
-               i = arg_getattr(MDOC_Width, bl->argc, bl->argv);
-               assert(i >= 0); /* XXX */
-               assert(1 == bl->argv[i].sz);
-               width = strlen(*bl->argv[i].value); /* XXX */
+       switch (type) {
+       case (MDOC_Bullet):
+               /* FALLTHROUGH */
+       case (MDOC_Dash):
+               /* FALLTHROUGH */
+       case (MDOC_Enum):
+               /* FALLTHROUGH */
+       case (MDOC_Hyphen):
+               /* FALLTHROUGH */
+       case (MDOC_Tag):
+               if (MDOC_HEAD == node->type)
+                       p->rmargin = p->offset + width;
+               else if (MDOC_BODY == node->type) 
+                       p->offset += width;
+               break;
+       default:
+               break;
+       }
 
-               /* FIXME: nested lists. */
+       if (NULL == tp)
+               return(1);
 
-               if (MDOC_HEAD == node->type) {
-                       p->flags |= TERMP_NOBREAK;
-                       p->flags |= TERMP_NOSPACE;
-                       p->rmargin = p->offset + width;
-               } else {
-                       p->flags |= TERMP_NOSPACE;
-                       p->flags |= TERMP_NOLPAD;
-                       p->offset += width + 1;
+       word(p, tp);
+       return(0);
+}
+
+
+/* ARGSUSED */
+static void
+termp_it_post(DECL_ARGS)
+{
+       int                type, i;
+       struct mdoc_block *bl;
+
+       if (MDOC_BODY != node->type && MDOC_HEAD != node->type)
+               return;
+
+       assert(MDOC_BLOCK == node->parent->parent->parent->type);
+       assert(MDOC_Bl == node->parent->parent->parent->tok);
+       bl = &node->parent->parent->parent->data.block;
+
+       for (type = -1, i = 0; i < (int)bl->argc; i++) 
+               switch (bl->argv[i].arg) {
+               case (MDOC_Bullet):
+                       /* FALLTHROUGH */
+               case (MDOC_Dash):
+                       /* FALLTHROUGH */
+               case (MDOC_Enum):
+                       /* FALLTHROUGH */
+               case (MDOC_Hyphen):
+                       /* FALLTHROUGH */
+               case (MDOC_Tag):
+                       /* FALLTHROUGH */
+               case (MDOC_Diag):
+                       /* FALLTHROUGH */
+               case (MDOC_Inset):
+                       /* FALLTHROUGH */
+               case (MDOC_Ohang):
+                       type = bl->argv[i].arg;
+                       i = (int)bl->argc;
+                       break;
+               default:
+                       errx(1, "list type not supported");
+                       /* NOTREACHED */
                }
+
+
+       switch (type) {
+       case (MDOC_Diag):
+               /* FALLTHROUGH */
+       case (MDOC_Inset):
+               break;
+       default:
+               flushln(p);
+               break;
        }
 
-       return(1);
+       p->offset = pair->offset;
+       p->rmargin = pair->rmargin;
+
+       switch (type) {
+       case (MDOC_Inset):
+               break;
+       default:
+               if (MDOC_HEAD == node->type)
+                       p->flags &= ~TERMP_NOBREAK;
+               else if (MDOC_BODY == node->type)
+                       p->flags &= ~TERMP_NOLPAD;
+               break;
+       }
 }
 
 
 /* ARGSUSED */
 static int
-termp_bold_post(struct termp *p, const struct mdoc_meta *meta,
-               const struct mdoc_node *node)
+termp_nm_pre(DECL_ARGS)
 {
 
-       p->flags &= ~TERMP_BOLD;
+       if (SEC_SYNOPSIS == node->sec)
+               newln(p);
+
+       TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_PROG]);
+       if (NULL == node->child)
+               word(p, meta->name);
+
        return(1);
 }
 
 
 /* ARGSUSED */
 static int
-termp_under_pre(struct termp *p, const struct mdoc_meta *meta,
-               const struct mdoc_node *node)
+termp_fl_pre(DECL_ARGS)
 {
 
-       p->flags |= TERMP_UNDERLINE;
+       TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_CMD_FLAG]);
+       word(p, "\\-");
+       p->flags |= TERMP_NOSPACE;
        return(1);
 }
 
 
 /* ARGSUSED */
 static int
-termp_bold_pre(struct termp *p, const struct mdoc_meta *meta,
-               const struct mdoc_node *node)
+termp_ar_pre(DECL_ARGS)
 {
 
-       p->flags |= TERMP_BOLD;
+       TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_CMD_ARG]);
+       if (NULL == node->child) {
+               word(p, "file");
+               word(p, "...");
+       }
        return(1);
 }
 
 
 /* ARGSUSED */
 static int
-termp_ns_pre(struct termp *p, const struct mdoc_meta *meta,
-               const struct mdoc_node *node)
+termp_ns_pre(DECL_ARGS)
 {
 
        p->flags |= TERMP_NOSPACE;
@@ -625,8 +668,7 @@ termp_ns_pre(struct termp *p, const struct mdoc_meta *meta,
 
 /* ARGSUSED */
 static int
-termp_pp_pre(struct termp *p, const struct mdoc_meta *meta,
-               const struct mdoc_node *node)
+termp_pp_pre(DECL_ARGS)
 {
 
        vspace(p);
@@ -636,75 +678,200 @@ termp_pp_pre(struct termp *p, const struct mdoc_meta *meta,
 
 /* ARGSUSED */
 static int
-termp_under_post(struct termp *p, const struct mdoc_meta *meta,
-               const struct mdoc_node *node)
+termp_st_pre(DECL_ARGS)
 {
+       const char      *tp;
+
+       assert(1 == node->data.elem.argc);
+
+       tp = mdoc_st2a(node->data.elem.argv[0].arg);
+       word(p, tp);
 
-       p->flags &= ~TERMP_UNDERLINE;
        return(1);
 }
 
 
 /* ARGSUSED */
 static int
-termp_nd_pre(struct termp *p, const struct mdoc_meta *meta,
-               const struct mdoc_node *node)
+termp_rs_pre(DECL_ARGS)
 {
 
-       word(p, "-");
+       if (MDOC_BLOCK == node->type && node->prev)
+               vspace(p);
        return(1);
 }
 
 
 /* ARGSUSED */
 static int
-termp_bl_post(struct termp *p, const struct mdoc_meta *meta,
-               const struct mdoc_node *node)
+termp_rv_pre(DECL_ARGS)
 {
+       int              i;
+
+       i = arg_getattr(MDOC_Std, node->data.elem.argc, 
+                       node->data.elem.argv);
+       assert(i >= 0);
+
+       newln(p);
+       word(p, "The");
+
+       p->flags |= ttypes[TTYPE_FUNC_NAME];
+       word(p, *node->data.elem.argv[i].value);
+       p->flags &= ~ttypes[TTYPE_FUNC_NAME];
+
+               word(p, "() function returns the value 0 if successful;");
+               word(p, "otherwise the value -1 is returned and the");
+               word(p, "global variable");
+
+       p->flags |= ttypes[TTYPE_VAR_DECL];
+       word(p, "errno");
+       p->flags &= ~ttypes[TTYPE_VAR_DECL];
+
+               word(p, "is set to indicate the error.");
 
-       switch (node->type) {
-       case (MDOC_BLOCK):
-               newln(p);
-               break;
-       default:
-               break;
-       }
        return(1);
 }
 
 
 /* ARGSUSED */
 static int
-termp_op_post(struct termp *p, const struct mdoc_meta *meta,
-               const struct mdoc_node *node)
+termp_ex_pre(DECL_ARGS)
 {
+       int              i;
+
+       i = arg_getattr(MDOC_Std, node->data.elem.argc, 
+                       node->data.elem.argv);
+       assert(i >= 0);
+
+       word(p, "The");
+       p->flags |= ttypes[TTYPE_PROG];
+       word(p, *node->data.elem.argv[i].value);
+       p->flags &= ~ttypes[TTYPE_PROG];
+               word(p, "utility exits 0 on success, and >0 if an error occurs.");
 
-       switch (node->type) {
-       case (MDOC_BODY):
-               p->flags |= TERMP_NOSPACE;
-               word(p, "\\(rB");
-               break;
-       default:
-               break;
-       }
        return(1);
 }
 
 
 /* ARGSUSED */
 static int
-termp_sh_post(struct termp *p, const struct mdoc_meta *meta,
-               const struct mdoc_node *node)
+termp_nd_pre(DECL_ARGS)
 {
 
-       switch (node->type) {
-       case (MDOC_HEAD):
-               p->flags &= ~TERMP_BOLD;
-               newln(p);
-               break;
-       case (MDOC_BODY):
+       word(p, "\\-");
+       return(1);
+}
+
+
+/* ARGSUSED */
+static void
+termp_bl_post(DECL_ARGS)
+{
+
+       if (MDOC_BLOCK == node->type)
                newln(p);
-               p->offset -= 4;
+}
+
+
+/* ARGSUSED */
+static void
+termp_op_post(DECL_ARGS)
+{
+
+       if (MDOC_BODY != node->type) 
+               return;
+       p->flags |= TERMP_NOSPACE;
+       word(p, "\\(rB");
+}
+
+
+/* ARGSUSED */
+static int
+termp_xr_pre(DECL_ARGS)
+{
+       const struct mdoc_node *n;
+
+       n = node->child;
+       assert(n);
+
+       assert(MDOC_TEXT == n->type);
+       word(p, n->data.text.string);
+
+       if (NULL == (n = n->next)) 
+               return(0);
+
+       assert(MDOC_TEXT == n->type);
+       p->flags |= TERMP_NOSPACE;
+       word(p, "(");
+       p->flags |= TERMP_NOSPACE;
+       word(p, n->data.text.string);
+       p->flags |= TERMP_NOSPACE;
+       word(p, ")");
+
+       return(0);
+}
+
+
+/* ARGSUSED */
+static int
+termp_vt_pre(DECL_ARGS)
+{
+
+       /* FIXME: this can be "type name". */
+       TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_VAR_DECL]);
+       return(1);
+}
+
+
+/* ARGSUSED */
+static void
+termp_vt_post(DECL_ARGS)
+{
+
+       if (node->sec == SEC_SYNOPSIS)
+               vspace(p);
+}
+
+
+/* ARGSUSED */
+static int
+termp_fd_pre(DECL_ARGS)
+{
+
+       /* 
+        * FIXME: this naming is bad.  This value is used, in general,
+        * for the #include header or other preprocessor statement.
+        */
+       TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_FUNC_DECL]);
+       return(1);
+}
+
+
+/* ARGSUSED */
+static void
+termp_fd_post(DECL_ARGS)
+{
+
+       if (node->sec != SEC_SYNOPSIS)
+               return;
+       newln(p);
+       if (node->next && MDOC_Fd != node->next->tok)
+               vspace(p);
+}
+
+
+/* ARGSUSED */
+static int
+termp_sh_pre(DECL_ARGS)
+{
+
+       switch (node->type) {
+       case (MDOC_HEAD):
+               vspace(p);
+               TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_SECTION]);
+               break;
+       case (MDOC_BODY):
+               p->offset = INDENT;
                break;
        default:
                break;
@@ -714,30 +881,27 @@ termp_sh_post(struct termp *p, const struct mdoc_meta *meta,
 
 
 /* ARGSUSED */
-static int
-termp_sh_pre(struct termp *p, const struct mdoc_meta *meta,
-               const struct mdoc_node *node)
+static void
+termp_sh_post(DECL_ARGS)
 {
 
        switch (node->type) {
        case (MDOC_HEAD):
-               vspace(p);
-               p->flags |= TERMP_BOLD;
+               newln(p);
                break;
        case (MDOC_BODY):
-               p->offset += 4;
+               newln(p);
+               p->offset = 0;
                break;
        default:
                break;
        }
-       return(1);
 }
 
 
 /* ARGSUSED */
 static int
-termp_op_pre(struct termp *p, const struct mdoc_meta *meta,
-               const struct mdoc_node *node)
+termp_op_pre(DECL_ARGS)
 {
 
        switch (node->type) {
@@ -754,227 +918,731 @@ termp_op_pre(struct termp *p, const struct mdoc_meta *meta,
 
 /* ARGSUSED */
 static int
-termp_fl_pre(struct termp *p, const struct mdoc_meta *meta,
-               const struct mdoc_node *node)
+termp_bt_pre(DECL_ARGS)
 {
 
-       p->flags |= TERMP_BOLD;
-       word(p, "-");
-       p->flags |= TERMP_NOSPACE;
+       word(p, "is currently in beta test.");
+       return(1);
+}
+
+
+/* ARGSUSED */
+static int
+termp_ud_pre(DECL_ARGS)
+{
+
+       word(p, "currently under development.");
+       return(1);
+}
+
+
+/* ARGSUSED */
+static int
+termp_d1_pre(DECL_ARGS)
+{
+
+       if (MDOC_BODY != node->type)
+               return(1);
+       newln(p);
+       p->offset += (pair->offset = INDENT);
        return(1);
 }
 
 
+/* ARGSUSED */
 static void
-termprint_r(struct termp *p, const struct mdoc_meta *meta,
-               const struct mdoc_node *node)
+termp_d1_post(DECL_ARGS)
 {
 
-       /* Pre-processing ----------------- */
+       if (MDOC_BODY != node->type) 
+               return;
+       newln(p);
+       p->offset -= pair->offset;
+}
+
 
-       if (MDOC_TEXT != node->type) {
-               if (termacts[node->tok].pre)
-                       if ( ! (*termacts[node->tok].pre)(p, meta, node))
-                               return;
-       } else /* MDOC_TEXT == node->type */
-               word(p, node->data.text.string);
+/* ARGSUSED */
+static int
+termp_aq_pre(DECL_ARGS)
+{
 
-       /* Children ---------------------- */
+       if (MDOC_BODY != node->type)
+               return(1);
+       word(p, "<");
+       p->flags |= TERMP_NOSPACE;
+       return(1);
+}
 
-       if (NULL == node->child) {
-               /* No-child processing. */
-               switch (node->type) {
-               case (MDOC_ELEM):
-                       switch (node->tok) {
-                       case (MDOC_Nm):
-                               word(p, "progname"); /* TODO */
-                               break;
-                       case (MDOC_Ar):
-                               word(p, "..."); 
-                               break;
-                       default:
-                               break;
-                       }
-                       break;
-               default:
-                       break;
-               }
-       } else
-               termprint_r(p, meta, node->child);
 
-       /* Post-processing --------------- */
+/* ARGSUSED */
+static void
+termp_aq_post(DECL_ARGS)
+{
+
+       if (MDOC_BODY != node->type)
+               return;
+       p->flags |= TERMP_NOSPACE;
+       word(p, ">");
+}
 
-       if (MDOC_TEXT != node->type) {
-               if (termacts[node->tok].post)
-                       if ( ! (*termacts[node->tok].post)(p, meta, node))
-                               return;
-       } 
 
-       /* Siblings ---------------------- */
+/* ARGSUSED */
+static int
+termp_ft_pre(DECL_ARGS)
+{
 
-       if (node->next)
-               termprint_r(p, meta, node->next);
+       if (SEC_SYNOPSIS == node->sec)
+               if (node->prev && MDOC_Fo == node->prev->tok)
+                       vspace(p);
+       TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_FUNC_TYPE]);
+       return(1);
 }
 
 
+/* ARGSUSED */
 static void
-termprint_footer(struct termp *p, const struct mdoc_meta *meta)
+termp_ft_post(DECL_ARGS)
+{
+
+       if (SEC_SYNOPSIS == node->sec)
+               newln(p);
+}
+
+
+/* ARGSUSED */
+static int
+termp_fn_pre(DECL_ARGS)
 {
-       struct tm       *tm;
-       char            *buf, *os;
-       size_t           sz, osz, ssz, i;
+       const struct mdoc_node *n;
 
-       if (NULL == (buf = malloc(p->rmargin)))
-               err(1, "malloc");
-       if (NULL == (os = malloc(p->rmargin)))
-               err(1, "malloc");
+       assert(node->child);
+       assert(MDOC_TEXT == node->child->type);
 
-       tm = localtime(&meta->date);
-       if (NULL == strftime(buf, p->rmargin, "%B %d, %Y", tm))
-               err(1, "strftime");
+       /* FIXME: can be "type funcname" "type varname"... */
 
-       osz = strlcpy(os, meta->os, p->rmargin);
+       p->flags |= ttypes[TTYPE_FUNC_NAME];
+       word(p, node->child->data.text.string);
+       p->flags &= ~ttypes[TTYPE_FUNC_NAME];
 
-       sz = strlen(buf);
-       ssz = sz + osz + 1;
+       word(p, "(");
 
-       if (ssz > p->rmargin) {
-               ssz -= p->rmargin;
-               assert(ssz <= osz);
-               os[osz - ssz] = 0;
-               ssz = 1;
-       } else
-               ssz = p->rmargin - ssz + 1;
+       p->flags |= TERMP_NOSPACE;
+       for (n = node->child->next; n; n = n->next) {
+               assert(MDOC_TEXT == n->type);
+               p->flags |= ttypes[TTYPE_FUNC_ARG];
+               word(p, n->data.text.string);
+               p->flags &= ~ttypes[TTYPE_FUNC_ARG];
+               if (n->next)
+                       word(p, ",");
+       }
 
-       printf("\n");
-       printf("%s", os);
-       for (i = 0; i < ssz; i++)
-               printf(" ");
+       word(p, ")");
 
-       printf("%s\n", buf);
-       fflush(stdout);
+       if (SEC_SYNOPSIS == node->sec)
+               word(p, ";");
 
-       free(buf);
-       free(os);
+       return(0);
 }
 
 
+/* ARGSUSED */
 static void
-termprint_header(struct termp *p, const struct mdoc_meta *meta)
+termp_fn_post(DECL_ARGS)
 {
-       char            *msec, *buf, *title, *pp;
-       size_t           ssz, tsz, ttsz, i;;
 
-       if (NULL == (buf = malloc(p->rmargin)))
-               err(1, "malloc");
-       if (NULL == (title = malloc(p->rmargin)))
-               err(1, "malloc");
+       if (node->sec == SEC_SYNOPSIS && node->next)
+               vspace(p);
 
-       if (NULL == (pp = mdoc_vol2a(meta->vol)))
-               switch (meta->msec) {
-               case (MSEC_1):
-                       /* FALLTHROUGH */
-               case (MSEC_6):
-                       /* FALLTHROUGH */
-               case (MSEC_7):
-                       pp = mdoc_vol2a(VOL_URM);
-                       break;
-               case (MSEC_8):
-                       pp = mdoc_vol2a(VOL_SMM);
-                       break;
-               case (MSEC_2):
+}
+
+
+/* ARGSUSED */
+static int
+termp_sx_pre(DECL_ARGS)
+{
+
+       TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_LINK]);
+       return(1);
+}
+
+
+/* ARGSUSED */
+static int
+termp_fa_pre(DECL_ARGS)
+{
+       struct mdoc_node *n;
+
+       if (node->parent->tok != MDOC_Fo) {
+               TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_FUNC_ARG]);
+               return(1);
+       }
+
+       for (n = node->child; n; n = n->next) {
+               assert(MDOC_TEXT == n->type);
+
+               p->flags |= ttypes[TTYPE_FUNC_ARG];
+               word(p, n->data.text.string);
+               p->flags &= ~ttypes[TTYPE_FUNC_ARG];
+
+               if (n->next)
+                       word(p, ",");
+       }
+
+       if (node->next && node->next->tok == MDOC_Fa)
+               word(p, ",");
+
+       return(0);
+}
+
+
+/* ARGSUSED */
+static int
+termp_va_pre(DECL_ARGS)
+{
+
+       TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_VAR_DECL]);
+       return(1);
+}
+
+
+/* ARGSUSED */
+static int
+termp_bd_pre(DECL_ARGS)
+{
+       const struct mdoc_block *bl;
+       const struct mdoc_node  *n;
+       int              i, type;
+
+       if (MDOC_BLOCK == node->type) {
+               if (node->prev)
+                       vspace(p);
+               return(1);
+       } else if (MDOC_BODY != node->type)
+               return(1);
+
+       pair->offset = p->offset;
+       bl = &node->parent->data.block;
+
+       for (type = -1, i = 0; i < (int)bl->argc; i++) {
+               switch (bl->argv[i].arg) {
+               case (MDOC_Ragged):
                        /* FALLTHROUGH */
-               case (MSEC_3):
+               case (MDOC_Filled):
                        /* FALLTHROUGH */
-               case (MSEC_4):
+               case (MDOC_Unfilled):
                        /* FALLTHROUGH */
-               case (MSEC_5):
-                       pp = mdoc_vol2a(VOL_PRM);
-                       break;
-               case (MSEC_9):
-                       pp = mdoc_vol2a(VOL_KM);
+               case (MDOC_Literal):
+                       type = bl->argv[i].arg;
+                       i = (int)bl->argc;
                        break;
                default:
-                       /* FIXME: capitalise. */
-                       if (NULL == (pp = mdoc_msec2a(meta->msec)))
-                               pp = mdoc_msec2a(MSEC_local);
-                       break;
+                       errx(1, "display type not supported");
                }
-       assert(pp);
-
-       tsz = strlcpy(buf, pp, p->rmargin);
-       assert(tsz < p->rmargin);
-
-       if ((pp = mdoc_arch2a(meta->arch))) {
-               tsz = strlcat(buf, " (", p->rmargin);
-               assert(tsz < p->rmargin);
-               tsz = strlcat(buf, pp, p->rmargin);
-               assert(tsz < p->rmargin);
-               tsz = strlcat(buf, ")", p->rmargin);
-               assert(tsz < p->rmargin);
        }
 
-       ttsz = strlcpy(title, meta->title, p->rmargin);
+       assert(-1 != type);
+
+       i = arg_getattr(MDOC_Offset, bl->argc, bl->argv);
+       if (-1 != i) {
+               assert(1 == bl->argv[i].sz);
+               p->offset += arg_offset(&bl->argv[i]);
+       }
+
 
-       if (NULL == (msec = mdoc_msec2a(meta->msec)))
-               msec = "";
+       switch (type) {
+       case (MDOC_Literal):
+               /* FALLTHROUGH */
+       case (MDOC_Unfilled):
+               break;
+       default:
+               return(1);
+       }
 
-       ssz = (2 * (ttsz + 2 + strlen(msec))) + tsz + 2;
+       p->flags |= TERMP_LITERAL;
 
-       if (ssz > p->rmargin) {
-               if ((ssz -= p->rmargin) % 2)
-                       ssz++;
-               ssz /= 2;
-       
-               assert(ssz <= ttsz);
-               title[ttsz - ssz] = 0;
-               ssz = 1;
-       } else
-               ssz = ((p->rmargin - ssz) / 2) + 1;
+       for (n = node->child; n; n = n->next) {
+               if (MDOC_TEXT != n->type) {
+                       warnx("non-text children not yet allowed");
+                       continue;
+               }
+               word(p, n->data.text.string);
+               flushln(p);
+       }
 
-       printf("%s(%s)", title, msec);
+       return(0);
+}
 
-       for (i = 0; i < ssz; i++)
-               printf(" ");
 
-       printf("%s", buf);
+/* ARGSUSED */
+static void
+termp_bd_post(DECL_ARGS)
+{
 
-       for (i = 0; i < ssz; i++)
-               printf(" ");
+       if (MDOC_BODY != node->type) 
+               return;
 
-       printf("%s(%s)\n", title, msec);
-       fflush(stdout);
+       if ( ! (p->flags & TERMP_LITERAL))
+               flushln(p);
 
-       free(title);
-       free(buf);
+       p->flags &= ~TERMP_LITERAL;
+       p->offset = pair->offset;
 }
 
 
-int
-termprint(const struct mdoc_node *node,
-               const struct mdoc_meta *meta)
+/* ARGSUSED */
+static int
+termp_qq_pre(DECL_ARGS)
 {
-       struct termp     p;
 
-       if (ERR == setupterm(NULL, STDOUT_FILENO, NULL))
-               return(0);
+       if (MDOC_BODY != node->type)
+               return(1);
+       word(p, "\"");
+       p->flags |= TERMP_NOSPACE;
+       return(1);
+}
+
+
+/* ARGSUSED */
+static void
+termp_qq_post(DECL_ARGS)
+{
+
+       if (MDOC_BODY != node->type)
+               return;
+       p->flags |= TERMP_NOSPACE;
+       word(p, "\"");
+}
+
+
+/* ARGSUSED */
+static int
+termp_bsx_pre(DECL_ARGS)
+{
+
+       word(p, "BSDI BSD/OS");
+       return(1);
+}
 
-       p.maxrmargin = columns < 60 ? 60 : (size_t)columns;
-       p.rmargin = p.maxrmargin;
-       p.maxcols = 1024;
-       p.offset = p.col = 0;
-       p.flags = TERMP_NOSPACE;
 
-       if (NULL == (p.buf = malloc(p.maxcols)))
-               err(1, "malloc");
+/* ARGSUSED */
+static void
+termp_bx_post(DECL_ARGS)
+{
+
+       if (node->child)
+               p->flags |= TERMP_NOSPACE;
+       word(p, "BSD");
+}
 
-       termprint_header(&p, meta);
-       termprint_r(&p, meta, node);
-       termprint_footer(&p, meta);
 
-       free(p.buf);
+/* ARGSUSED */
+static int
+termp_ox_pre(DECL_ARGS)
+{
 
+       word(p, "OpenBSD");
        return(1);
 }
 
 
+/* ARGSUSED */
+static int
+termp_ux_pre(DECL_ARGS)
+{
+
+       word(p, "UNIX");
+       return(1);
+}
+
+
+/* ARGSUSED */
+static int
+termp_fx_pre(DECL_ARGS)
+{
+
+       word(p, "FreeBSD");
+       return(1);
+}
+
+
+/* ARGSUSED */
+static int
+termp_nx_pre(DECL_ARGS)
+{
+
+       word(p, "NetBSD");
+       return(1);
+}
+
+
+/* ARGSUSED */
+static int
+termp_sq_pre(DECL_ARGS)
+{
+
+       if (MDOC_BODY != node->type)
+               return(1);
+       word(p, "`");
+       p->flags |= TERMP_NOSPACE;
+       return(1);
+}
+
+
+/* ARGSUSED */
+static void
+termp_sq_post(DECL_ARGS)
+{
+
+       if (MDOC_BODY != node->type)
+               return;
+       p->flags |= TERMP_NOSPACE;
+       word(p, "\'");
+}
+
+
+/* ARGSUSED */
+static int
+termp_pf_pre(DECL_ARGS)
+{
+
+       p->flags |= TERMP_IGNDELIM;
+       return(1);
+}
+
+
+/* ARGSUSED */
+static void
+termp_pf_post(DECL_ARGS)
+{
+
+       p->flags &= ~TERMP_IGNDELIM;
+       p->flags |= TERMP_NOSPACE;
+}
+
+
+/* ARGSUSED */
+static int
+termp_ss_pre(DECL_ARGS)
+{
+
+       switch (node->type) {
+       case (MDOC_HEAD):
+               vspace(p);
+               TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_SSECTION]);
+               p->offset = INDENT / 2;
+               break;
+       default:
+               break;
+       }
+
+       return(1);
+}
+
+
+/* ARGSUSED */
+static void
+termp_ss_post(DECL_ARGS)
+{
+
+       switch (node->type) {
+       case (MDOC_HEAD):
+               newln(p);
+               p->offset = INDENT;
+               break;
+       default:
+               break;
+       }
+}
+
+
+/* ARGSUSED */
+static int
+termp_pa_pre(DECL_ARGS)
+{
+
+       TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_FILE]);
+       return(1);
+}
+
+
+/* ARGSUSED */
+static int
+termp_em_pre(DECL_ARGS)
+{
+
+       TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_EMPH]);
+       return(1);
+}
+
+
+/* ARGSUSED */
+static int
+termp_cd_pre(DECL_ARGS)
+{
+
+       TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_CONFIG]);
+       newln(p);
+       return(1);
+}
+
+
+/* ARGSUSED */
+static int
+termp_cm_pre(DECL_ARGS)
+{
+
+       TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_CMD_FLAG]);
+       return(1);
+}
+
+
+/* ARGSUSED */
+static int
+termp_ic_pre(DECL_ARGS)
+{
+
+       TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_CMD]);
+       return(1);
+}
+
+
+/* ARGSUSED */
+static int
+termp_in_pre(DECL_ARGS)
+{
+
+       TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_INCLUDE]);
+       word(p, "#include");
+       word(p, "<");
+       p->flags |= TERMP_NOSPACE;
+       return(1);
+}
+
+
+/* ARGSUSED */
+static void
+termp_in_post(DECL_ARGS)
+{
+
+       p->flags |= TERMP_NOSPACE;
+       word(p, ">");
+
+       newln(p);
+       if (SEC_SYNOPSIS != node->sec)
+               return;
+       if (node->next && MDOC_In != node->next->tok)
+               vspace(p);
+}
+
+
+/* ARGSUSED */
+static int
+termp_at_pre(DECL_ARGS)
+{
+       enum mdoc_att    c;
+
+       c = ATT_DEFAULT;
+       if (node->child) {
+               assert(MDOC_TEXT == node->child->type);
+               c = mdoc_atoatt(node->child->data.text.string);
+       }
+
+       word(p, mdoc_att2a(c));
+       return(0);
+}
+
+
+/* ARGSUSED */
+static int
+termp_bq_pre(DECL_ARGS)
+{
+
+       if (MDOC_BODY != node->type)
+               return(1);
+       word(p, "[");
+       p->flags |= TERMP_NOSPACE;
+       return(1);
+}
+
+
+/* ARGSUSED */
+static void
+termp_bq_post(DECL_ARGS)
+{
+
+       if (MDOC_BODY != node->type)
+               return;
+       word(p, "]");
+}
+
+
+/* ARGSUSED */
+static int
+termp_pq_pre(DECL_ARGS)
+{
+
+       if (MDOC_BODY != node->type)
+               return(1);
+       word(p, "\\&(");
+       p->flags |= TERMP_NOSPACE;
+       return(1);
+}
+
+
+/* ARGSUSED */
+static void
+termp_pq_post(DECL_ARGS)
+{
+
+       if (MDOC_BODY != node->type)
+               return;
+       word(p, ")");
+}
+
+
+/* ARGSUSED */
+static int
+termp_fo_pre(DECL_ARGS)
+{
+       const struct mdoc_node *n;
+
+       if (MDOC_BODY == node->type) {
+               word(p, "(");
+               p->flags |= TERMP_NOSPACE;
+               return(1);
+       } else if (MDOC_HEAD != node->type) 
+               return(1);
+
+       /* XXX - groff shows only first parameter */
+
+       p->flags |= ttypes[TTYPE_FUNC_NAME];
+       for (n = node->child; n; n = n->next) {
+               assert(MDOC_TEXT == n->type);
+               word(p, n->data.text.string);
+       }
+       p->flags &= ~ttypes[TTYPE_FUNC_NAME];
+
+       return(0);
+}
+
+
+/* ARGSUSED */
+static void
+termp_fo_post(DECL_ARGS)
+{
+
+       if (MDOC_BODY != node->type)
+               return;
+       word(p, ")");
+       word(p, ";");
+       newln(p);
+}
+
+
+/* ARGSUSED */
+static int
+termp_bf_pre(DECL_ARGS)
+{
+       const struct mdoc_node  *n;
+       const struct mdoc_block *b;
+
+       /* XXX - we skip over possible trailing HEAD tokens. */
+
+       if (MDOC_HEAD == node->type)
+               return(0);
+       else if (MDOC_BLOCK != node->type)
+               return(1);
+
+       b = &node->data.block;
+
+       if (NULL == (n = b->head->child)) {
+               if (arg_hasattr(MDOC_Emphasis, b->argc, b->argv))
+                       TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_EMPH]);
+               else if (arg_hasattr(MDOC_Symbolic, b->argc, b->argv))
+                       TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_SYMB]);
+
+               return(1);
+       } 
+
+       assert(MDOC_TEXT == n->type);
+
+       if (0 == strcmp("Em", n->data.text.string))
+               TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_EMPH]);
+       else if (0 == strcmp("Sy", n->data.text.string))
+               TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_EMPH]);
+
+       return(1);
+}
+
+
+/* ARGSUSED */
+static int
+termp_sy_pre(DECL_ARGS)
+{
+
+       TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_SYMB]);
+       return(1);
+}
+
+
+/* ARGSUSED */
+static int
+termp_ms_pre(DECL_ARGS)
+{
+
+       TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_SYMBOL]);
+       return(1);
+}
+
+
+
+/* ARGSUSED */
+static int
+termp_sm_pre(DECL_ARGS)
+{
+
+#if notyet
+       assert(node->child);
+       if (0 == strcmp("off", node->child->data.text.string)) {
+               p->flags &= ~TERMP_NONOSPACE;
+               p->flags &= ~TERMP_NOSPACE;
+       } else {
+               p->flags |= TERMP_NONOSPACE;
+               p->flags |= TERMP_NOSPACE;
+       }
+#endif
+
+       return(0);
+}
+
+
+/* ARGSUSED */
+static int
+termp__t_pre(DECL_ARGS)
+{
+
+       word(p, "\"");
+       p->flags |= TERMP_NOSPACE;
+       return(1);
+}
+
+
+/* ARGSUSED */
+static void
+termp__t_post(DECL_ARGS)
+{
+
+       p->flags |= TERMP_NOSPACE;
+       word(p, "\"");
+       word(p, node->next ? "," : ".");
+}
+
+
+/* ARGSUSED */
+static void
+termp____post(DECL_ARGS)
+{
+
+       p->flags |= TERMP_NOSPACE;
+       word(p, node->next ? "," : ".");
+}