]> git.cameronkatri.com Git - mandoc.git/blobdiff - roff.c
Abstract ml/mlg/html/xml.
[mandoc.git] / roff.c
diff --git a/roff.c b/roff.c
index b00d32c1c9f7f8e865d2384a58f91015f649e17c..aea3263b1ca4b7fae9955c4583372c7916a836b8 100644 (file)
--- a/roff.c
+++ b/roff.c
@@ -1,4 +1,4 @@
-/* $Id: roff.c,v 1.15 2008/11/28 15:25:49 kristaps Exp $ */
+/* $Id: roff.c,v 1.34 2008/12/02 18:26:57 kristaps Exp $ */
 /*
  * Copyright (c) 2008 Kristaps Dzonsons <kristaps@kth.se>
  *
 /*
  * Copyright (c) 2008 Kristaps Dzonsons <kristaps@kth.se>
  *
@@ -16,6 +16,9 @@
  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  * PERFORMANCE OF THIS SOFTWARE.
  */
  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  * PERFORMANCE OF THIS SOFTWARE.
  */
+#include <sys/param.h>
+#include <sys/types.h>
+
 #include <assert.h>
 #include <ctype.h>
 #include <err.h>
 #include <assert.h>
 #include <ctype.h>
 #include <err.h>
 #include "libmdocml.h"
 #include "private.h"
 
 #include "libmdocml.h"
 #include "private.h"
 
-/* FIXME: warn if Pp occurs before/after Sh etc. (see mdoc.samples). */
-
-/* FIXME: warn about "X section only" macros. */
-
-/* FIXME: warn about empty lists. */
-
-/* FIXME: ; : } ) (etc.) after text macros? */
-
-/* FIXME: NAME section needs specific elements. */
+/* FIXME: First letters of quoted-text interpreted in rofffindtok. */
+/* FIXME: `No' not implemented. */
+/* TODO: warn if Pp occurs before/after Sh etc. (see mdoc.samples). */
+/* TODO: warn about "X section only" macros. */
+/* TODO: warn about empty lists. */
+/* TODO: (warn) some sections need specific elements. */
+/* TODO: (warn) NAME section has particular order. */
+/* TODO: unify empty-content tags a la <br />. */
+/* TODO: macros with a set number of arguments? */
 
 #define        ROFF_MAXARG       32
 
 
 #define        ROFF_MAXARG       32
 
@@ -54,22 +57,22 @@ enum        rofftype {
 
 #define        ROFFCALL_ARGS \
        int tok, struct rofftree *tree, \
 
 #define        ROFFCALL_ARGS \
        int tok, struct rofftree *tree, \
-       const char *argv[], enum roffd type
+       char *argv[], enum roffd type
 
 struct rofftree;
 
 struct rofftok {
        int             (*cb)(ROFFCALL_ARGS);   /* Callback. */
        const int        *args;                 /* Args (or NULL). */
 
 struct rofftree;
 
 struct rofftok {
        int             (*cb)(ROFFCALL_ARGS);   /* Callback. */
        const int        *args;                 /* Args (or NULL). */
-       const int        *parents;
-       const int        *children;
-       int               ctx;
+       const int        *parents;              /* Limit to parents. */
+       const int        *children;             /* Limit to kids. */
+       int               ctx;                  /* Blk-close node. */
        enum rofftype     type;                 /* Type of macro. */
        int               flags;
 #define        ROFF_PARSED      (1 << 0)               /* "Parsed". */
 #define        ROFF_CALLABLE    (1 << 1)               /* "Callable". */
        enum rofftype     type;                 /* Type of macro. */
        int               flags;
 #define        ROFF_PARSED      (1 << 0)               /* "Parsed". */
 #define        ROFF_CALLABLE    (1 << 1)               /* "Callable". */
-#define        ROFF_QUOTES      (1 << 2)               /* Quoted args. */
-#define        ROFF_SHALLOW     (1 << 3)               /* Nesting block. */
+#define        ROFF_SHALLOW     (1 << 2)               /* Nesting block. */
+#define        ROFF_LSCOPE      (1 << 3)               /* Line scope. */
 };
 
 struct roffarg {
 };
 
 struct roffarg {
@@ -84,43 +87,38 @@ struct      roffnode {
 
 struct rofftree {
        struct roffnode  *last;                 /* Last parsed node. */
 
 struct rofftree {
        struct roffnode  *last;                 /* Last parsed node. */
-       char             *cur;
-
-       time_t            date;                 /* `Dd' results. */
+       char             *cur;                  /* Line start. */
+       struct tm         tm;                   /* `Dd' results. */
        char              os[64];               /* `Os' results. */
        char              title[64];            /* `Dt' results. */
        char              section[64];          /* `Dt' results. */
        char              volume[64];           /* `Dt' results. */
        char              os[64];               /* `Os' results. */
        char              title[64];            /* `Dt' results. */
        char              section[64];          /* `Dt' results. */
        char              volume[64];           /* `Dt' results. */
-
        int               state;
 #define        ROFF_PRELUDE     (1 << 1)               /* In roff prelude. */
 #define        ROFF_PRELUDE_Os  (1 << 2)               /* `Os' is parsed. */
 #define        ROFF_PRELUDE_Dt  (1 << 3)               /* `Dt' is parsed. */
 #define        ROFF_PRELUDE_Dd  (1 << 4)               /* `Dd' is parsed. */
 #define        ROFF_BODY        (1 << 5)               /* In roff body. */
        int               state;
 #define        ROFF_PRELUDE     (1 << 1)               /* In roff prelude. */
 #define        ROFF_PRELUDE_Os  (1 << 2)               /* `Os' is parsed. */
 #define        ROFF_PRELUDE_Dt  (1 << 3)               /* `Dt' is parsed. */
 #define        ROFF_PRELUDE_Dd  (1 << 4)               /* `Dd' is parsed. */
 #define        ROFF_BODY        (1 << 5)               /* In roff body. */
-
-       struct roffcb     cb;
-       void             *arg;
+       struct roffcb     cb;                   /* Callbacks. */
+       void             *arg;                  /* Callbacks' arg. */
 };
 
 static int               roff_Dd(ROFFCALL_ARGS);
 static int               roff_Dt(ROFFCALL_ARGS);
 static int               roff_Os(ROFFCALL_ARGS);
 };
 
 static int               roff_Dd(ROFFCALL_ARGS);
 static int               roff_Dt(ROFFCALL_ARGS);
 static int               roff_Os(ROFFCALL_ARGS);
-
+static int               roff_Ns(ROFFCALL_ARGS);
+static int               roff_Sm(ROFFCALL_ARGS);
 static int               roff_layout(ROFFCALL_ARGS);
 static int               roff_text(ROFFCALL_ARGS);
 static int               roff_layout(ROFFCALL_ARGS);
 static int               roff_text(ROFFCALL_ARGS);
-static int               roff_comment(ROFFCALL_ARGS);
-static int               roff_close(ROFFCALL_ARGS);
-static int               roff_special(ROFFCALL_ARGS);
-
+static int               roff_noop(ROFFCALL_ARGS);
+static int               roff_depr(ROFFCALL_ARGS);
 static struct roffnode  *roffnode_new(int, struct rofftree *);
 static void              roffnode_free(struct rofftree *);
 static struct roffnode  *roffnode_new(int, struct rofftree *);
 static void              roffnode_free(struct rofftree *);
-
 static void              roff_warn(const struct rofftree *, 
                                const char *, char *, ...);
 static void              roff_err(const struct rofftree *, 
                                const char *, char *, ...);
 static void              roff_warn(const struct rofftree *, 
                                const char *, char *, ...);
 static void              roff_err(const struct rofftree *, 
                                const char *, char *, ...);
-
+static int               roffpurgepunct(struct rofftree *, char **);
 static int               roffscan(int, const int *);
 static int               rofffindtok(const char *);
 static int               rofffindarg(const char *);
 static int               roffscan(int, const int *);
 static int               rofffindtok(const char *);
 static int               rofffindarg(const char *);
@@ -129,70 +127,74 @@ static    int               roffargs(const struct rofftree *,
                                int, char *, char **);
 static int               roffargok(int, int);
 static int               roffnextopt(const struct rofftree *,
                                int, char *, char **);
 static int               roffargok(int, int);
 static int               roffnextopt(const struct rofftree *,
-                               int, const char ***, char **);
-static int               roffparse(struct rofftree *, char *, size_t);
-static int               textparse(const struct rofftree *,
-                               const char *, size_t);
-
-
-static const int roffarg_An[] = { ROFF_Split, ROFF_Nosplit, 
-       ROFF_ARGMAX };
-static const int roffarg_Bd[] = { ROFF_Ragged, ROFF_Unfilled, 
-       ROFF_Literal, ROFF_File, ROFF_Offset, ROFF_Filled,
-       ROFF_Compact, ROFF_ARGMAX };
+                               int, char ***, char **);
+static int               roffparseopts(struct rofftree *, int, 
+                               char ***, int *, char **);
+static int               roffcall(struct rofftree *, int, char **);
+static int               roffparse(struct rofftree *, char *);
+static int               textparse(const struct rofftree *, char *);
+
+#ifdef __linux__ /* FIXME: remove */
+static size_t            strlcat(char *, const char *, size_t);
+static size_t            strlcpy(char *, const char *, size_t);
+extern int               vsnprintf(char *, size_t, 
+                               const char *, va_list);
+extern char             *strptime(const char *, const char *,
+                               struct tm *);
+#endif
+
+
+static const int roffarg_An[] = { ROFF_Split, ROFF_Nosplit, ROFF_ARGMAX };
+static const int roffarg_Bd[] = { ROFF_Ragged, ROFF_Unfilled, ROFF_Literal,
+       ROFF_File, ROFF_Offset, ROFF_Filled, ROFF_Compact, ROFF_ARGMAX };
 static const int roffarg_Bk[] = { ROFF_Words, ROFF_ARGMAX };
 static const int roffarg_Ex[] = { ROFF_Std, ROFF_ARGMAX };
 static const int roffarg_Rv[] = { ROFF_Std, ROFF_ARGMAX };
 static const int roffarg_Bk[] = { ROFF_Words, ROFF_ARGMAX };
 static const int roffarg_Ex[] = { ROFF_Std, ROFF_ARGMAX };
 static const int roffarg_Rv[] = { ROFF_Std, ROFF_ARGMAX };
-static         const int roffarg_Bl[] = { ROFF_Bullet, ROFF_Dash, 
-       ROFF_Hyphen, ROFF_Item, ROFF_Enum, ROFF_Tag, ROFF_Diag, 
-       ROFF_Hang, ROFF_Ohang, ROFF_Inset, ROFF_Column, ROFF_Offset, 
-       ROFF_Width, ROFF_Compact, ROFF_ARGMAX };
-static         const int roffarg_St[] = {
-       ROFF_p1003_1_88, ROFF_p1003_1_90, ROFF_p1003_1_96,
-       ROFF_p1003_1_2001, ROFF_p1003_1_2004, ROFF_p1003_1,
-       ROFF_p1003_1b, ROFF_p1003_1b_93, ROFF_p1003_1c_95,
-       ROFF_p1003_1g_2000, ROFF_p1003_2_92, ROFF_p1387_2_95,
-       ROFF_p1003_2, ROFF_p1387_2, ROFF_isoC_90, ROFF_isoC_amd1,
-       ROFF_isoC_tcor1, ROFF_isoC_tcor2, ROFF_isoC_99, ROFF_ansiC,
-       ROFF_ansiC_89, ROFF_ansiC_99, ROFF_ieee754, ROFF_iso8802_3,
-       ROFF_xpg3, ROFF_xpg4, ROFF_xpg4_2, ROFF_xpg4_3, ROFF_xbd5,
-       ROFF_xcu5, ROFF_xsh5, ROFF_xns5, ROFF_xns5_2d2_0,
-       ROFF_xcurses4_2, ROFF_susv2, ROFF_susv3, ROFF_svid4,
+static         const int roffarg_Bl[] = { ROFF_Bullet, ROFF_Dash, ROFF_Hyphen,
+       ROFF_Item, ROFF_Enum, ROFF_Tag, ROFF_Diag, ROFF_Hang, ROFF_Ohang,
+       ROFF_Inset, ROFF_Column, ROFF_Offset, ROFF_Width, ROFF_Compact,
        ROFF_ARGMAX };
        ROFF_ARGMAX };
+static         const int roffarg_St[] = { ROFF_p1003_1_88, ROFF_p1003_1_90,
+       ROFF_p1003_1_96, ROFF_p1003_1_2001, ROFF_p1003_1_2004, ROFF_p1003_1,
+       ROFF_p1003_1b, ROFF_p1003_1b_93, ROFF_p1003_1c_95, ROFF_p1003_1g_2000,
+       ROFF_p1003_2_92, ROFF_p1387_2_95, ROFF_p1003_2, ROFF_p1387_2,
+       ROFF_isoC_90, ROFF_isoC_amd1, ROFF_isoC_tcor1, ROFF_isoC_tcor2,
+       ROFF_isoC_99, ROFF_ansiC, ROFF_ansiC_89, ROFF_ansiC_99, ROFF_ieee754,
+       ROFF_iso8802_3, ROFF_xpg3, ROFF_xpg4, ROFF_xpg4_2, ROFF_xpg4_3,
+       ROFF_xbd5, ROFF_xcu5, ROFF_xsh5, ROFF_xns5, ROFF_xns5_2d2_0,
+       ROFF_xcurses4_2, ROFF_susv2, ROFF_susv3, ROFF_svid4, ROFF_ARGMAX };
 
 static const int roffchild_Bl[] = { ROFF_It, ROFF_El, ROFF_MAX };
 static const int roffchild_Fo[] = { ROFF_Fa, ROFF_Fc, ROFF_MAX };
 
 static const int roffchild_Bl[] = { ROFF_It, ROFF_El, ROFF_MAX };
 static const int roffchild_Fo[] = { ROFF_Fa, ROFF_Fc, ROFF_MAX };
-static const int roffchild_Oo[] = { ROFF_Op, ROFF_Oc, ROFF_MAX };
-static const int roffchild_Rs[] = { ROFF_Re, ROFF__A, ROFF__B,
-       ROFF__D, ROFF__I, ROFF__J, ROFF__N, ROFF__O, ROFF__P,
-       ROFF__R, ROFF__T, ROFF__V, ROFF_MAX };
+static const int roffchild_Rs[] = { ROFF_Re, ROFF__A, ROFF__B, ROFF__D,
+       ROFF__I, ROFF__J, ROFF__N, ROFF__O, ROFF__P, ROFF__R, ROFF__T, ROFF__V,
+       ROFF_MAX };
 
 static const int roffparent_El[] = { ROFF_Bl, ROFF_It, ROFF_MAX };
 static const int roffparent_Fc[] = { ROFF_Fo, ROFF_Fa, ROFF_MAX };
 
 static const int roffparent_El[] = { ROFF_Bl, ROFF_It, ROFF_MAX };
 static const int roffparent_Fc[] = { ROFF_Fo, ROFF_Fa, ROFF_MAX };
-static const int roffparent_Oc[] = { ROFF_Oo, ROFF_Oc, ROFF_MAX };
+static const int roffparent_Oc[] = { ROFF_Oo, ROFF_MAX };
 static const int roffparent_It[] = { ROFF_Bl, ROFF_It, ROFF_MAX };
 static const int roffparent_Re[] = { ROFF_Rs, ROFF_MAX };
 
 static const int roffparent_It[] = { ROFF_Bl, ROFF_It, ROFF_MAX };
 static const int roffparent_Re[] = { ROFF_Rs, ROFF_MAX };
 
-/* Table of all known tokens. */
 static const struct rofftok tokens[ROFF_MAX] = {
 static const struct rofftok tokens[ROFF_MAX] = {
-       {roff_comment, NULL, NULL, NULL, 0, ROFF_COMMENT, 0 }, /* \" */
+       {   roff_noop, NULL, NULL, NULL, 0, ROFF_COMMENT, 0 }, /* \" */
        {     roff_Dd, NULL, NULL, NULL, 0, ROFF_TEXT, 0 }, /* Dd */
        {     roff_Dt, NULL, NULL, NULL, 0, ROFF_TEXT, 0 }, /* Dt */
        {     roff_Dd, NULL, NULL, NULL, 0, ROFF_TEXT, 0 }, /* Dd */
        {     roff_Dt, NULL, NULL, NULL, 0, ROFF_TEXT, 0 }, /* Dt */
-       {     roff_Os, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_QUOTES }, /* Os */
-       { roff_layout, NULL, NULL, NULL, ROFF_Sh, ROFF_LAYOUT, ROFF_PARSED }, /* Sh */
-       { roff_layout, NULL, NULL, NULL, ROFF_Ss, ROFF_LAYOUT, ROFF_PARSED }, /* Ss */ 
-       {   roff_text, NULL, NULL, NULL, ROFF_Pp, ROFF_TEXT, 0 }, /* Pp */
-       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED }, /* D1 */
-       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED }, /* Dl */
+       {     roff_Os, NULL, NULL, NULL, 0, ROFF_TEXT, 0 }, /* Os */
+       { roff_layout, NULL, NULL, NULL, ROFF_Sh, ROFF_LAYOUT, 0 }, /* Sh */
+       { roff_layout, NULL, NULL, NULL, ROFF_Ss, ROFF_LAYOUT, 0 }, /* Ss */ 
+       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, 0 }, /* Pp */ /* XXX 0 args */
+       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_LSCOPE }, /* D1 */
+       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_LSCOPE }, /* Dl */
        { roff_layout, roffarg_Bd, NULL, NULL, 0, ROFF_LAYOUT, 0 },     /* Bd */
        { roff_layout, roffarg_Bd, NULL, NULL, 0, ROFF_LAYOUT, 0 },     /* Bd */
-       {  roff_close, NULL, NULL, NULL, ROFF_Bd, ROFF_LAYOUT, 0 }, /* Ed */
+       {   roff_noop, NULL, NULL, NULL, ROFF_Bd, ROFF_LAYOUT, 0 }, /* Ed */
        { roff_layout, roffarg_Bl, NULL, roffchild_Bl, 0, ROFF_LAYOUT, 0 }, /* Bl */
        { roff_layout, roffarg_Bl, NULL, roffchild_Bl, 0, ROFF_LAYOUT, 0 }, /* Bl */
-       {  roff_close, NULL, roffparent_El, NULL, ROFF_Bl, ROFF_LAYOUT, 0 }, /* El */
-       { roff_layout, NULL, roffparent_It, NULL, ROFF_It, ROFF_LAYOUT, ROFF_SHALLOW }, /* It */
-       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Ad */
+       {   roff_noop, NULL, roffparent_El, NULL, ROFF_Bl, ROFF_LAYOUT, 0 }, /* El */
+       { roff_layout, NULL, roffparent_It, NULL, ROFF_It, ROFF_LAYOUT, ROFF_PARSED | ROFF_SHALLOW }, /* It */
+       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Ad */ /* FIXME */
        {   roff_text, roffarg_An, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED }, /* An */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Ar */
        {   roff_text, roffarg_An, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED }, /* An */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Ar */
-       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_QUOTES }, /* Cd */ /* XXX man.4 only */
+       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, 0 }, /* Cd */ /* XXX man.4 only */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Cm */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Dv */ /* XXX needs arg */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Er */ /* XXX needs arg */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Cm */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Dv */ /* XXX needs arg */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Er */ /* XXX needs arg */
@@ -206,10 +208,10 @@ static    const struct rofftok tokens[ROFF_MAX] = {
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Ic */ /* XXX needs arg */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, 0 }, /* In */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Li */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Ic */ /* XXX needs arg */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, 0 }, /* In */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Li */
-       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_QUOTES }, /* Nd */
+       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, 0 }, /* Nd */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Nm */ /* FIXME */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Nm */ /* FIXME */
-       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Op */
-       {   NULL, NULL, NULL, NULL, 0, ROFF_TEXT, 0 }, /* Ot */ /* XXX deprecated */
+       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE | ROFF_LSCOPE }, /* Op */
+       {   roff_depr, NULL, NULL, NULL, 0, ROFF_TEXT, 0 }, /* Ot */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Pa */
        {   roff_text, roffarg_Rv, NULL, NULL, 0, ROFF_TEXT, 0 }, /* Rv */
        {   roff_text, roffarg_St, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* St */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Pa */
        {   roff_text, roffarg_Rv, NULL, NULL, 0, ROFF_TEXT, 0 }, /* Rv */
        {   roff_text, roffarg_St, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* St */
@@ -229,42 +231,42 @@ static    const struct rofftok tokens[ROFF_MAX] = {
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, 0 }, /* %V */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Ac */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Ao */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, 0 }, /* %V */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Ac */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Ao */
-       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Aq */
+       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE | ROFF_LSCOPE }, /* Aq */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, 0 }, /* At */ /* XXX at most 2 args */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Bc */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, 0 }, /* At */ /* XXX at most 2 args */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Bc */
-       {   NULL, NULL, NULL, NULL, 0, ROFF_TEXT, 0 },  /* Bf */ /* FIXME */
+       { roff_layout, NULL, NULL, NULL, 0, ROFF_LAYOUT, 0 }, /* Bf */ /* FIXME */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Bo */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Bo */
-       {   NULL, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Bq */
+       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE | ROFF_LSCOPE }, /* Bq */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED }, /* Bsx */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED }, /* Bx */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED }, /* Bsx */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED }, /* Bx */
-       {roff_special, NULL, NULL, NULL, 0, ROFF_SPECIAL, 0 },  /* Db */
+       {        NULL, NULL, NULL, NULL, 0, ROFF_SPECIAL, 0 },  /* Db */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Dc */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Do */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Dc */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Do */
-       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Dq */
+       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE | ROFF_LSCOPE }, /* Dq */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Ec */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Ec */
-       {   NULL, NULL, NULL, NULL, 0, ROFF_TEXT, 0 },  /* Ef */ /* FIXME */
+       {   roff_noop, NULL, NULL, NULL, ROFF_Bf, ROFF_LAYOUT, 0 }, /* Ef */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Em */ /* XXX needs arg */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Eo */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED }, /* Fx */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED }, /* Ms */
        {   NULL, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* No */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Em */ /* XXX needs arg */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Eo */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED }, /* Fx */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED }, /* Ms */
        {   NULL, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* No */
-       {   NULL, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Ns */
+       {     roff_Ns, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Ns */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED }, /* Nx */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED }, /* Ox */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Pc */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED }, /* Nx */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED }, /* Ox */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Pc */
-       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED }, /* Pf */
-       {   roff_text, NULL, NULL, NULL, 0, ROFF_LAYOUT, ROFF_PARSED | ROFF_CALLABLE }, /* Po */
-       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Pq */
+       {        NULL, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED }, /* Pf */
+       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Po */
+       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE | ROFF_LSCOPE }, /* Pq */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Qc */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Ql */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Qc */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Ql */
-       { roff_layout, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Qo */
-       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Qq */
-       {  roff_close, NULL, roffparent_Re, NULL, ROFF_Rs, ROFF_LAYOUT, 0 }, /* Re */
+       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Qo */
+       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE | ROFF_LSCOPE }, /* Qq */
+       {   roff_noop, NULL, roffparent_Re, NULL, ROFF_Rs, ROFF_LAYOUT, 0 }, /* Re */
        { roff_layout, NULL, NULL, roffchild_Rs, 0, ROFF_LAYOUT, 0 },   /* Rs */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Sc */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* So */
        { roff_layout, NULL, NULL, roffchild_Rs, 0, ROFF_LAYOUT, 0 },   /* Rs */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Sc */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* So */
-       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Sq */
-       {roff_special, NULL, NULL, NULL, 0, ROFF_SPECIAL, 0 }, /* Sm */
+       {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE | ROFF_LSCOPE }, /* Sq */
+       {     roff_Sm, NULL, NULL, NULL, 0, ROFF_TEXT, 0 }, /* Sm */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Sx */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Sy */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Tn */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Sx */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Sy */
        {   roff_text, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Tn */
@@ -272,20 +274,23 @@ static    const struct rofftok tokens[ROFF_MAX] = {
        {   NULL, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Xc */
        {   NULL, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Xo */
        { roff_layout, NULL, NULL, roffchild_Fo, 0, ROFF_LAYOUT, 0 }, /* Fo */
        {   NULL, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Xc */
        {   NULL, NULL, NULL, NULL, 0, ROFF_TEXT, ROFF_PARSED | ROFF_CALLABLE }, /* Xo */
        { roff_layout, NULL, NULL, roffchild_Fo, 0, ROFF_LAYOUT, 0 }, /* Fo */
-       {  roff_close, NULL, roffparent_Fc, NULL, ROFF_Fo, ROFF_LAYOUT, 0 }, /* Fc */
-       { roff_layout, NULL, NULL, roffchild_Oo, 0, ROFF_LAYOUT, 0 }, /* Oo */
-       {  roff_close, NULL, roffparent_Oc, NULL, ROFF_Oo, ROFF_LAYOUT, 0 }, /* Oc */
+       {   roff_noop, NULL, roffparent_Fc, NULL, ROFF_Fo, ROFF_LAYOUT, 0 }, /* Fc */
+       { roff_layout, NULL, NULL, NULL, 0, ROFF_LAYOUT, 0 }, /* Oo */
+       {   roff_noop, NULL, roffparent_Oc, NULL, ROFF_Oo, ROFF_LAYOUT, 0 }, /* Oc */
        { roff_layout, roffarg_Bk, NULL, NULL, 0, ROFF_LAYOUT, 0 }, /* Bk */
        { roff_layout, roffarg_Bk, NULL, NULL, 0, ROFF_LAYOUT, 0 }, /* Bk */
-       {  roff_close, NULL, NULL, NULL, ROFF_Bk, ROFF_LAYOUT, 0 }, /* Ek */
+       {   roff_noop, NULL, NULL, NULL, ROFF_Bk, ROFF_LAYOUT, 0 }, /* Ek */
+       {        NULL, NULL, NULL, NULL, 0, ROFF_TEXT, 0 }, /* Bt */
+       {        NULL, NULL, NULL, NULL, 0, ROFF_TEXT, 0 }, /* Hf */
+       {   roff_depr, NULL, NULL, NULL, 0, ROFF_TEXT, 0 }, /* Fr */
+       {        NULL, NULL, NULL, NULL, 0, ROFF_TEXT, 0 }, /* Ud */
        };
 
        };
 
-/* Table of all known token arguments. */
 static const int tokenargs[ROFF_ARGMAX] = {
        0,              0,              0,              0,
        0,              ROFF_VALUE,     ROFF_VALUE,     0,
        0,              0,              0,              0,
        0,              0,              0,              0,
 static const int tokenargs[ROFF_ARGMAX] = {
        0,              0,              0,              0,
        0,              ROFF_VALUE,     ROFF_VALUE,     0,
        0,              0,              0,              0,
        0,              0,              0,              0,
-       0,              0,              0,              0,
+       0,              0,              ROFF_VALUE,     0,
        0,              0,              0,              0,
        0,              0,              0,              0,
        0,              0,              0,              0,
        0,              0,              0,              0,
        0,              0,              0,              0,
        0,              0,              0,              0,
@@ -309,8 +314,11 @@ const      char *const toknamesp[ROFF_MAX] = {
        "Ic",           "In",           "Li",           "Nd",
        "Nm",           "Op",           "Ot",           "Pa",
        "Rv",           "St",           "Va",           "Vt",
        "Ic",           "In",           "Li",           "Nd",
        "Nm",           "Op",           "Ot",           "Pa",
        "Rv",           "St",           "Va",           "Vt",
+       /* LINTED */
        "Xr",           "\%A",          "\%B",          "\%D",
        "Xr",           "\%A",          "\%B",          "\%D",
+       /* LINTED */
        "\%I",          "\%J",          "\%N",          "\%O",
        "\%I",          "\%J",          "\%N",          "\%O",
+       /* LINTED */
        "\%P",          "\%R",          "\%T",          "\%V",
        "Ac",           "Ao",           "Aq",           "At",
        "Bc",           "Bf",           "Bo",           "Bq",
        "\%P",          "\%R",          "\%T",          "\%V",
        "Ac",           "Ao",           "Aq",           "At",
        "Bc",           "Bf",           "Bo",           "Bq",
@@ -324,7 +332,8 @@ const       char *const toknamesp[ROFF_MAX] = {
        "Sq",           "Sm",           "Sx",           "Sy",
        "Tn",           "Ux",           "Xc",           "Xo",
        "Fo",           "Fc",           "Oo",           "Oc",
        "Sq",           "Sm",           "Sx",           "Sy",
        "Tn",           "Ux",           "Xc",           "Xo",
        "Fo",           "Fc",           "Oo",           "Oc",
-       "Bk",           "Ek",
+       "Bk",           "Ek",           "Bt",           "Hf",
+       "Fr",           "Ud",
        };
 
 const  char *const tokargnamesp[ROFF_ARGMAX] = {                
        };
 
 const  char *const tokargnamesp[ROFF_ARGMAX] = {                
@@ -357,27 +366,47 @@ const     char *const *tokargnames = tokargnamesp;
 int
 roff_free(struct rofftree *tree, int flush)
 {
 int
 roff_free(struct rofftree *tree, int flush)
 {
-       int              error;
+       int              error, t;
        struct roffnode *n;
 
        error = 0;
 
        struct roffnode *n;
 
        error = 0;
 
-       for (n = tree->last; n->parent; n = n->parent)
-               if (tokens[n->tok].ctx == 0) {
-                       roff_warn(tree, NULL, "closing explicit scope "
-                                       "of `%s'", toknames[n->tok]);
-                       error = 1;
-               }
+       if ( ! flush)
+               goto end;
+
+       error = 1;
+
+       if (ROFF_PRELUDE & tree->state) {
+               roff_err(tree, NULL, "prelude never finished");
+               goto end;
+       } 
+
+       for (n = tree->last; n; n = n->parent) {
+               if (0 != tokens[n->tok].ctx) 
+                       continue;
+               roff_err(tree, NULL, "closing explicit scope `%s'", 
+                               toknames[n->tok]);
+               goto end;
+       }
 
 
-       if (0 == error && (ROFF_PRELUDE & tree->state)) {
-               roff_warn(tree, NULL, "prelude never finished");
-               error = 1;
+       while (tree->last) {
+               t = tree->last->tok;
+               if ( ! (*tokens[t].cb)(t, tree, NULL, ROFF_EXIT))
+                       goto end;
        }
 
        }
 
+       if ( ! (*tree->cb.rofftail)(tree->arg))
+               goto end;
+
+       error = 0;
+
+end:
+
        while (tree->last) 
                roffnode_free(tree);
 
        free(tree);
        while (tree->last) 
                roffnode_free(tree);
 
        free(tree);
+
        return(error ? 0 : 1);
 }
 
        return(error ? 0 : 1);
 }
 
@@ -387,6 +416,9 @@ roff_alloc(const struct roffcb *cb, void *args)
 {
        struct rofftree *tree;
 
 {
        struct rofftree *tree;
 
+       assert(args);
+       assert(cb);
+
        if (NULL == (tree = calloc(1, sizeof(struct rofftree))))
                err(1, "calloc");
 
        if (NULL == (tree = calloc(1, sizeof(struct rofftree))))
                err(1, "calloc");
 
@@ -400,27 +432,31 @@ roff_alloc(const struct roffcb *cb, void *args)
 
 
 int
 
 
 int
-roff_engine(struct rofftree *tree, char *buf, size_t sz)
+roff_engine(struct rofftree *tree, char *buf)
 {
 
 {
 
-       tree->cur = NULL;
+       tree->cur = buf;
+       assert(buf);
 
 
-       if (0 == sz) {
-               roff_warn(tree, buf, "blank line");
+       if (0 == *buf) {
+               roff_err(tree, buf, "blank line");
                return(0);
        } else if ('.' != *buf)
                return(0);
        } else if ('.' != *buf)
-               return(textparse(tree, buf, sz));
+               return(textparse(tree, buf));
 
 
-       return(roffparse(tree, buf, sz));
+       return(roffparse(tree, buf));
 }
 
 
 static int
 }
 
 
 static int
-textparse(const struct rofftree *tree, const char *buf, size_t sz)
+textparse(const struct rofftree *tree, char *buf)
 {
 {
-       
-       /* Print text. */
-       return(1);
+
+       if ( ! (ROFF_BODY & tree->state)) {
+               roff_err(tree, buf, "data not in body");
+               return(0);
+       }
+       return((*tree->cb.roffdata)(tree->arg, 1, buf));
 }
 
 
 }
 
 
@@ -473,7 +509,6 @@ roffargs(const struct rofftree *tree,
 }
 
 
 }
 
 
-/* XXX */
 static int
 roffscan(int tok, const int *tokv)
 {
 static int
 roffscan(int tok, const int *tokv)
 {
@@ -490,14 +525,16 @@ roffscan(int tok, const int *tokv)
 
 
 static int
 
 
 static int
-roffparse(struct rofftree *tree, char *buf, size_t sz)
+roffparse(struct rofftree *tree, char *buf)
 {
        int               tok, t;
        struct roffnode  *n;
        char             *argv[ROFF_MAXARG];
 {
        int               tok, t;
        struct roffnode  *n;
        char             *argv[ROFF_MAXARG];
-       const char      **argvp;
+       char            **argvp;
 
 
-       assert(sz > 0);
+       if (0 != *buf && 0 != *(buf + 1) && 0 != *(buf + 2))
+               if (0 == strncmp(buf, ".\\\"", 3))
+                       return(1);
 
        if (ROFF_MAX == (tok = rofffindtok(buf + 1))) {
                roff_err(tree, buf + 1, "bogus line macro");
 
        if (ROFF_MAX == (tok = rofffindtok(buf + 1))) {
                roff_err(tree, buf + 1, "bogus line macro");
@@ -506,13 +543,13 @@ roffparse(struct rofftree *tree, char *buf, size_t sz)
                roff_err(tree, buf + 1, "unsupported macro `%s'", 
                                toknames[tok]);
                return(0);
                roff_err(tree, buf + 1, "unsupported macro `%s'", 
                                toknames[tok]);
                return(0);
-       } else if (ROFF_COMMENT == tokens[tok].type)
-               return(1);
-       
+       }
+
+       assert(ROFF___ != tok);
        if ( ! roffargs(tree, tok, buf, argv)) 
                return(0);
 
        if ( ! roffargs(tree, tok, buf, argv)) 
                return(0);
 
-       argvp = (const char **)argv;
+       argvp = (char **)argv;
 
        /* 
         * Prelude macros break some assumptions, so branch now. 
 
        /* 
         * Prelude macros break some assumptions, so branch now. 
@@ -521,8 +558,7 @@ roffparse(struct rofftree *tree, char *buf, size_t sz)
        if (ROFF_PRELUDE & tree->state) {
                assert(NULL == tree->last);
                return((*tokens[tok].cb)(tok, tree, argvp, ROFF_ENTER));
        if (ROFF_PRELUDE & tree->state) {
                assert(NULL == tree->last);
                return((*tokens[tok].cb)(tok, tree, argvp, ROFF_ENTER));
-       } else 
-               assert(tree->last);
+       } 
 
        assert(ROFF_BODY & tree->state);
 
 
        assert(ROFF_BODY & tree->state);
 
@@ -531,17 +567,19 @@ roffparse(struct rofftree *tree, char *buf, size_t sz)
         * children are satisfied.  
         */
 
         * children are satisfied.  
         */
 
-       if ( ! roffscan(tree->last->tok, tokens[tok].parents)) {
+       if (tree->last && ! roffscan
+                       (tree->last->tok, tokens[tok].parents)) {
                roff_err(tree, *argvp, "`%s' has invalid parent `%s'",
                                toknames[tok], 
                                toknames[tree->last->tok]);
                return(0);
        } 
 
                roff_err(tree, *argvp, "`%s' has invalid parent `%s'",
                                toknames[tok], 
                                toknames[tree->last->tok]);
                return(0);
        } 
 
-       if ( ! roffscan(tok, tokens[tree->last->tok].children)) {
-               roff_err(tree, *argvp, "`%s' is invalid child `%s'",
-                               toknames[tree->last->tok],
-                               toknames[tok]);
+       if (tree->last && ! roffscan
+                       (tok, tokens[tree->last->tok].children)) {
+               roff_err(tree, *argvp, "`%s' is invalid child of `%s'",
+                               toknames[tok],
+                               toknames[tree->last->tok]);
                return(0);
        }
 
                return(0);
        }
 
@@ -551,11 +589,6 @@ roffparse(struct rofftree *tree, char *buf, size_t sz)
 
        if (ROFF_LAYOUT != tokens[tok].type)
                return((*tokens[tok].cb)(tok, tree, argvp, ROFF_ENTER));
 
        if (ROFF_LAYOUT != tokens[tok].type)
                return((*tokens[tok].cb)(tok, tree, argvp, ROFF_ENTER));
-
-       /* 
-        * Check our scope rules. 
-        */
-
        if (0 == tokens[tok].ctx)
                return((*tokens[tok].cb)(tok, tree, argvp, ROFF_ENTER));
 
        if (0 == tokens[tok].ctx)
                return((*tokens[tok].cb)(tok, tree, argvp, ROFF_ENTER));
 
@@ -586,6 +619,11 @@ roffparse(struct rofftree *tree, char *buf, size_t sz)
                                n = NULL;
                                break;
                        }
                                n = NULL;
                                break;
                        }
+                       if (tokens[n->tok].ctx == n->tok)
+                               continue;
+                       roff_err(tree, *argv, "`%s' breaks `%s' scope",
+                                       toknames[tok], toknames[n->tok]);
+                       return(0);
                }
 
                /*
                }
 
                /*
@@ -619,9 +657,27 @@ roffparse(struct rofftree *tree, char *buf, size_t sz)
         * In this, the `El' tag closes out the scope of `Bl'.
         */
 
         * In this, the `El' tag closes out the scope of `Bl'.
         */
 
-       assert(tree->last);
        assert(tok != tokens[tok].ctx && 0 != tokens[tok].ctx);
 
        assert(tok != tokens[tok].ctx && 0 != tokens[tok].ctx);
 
+       /* LINTED */
+       for (n = tree->last; n; n = n->parent)
+               if (n->tok != tokens[tok].ctx) {
+                       if (n->tok == tokens[n->tok].ctx)
+                               continue;
+                       roff_err(tree, *argv, "`%s' breaks `%s' scope",
+                                       toknames[tok], toknames[n->tok]);
+                       return(0);
+               } else
+                       break;
+
+
+       if (NULL == n) {
+               roff_err(tree, *argv, "`%s' has no starting tag `%s'",
+                               toknames[tok], 
+                               toknames[tokens[tok].ctx]);
+               return(0);
+       }
+
        /* LINTED */
        do {
                t = tree->last->tok;
        /* LINTED */
        do {
                t = tree->last->tok;
@@ -629,7 +685,6 @@ roffparse(struct rofftree *tree, char *buf, size_t sz)
                        return(0);
        } while (t != tokens[tok].ctx);
 
                        return(0);
        } while (t != tokens[tok].ctx);
 
-       assert(tree->last);
        return(1);
 }
 
        return(1);
 }
 
@@ -655,7 +710,7 @@ static int
 rofffindtok(const char *buf)
 {
        char             token[4];
 rofffindtok(const char *buf)
 {
        char             token[4];
-       size_t           i;
+       int              i;
 
        for (i = 0; *buf && ! isspace(*buf) && i < 3; i++, buf++)
                token[i] = *buf;
 
        for (i = 0; *buf && ! isspace(*buf) && i < 3; i++, buf++)
                token[i] = *buf;
@@ -677,6 +732,48 @@ rofffindtok(const char *buf)
 }
 
 
 }
 
 
+static int
+roffispunct(const char *p)
+{
+
+       if (0 == *p)
+               return(0);
+       if (0 != *(p + 1))
+               return(0);
+
+       switch (*p) {
+       case('{'):
+               /* FALLTHROUGH */
+       case('.'):
+               /* FALLTHROUGH */
+       case(','):
+               /* FALLTHROUGH */
+       case(';'):
+               /* FALLTHROUGH */
+       case(':'):
+               /* FALLTHROUGH */
+       case('?'):
+               /* FALLTHROUGH */
+       case('!'):
+               /* FALLTHROUGH */
+       case('('):
+               /* FALLTHROUGH */
+       case(')'):
+               /* FALLTHROUGH */
+       case('['):
+               /* FALLTHROUGH */
+       case(']'):
+               /* FALLTHROUGH */
+       case('}'):
+               return(1);
+       default:
+               break;
+       }
+
+       return(0);
+}
+
+
 static int
 rofffindcallable(const char *name)
 {
 static int
 rofffindcallable(const char *name)
 {
@@ -734,11 +831,26 @@ roffnode_free(struct rofftree *tree)
 }
 
 
 }
 
 
+static int
+roffcall(struct rofftree *tree, int tok, char **argv)
+{
+
+       if (NULL == tokens[tok].cb) {
+               roff_err(tree, *argv, "unsupported macro `%s'", 
+                               toknames[tok]);
+               return(0);
+       }
+       if ( ! (*tokens[tok].cb)(tok, tree, argv, ROFF_ENTER))
+               return(0);
+       return(1);
+}
+
+
 static int
 roffnextopt(const struct rofftree *tree, int tok, 
 static int
 roffnextopt(const struct rofftree *tree, int tok, 
-               const char ***in, char **val)
+               char ***in, char **val)
 {
 {
-       const char      *arg, **argv;
+       char            *arg, **argv;
        int              v;
 
        *val = NULL;
        int              v;
 
        *val = NULL;
@@ -752,7 +864,7 @@ roffnextopt(const struct rofftree *tree, int tok,
 
        if (ROFF_ARGMAX == (v = rofffindarg(arg + 1))) {
                roff_warn(tree, arg, "argument-like parameter `%s' to "
 
        if (ROFF_ARGMAX == (v = rofffindarg(arg + 1))) {
                roff_warn(tree, arg, "argument-like parameter `%s' to "
-                               "`%s'", &arg[1], toknames[tok]);
+                               "`%s'", arg, toknames[tok]);
                return(-1);
        } 
        
                return(-1);
        } 
        
@@ -777,10 +889,60 @@ roffnextopt(const struct rofftree *tree, int tok,
 }
 
 
 }
 
 
+static int
+roffpurgepunct(struct rofftree *tree, char **argv)
+{
+       int              i;
+
+       i = 0;
+       while (argv[i])
+               i++;
+       assert(i > 0);
+       if ( ! roffispunct(argv[--i]))
+               return(1);
+       while (i >= 0 && roffispunct(argv[i]))
+               i--;
+       i++;
+
+       /* LINTED */
+       while (argv[i])
+               if ( ! (*tree->cb.roffdata)(tree->arg, 0, argv[i++]))
+                       return(0);
+       return(1);
+}
+
+
+static int
+roffparseopts(struct rofftree *tree, int tok, 
+               char ***args, int *argc, char **argv)
+{
+       int              i, c;
+       char            *v;
+
+       i = 0;
+
+       while (-1 != (c = roffnextopt(tree, tok, args, &v))) {
+               if (ROFF_ARGMAX == c) 
+                       return(0);
+
+               argc[i] = c;
+               argv[i] = v;
+               i++;
+               *args = *args + 1;
+       }
+
+       argc[i] = ROFF_ARGMAX;
+       argv[i] = NULL;
+       return(1);
+}
+
+
 /* ARGSUSED */
 static int
 roff_Dd(ROFFCALL_ARGS)
 {
 /* ARGSUSED */
 static int
 roff_Dd(ROFFCALL_ARGS)
 {
+       time_t           t;
+       char            *p, buf[32];
 
        if (ROFF_BODY & tree->state) {
                assert( ! (ROFF_PRELUDE & tree->state));
 
        if (ROFF_BODY & tree->state) {
                assert( ! (ROFF_PRELUDE & tree->state));
@@ -799,11 +961,63 @@ roff_Dd(ROFFCALL_ARGS)
                return(0);
        }
 
                return(0);
        }
 
-       /* TODO: parse date. */
-
        assert(NULL == tree->last);
        assert(NULL == tree->last);
-       tree->state |= ROFF_PRELUDE_Dd;
 
 
+       argv++;
+
+       if (0 == strcmp(*argv, "$Mdocdate: December 2 2008 $")) {
+               t = time(NULL);
+               if (NULL == localtime_r(&t, &tree->tm))
+                       err(1, "localtime_r");
+               tree->state |= ROFF_PRELUDE_Dd;
+               return(1);
+       } 
+
+       /* Build this from Mdocdate or raw date. */
+       
+       buf[0] = 0;
+       p = *argv;
+
+       if (0 != strcmp(*argv, "$Mdocdate:")) {
+               while (*argv) {
+                       if (strlcat(buf, *argv++, sizeof(buf))
+                                       < sizeof(buf)) 
+                               continue;
+                       roff_err(tree, p, "bad `Dd' date");
+                       return(0);
+               }
+               if (strptime(buf, "%b%d,%Y", &tree->tm)) {
+                       tree->state |= ROFF_PRELUDE_Dd;
+                       return(1);
+               }
+               roff_err(tree, *argv, "bad `Dd' date");
+               return(0);
+       }
+
+       argv++;
+       while (*argv && **argv != '$') {
+               if (strlcat(buf, *argv++, sizeof(buf))
+                               >= sizeof(buf)) {
+                       roff_err(tree, p, "bad `Dd' Mdocdate");
+                       return(0);
+               } 
+               if (strlcat(buf, " ", sizeof(buf))
+                               >= sizeof(buf)) {
+                       roff_err(tree, p, "bad `Dd' Mdocdate");
+                       return(0);
+               }
+       }
+       if (NULL == *argv) {
+               roff_err(tree, p, "bad `Dd' Mdocdate");
+               return(0);
+       }
+
+       if (NULL == strptime(buf, "%b %d %Y", &tree->tm)) {
+               roff_err(tree, *argv, "bad `Dd' Mdocdate");
+               return(0);
+       }
+
+       tree->state |= ROFF_PRELUDE_Dd;
        return(1);
 }
 
        return(1);
 }
 
@@ -830,7 +1044,34 @@ roff_Dt(ROFFCALL_ARGS)
                return(0);
        }
 
                return(0);
        }
 
-       /* TODO: parse date. */
+       argv++;
+       if (NULL == *argv) {
+               roff_err(tree, *argv, "`Dt' needs document title");
+               return(0);
+       } else if (strlcpy(tree->title, *argv, sizeof(tree->title))
+                       >= sizeof(tree->title)) {
+               roff_err(tree, *argv, "`Dt' document title too long");
+               return(0);
+       }
+
+       argv++;
+       if (NULL == *argv) {
+               roff_err(tree, *argv, "`Dt' needs section");
+               return(0);
+       } else if (strlcpy(tree->section, *argv, sizeof(tree->section))
+                       >= sizeof(tree->section)) {
+               roff_err(tree, *argv, "`Dt' section too long");
+               return(0);
+       }
+
+       argv++;
+       if (NULL == *argv) {
+               tree->volume[0] = 0;
+       } else if (strlcpy(tree->volume, *argv, sizeof(tree->volume))
+                       >= sizeof(tree->volume)) {
+               roff_err(tree, *argv, "`Dt' volume too long");
+               return(0);
+       }
 
        assert(NULL == tree->last);
        tree->state |= ROFF_PRELUDE_Dt;
 
        assert(NULL == tree->last);
        tree->state |= ROFF_PRELUDE_Dt;
@@ -839,15 +1080,99 @@ roff_Dt(ROFFCALL_ARGS)
 }
 
 
 }
 
 
+/* ARGSUSED */
+static int
+roff_Sm(ROFFCALL_ARGS)
+{
+       int              argcp[1];
+       char            *argvp[1], *morep[1], *p;
+
+       p = *argv++;
+
+       argcp[0] = ROFF_ARGMAX;
+       argvp[0] = NULL;
+       if (NULL == (morep[0] = *argv++)) {
+               roff_err(tree, p, "`Sm' expects an argument");
+               return(0);
+       } else if (0 != strcmp(morep[0], "on") && 
+                       0 != strcmp(morep[0], "off")) {
+               roff_err(tree, p, "`Sm' has invalid argument");
+               return(0);
+       }
+
+       if (*argv) 
+               roff_warn(tree, *argv, "`Sm' shouldn't have arguments");
+
+       if ( ! (*tree->cb.roffspecial)(tree->arg, 
+                               tok, argcp, argvp, morep))
+               return(0);
+
+       while (*argv) {
+               if ((*tree->cb.roffdata)(tree->arg, 1, *argv++))
+                       continue;
+               return(0);
+       }
+
+       return(1);
+}
+
+
+/* ARGSUSED */
+static int
+roff_Ns(ROFFCALL_ARGS)
+{
+       int              j, c, first;
+       int              argcp[1];
+       char            *argvp[1], *morep[1];
+
+       first = (*argv++ == tree->cur);
+
+       argcp[0] = ROFF_ARGMAX;
+       argvp[0] = morep[0] = NULL;
+
+       if ( ! (*tree->cb.roffspecial)(tree->arg, 
+                               tok, argcp, argvp, morep))
+               return(0);
+
+       while (*argv) {
+               if (ROFF_MAX != (c = rofffindcallable(*argv))) {
+                       if ( ! roffcall(tree, c, argv))
+                               return(0);
+                       break;
+               }
+
+               if ( ! roffispunct(*argv)) {
+                       if ((*tree->cb.roffdata)(tree->arg, 1, *argv++))
+                               continue;
+                       return(0);
+               }
+               for (j = 0; argv[j]; j++)
+                       if ( ! roffispunct(argv[j]))
+                               break;
+
+               if (argv[j]) {
+                       if ((*tree->cb.roffdata)(tree->arg, 0, *argv++))
+                               continue;
+                       return(0);
+               }
+
+               break;
+       }
+
+       if ( ! first)
+               return(1);
+
+       return(roffpurgepunct(tree, argv));
+}
+
+
 /* ARGSUSED */
 static int
 roff_Os(ROFFCALL_ARGS)
 {
 /* ARGSUSED */
 static int
 roff_Os(ROFFCALL_ARGS)
 {
+       char            *p;
 
 
-       if (ROFF_EXIT == type) {
-               assert(ROFF_PRELUDE_Os & tree->state);
-               return(roff_layout(tok, tree, argv, type));
-       } else if (ROFF_BODY & tree->state) {
+       if (ROFF_BODY & tree->state) {
                assert( ! (ROFF_PRELUDE & tree->state));
                assert(ROFF_PRELUDE_Os & tree->state);
                return(roff_text(tok, tree, argv, type));
                assert( ! (ROFF_PRELUDE & tree->state));
                assert(ROFF_PRELUDE_Os & tree->state);
                return(roff_text(tok, tree, argv, type));
@@ -860,7 +1185,24 @@ roff_Os(ROFFCALL_ARGS)
                return(0);
        }
 
                return(0);
        }
 
-       /* TODO: extract OS. */
+       tree->os[0] = 0;
+
+       p = *++argv;
+
+       while (*argv) {
+               if (strlcat(tree->os, *argv++, sizeof(tree->os))
+                               < sizeof(tree->os)) 
+                       continue;
+               roff_err(tree, p, "`Os' value too long");
+               return(0);
+       }
+
+       if (0 == tree->os[0])
+               if (strlcpy(tree->os, "LOCAL", sizeof(tree->os))
+                               >= sizeof(tree->os)) {
+                       roff_err(tree, p, "`Os' value too long");
+                       return(0);
+               }
 
        tree->state |= ROFF_PRELUDE_Os;
        tree->state &= ~ROFF_PRELUDE;
 
        tree->state |= ROFF_PRELUDE_Os;
        tree->state &= ~ROFF_PRELUDE;
@@ -868,7 +1210,7 @@ roff_Os(ROFFCALL_ARGS)
 
        assert(NULL == tree->last);
 
 
        assert(NULL == tree->last);
 
-       return(roff_layout(tok, tree, argv, type));
+       return((*tree->cb.roffhead)(tree->arg));
 }
 
 
 }
 
 
@@ -877,73 +1219,92 @@ static int
 roff_layout(ROFFCALL_ARGS) 
 {
        int              i, c, argcp[ROFF_MAXARG];
 roff_layout(ROFFCALL_ARGS) 
 {
        int              i, c, argcp[ROFF_MAXARG];
-       char            *v, *argvp[ROFF_MAXARG];
+       char            *argvp[ROFF_MAXARG];
 
        if (ROFF_PRELUDE & tree->state) {
 
        if (ROFF_PRELUDE & tree->state) {
-               roff_err(tree, *argv, "`%s' disallowed in prelude", 
+               roff_err(tree, *argv, "bad `%s' in prelude", 
                                toknames[tok]);
                return(0);
                                toknames[tok]);
                return(0);
-       }
-
-       if (ROFF_EXIT == type) {
+       } else if (ROFF_EXIT == type) {
                roffnode_free(tree);
                return((*tree->cb.roffblkout)(tree->arg, tok));
        } 
 
                roffnode_free(tree);
                return((*tree->cb.roffblkout)(tree->arg, tok));
        } 
 
-       i = 0;
-       argv++;
-
-       while (-1 != (c = roffnextopt(tree, tok, &argv, &v))) {
-               if (ROFF_ARGMAX == c)
-                       return(0);
-
-               argcp[i] = c;
-               argvp[i] = v;
-               i++;
-               argv++;
-       }
+       assert( ! (ROFF_CALLABLE & tokens[tok].flags));
 
 
-       argcp[i] = ROFF_ARGMAX;
-       argvp[i] = NULL;
+       ++argv;
 
 
+       if ( ! roffparseopts(tree, tok, &argv, argcp, argvp))
+               return(0);
        if (NULL == roffnode_new(tok, tree))
                return(0);
 
        if (NULL == roffnode_new(tok, tree))
                return(0);
 
+       /*
+        * Layouts have two parts: the layout body and header.  The
+        * layout header is the trailing text of the line macro, while
+        * the layout body is everything following until termination.
+        */
+
+       if ( ! (*tree->cb.roffblkin)(tree->arg, tok, argcp, argvp))
+               return(0);
+       if (NULL == *argv)
+               return(1);
        if ( ! (*tree->cb.roffin)(tree->arg, tok, argcp, argvp))
                return(0);
 
        if ( ! (*tree->cb.roffin)(tree->arg, tok, argcp, argvp))
                return(0);
 
+       /*
+        * If there are no parsable parts, then write remaining tokens
+        * into the layout header and exit.
+        */
+
        if ( ! (ROFF_PARSED & tokens[tok].flags)) {
        if ( ! (ROFF_PARSED & tokens[tok].flags)) {
+               i = 0;
                while (*argv) {
                while (*argv) {
-                       if ( ! (*tree->cb.roffdata)
-                                       (tree->arg, *argv++))
+                       if ( ! (*tree->cb.roffdata)(tree->arg, i, *argv++))
                                return(0);
                                return(0);
+                       i = 1;
                }
                }
-
-               if ( ! ((*tree->cb.roffout)(tree->arg, tok)))
-                       return(0);
-               return((*tree->cb.roffblkin)(tree->arg, tok));
+               return((*tree->cb.roffout)(tree->arg, tok));
        }
 
        }
 
+       /*
+        * Parsable elements may be in the header (or be the header, for
+        * that matter).  Follow the regular parsing rules for these.
+        */
+
+       i = 0;
        while (*argv) {
        while (*argv) {
-               if (ROFF_MAX != (c = rofffindcallable(*argv))) {
-                       if (NULL == tokens[c].cb) {
-                               roff_err(tree, *argv, "unsupported "
-                                               "macro `%s'",
-                                               toknames[c]);
-                               return(0);
-                       }
-                       if ( ! (*tokens[c].cb)(c, tree, argv, ROFF_ENTER))
+               if (ROFF_MAX == (c = rofffindcallable(*argv))) {
+                       assert(tree->arg);
+                       if ( ! (*tree->cb.roffdata)
+                                       (tree->arg, i, *argv++))
                                return(0);
                                return(0);
-                       break;
+                       i = 1;
+                       continue;
                }
                }
-
-               if ( ! (*tree->cb.roffdata)(tree->arg, *argv++))
+               if ( ! roffcall(tree, c, argv))
                        return(0);
                        return(0);
+               break;
        }
 
        }
 
-       if ( ! ((*tree->cb.roffout)(tree->arg, tok)))
+       /* 
+        * If there's trailing punctuation in the header, then write it
+        * out now.  Here we mimic the behaviour of a line-dominant text
+        * macro.
+        */
+
+       if (NULL == *argv)
+               return((*tree->cb.roffout)(tree->arg, tok));
+
+       /*
+        * Expensive.  Scan to the end of line then work backwards until
+        * a token isn't punctuation.
+        */
+
+       if ( ! roffpurgepunct(tree, argv))
                return(0);
                return(0);
-       return((*tree->cb.roffblkin)(tree->arg, tok));
+
+       return((*tree->cb.roffout)(tree->arg, tok));
 }
 
 
 }
 
 
@@ -951,8 +1312,8 @@ roff_layout(ROFFCALL_ARGS)
 static int
 roff_text(ROFFCALL_ARGS) 
 {
 static int
 roff_text(ROFFCALL_ARGS) 
 {
-       int              i, c, argcp[ROFF_MAXARG];
-       char            *v, *argvp[ROFF_MAXARG];
+       int              i, j, first, c, argcp[ROFF_MAXARG];
+       char            *argvp[ROFF_MAXARG];
 
        if (ROFF_PRELUDE & tree->state) {
                roff_err(tree, *argv, "`%s' disallowed in prelude", 
 
        if (ROFF_PRELUDE & tree->state) {
                roff_err(tree, *argv, "`%s' disallowed in prelude", 
@@ -960,66 +1321,85 @@ roff_text(ROFFCALL_ARGS)
                return(0);
        }
 
                return(0);
        }
 
-       i = 0;
+       first = (*argv == tree->cur);
        argv++;
 
        argv++;
 
-       while (-1 != (c = roffnextopt(tree, tok, &argv, &v))) {
-               if (ROFF_ARGMAX == c) 
-                       return(0);
-
-               argcp[i] = c;
-               argvp[i] = v;
-               i++;
-               argv++;
-       }
-
-       argcp[i] = ROFF_ARGMAX;
-       argvp[i] = NULL;
-
+       if ( ! roffparseopts(tree, tok, &argv, argcp, argvp))
+               return(0);
        if ( ! (*tree->cb.roffin)(tree->arg, tok, argcp, argvp))
                return(0);
        if ( ! (*tree->cb.roffin)(tree->arg, tok, argcp, argvp))
                return(0);
+       if (NULL == *argv)
+               return((*tree->cb.roffout)(tree->arg, tok));
 
        if ( ! (ROFF_PARSED & tokens[tok].flags)) {
 
        if ( ! (ROFF_PARSED & tokens[tok].flags)) {
+               i = 0;
                while (*argv) {
                while (*argv) {
-                       if ( ! (*tree->cb.roffdata)(tree->arg, *argv++))
+                       if ( ! (*tree->cb.roffdata)(tree->arg, i, *argv++))
                                return(0);
                                return(0);
+                       i = 1;
                }
                return((*tree->cb.roffout)(tree->arg, tok));
        }
 
                }
                return((*tree->cb.roffout)(tree->arg, tok));
        }
 
+       /*
+        * Deal with punctuation.  Ugly.  Work ahead until we encounter
+        * terminating punctuation.  If we encounter it and all
+        * subsequent tokens are punctuation, then stop processing (the
+        * line-dominant macro will print these tokens after closure).
+        */
+
+       i = 0;
        while (*argv) {
                if (ROFF_MAX != (c = rofffindcallable(*argv))) {
        while (*argv) {
                if (ROFF_MAX != (c = rofffindcallable(*argv))) {
-                       if (NULL == tokens[c].cb) {
-                               roff_err(tree, *argv, "unsupported "
-                                               "macro `%s'",
-                                               toknames[c]);
-                               return(0);
-                       }
-                       if ( ! (*tokens[c].cb)(c, tree, 
-                                               argv, ROFF_ENTER))
+                       if ( ! (ROFF_LSCOPE & tokens[tok].flags))
+                               if ( ! (*tree->cb.roffout)(tree->arg, tok))
+                                       return(0);
+       
+                       if ( ! roffcall(tree, c, argv))
                                return(0);
                                return(0);
+       
+                       if (ROFF_LSCOPE & tokens[tok].flags)
+                               if ( ! (*tree->cb.roffout)(tree->arg, tok))
+                                       return(0);
+       
                        break;
                }
                        break;
                }
-               if ( ! (*tree->cb.roffdata)(tree->arg, *argv++))
-                       return(0);
-       }
 
 
-       return((*tree->cb.roffout)(tree->arg, tok));
-}
+               if ( ! roffispunct(*argv)) {
+                       if ( ! (*tree->cb.roffdata)(tree->arg, i, *argv++))
+                               return(0);
+                       i = 1;
+                       continue;
+               }
 
 
+               i = 1;
+               for (j = 0; argv[j]; j++)
+                       if ( ! roffispunct(argv[j]))
+                               break;
 
 
-/* ARGSUSED */
-static int
-roff_comment(ROFFCALL_ARGS)
-{
+               if (argv[j]) {
+                       if ( ! (*tree->cb.roffdata)(tree->arg, 0, *argv++))
+                               return(0);
+                       continue;
+               }
 
 
-       return(1);
+               if ( ! (*tree->cb.roffout)(tree->arg, tok))
+                       return(0);
+               break;
+       }
+
+       if (NULL == *argv)
+               return((*tree->cb.roffout)(tree->arg, tok));
+       if ( ! first)
+               return(1);
+
+       return(roffpurgepunct(tree, argv));
 }
 
 
 /* ARGSUSED */
 static int
 }
 
 
 /* ARGSUSED */
 static int
-roff_close(ROFFCALL_ARGS)
+roff_noop(ROFFCALL_ARGS)
 {
 
        return(1);
 {
 
        return(1);
@@ -1028,10 +1408,11 @@ roff_close(ROFFCALL_ARGS)
 
 /* ARGSUSED */
 static int
 
 /* ARGSUSED */
 static int
-roff_special(ROFFCALL_ARGS)
+roff_depr(ROFFCALL_ARGS)
 {
 
 {
 
-       return((*tree->cb.roffspecial)(tree->arg, tok));
+       roff_err(tree, *argv, "`%s' is deprecated", toknames[tok]);
+       return(0);
 }
 
 
 }
 
 
@@ -1063,3 +1444,81 @@ roff_err(const struct rofftree *tree, const char *pos, char *fmt, ...)
        (*tree->cb.roffmsg)(tree->arg, 
                        ROFF_ERROR, tree->cur, pos, buf);
 }
        (*tree->cb.roffmsg)(tree->arg, 
                        ROFF_ERROR, tree->cur, pos, buf);
 }
+
+
+#ifdef __linux /* FIXME: remove. */
+/*     $OpenBSD: strlcat.c,v 1.13 2005/08/08 08:05:37 espie Exp $      */
+
+/*
+ * Copyright (c) 1998 Todd C. Miller <Todd.Miller@courtesan.com>
+ *
+ * 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.
+ *
+ * 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.
+ */
+static size_t
+strlcat(char *dst, const char *src, size_t siz)
+{
+       char *d = dst;
+       const char *s = src;
+       size_t n = siz;
+       size_t dlen;
+
+       /* Find the end of dst and adjust bytes left but don't go past
+        * end */
+       while (n-- != 0 && *d != '\0')
+               d++;
+       dlen = d - dst;
+       n = siz - dlen;
+
+       if (n == 0)
+               return(dlen + strlen(s));
+       while (*s != '\0') {
+               if (n != 1) {
+                       *d++ = *s;
+                       n--;
+               }
+               s++;
+       }
+       *d = '\0';
+
+       return(dlen + (s - src));       /* count does not include NUL */
+}
+
+
+static size_t
+strlcpy(char *dst, const char *src, size_t siz)
+{
+       char *d = dst;
+       const char *s = src;
+       size_t n = siz;
+
+       /* Copy as many bytes as will fit */
+       if (n != 0) {
+               while (--n != 0) {
+                       if ((*d++ = *s++) == '\0')
+                               break;
+               }
+       }
+
+       /* Not enough room in dst, add NUL and traverse rest of src */
+       if (n == 0) {
+               if (siz != 0)
+                       *d = '\0';              /* NUL-terminate dst */
+               while (*s++)
+                       ;
+       }
+
+       return(s - src - 1);    /* count does not include NUL */
+}
+#endif /*__linux__*/