]> git.cameronkatri.com Git - mandoc.git/blobdiff - man_term.c
Adjust -Tman SYNOPSIS .Nm indentation using .HP; requested by millert@.
[mandoc.git] / man_term.c
index ab72059446c08c702e34597645cffecd49a3046f..14e13246969d168211fa5698756a3483ff199bbc 100644 (file)
@@ -1,6 +1,7 @@
-/*     $Id: man_term.c,v 1.34 2009/10/07 12:19:39 kristaps Exp $ */
+/*     $Id: man_term.c,v 1.131 2012/07/13 14:19:49 schwarze Exp $ */
 /*
- * Copyright (c) 2008, 2009 Kristaps Dzonsons <kristaps@kth.se>
+ * Copyright (c) 2008-2012 Kristaps Dzonsons <kristaps@bsd.lv>
+ * Copyright (c) 2010, 2011, 2012 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
  * 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 <ctype.h>
-#include <err.h>
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
 
-#include "term.h"
+#include "mandoc.h"
+#include "out.h"
 #include "man.h"
+#include "term.h"
+#include "main.h"
+
+#define        MAXMARGINS        64 /* maximum number of indented scopes */
 
-#define        INDENT            7
-#define        HALFINDENT        3
+/* FIXME: have PD set the default vspace width. */
 
 struct mtermp {
        int               fl;
 #define        MANT_LITERAL     (1 << 0)
-       /* 
-        * Default amount to indent the left margin after leading text
-        * has been printed (e.g., `HP' left-indent, `TP' and `IP' body
-        * indent).  This needs to be saved because `HP' and so on, if
-        * not having a specified value, must default.
-        *
-        * Note that this is the indentation AFTER the left offset, so
-        * the total offset is usually offset + lmargin.
-        */
-       size_t            lmargin;
-       /*
-        * The default offset, i.e., the amount between any text and the
-        * page boundary.
-        */
-       size_t            offset;
+       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 */
 };
 
 #define        DECL_ARGS         struct termp *p, \
@@ -57,366 +54,385 @@ struct    mtermp {
 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 *);
+
 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_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 int               pre_br(DECL_ARGS);
-static int               pre_fi(DECL_ARGS);
+static int               pre_alternate(DECL_ARGS);
+static int               pre_ft(DECL_ARGS);
 static int               pre_ign(DECL_ARGS);
-static int               pre_nf(DECL_ARGS);
-static int               pre_r(DECL_ARGS);
+static int               pre_in(DECL_ARGS);
+static int               pre_literal(DECL_ARGS);
 static int               pre_sp(DECL_ARGS);
 
-static void              post_B(DECL_ARGS);
-static void              post_I(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 void              post_TP(DECL_ARGS);
-static void              post_i(DECL_ARGS);
 
 static const struct termact termacts[MAN_MAX] = {
-       { pre_br, NULL }, /* br */
-       { NULL, NULL }, /* TH */
-       { pre_SH, post_SH }, /* SH */
-       { pre_SS, post_SS }, /* SS */
-       { pre_TP, post_TP }, /* TP */
-       { pre_PP, NULL }, /* LP */
-       { pre_PP, NULL }, /* PP */
-       { pre_PP, NULL }, /* P */
-       { pre_IP, post_IP }, /* IP */
-       { pre_HP, post_HP }, /* HP */ 
-       { 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 */
-       { NULL, NULL }, /* na */
-       { pre_I, post_i }, /* i */
-       { pre_sp, NULL }, /* sp */
-       { pre_nf, NULL }, /* nf */
-       { pre_fi, NULL }, /* fi */
-       { pre_r, NULL }, /* r */
-       { NULL, NULL }, /* RE */
-       { pre_RS, post_RS }, /* RS */
-       { pre_ign, NULL }, /* DT */
-       { pre_ign, NULL }, /* UC */
+       { 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_ign, NULL, 0 }, /* 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 */
 };
 
-#ifdef __linux__
-extern size_t            strlcpy(char *, const char *, size_t);
-extern size_t            strlcat(char *, const char *, size_t);
-#endif
-
-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 *);
-static void              fmt_block_vspace(struct termp *, 
-                               const struct man_node *);
-static int               arg_width(const struct man_node *);
 
 
 void
-man_run(struct termp *p, const struct man *m)
+terminal_man(void *arg, const struct man *man)
 {
-       struct mtermp    mt;
+       struct termp            *p;
+       const struct man_node   *n;
+       const struct man_meta   *m;
+       struct mtermp            mt;
 
-       print_head(p, man_meta(m));
-       p->flags |= TERMP_NOSPACE;
+       p = (struct termp *)arg;
 
-       mt.fl = 0;
-       mt.lmargin = INDENT;
-       mt.offset = INDENT;
+       if (0 == p->defindent)
+               p->defindent = 7;
 
-       if (man_node(m)->child)
-               print_body(p, &mt, man_node(m)->child, man_meta(m));
-       print_foot(p, man_meta(m));
-}
+       p->overstep = 0;
+       p->maxrmargin = p->defrmargin;
+       p->tabwidth = term_len(p, 5);
 
+       if (NULL == p->symtab)
+               p->symtab = mchars_alloc();
 
-static void
-fmt_block_vspace(struct termp *p, const struct man_node *n)
-{
-       term_newln(p);
+       n = man_node(man);
+       m = man_meta(man);
 
-       if (NULL == n->prev)
-               return;
-
-       if (MAN_SS == n->prev->tok)
-               return;
-       if (MAN_SH == n->prev->tok)
-               return;
-
-       term_vspace(p);
-}
-
-
-static int
-arg_width(const struct man_node *n)
-{
-       int              i, len;
-       const char      *p;
+       term_begin(p, print_man_head, print_man_foot, m);
+       p->flags |= TERMP_NOSPACE;
 
-       assert(MAN_TEXT == n->type);
-       assert(n->string);
+       memset(&mt, 0, sizeof(struct mtermp));
 
-       p = n->string;
+       mt.lmargin[mt.lmargincur] = term_len(p, p->defindent);
+       mt.offset = term_len(p, p->defindent);
 
-       if (0 == (len = (int)strlen(p)))
-               return(-1);
-
-       for (i = 0; i < len; i++) 
-               if ( ! isdigit((u_char)p[i]))
-                       break;
+       if (n->child)
+               print_man_nodelist(p, &mt, n->child, m);
 
-       if (i == len - 1)  {
-               if ('n' == p[len - 1] || 'm' == p[len - 1])
-                       return(atoi(p));
-       } else if (i == len)
-               return(atoi(p));
-
-       return(-1);
+       term_end(p);
 }
 
 
-/* ARGSUSED */
-static int
-pre_ign(DECL_ARGS)
+static size_t
+a2height(const struct termp *p, const char *cp)
 {
+       struct roffsu    su;
 
-       return(0);
-}
-
-
-/* ARGSUSED */
-static int
-pre_I(DECL_ARGS)
-{
+       if ( ! a2roffsu(cp, &su, SCALE_VS))
+               SCALE_VS_INIT(&su, atoi(cp));
 
-       p->under++;
-       return(1);
+       return(term_vspan(p, &su));
 }
 
 
-/* ARGSUSED */
 static int
-pre_r(DECL_ARGS)
+a2width(const struct termp *p, const char *cp)
 {
+       struct roffsu    su;
 
-       p->bold = p->under = 0;
-       return(1);
-}
+       if ( ! a2roffsu(cp, &su, SCALE_BU))
+               return(-1);
 
+       return((int)term_hspan(p, &su));
+}
 
-/* ARGSUSED */
+/*
+ * 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
-post_i(DECL_ARGS)
+print_bvspace(struct termp *p, const struct man_node *n)
 {
 
-       if (n->nchild)
-               p->under--;
-}
+       term_newln(p);
 
+       if (n->body && n->body->child)
+               if (MAN_TBL == n->body->child->type)
+                       return;
 
-/* ARGSUSED */
-static void
-post_I(DECL_ARGS)
-{
+       if (MAN_ROOT == n->parent->type || MAN_RS != n->parent->tok)
+               if (NULL == n->prev)
+                       return;
 
-       p->under--;
+       term_vspace(p);
 }
 
-
 /* ARGSUSED */
 static int
-pre_fi(DECL_ARGS)
+pre_ign(DECL_ARGS)
 {
 
-       mt->fl &= ~MANT_LITERAL;
-       return(1);
+       return(0);
 }
 
 
 /* ARGSUSED */
 static int
-pre_nf(DECL_ARGS)
+pre_I(DECL_ARGS)
 {
 
-       term_newln(p);
-       mt->fl |= MANT_LITERAL;
+       term_fontrepl(p, TERMFONT_UNDER);
        return(1);
 }
 
 
 /* ARGSUSED */
 static int
-pre_IR(DECL_ARGS)
+pre_literal(DECL_ARGS)
 {
-       const struct man_node *nn;
-       int              i;
 
-       for (i = 0, nn = n->child; nn; nn = nn->next, i++) {
-               if ( ! (i % 2))
-                       p->under++;
-               if (i > 0)
-                       p->flags |= TERMP_NOSPACE;
-               print_node(p, mt, nn, m);
-               if ( ! (i % 2))
-                       p->under--;
+       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->flags &= ~(TERMP_NOBREAK | TERMP_TWOSPACE);
+               p->flags |= TERMP_NOSPACE;
        }
+
        return(0);
 }
 
-
 /* ARGSUSED */
 static int
-pre_IB(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;
 
-       for (i = 0, nn = n->child; nn; nn = nn->next, i++) {
-               if (i % 2)
-                       p->bold++;
-               else
-                       p->under++;
-               if (i > 0)
+       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 = 1 - i) {
+               term_fontrepl(p, font[i]);
+               if (savelit && NULL == nn->next)
+                       mt->fl |= MANT_LITERAL;
+               print_man_node(p, mt, nn, m);
+               if (nn->next)
                        p->flags |= TERMP_NOSPACE;
-               print_node(p, mt, nn, m);
-               if (i % 2)
-                       p->bold--;
-               else
-                       p->under--;
        }
+
        return(0);
 }
 
-
 /* ARGSUSED */
 static int
-pre_RB(DECL_ARGS)
+pre_B(DECL_ARGS)
 {
-       const struct man_node *nn;
-       int              i;
 
-       for (i = 0, nn = n->child; nn; nn = nn->next, i++) {
-               if (i % 2)
-                       p->bold++;
-               if (i > 0)
-                       p->flags |= TERMP_NOSPACE;
-               print_node(p, mt, nn, m);
-               if (i % 2)
-                       p->bold--;
-       }
-       return(0);
+       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->under++;
-               if (i > 0)
-                       p->flags |= TERMP_NOSPACE;
-               print_node(p, mt, nn, m);
-               if ( ! (i % 2))
-                       p->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_BR(DECL_ARGS)
+pre_ft(DECL_ARGS)
 {
-       const struct man_node *nn;
-       int              i;
+       const char      *cp;
 
-       for (i = 0, nn = n->child; nn; nn = nn->next, i++) {
-               if ( ! (i % 2))
-                       p->bold++;
-               if (i > 0)
-                       p->flags |= TERMP_NOSPACE;
-               print_node(p, mt, nn, m);
-               if ( ! (i % 2))
-                       p->bold--;
+       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_BI(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->under++;
-               else
-                       p->bold++;
-               if (i > 0)
-                       p->flags |= TERMP_NOSPACE;
-               print_node(p, mt, nn, m);
-               if (i % 2)
-                       p->under--;
-               else
-                       p->bold--;
+       term_newln(p);
+
+       if (NULL == n->child) {
+               p->offset = mt->offset;
+               return(0);
        }
-       return(0);
-}
 
+       cp = n->child->string;
+       less = 0;
 
-/* ARGSUSED */
-static int
-pre_B(DECL_ARGS)
-{
+       if ('-' == *cp)
+               less = -1;
+       else if ('+' == *cp)
+               less = 1;
+       else
+               cp--;
 
-       p->bold++;
-       return(1);
-}
+       if ((len = a2width(p, ++cp)) < 0)
+               return(0);
 
+       v = (size_t)len;
 
-/* ARGSUSED */
-static void
-post_B(DECL_ARGS)
-{
+       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. */
 
-       p->bold--;
+       if (p->offset > p->rmargin)
+               p->offset = p->rmargin;
+
+       return(0);
 }
 
 
@@ -424,29 +440,44 @@ post_B(DECL_ARGS)
 static int
 pre_sp(DECL_ARGS)
 {
-       int              i, len;
+       char            *s;
+       size_t           i, len;
+       int              neg;
+
+       if ((NULL == n->prev && n->parent)) {
+               if (MAN_SS == n->parent->tok)
+                       return(0);
+               if (MAN_SH == n->parent->tok)
+                       return(0);
+       }
 
-       if (NULL == n->child) {
-               term_vspace(p);
-               return(0);
+       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;
        }
 
-       len = atoi(n->child->string);
        if (0 == len)
                term_newln(p);
-       for (i = 0; i < len; i++)
-               term_vspace(p);
-
-       return(0);
-}
-
-
-/* ARGSUSED */
-static int
-pre_br(DECL_ARGS)
-{
+       else if (neg)
+               p->skipvsp += len;
+       else
+               for (i = 0; i < len; i++)
+                       term_vspace(p);
 
-       term_newln(p);
        return(0);
 }
 
@@ -455,39 +486,43 @@ pre_br(DECL_ARGS)
 static int
 pre_HP(DECL_ARGS)
 {
-       size_t                   len;
+       size_t                   len, one;
        int                      ival;
        const struct man_node   *nn;
 
        switch (n->type) {
        case (MAN_BLOCK):
-               fmt_block_vspace(p, n);
+               print_bvspace(p, n);
                return(1);
        case (MAN_BODY):
-               p->flags |= TERMP_NOBREAK;
-               p->flags |= TERMP_TWOSPACE;
                break;
        default:
                return(0);
        }
 
-       len = mt->lmargin;
+       if ( ! (MANT_LITERAL & mt->fl)) {
+               p->flags |= TERMP_NOBREAK;
+               p->flags |= TERMP_TWOSPACE;
+       }
+
+       len = mt->lmargin[mt->lmargincur];
        ival = -1;
 
        /* Calculate offset. */
 
        if (NULL != (nn = n->parent->head->child))
-               if ((ival = arg_width(nn)) >= 0)
+               if ((ival = a2width(p, nn->string)) >= 0)
                        len = (size_t)ival;
 
-       if (0 == len)
-               len = 1;
+       one = term_len(p, 1);
+       if (len < one)
+               len = one;
 
        p->offset = mt->offset;
        p->rmargin = mt->offset + len;
 
        if (ival >= 0)
-               mt->lmargin = (size_t)ival;
+               mt->lmargin[mt->lmargincur] = (size_t)ival;
 
        return(1);
 }
@@ -499,9 +534,6 @@ post_HP(DECL_ARGS)
 {
 
        switch (n->type) {
-       case (MAN_BLOCK):
-               term_flushln(p);
-               break;
        case (MAN_BODY):
                term_flushln(p);
                p->flags &= ~TERMP_NOBREAK;
@@ -522,15 +554,15 @@ pre_PP(DECL_ARGS)
 
        switch (n->type) {
        case (MAN_BLOCK):
-               mt->lmargin = INDENT;
-               fmt_block_vspace(p, n);
+               mt->lmargin[mt->lmargincur] = term_len(p, p->defindent);
+               print_bvspace(p, n);
                break;
        default:
                p->offset = mt->offset;
                break;
        }
 
-       return(1);
+       return(MAN_HEAD != n->type);
 }
 
 
@@ -540,42 +572,36 @@ pre_IP(DECL_ARGS)
 {
        const struct man_node   *nn;
        size_t                   len;
-       int                      ival;
+       int                      savelit, ival;
 
        switch (n->type) {
        case (MAN_BODY):
-               p->flags |= TERMP_NOLPAD;
                p->flags |= TERMP_NOSPACE;
                break;
        case (MAN_HEAD):
                p->flags |= TERMP_NOBREAK;
-               p->flags |= TERMP_TWOSPACE;
                break;
        case (MAN_BLOCK):
-               fmt_block_vspace(p, n);
+               print_bvspace(p, n);
                /* FALLTHROUGH */
        default:
                return(1);
        }
 
-       len = mt->lmargin;
+       len = mt->lmargin[mt->lmargincur];
        ival = -1;
 
-       /* Calculate offset. */
-
+       /* Calculate the offset from the optional second argument. */
        if (NULL != (nn = n->parent->head->child))
-               if (NULL != (nn = nn->next)) {
-                       for ( ; nn->next; nn = nn->next)
-                               /* Do nothing. */ ;
-                       if ((ival = arg_width(nn)) >= 0)
+               if (NULL != (nn = nn->next))
+                       if ((ival = a2width(p, nn->string)) >= 0)
                                len = (size_t)ival;
-               }
 
        switch (n->type) {
        case (MAN_HEAD):
                /* Handle zero-width lengths. */
                if (0 == len)
-                       len = 1;
+                       len = term_len(p, 1);
 
                p->offset = mt->offset;
                p->rmargin = mt->offset + len;
@@ -583,11 +609,17 @@ pre_IP(DECL_ARGS)
                        break;
 
                /* Set the saved left-margin. */
-               mt->lmargin = (size_t)ival;
+               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, m);
+
+               if (savelit)
+                       mt->fl |= MANT_LITERAL;
 
-               /* Don't print the length value. */
-               for (nn = n->child; nn->next; nn = nn->next)
-                       print_node(p, mt, nn, m);
                return(0);
        case (MAN_BODY):
                p->offset = mt->offset + len;
@@ -610,12 +642,10 @@ post_IP(DECL_ARGS)
        case (MAN_HEAD):
                term_flushln(p);
                p->flags &= ~TERMP_NOBREAK;
-               p->flags &= ~TERMP_TWOSPACE;
                p->rmargin = p->maxrmargin;
                break;
        case (MAN_BODY):
-               term_flushln(p);
-               p->flags &= ~TERMP_NOLPAD;
+               term_newln(p);
                break;
        default:
                break;
@@ -629,55 +659,60 @@ pre_TP(DECL_ARGS)
 {
        const struct man_node   *nn;
        size_t                   len;
-       int                      ival;
+       int                      savelit, ival;
 
        switch (n->type) {
        case (MAN_HEAD):
                p->flags |= TERMP_NOBREAK;
-               p->flags |= TERMP_TWOSPACE;
                break;
        case (MAN_BODY):
-               p->flags |= TERMP_NOLPAD;
                p->flags |= TERMP_NOSPACE;
                break;
        case (MAN_BLOCK):
-               fmt_block_vspace(p, n);
+               print_bvspace(p, n);
                /* FALLTHROUGH */
        default:
                return(1);
        }
 
-       len = (size_t)mt->lmargin;
+       len = (size_t)mt->lmargin[mt->lmargincur];
        ival = -1;
 
        /* Calculate offset. */
 
        if (NULL != (nn = n->parent->head->child))
-               if (NULL != nn->next)
-                       if ((ival = arg_width(nn)) >= 0)
+               if (nn->string && nn->parent->line == nn->line)
+                       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 = 1;
+                       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. */
-               for (nn = n->child; nn; nn = nn->next) 
+               for (nn = n->child; nn; nn = nn->next)
                        if (nn->line > n->line)
-                               print_node(p, mt, nn, m);
+                               print_man_node(p, mt, nn, m);
 
+               if (savelit)
+                       mt->fl |= MANT_LITERAL;
                if (ival >= 0)
-                       mt->lmargin = (size_t)ival;
+                       mt->lmargin[mt->lmargincur] = (size_t)ival;
 
                return(0);
        case (MAN_BODY):
                p->offset = mt->offset + len;
                p->rmargin = p->maxrmargin;
+               p->flags &= ~TERMP_NOBREAK;
+               p->flags &= ~TERMP_TWOSPACE;
                break;
        default:
                break;
@@ -695,13 +730,9 @@ post_TP(DECL_ARGS)
        switch (n->type) {
        case (MAN_HEAD):
                term_flushln(p);
-               p->flags &= ~TERMP_NOBREAK;
-               p->flags &= ~TERMP_TWOSPACE;
-               p->rmargin = p->maxrmargin;
                break;
        case (MAN_BODY):
-               term_flushln(p);
-               p->flags &= ~TERMP_NOLPAD;
+               term_newln(p);
                break;
        default:
                break;
@@ -716,8 +747,9 @@ pre_SS(DECL_ARGS)
 
        switch (n->type) {
        case (MAN_BLOCK):
-               mt->lmargin = INDENT;
-               mt->offset = INDENT;
+               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)
@@ -727,8 +759,8 @@ pre_SS(DECL_ARGS)
                term_vspace(p);
                break;
        case (MAN_HEAD):
-               p->bold++;
-               p->offset = HALFINDENT;
+               term_fontrepl(p, TERMFONT_BOLD);
+               p->offset = term_len(p, p->defindent/2);
                break;
        case (MAN_BODY):
                p->offset = mt->offset;
@@ -749,7 +781,6 @@ post_SS(DECL_ARGS)
        switch (n->type) {
        case (MAN_HEAD):
                term_newln(p);
-               p->bold--;
                break;
        case (MAN_BODY):
                term_newln(p);
@@ -767,16 +798,20 @@ pre_SH(DECL_ARGS)
 
        switch (n->type) {
        case (MAN_BLOCK):
-               mt->lmargin = INDENT;
-               mt->offset = INDENT;
+               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;
                term_vspace(p);
                break;
        case (MAN_HEAD):
-               p->bold++;
+               term_fontrepl(p, TERMFONT_BOLD);
                p->offset = 0;
                break;
        case (MAN_BODY):
@@ -798,7 +833,6 @@ post_SH(DECL_ARGS)
        switch (n->type) {
        case (MAN_HEAD):
                term_newln(p);
-               p->bold--;
                break;
        case (MAN_BODY):
                term_newln(p);
@@ -808,13 +842,12 @@ post_SH(DECL_ARGS)
        }
 }
 
-
 /* ARGSUSED */
 static int
 pre_RS(DECL_ARGS)
 {
-       const struct man_node   *nn;
-       int                      ival;
+       int              ival;
+       size_t           sz;
 
        switch (n->type) {
        case (MAN_BLOCK):
@@ -826,176 +859,279 @@ pre_RS(DECL_ARGS)
                break;
        }
 
-       if (NULL == (nn = n->parent->head->child)) {
-               mt->offset = mt->lmargin + INDENT;
-               p->offset = mt->offset;
-               return(1);
-       }
+       sz = term_len(p, p->defindent);
 
-       if ((ival = arg_width(nn)) < 0)
-               return(1);
+       if (NULL != (n = n->parent->head->child))
+               if ((ival = a2width(p, n->string)) >= 0) 
+                       sz = (size_t)ival;
 
-       mt->offset = INDENT + (size_t)ival;
-       p->offset = mt->offset;
+       mt->offset += sz;
+       p->rmargin = p->maxrmargin;
+       p->offset = mt->offset < p->rmargin ? mt->offset : p->rmargin;
+
+       if (++mt->lmarginsz < MAXMARGINS)
+               mt->lmargincur = mt->lmarginsz;
 
+       mt->lmargin[mt->lmargincur] = mt->lmargin[mt->lmargincur - 1];
        return(1);
 }
 
-
 /* ARGSUSED */
 static void
 post_RS(DECL_ARGS)
 {
+       int              ival;
+       size_t           sz;
 
        switch (n->type) {
        case (MAN_BLOCK):
-               mt->offset = mt->lmargin = INDENT;
-               break;
+               return;
+       case (MAN_HEAD):
+               return;
        default:
                term_newln(p);
-               p->offset = INDENT;
                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;
+}
 
 static void
-print_node(DECL_ARGS)
+print_man_node(DECL_ARGS)
 {
-       int              c, sz;
-
-       c = 1;
+       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;
-               /* FIXME: this means that macro lines are munged!  */
-               if (MANT_LITERAL & mt->fl) {
-                       p->flags |= TERMP_NOSPACE;
-                       term_flushln(p);
-               }
-               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:
-               if (termacts[n->tok].pre)
-                       c = (*termacts[n->tok].pre)(p, mt, n, m);
                break;
        }
 
+       if ( ! (MAN_NOTEXT & termacts[n->tok].flags))
+               term_fontrepl(p, TERMFONT_NONE);
+
+       c = 1;
+       if (termacts[n->tok].pre)
+               c = (*termacts[n->tok].pre)(p, mt, n, m);
+
        if (c && n->child)
-               print_body(p, mt, n->child, m);
+               print_man_nodelist(p, mt, n->child, m);
+
+       if (termacts[n->tok].post)
+               (*termacts[n->tok].post)(p, mt, n, m);
+       if ( ! (MAN_NOTEXT & termacts[n->tok].flags))
+               term_fontrepl(p, TERMFONT_NONE);
 
-       if (MAN_TEXT != n->type)
-               if (termacts[n->tok].post)
-                       (*termacts[n->tok].post)(p, mt, n, m);
+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 && n->next->line > n->line) {
+               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, mt, n, m);
+       print_man_node(p, mt, n, m);
        if ( ! n->next)
                return;
-       print_body(p, mt, n->next, m);
+       print_man_nodelist(p, mt, n->next, m);
 }
 
 
 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[BUFSIZ];
+       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);
 
-       if (0 == strftime(buf, p->rmargin, "%B %d, %Y", tm))
-               (void)strlcpy(buf, "(invalid date)", BUFSIZ);
+       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->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;
+       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->offset = p->rmargin;
+       p->rmargin = p->maxrmargin;
 
-       term_word(p, buf);
+       term_word(p, title);
        term_flushln(p);
 }
 
 
 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 *m;
 
-       p->rmargin = p->maxrmargin;
-       p->offset = 0;
+       m = (const struct man_meta *)arg;
+       assert(m->title);
+       assert(m->msec);
 
-       if (NULL == (buf = malloc(p->rmargin)))
-               err(EXIT_FAILURE, "malloc");
-       if (NULL == (title = malloc(p->rmargin)))
-               err(EXIT_FAILURE, "malloc");
-
-       if (meta->vol)
-               (void)strlcpy(buf, meta->vol, p->rmargin);
+       if (m->vol)
+               strlcpy(buf, m->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)", m->title, m->msec);
+       titlen = term_strlen(p, title);
 
-       p->offset = 0;
-       p->rmargin = (p->maxrmargin - strlen(buf) + 1) / 2;
        p->flags |= TERMP_NOBREAK | TERMP_NOSPACE;
+       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;
+       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);
+       }
+}