]> git.cameronkatri.com Git - mandoc.git/blobdiff - man_term.c
Two minor tweaks regarding the fallback from -u/-d to default mode:
[mandoc.git] / man_term.c
index bb8df7bae2a684b747bd2c20c4febe95661602e5..5a659503e3876c9813e7e0e2f28d205b7893e63c 100644 (file)
-/* $Id: man_term.c,v 1.5 2009/03/27 14:56:15 kristaps Exp $ */
+/*     $Id: man_term.c,v 1.145 2014/04/08 07:13:11 schwarze Exp $ */
 /*
- * Copyright (c) 2008, 2009 Kristaps Dzonsons <kristaps@openbsd.org>
+ * Copyright (c) 2008-2012 Kristaps Dzonsons <kristaps@bsd.lv>
+ * Copyright (c) 2010-2014 Ingo Schwarze <schwarze@openbsd.org>
  *
  * Permission to use, copy, modify, and distribute this software for any
- * purpose with or without fee is hereby granted, provided that the
- * above copyright notice and this permission notice appear in all
- * copies.
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice appear in all copies.
  *
- * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
- * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
- * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
- * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
- * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
- * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
- * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
- * PERFORMANCE OF THIS SOFTWARE.
+ * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+ * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+ * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+ * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+ * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
+#ifdef HAVE_CONFIG_H
+#include "config.h"
+#endif
+
+#include <sys/types.h>
+
 #include <assert.h>
-#include <err.h>
+#include <ctype.h>
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
 
-#include "term.h"
+#include "mandoc.h"
+#include "out.h"
 #include "man.h"
-
-#ifdef __linux__
-extern size_t            strlcpy(char *, const char *, size_t);
-extern size_t            strlcat(char *, const char *, size_t);
-#endif
+#include "term.h"
+#include "main.h"
+
+#define        MAXMARGINS        64 /* maximum number of indented scopes */
+
+struct mtermp {
+       int               fl;
+#define        MANT_LITERAL     (1 << 0)
+       size_t            lmargin[MAXMARGINS]; /* margins (incl. visible page) */
+       int               lmargincur; /* index of current margin */
+       int               lmarginsz; /* actual number of nested margins */
+       size_t            offset; /* default offset to visible page */
+       int               pardist; /* vert. space before par., unit: [v] */
+};
 
 #define        DECL_ARGS         struct termp *p, \
+                         struct mtermp *mt, \
                          const struct man_node *n, \
-                         const struct man_meta *m
+                         const struct man_meta *meta
 
 struct termact {
        int             (*pre)(DECL_ARGS);
        void            (*post)(DECL_ARGS);
+       int               flags;
+#define        MAN_NOTEXT       (1 << 0) /* Never has text children. */
 };
 
+static int               a2width(const struct termp *, const char *);
+static size_t            a2height(const struct termp *, const char *);
+
+static void              print_man_nodelist(DECL_ARGS);
+static void              print_man_node(DECL_ARGS);
+static void              print_man_head(struct termp *, const void *);
+static void              print_man_foot(struct termp *, const void *);
+static void              print_bvspace(struct termp *, 
+                               const struct man_node *, int);
+
 static int               pre_B(DECL_ARGS);
-static int               pre_BI(DECL_ARGS);
-static int               pre_BR(DECL_ARGS);
+static int               pre_HP(DECL_ARGS);
 static int               pre_I(DECL_ARGS);
-static int               pre_IB(DECL_ARGS);
 static int               pre_IP(DECL_ARGS);
-static int               pre_IR(DECL_ARGS);
+static int               pre_OP(DECL_ARGS);
+static int               pre_PD(DECL_ARGS);
 static int               pre_PP(DECL_ARGS);
-static int               pre_RB(DECL_ARGS);
-static int               pre_RI(DECL_ARGS);
+static int               pre_RS(DECL_ARGS);
 static int               pre_SH(DECL_ARGS);
 static int               pre_SS(DECL_ARGS);
 static int               pre_TP(DECL_ARGS);
-
-static void              post_B(DECL_ARGS);
-static void              post_I(DECL_ARGS);
+static int               pre_UR(DECL_ARGS);
+static int               pre_alternate(DECL_ARGS);
+static int               pre_ft(DECL_ARGS);
+static int               pre_ign(DECL_ARGS);
+static int               pre_in(DECL_ARGS);
+static int               pre_literal(DECL_ARGS);
+static int               pre_ll(DECL_ARGS);
+static int               pre_sp(DECL_ARGS);
+
+static void              post_IP(DECL_ARGS);
+static void              post_HP(DECL_ARGS);
+static void              post_RS(DECL_ARGS);
 static void              post_SH(DECL_ARGS);
 static void              post_SS(DECL_ARGS);
-
-static const struct termact termacts[MAN_MAX] = {
-       { NULL, NULL }, /* __ */
-       { NULL, NULL }, /* TH */
-       { pre_SH, post_SH }, /* SH */
-       { pre_SS, post_SS }, /* SS */
-       { pre_TP, NULL }, /* TP */
-       { pre_PP, NULL }, /* LP */
-       { pre_PP, NULL }, /* PP */
-       { pre_PP, NULL }, /* P */
-       { pre_IP, NULL }, /* IP */
-       { pre_PP, NULL }, /* HP */ /* FIXME */
-       { NULL, NULL }, /* SM */
-       { pre_B, post_B }, /* SB */
-       { pre_BI, NULL }, /* BI */
-       { pre_IB, NULL }, /* IB */
-       { pre_BR, NULL }, /* BR */
-       { pre_RB, NULL }, /* RB */
-       { NULL, NULL }, /* R */
-       { pre_B, post_B }, /* B */
-       { pre_I, post_I }, /* I */
-       { pre_IR, NULL }, /* IR */
-       { pre_RI, NULL }, /* RI */
-       { pre_PP, NULL }, /* br */
+static void              post_TP(DECL_ARGS);
+static void              post_UR(DECL_ARGS);
+
+static const struct termact termacts[MAN_MAX] = {
+       { pre_sp, NULL, MAN_NOTEXT }, /* br */
+       { NULL, NULL, 0 }, /* TH */
+       { pre_SH, post_SH, 0 }, /* SH */
+       { pre_SS, post_SS, 0 }, /* SS */
+       { pre_TP, post_TP, 0 }, /* TP */
+       { pre_PP, NULL, 0 }, /* LP */
+       { pre_PP, NULL, 0 }, /* PP */
+       { pre_PP, NULL, 0 }, /* P */
+       { pre_IP, post_IP, 0 }, /* IP */
+       { pre_HP, post_HP, 0 }, /* HP */ 
+       { NULL, NULL, 0 }, /* SM */
+       { pre_B, NULL, 0 }, /* SB */
+       { pre_alternate, NULL, 0 }, /* BI */
+       { pre_alternate, NULL, 0 }, /* IB */
+       { pre_alternate, NULL, 0 }, /* BR */
+       { pre_alternate, NULL, 0 }, /* RB */
+       { NULL, NULL, 0 }, /* R */
+       { pre_B, NULL, 0 }, /* B */
+       { pre_I, NULL, 0 }, /* I */
+       { pre_alternate, NULL, 0 }, /* IR */
+       { pre_alternate, NULL, 0 }, /* RI */
+       { pre_ign, NULL, MAN_NOTEXT }, /* na */
+       { pre_sp, NULL, MAN_NOTEXT }, /* sp */
+       { pre_literal, NULL, 0 }, /* nf */
+       { pre_literal, NULL, 0 }, /* fi */
+       { NULL, NULL, 0 }, /* RE */
+       { pre_RS, post_RS, 0 }, /* RS */
+       { pre_ign, NULL, 0 }, /* DT */
+       { pre_ign, NULL, 0 }, /* UC */
+       { pre_PD, NULL, MAN_NOTEXT }, /* PD */
+       { pre_ign, NULL, 0 }, /* AT */
+       { pre_in, NULL, MAN_NOTEXT }, /* in */
+       { pre_ft, NULL, MAN_NOTEXT }, /* ft */
+       { pre_OP, NULL, 0 }, /* OP */
+       { pre_literal, NULL, 0 }, /* EX */
+       { pre_literal, NULL, 0 }, /* EE */
+       { pre_UR, post_UR, 0 }, /* UR */
+       { NULL, NULL, 0 }, /* UE */
+       { pre_ll, NULL, MAN_NOTEXT }, /* ll */
 };
 
-static void              print_head(struct termp *, 
-                               const struct man_meta *);
-static void              print_body(DECL_ARGS);
-static void              print_node(DECL_ARGS);
-static void              print_foot(struct termp *, 
-                               const struct man_meta *);
 
 
-int
-man_run(struct termp *p, const struct man *m)
+void
+terminal_man(void *arg, const struct man *man)
 {
+       struct termp            *p;
+       const struct man_node   *n;
+       const struct man_meta   *meta;
+       struct mtermp            mt;
 
-       print_head(p, man_meta(m));
+       p = (struct termp *)arg;
+
+       if (0 == p->defindent)
+               p->defindent = 7;
+
+       p->overstep = 0;
+       p->maxrmargin = p->defrmargin;
+       p->tabwidth = term_len(p, 5);
+
+       if (NULL == p->symtab)
+               p->symtab = mchars_alloc();
+
+       n = man_node(man);
+       meta = man_meta(man);
+
+       term_begin(p, print_man_head, print_man_foot, meta);
        p->flags |= TERMP_NOSPACE;
-       print_body(p, man_node(m), man_meta(m));
-       print_foot(p, man_meta(m));
 
-       return(1);
+       memset(&mt, 0, sizeof(struct mtermp));
+
+       mt.lmargin[mt.lmargincur] = term_len(p, p->defindent);
+       mt.offset = term_len(p, p->defindent);
+       mt.pardist = 1;
+
+       if (n->child)
+               print_man_nodelist(p, &mt, n->child, meta);
+
+       term_end(p);
+}
+
+
+static size_t
+a2height(const struct termp *p, const char *cp)
+{
+       struct roffsu    su;
+
+       if ( ! a2roffsu(cp, &su, SCALE_VS))
+               SCALE_VS_INIT(&su, atoi(cp));
+
+       return(term_vspan(p, &su));
 }
 
 
-/* ARGSUSED */
 static int
-pre_I(DECL_ARGS)
+a2width(const struct termp *p, const char *cp)
 {
+       struct roffsu    su;
 
-       p->flags |= TERMP_UNDER;
-       return(1);
+       if ( ! a2roffsu(cp, &su, SCALE_BU))
+               return(-1);
+
+       return((int)term_hspan(p, &su));
 }
 
+/*
+ * Printing leading vertical space before a block.
+ * This is used for the paragraph macros.
+ * The rules are pretty simple, since there's very little nesting going
+ * on here.  Basically, if we're the first within another block (SS/SH),
+ * then don't emit vertical space.  If we are (RS), then do.  If not the
+ * first, print it.
+ */
+static void
+print_bvspace(struct termp *p, const struct man_node *n, int pardist)
+{
+       int      i;
+
+       term_newln(p);
+
+       if (n->body && n->body->child)
+               if (MAN_TBL == n->body->child->type)
+                       return;
+
+       if (MAN_ROOT == n->parent->type || MAN_RS != n->parent->tok)
+               if (NULL == n->prev)
+                       return;
+
+       for (i = 0; i < pardist; i++)
+               term_vspace(p);
+}
 
 /* ARGSUSED */
-static void
-post_I(DECL_ARGS)
+static int
+pre_ign(DECL_ARGS)
 {
 
-       p->flags &= ~TERMP_UNDER;
+       return(0);
 }
 
 
 /* ARGSUSED */
 static int
-pre_IR(DECL_ARGS)
+pre_ll(DECL_ARGS)
 {
-       const struct man_node *nn;
-       int              i;
 
-       for (i = 0, nn = n->child; nn; nn = nn->next, i++) {
-               if ( ! (i % 2))
-                       p->flags |= TERMP_UNDER;
-               if (i > 0)
-                       p->flags |= TERMP_NOSPACE;
-               print_node(p, nn, m);
-               if ( ! (i % 2))
-                       p->flags &= ~TERMP_UNDER;
-       }
+       term_setwidth(p, n->nchild ? n->child->string : NULL);
        return(0);
 }
 
 
 /* ARGSUSED */
 static int
-pre_IB(DECL_ARGS)
+pre_I(DECL_ARGS)
 {
-       const struct man_node *nn;
-       int              i;
 
-       for (i = 0, nn = n->child; nn; nn = nn->next, i++) {
-               p->flags |= i % 2 ? TERMP_BOLD : TERMP_UNDER;
-               if (i > 0)
-                       p->flags |= TERMP_NOSPACE;
-               print_node(p, nn, m);
-               p->flags &= i % 2 ? ~TERMP_BOLD : ~TERMP_UNDER;
+       term_fontrepl(p, TERMFONT_UNDER);
+       return(1);
+}
+
+
+/* ARGSUSED */
+static int
+pre_literal(DECL_ARGS)
+{
+
+       term_newln(p);
+
+       if (MAN_nf == n->tok || MAN_EX == n->tok)
+               mt->fl |= MANT_LITERAL;
+       else
+               mt->fl &= ~MANT_LITERAL;
+
+       /*
+        * Unlike .IP and .TP, .HP does not have a HEAD.
+        * So in case a second call to term_flushln() is needed,
+        * indentation has to be set up explicitly.
+        */
+       if (MAN_HP == n->parent->tok && p->rmargin < p->maxrmargin) {
+               p->offset = p->rmargin;
+               p->rmargin = p->maxrmargin;
+               p->trailspace = 0;
+               p->flags &= ~(TERMP_NOBREAK | TERMP_BRIND);
+               p->flags |= TERMP_NOSPACE;
        }
+
        return(0);
 }
 
+/* ARGSUSED */
+static int
+pre_PD(DECL_ARGS)
+{
+
+       n = n->child;
+       if (0 == n) {
+               mt->pardist = 1;
+               return(0);
+       }
+       assert(MAN_TEXT == n->type);
+       mt->pardist = atoi(n->string);
+       return(0);
+}
 
 /* ARGSUSED */
 static int
-pre_RB(DECL_ARGS)
+pre_alternate(DECL_ARGS)
 {
-       const struct man_node *nn;
-       int              i;
+       enum termfont            font[2];
+       const struct man_node   *nn;
+       int                      savelit, i;
+
+       switch (n->tok) {
+       case (MAN_RB):
+               font[0] = TERMFONT_NONE;
+               font[1] = TERMFONT_BOLD;
+               break;
+       case (MAN_RI):
+               font[0] = TERMFONT_NONE;
+               font[1] = TERMFONT_UNDER;
+               break;
+       case (MAN_BR):
+               font[0] = TERMFONT_BOLD;
+               font[1] = TERMFONT_NONE;
+               break;
+       case (MAN_BI):
+               font[0] = TERMFONT_BOLD;
+               font[1] = TERMFONT_UNDER;
+               break;
+       case (MAN_IR):
+               font[0] = TERMFONT_UNDER;
+               font[1] = TERMFONT_NONE;
+               break;
+       case (MAN_IB):
+               font[0] = TERMFONT_UNDER;
+               font[1] = TERMFONT_BOLD;
+               break;
+       default:
+               abort();
+       }
+
+       savelit = MANT_LITERAL & mt->fl;
+       mt->fl &= ~MANT_LITERAL;
 
-       for (i = 0, nn = n->child; nn; nn = nn->next, i++) {
-               if (i % 2)
-                       p->flags |= TERMP_BOLD;
-               if (i > 0)
+       for (i = 0, nn = n->child; nn; nn = nn->next, i = 1 - i) {
+               term_fontrepl(p, font[i]);
+               if (savelit && NULL == nn->next)
+                       mt->fl |= MANT_LITERAL;
+               print_man_node(p, mt, nn, meta);
+               if (nn->next)
                        p->flags |= TERMP_NOSPACE;
-               print_node(p, nn, m);
-               if (i % 2)
-                       p->flags &= ~TERMP_BOLD;
        }
+
        return(0);
 }
 
+/* ARGSUSED */
+static int
+pre_B(DECL_ARGS)
+{
+
+       term_fontrepl(p, TERMFONT_BOLD);
+       return(1);
+}
 
 /* ARGSUSED */
 static int
-pre_RI(DECL_ARGS)
+pre_OP(DECL_ARGS)
 {
-       const struct man_node *nn;
-       int              i;
 
-       for (i = 0, nn = n->child; nn; nn = nn->next, i++) {
-               if ( ! (i % 2))
-                       p->flags |= TERMP_UNDER;
-               if (i > 0)
-                       p->flags |= TERMP_NOSPACE;
-               print_node(p, nn, m);
-               if ( ! (i % 2))
-                       p->flags &= ~TERMP_UNDER;
+       term_word(p, "[");
+       p->flags |= TERMP_NOSPACE;
+
+       if (NULL != (n = n->child)) {
+               term_fontrepl(p, TERMFONT_BOLD);
+               term_word(p, n->string);
+       }
+       if (NULL != n && NULL != n->next) {
+               term_fontrepl(p, TERMFONT_UNDER);
+               term_word(p, n->next->string);
        }
+
+       term_fontrepl(p, TERMFONT_NONE);
+       p->flags |= TERMP_NOSPACE;
+       term_word(p, "]");
        return(0);
 }
 
+/* ARGSUSED */
+static int
+pre_ft(DECL_ARGS)
+{
+       const char      *cp;
+
+       if (NULL == n->child) {
+               term_fontlast(p);
+               return(0);
+       }
+
+       cp = n->child->string;
+       switch (*cp) {
+       case ('4'):
+               /* FALLTHROUGH */
+       case ('3'):
+               /* FALLTHROUGH */
+       case ('B'):
+               term_fontrepl(p, TERMFONT_BOLD);
+               break;
+       case ('2'):
+               /* FALLTHROUGH */
+       case ('I'):
+               term_fontrepl(p, TERMFONT_UNDER);
+               break;
+       case ('P'):
+               term_fontlast(p);
+               break;
+       case ('1'):
+               /* FALLTHROUGH */
+       case ('C'):
+               /* FALLTHROUGH */
+       case ('R'):
+               term_fontrepl(p, TERMFONT_NONE);
+               break;
+       default:
+               break;
+       }
+       return(0);
+}
 
 /* ARGSUSED */
 static int
-pre_BR(DECL_ARGS)
+pre_in(DECL_ARGS)
 {
-       const struct man_node *nn;
-       int              i;
+       int              len, less;
+       size_t           v;
+       const char      *cp;
 
-       for (i = 0, nn = n->child; nn; nn = nn->next, i++) {
-               if ( ! (i % 2))
-                       p->flags |= TERMP_BOLD;
-               if (i > 0)
-                       p->flags |= TERMP_NOSPACE;
-               print_node(p, nn, m);
-               if ( ! (i % 2))
-                       p->flags &= ~TERMP_BOLD;
+       term_newln(p);
+
+       if (NULL == n->child) {
+               p->offset = mt->offset;
+               return(0);
        }
+
+       cp = n->child->string;
+       less = 0;
+
+       if ('-' == *cp)
+               less = -1;
+       else if ('+' == *cp)
+               less = 1;
+       else
+               cp--;
+
+       if ((len = a2width(p, ++cp)) < 0)
+               return(0);
+
+       v = (size_t)len;
+
+       if (less < 0)
+               p->offset -= p->offset > v ? v : p->offset;
+       else if (less > 0)
+               p->offset += v;
+       else 
+               p->offset = v;
+
+       /* Don't let this creep beyond the right margin. */
+
+       if (p->offset > p->rmargin)
+               p->offset = p->rmargin;
+
        return(0);
 }
 
 
 /* ARGSUSED */
 static int
-pre_BI(DECL_ARGS)
+pre_sp(DECL_ARGS)
 {
-       const struct man_node *nn;
-       int              i;
+       char            *s;
+       size_t           i, len;
+       int              neg;
+
+       if ((NULL == n->prev && n->parent)) {
+               switch (n->parent->tok) {
+               case (MAN_SH):
+                       /* FALLTHROUGH */
+               case (MAN_SS):
+                       /* FALLTHROUGH */
+               case (MAN_PP):
+                       /* FALLTHROUGH */
+               case (MAN_LP):
+                       /* FALLTHROUGH */
+               case (MAN_P):
+                       /* FALLTHROUGH */
+                       return(0);
+               default:
+                       break;
+               }
+       }
 
-       for (i = 0, nn = n->child; nn; nn = nn->next, i++) {
-               p->flags |= i % 2 ? TERMP_UNDER : TERMP_BOLD;
-               if (i > 0)
-                       p->flags |= TERMP_NOSPACE;
-               print_node(p, nn, m);
-               p->flags &= i % 2 ? ~TERMP_UNDER : ~TERMP_BOLD;
+       neg = 0;
+       switch (n->tok) {
+       case (MAN_br):
+               len = 0;
+               break;
+       default:
+               if (NULL == n->child) {
+                       len = 1;
+                       break;
+               }
+               s = n->child->string;
+               if ('-' == *s) {
+                       neg = 1;
+                       s++;
+               }
+               len = a2height(p, s);
+               break;
        }
+
+       if (0 == len)
+               term_newln(p);
+       else if (neg)
+               p->skipvsp += len;
+       else
+               for (i = 0; i < len; i++)
+                       term_vspace(p);
+
        return(0);
 }
 
 
 /* ARGSUSED */
 static int
-pre_B(DECL_ARGS)
+pre_HP(DECL_ARGS)
 {
+       size_t                   len, one;
+       int                      ival;
+       const struct man_node   *nn;
+
+       switch (n->type) {
+       case (MAN_BLOCK):
+               print_bvspace(p, n, mt->pardist);
+               return(1);
+       case (MAN_BODY):
+               break;
+       default:
+               return(0);
+       }
+
+       if ( ! (MANT_LITERAL & mt->fl)) {
+               p->flags |= TERMP_NOBREAK | TERMP_BRIND;
+               p->trailspace = 2;
+       }
+
+       len = mt->lmargin[mt->lmargincur];
+       ival = -1;
+
+       /* Calculate offset. */
+
+       if (NULL != (nn = n->parent->head->child))
+               if ((ival = a2width(p, nn->string)) >= 0)
+                       len = (size_t)ival;
+
+       one = term_len(p, 1);
+       if (len < one)
+               len = one;
+
+       p->offset = mt->offset;
+       p->rmargin = mt->offset + len;
+
+       if (ival >= 0)
+               mt->lmargin[mt->lmargincur] = (size_t)ival;
 
-       p->flags |= TERMP_BOLD;
        return(1);
 }
 
 
 /* ARGSUSED */
 static void
-post_B(DECL_ARGS)
+post_HP(DECL_ARGS)
 {
 
-       p->flags &= ~TERMP_BOLD;
+       switch (n->type) {
+       case (MAN_BODY):
+               term_newln(p);
+               p->flags &= ~(TERMP_NOBREAK | TERMP_BRIND);
+               p->trailspace = 0;
+               p->offset = mt->offset;
+               p->rmargin = p->maxrmargin;
+               break;
+       default:
+               break;
+       }
 }
 
 
@@ -263,9 +598,17 @@ static int
 pre_PP(DECL_ARGS)
 {
 
-       term_vspace(p);
-       p->offset = INDENT;
-       return(0);
+       switch (n->type) {
+       case (MAN_BLOCK):
+               mt->lmargin[mt->lmargincur] = term_len(p, p->defindent);
+               print_bvspace(p, n, mt->pardist);
+               break;
+       default:
+               p->offset = mt->offset;
+               break;
+       }
+
+       return(MAN_HEAD != n->type);
 }
 
 
@@ -273,27 +616,90 @@ pre_PP(DECL_ARGS)
 static int
 pre_IP(DECL_ARGS)
 {
-       const struct man_node *nn;
-       size_t           offs;
-
-       term_vspace(p);
-       p->offset = INDENT;
+       const struct man_node   *nn;
+       size_t                   len;
+       int                      savelit, ival;
 
-       if (NULL == (nn = n->child))
+       switch (n->type) {
+       case (MAN_BODY):
+               p->flags |= TERMP_NOSPACE;
+               break;
+       case (MAN_HEAD):
+               p->flags |= TERMP_NOBREAK;
+               p->trailspace = 1;
+               break;
+       case (MAN_BLOCK):
+               print_bvspace(p, n, mt->pardist);
+               /* FALLTHROUGH */
+       default:
                return(1);
+       }
 
-       /* FIXME - ignore the designator. */
-       nn = nn->next;
+       len = mt->lmargin[mt->lmargincur];
+       ival = -1;
 
-       if (MAN_TEXT != nn->type)
-               errx(1, "expected text line argument");
+       /* Calculate the offset from the optional second argument. */
+       if (NULL != (nn = n->parent->head->child))
+               if (NULL != (nn = nn->next))
+                       if ((ival = a2width(p, nn->string)) >= 0)
+                               len = (size_t)ival;
 
-       offs = (size_t)atoi(nn->string);
-       nn = nn->next;
+       switch (n->type) {
+       case (MAN_HEAD):
+               /* Handle zero-width lengths. */
+               if (0 == len)
+                       len = term_len(p, 1);
+
+               p->offset = mt->offset;
+               p->rmargin = mt->offset + len;
+               if (ival < 0)
+                       break;
 
-       p->flags |= TERMP_NOSPACE;
-       p->offset += offs;
-       return(0);
+               /* Set the saved left-margin. */
+               mt->lmargin[mt->lmargincur] = (size_t)ival;
+
+               savelit = MANT_LITERAL & mt->fl;
+               mt->fl &= ~MANT_LITERAL;
+
+               if (n->child)
+                       print_man_node(p, mt, n->child, meta);
+
+               if (savelit)
+                       mt->fl |= MANT_LITERAL;
+
+               return(0);
+       case (MAN_BODY):
+               p->offset = mt->offset + len;
+               p->rmargin = p->maxrmargin > p->offset ?
+                               p->maxrmargin : p->offset;
+               break;
+       default:
+               break;
+       }
+
+       return(1);
+}
+
+
+/* ARGSUSED */
+static void
+post_IP(DECL_ARGS)
+{
+
+       switch (n->type) {
+       case (MAN_HEAD):
+               term_flushln(p);
+               p->flags &= ~TERMP_NOBREAK;
+               p->trailspace = 0;
+               p->rmargin = p->maxrmargin;
+               break;
+       case (MAN_BODY):
+               term_newln(p);
+               p->offset = mt->offset;
+               break;
+       default:
+               break;
+       }
 }
 
 
@@ -301,30 +707,94 @@ pre_IP(DECL_ARGS)
 static int
 pre_TP(DECL_ARGS)
 {
-       const struct man_node *nn;
-       size_t           offs;
+       const struct man_node   *nn;
+       size_t                   len;
+       int                      savelit, ival;
 
-       term_vspace(p);
-       p->offset = INDENT;
-
-       if (NULL == (nn = n->child))
+       switch (n->type) {
+       case (MAN_HEAD):
+               p->flags |= TERMP_NOBREAK;
+               p->trailspace = 1;
+               break;
+       case (MAN_BODY):
+               p->flags |= TERMP_NOSPACE;
+               break;
+       case (MAN_BLOCK):
+               print_bvspace(p, n, mt->pardist);
+               /* FALLTHROUGH */
+       default:
                return(1);
+       }
 
-       if (nn->line == n->line) {
-               if (MAN_TEXT != nn->type)
-                       errx(1, "expected text line argument");
-               offs = (size_t)atoi(nn->string);
-               nn = nn->next;
-       } else
-               offs = INDENT;
+       len = (size_t)mt->lmargin[mt->lmargincur];
+       ival = -1;
 
-       for ( ; nn; nn = nn->next)
-               print_node(p, nn, m);
+       /* Calculate offset. */
 
-       term_flushln(p);
-       p->flags |= TERMP_NOSPACE;
-       p->offset += offs;
-       return(0);
+       if (NULL != (nn = n->parent->head->child))
+               if (nn->string && 0 == (MAN_LINE & nn->flags))
+                       if ((ival = a2width(p, nn->string)) >= 0)
+                               len = (size_t)ival;
+
+       switch (n->type) {
+       case (MAN_HEAD):
+               /* Handle zero-length properly. */
+               if (0 == len)
+                       len = term_len(p, 1);
+
+               p->offset = mt->offset;
+               p->rmargin = mt->offset + len;
+
+               savelit = MANT_LITERAL & mt->fl;
+               mt->fl &= ~MANT_LITERAL;
+
+               /* Don't print same-line elements. */
+               nn = n->child;
+               while (NULL != nn && 0 == (MAN_LINE & nn->flags))
+                       nn = nn->next;
+
+               while (NULL != nn) {
+                       print_man_node(p, mt, nn, meta);
+                       nn = nn->next;
+               }
+
+               if (savelit)
+                       mt->fl |= MANT_LITERAL;
+               if (ival >= 0)
+                       mt->lmargin[mt->lmargincur] = (size_t)ival;
+
+               return(0);
+       case (MAN_BODY):
+               p->offset = mt->offset + len;
+               p->rmargin = p->maxrmargin > p->offset ?
+                               p->maxrmargin : p->offset;
+               p->trailspace = 0;
+               p->flags &= ~TERMP_NOBREAK;
+               break;
+       default:
+               break;
+       }
+
+       return(1);
+}
+
+
+/* ARGSUSED */
+static void
+post_TP(DECL_ARGS)
+{
+
+       switch (n->type) {
+       case (MAN_HEAD):
+               term_flushln(p);
+               break;
+       case (MAN_BODY):
+               term_newln(p);
+               p->offset = mt->offset;
+               break;
+       default:
+               break;
+       }
 }
 
 
@@ -332,9 +802,33 @@ pre_TP(DECL_ARGS)
 static int
 pre_SS(DECL_ARGS)
 {
+       int      i;
+
+       switch (n->type) {
+       case (MAN_BLOCK):
+               mt->fl &= ~MANT_LITERAL;
+               mt->lmargin[mt->lmargincur] = term_len(p, p->defindent);
+               mt->offset = term_len(p, p->defindent);
+               /* If following a prior empty `SS', no vspace. */
+               if (n->prev && MAN_SS == n->prev->tok)
+                       if (NULL == n->prev->body->child)
+                               break;
+               if (NULL == n->prev)
+                       break;
+               for (i = 0; i < mt->pardist; i++)
+                       term_vspace(p);
+               break;
+       case (MAN_HEAD):
+               term_fontrepl(p, TERMFONT_BOLD);
+               p->offset = term_len(p, 3);
+               break;
+       case (MAN_BODY):
+               p->offset = mt->offset;
+               break;
+       default:
+               break;
+       }
 
-       term_vspace(p);
-       p->flags |= TERMP_BOLD;
        return(1);
 }
 
@@ -344,9 +838,16 @@ static void
 post_SS(DECL_ARGS)
 {
        
-       term_flushln(p);
-       p->flags &= ~TERMP_BOLD;
-       p->flags |= TERMP_NOSPACE;
+       switch (n->type) {
+       case (MAN_HEAD):
+               term_newln(p);
+               break;
+       case (MAN_BODY):
+               term_newln(p);
+               break;
+       default:
+               break;
+       }
 }
 
 
@@ -354,10 +855,34 @@ post_SS(DECL_ARGS)
 static int
 pre_SH(DECL_ARGS)
 {
+       int      i;
+
+       switch (n->type) {
+       case (MAN_BLOCK):
+               mt->fl &= ~MANT_LITERAL;
+               mt->lmargin[mt->lmargincur] = term_len(p, p->defindent);
+               mt->offset = term_len(p, p->defindent);
+               /* If following a prior empty `SH', no vspace. */
+               if (n->prev && MAN_SH == n->prev->tok)
+                       if (NULL == n->prev->body->child)
+                               break;
+               /* If the first macro, no vspae. */
+               if (NULL == n->prev)
+                       break;
+               for (i = 0; i < mt->pardist; i++)
+                       term_vspace(p);
+               break;
+       case (MAN_HEAD):
+               term_fontrepl(p, TERMFONT_BOLD);
+               p->offset = 0;
+               break;
+       case (MAN_BODY):
+               p->offset = mt->offset;
+               break;
+       default:
+               break;
+       }
 
-       term_vspace(p);
-       p->offset = 0;
-       p->flags |= TERMP_BOLD;
        return(1);
 }
 
@@ -367,160 +892,339 @@ static void
 post_SH(DECL_ARGS)
 {
        
-       term_flushln(p);
-       p->offset = INDENT;
-       p->flags &= ~TERMP_BOLD;
-       p->flags |= TERMP_NOSPACE;
+       switch (n->type) {
+       case (MAN_HEAD):
+               term_newln(p);
+               break;
+       case (MAN_BODY):
+               term_newln(p);
+               break;
+       default:
+               break;
+       }
 }
 
+/* ARGSUSED */
+static int
+pre_RS(DECL_ARGS)
+{
+       int              ival;
+       size_t           sz;
 
+       switch (n->type) {
+       case (MAN_BLOCK):
+               term_newln(p);
+               return(1);
+       case (MAN_HEAD):
+               return(0);
+       default:
+               break;
+       }
+
+       sz = term_len(p, p->defindent);
+
+       if (NULL != (n = n->parent->head->child))
+               if ((ival = a2width(p, n->string)) >= 0) 
+                       sz = (size_t)ival;
+
+       mt->offset += sz;
+       p->offset = mt->offset;
+       p->rmargin = p->maxrmargin > p->offset ?
+                       p->maxrmargin : p->offset;
+
+       if (++mt->lmarginsz < MAXMARGINS)
+               mt->lmargincur = mt->lmarginsz;
+
+       mt->lmargin[mt->lmargincur] = mt->lmargin[mt->lmargincur - 1];
+       return(1);
+}
+
+/* ARGSUSED */
 static void
-print_node(DECL_ARGS)
+post_RS(DECL_ARGS)
 {
-       int              c, sz;
-
-       c = 1;
+       int              ival;
+       size_t           sz;
 
        switch (n->type) {
-       case(MAN_ELEM):
-               if (termacts[n->tok].pre)
-                       c = (*termacts[n->tok].pre)(p, n, m);
+       case (MAN_BLOCK):
+               return;
+       case (MAN_HEAD):
+               return;
+       default:
+               term_newln(p);
                break;
+       }
+
+       sz = term_len(p, p->defindent);
+
+       if (NULL != (n = n->parent->head->child)) 
+               if ((ival = a2width(p, n->string)) >= 0) 
+                       sz = (size_t)ival;
+
+       mt->offset = mt->offset < sz ?  0 : mt->offset - sz;
+       p->offset = mt->offset;
+
+       if (--mt->lmarginsz < MAXMARGINS)
+               mt->lmargincur = mt->lmarginsz;
+}
+
+/* ARGSUSED */
+static int
+pre_UR(DECL_ARGS)
+{
+
+       return (MAN_HEAD != n->type);
+}
+
+/* ARGSUSED */
+static void
+post_UR(DECL_ARGS)
+{
+
+       if (MAN_BLOCK != n->type)
+               return;
+
+       term_word(p, "<");
+       p->flags |= TERMP_NOSPACE;
+
+       if (NULL != n->child->child)
+               print_man_node(p, mt, n->child->child, meta);
+
+       p->flags |= TERMP_NOSPACE;
+       term_word(p, ">");
+}
+
+static void
+print_man_node(DECL_ARGS)
+{
+       size_t           rm, rmax;
+       int              c;
+
+       switch (n->type) {
        case(MAN_TEXT):
-               if (0 == *n->string) {
-                       term_vspace(p);
-                       break;
-               }
                /*
-                * Note!  This is hacky.  Here, we recognise the `\c'
-                * escape embedded in so many -man pages.  It's supposed
-                * to remove the subsequent space, so we mark NOSPACE if
-                * it's encountered in the string.
+                * If we have a blank line, output a vertical space.
+                * If we have a space as the first character, break
+                * before printing the line's data.
                 */
-               sz = (int)strlen(n->string);
+               if ('\0' == *n->string) {
+                       term_vspace(p);
+                       return;
+               } else if (' ' == *n->string && MAN_LINE & n->flags)
+                       term_newln(p);
+
                term_word(p, n->string);
-               if (sz >= 2 && n->string[sz - 1] == 'c' &&
-                               n->string[sz - 2] == '\\')
-                       p->flags |= TERMP_NOSPACE;
-               break;
+               goto out;
+
+       case (MAN_EQN):
+               term_eqn(p, n->eqn);
+               return;
+       case (MAN_TBL):
+               /*
+                * Tables are preceded by a newline.  Then process a
+                * table line, which will cause line termination,
+                */
+               if (TBL_SPAN_FIRST & n->span->flags) 
+                       term_newln(p);
+               term_tbl(p, n->span);
+               return;
        default:
                break;
        }
 
-       if (c && n->child)
-               print_body(p, n->child, m);
+       if ( ! (MAN_NOTEXT & termacts[n->tok].flags))
+               term_fontrepl(p, TERMFONT_NONE);
 
-       switch (n->type) {
-       case (MAN_ELEM):
-               if (termacts[n->tok].post)
-                       (*termacts[n->tok].post)(p, n, m);
-               break;
-       default:
-               break;
+       c = 1;
+       if (termacts[n->tok].pre)
+               c = (*termacts[n->tok].pre)(p, mt, n, meta);
+
+       if (c && n->child)
+               print_man_nodelist(p, mt, n->child, meta);
+
+       if (termacts[n->tok].post)
+               (*termacts[n->tok].post)(p, mt, n, meta);
+       if ( ! (MAN_NOTEXT & termacts[n->tok].flags))
+               term_fontrepl(p, TERMFONT_NONE);
+
+out:
+       /*
+        * If we're in a literal context, make sure that words
+        * together on the same line stay together.  This is a
+        * POST-printing call, so we check the NEXT word.  Since
+        * -man doesn't have nested macros, we don't need to be
+        * more specific than this.
+        */
+       if (MANT_LITERAL & mt->fl && ! (TERMP_NOBREAK & p->flags) &&
+           (NULL == n->next || MAN_LINE & n->next->flags)) {
+               rm = p->rmargin;
+               rmax = p->maxrmargin;
+               p->rmargin = p->maxrmargin = TERM_MAXMARGIN;
+               p->flags |= TERMP_NOSPACE;
+               if (NULL != n->string && '\0' != *n->string)
+                       term_flushln(p);
+               else
+                       term_newln(p);
+               if (rm < rmax && n->parent->tok == MAN_HP) {
+                       p->offset = rm;
+                       p->rmargin = rmax;
+               } else
+                       p->rmargin = rm;
+               p->maxrmargin = rmax;
        }
+       if (MAN_EOS & n->flags)
+               p->flags |= TERMP_SENTENCE;
 }
 
 
 static void
-print_body(DECL_ARGS)
+print_man_nodelist(DECL_ARGS)
 {
-       print_node(p, n, m);
+
+       print_man_node(p, mt, n, meta);
        if ( ! n->next)
                return;
-       print_body(p, n->next, m);
+       print_man_nodelist(p, mt, n->next, meta);
 }
 
 
 static void
-print_foot(struct termp *p, const struct man_meta *meta)
+print_man_foot(struct termp *p, const void *arg)
 {
-       struct tm       *tm;
-       char            *buf;
-
-       if (NULL == (buf = malloc(p->rmargin)))
-               err(1, "malloc");
+       char            title[BUFSIZ];
+       size_t          datelen;
+       const struct man_meta *meta;
 
-       tm = localtime(&meta->date);
+       meta = (const struct man_meta *)arg;
+       assert(meta->title);
+       assert(meta->msec);
+       assert(meta->date);
 
-#ifdef __OpenBSD__
-       if (NULL == strftime(buf, p->rmargin, "%B %d, %Y", tm))
-#else
-       if (0 == strftime(buf, p->rmargin, "%B %d, %Y", tm))
-#endif
-               err(1, "strftime");
+       term_fontrepl(p, TERMFONT_NONE);
 
        term_vspace(p);
 
+       /*
+        * Temporary, undocumented option to imitate mdoc(7) output.
+        * In the bottom right corner, use the source instead of
+        * the title.
+        */
+
+       if ( ! p->mdocstyle) {
+               term_vspace(p);
+               term_vspace(p);
+               snprintf(title, BUFSIZ, "%s(%s)", meta->title, meta->msec);
+       } else if (meta->source) {
+               strlcpy(title, meta->source, BUFSIZ);
+       } else {
+               title[0] = '\0';
+       }
+       datelen = term_strlen(p, meta->date);
+
+       /* Bottom left corner: manual source. */
+
        p->flags |= TERMP_NOSPACE | TERMP_NOBREAK;
-       p->rmargin = p->maxrmargin - strlen(buf);
+       p->trailspace = 1;
        p->offset = 0;
+       p->rmargin = (p->maxrmargin - datelen + term_len(p, 1)) / 2;
 
        if (meta->source)
                term_word(p, meta->source);
-       if (meta->source)
-               term_word(p, "");
        term_flushln(p);
 
-       p->flags |= TERMP_NOLPAD | TERMP_NOSPACE;
+       /* At the bottom in the middle: manual date. */
+
+       p->flags |= TERMP_NOSPACE;
+       p->offset = p->rmargin;
+       p->rmargin = p->maxrmargin - term_strlen(p, title);
+       if (p->offset + datelen >= p->rmargin)
+               p->rmargin = p->offset + datelen;
+
+       term_word(p, meta->date);
+       term_flushln(p);
+
+       /* Bottom right corner: manual title and section. */
+
+       p->flags &= ~TERMP_NOBREAK;
+       p->flags |= TERMP_NOSPACE;
+       p->trailspace = 0;
        p->offset = p->rmargin;
        p->rmargin = p->maxrmargin;
-       p->flags &= ~TERMP_NOBREAK;
 
-       term_word(p, buf);
+       term_word(p, title);
        term_flushln(p);
-
-       free(buf);
 }
 
 
 static void
-print_head(struct termp *p, const struct man_meta *meta)
+print_man_head(struct termp *p, const void *arg)
 {
-       char            *buf, *title;
+       char            buf[BUFSIZ], title[BUFSIZ];
+       size_t          buflen, titlen;
+       const struct man_meta *meta;
 
-       p->rmargin = p->maxrmargin;
-       p->offset = 0;
-
-       if (NULL == (buf = malloc(p->rmargin)))
-               err(1, "malloc");
-       if (NULL == (title = malloc(p->rmargin)))
-               err(1, "malloc");
+       meta = (const struct man_meta *)arg;
+       assert(meta->title);
+       assert(meta->msec);
 
        if (meta->vol)
-               (void)strlcpy(buf, meta->vol, p->rmargin);
+               strlcpy(buf, meta->vol, BUFSIZ);
        else
-               *buf = 0;
+               buf[0] = '\0';
+       buflen = term_strlen(p, buf);
 
-       (void)snprintf(title, p->rmargin, "%s(%d)", 
-                       meta->title, meta->msec);
+       /* Top left corner: manual title and section. */
+
+       snprintf(title, BUFSIZ, "%s(%s)", meta->title, meta->msec);
+       titlen = term_strlen(p, title);
 
-       p->offset = 0;
-       p->rmargin = (p->maxrmargin - strlen(buf)) / 2;
        p->flags |= TERMP_NOBREAK | TERMP_NOSPACE;
+       p->trailspace = 1;
+       p->offset = 0;
+       p->rmargin = 2 * (titlen+1) + buflen < p->maxrmargin ?
+           (p->maxrmargin - 
+            term_strlen(p, buf) + term_len(p, 1)) / 2 :
+           p->maxrmargin - buflen;
 
        term_word(p, title);
        term_flushln(p);
 
-       p->flags |= TERMP_NOLPAD | TERMP_NOSPACE;
+       /* At the top in the middle: manual volume. */
+
+       p->flags |= TERMP_NOSPACE;
        p->offset = p->rmargin;
-       p->rmargin = p->maxrmargin - strlen(title);
+       p->rmargin = p->offset + buflen + titlen < p->maxrmargin ?
+           p->maxrmargin - titlen : p->maxrmargin;
 
        term_word(p, buf);
        term_flushln(p);
 
-       p->offset = p->rmargin;
-       p->rmargin = p->maxrmargin;
-       p->flags &= ~TERMP_NOBREAK;
-       p->flags |= TERMP_NOLPAD | TERMP_NOSPACE;
+       /* Top right corner: title and section, again. */
 
-       term_word(p, title);
-       term_flushln(p);
+       p->flags &= ~TERMP_NOBREAK;
+       p->trailspace = 0;
+       if (p->rmargin + titlen <= p->maxrmargin) {
+               p->flags |= TERMP_NOSPACE;
+               p->offset = p->rmargin;
+               p->rmargin = p->maxrmargin;
+               term_word(p, title);
+               term_flushln(p);
+       }
 
-       p->rmargin = p->maxrmargin;
-       p->offset = 0;
        p->flags &= ~TERMP_NOSPACE;
+       p->offset = 0;
+       p->rmargin = p->maxrmargin;
 
-       free(title);
-       free(buf);
-}
+       /* 
+        * Groff prints three blank lines before the content.
+        * Do the same, except in the temporary, undocumented
+        * mode imitating mdoc(7) output.
+        */
 
+       term_vspace(p);
+       if ( ! p->mdocstyle) {
+               term_vspace(p);
+               term_vspace(p);
+       }
+}