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

Diff for /mandoc/mdoc_validate.c between version 1.87 and 1.386

version 1.87, 2010/05/30 22:56:02 version 1.386, 2020/04/24 12:02:33
Line 1 
Line 1 
 /*      $Id$ */  /* $Id$ */
 /*  /*
  * Copyright (c) 2008, 2009 Kristaps Dzonsons <kristaps@bsd.lv>   * Copyright (c) 2010-2020 Ingo Schwarze <schwarze@openbsd.org>
    * Copyright (c) 2008-2012 Kristaps Dzonsons <kristaps@bsd.lv>
    * Copyright (c) 2010 Joerg Sonnenberger <joerg@netbsd.org>
  *   *
  * Permission to use, copy, modify, and distribute this software for any   * Permission to use, copy, modify, and distribute this software for any
  * purpose with or without fee is hereby granted, provided that the above   * purpose with or without fee is hereby granted, provided that the above
  * copyright notice and this permission notice appear in all copies.   * copyright notice and this permission notice appear in all copies.
  *   *
  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES   * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHORS DISCLAIM ALL WARRANTIES
  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF   * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR   * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR
  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES   * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN   * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF   * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.   * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
    *
    * Validation module for mdoc(7) syntax trees used by mandoc(1).
  */   */
 #ifdef HAVE_CONFIG_H  
 #include "config.h"  #include "config.h"
 #endif  
   
 #include <sys/types.h>  #include <sys/types.h>
   #ifndef OSNAME
   #include <sys/utsname.h>
   #endif
   
 #include <assert.h>  #include <assert.h>
 #include <ctype.h>  #include <ctype.h>
Line 26 
Line 31 
 #include <stdio.h>  #include <stdio.h>
 #include <stdlib.h>  #include <stdlib.h>
 #include <string.h>  #include <string.h>
   #include <time.h>
   
   #include "mandoc_aux.h"
 #include "mandoc.h"  #include "mandoc.h"
 #include "libmdoc.h"  #include "mandoc_xr.h"
   #include "roff.h"
   #include "mdoc.h"
 #include "libmandoc.h"  #include "libmandoc.h"
   #include "roff_int.h"
   #include "libmdoc.h"
   #include "tag.h"
   
 /* FIXME: .Bl -diag can't have non-text children in HEAD. */  /* FIXME: .Bl -diag can't have non-text children in HEAD. */
 /* TODO: ignoring Pp (it's superfluous in some invocations). */  
   
 #define PRE_ARGS  struct mdoc *mdoc, const struct mdoc_node *n  #define POST_ARGS struct roff_man *mdoc
 #define POST_ARGS struct mdoc *mdoc  
   
 typedef int     (*v_pre)(PRE_ARGS);  enum    check_ineq {
 typedef int     (*v_post)(POST_ARGS);          CHECK_LT,
           CHECK_GT,
 struct  valids {          CHECK_EQ
         v_pre   *pre;  
         v_post  *post;  
 };  };
   
 static  int      check_parent(PRE_ARGS, enum mdoct, enum mdoc_type);  typedef void    (*v_post)(POST_ARGS);
 static  int      check_stdarg(PRE_ARGS);  
 static  int      check_text(struct mdoc *, int, int, const char *);  
 static  int      check_argv(struct mdoc *,  
                         const struct mdoc_node *,  
                         const struct mdoc_argv *);  
 static  int      check_args(struct mdoc *,  
                         const struct mdoc_node *);  
 static  int      err_child_lt(struct mdoc *, const char *, int);  
 static  int      warn_child_lt(struct mdoc *, const char *, int);  
 static  int      err_child_gt(struct mdoc *, const char *, int);  
 static  int      warn_child_gt(struct mdoc *, const char *, int);  
 static  int      err_child_eq(struct mdoc *, const char *, int);  
 static  int      warn_child_eq(struct mdoc *, const char *, int);  
 static  int      warn_count(struct mdoc *, const char *,  
                         int, const char *, int);  
 static  int      err_count(struct mdoc *, const char *,  
                         int, const char *, int);  
   
 static  int      berr_ge1(POST_ARGS);  static  int      build_list(struct roff_man *, int);
 static  int      bwarn_ge1(POST_ARGS);  static  void     check_argv(struct roff_man *,
 static  int      ebool(POST_ARGS);                          struct roff_node *, struct mdoc_argv *);
 static  int      eerr_eq0(POST_ARGS);  static  void     check_args(struct roff_man *, struct roff_node *);
 static  int      eerr_eq1(POST_ARGS);  static  void     check_text(struct roff_man *, int, int, char *);
 static  int      eerr_ge1(POST_ARGS);  static  void     check_text_em(struct roff_man *, int, int, char *);
 static  int      eerr_le1(POST_ARGS);  static  void     check_toptext(struct roff_man *, int, int, const char *);
 static  int      ewarn_ge1(POST_ARGS);  static  int      child_an(const struct roff_node *);
 static  int      herr_eq0(POST_ARGS);  static  size_t          macro2len(enum roff_tok);
 static  int      herr_ge1(POST_ARGS);  static  void     rewrite_macro2len(struct roff_man *, char **);
 static  int      hwarn_eq1(POST_ARGS);  static  int      similar(const char *, const char *);
 static  int      hwarn_eq0(POST_ARGS);  
 static  int      hwarn_le1(POST_ARGS);  
   
 static  int      post_an(POST_ARGS);  static  void     post_abort(POST_ARGS) __attribute__((__noreturn__));
 static  int      post_at(POST_ARGS);  static  void     post_an(POST_ARGS);
 static  int      post_bf(POST_ARGS);  static  void     post_an_norm(POST_ARGS);
 static  int      post_bl(POST_ARGS);  static  void     post_at(POST_ARGS);
 static  int      post_bl_head(POST_ARGS);  static  void     post_bd(POST_ARGS);
 static  int      post_dt(POST_ARGS);  static  void     post_bf(POST_ARGS);
 static  int      post_it(POST_ARGS);  static  void     post_bk(POST_ARGS);
 static  int      post_lb(POST_ARGS);  static  void     post_bl(POST_ARGS);
 static  int      post_nm(POST_ARGS);  static  void     post_bl_block(POST_ARGS);
 static  int      post_root(POST_ARGS);  static  void     post_bl_head(POST_ARGS);
 static  int      post_rs(POST_ARGS);  static  void     post_bl_norm(POST_ARGS);
 static  int      post_sh(POST_ARGS);  static  void     post_bx(POST_ARGS);
 static  int      post_sh_body(POST_ARGS);  static  void     post_defaults(POST_ARGS);
 static  int      post_sh_head(POST_ARGS);  static  void     post_display(POST_ARGS);
 static  int      post_st(POST_ARGS);  static  void     post_dd(POST_ARGS);
 static  int      post_eoln(POST_ARGS);  static  void     post_delim(POST_ARGS);
 static  int      post_vt(POST_ARGS);  static  void     post_delim_nb(POST_ARGS);
 static  int      pre_an(PRE_ARGS);  static  void     post_dt(POST_ARGS);
 static  int      pre_bd(PRE_ARGS);  static  void     post_em(POST_ARGS);
 static  int      pre_bl(PRE_ARGS);  static  void     post_en(POST_ARGS);
 static  int      pre_dd(PRE_ARGS);  static  void     post_er(POST_ARGS);
 static  int      pre_display(PRE_ARGS);  static  void     post_es(POST_ARGS);
 static  int      pre_dt(PRE_ARGS);  static  void     post_eoln(POST_ARGS);
 static  int      pre_it(PRE_ARGS);  static  void     post_ex(POST_ARGS);
 static  int      pre_os(PRE_ARGS);  static  void     post_fa(POST_ARGS);
 static  int      pre_rv(PRE_ARGS);  static  void     post_fn(POST_ARGS);
 static  int      pre_sh(PRE_ARGS);  static  void     post_fname(POST_ARGS);
 static  int      pre_ss(PRE_ARGS);  static  void     post_fo(POST_ARGS);
   static  void     post_hyph(POST_ARGS);
   static  void     post_it(POST_ARGS);
   static  void     post_lb(POST_ARGS);
   static  void     post_nd(POST_ARGS);
   static  void     post_nm(POST_ARGS);
   static  void     post_ns(POST_ARGS);
   static  void     post_obsolete(POST_ARGS);
   static  void     post_os(POST_ARGS);
   static  void     post_par(POST_ARGS);
   static  void     post_prevpar(POST_ARGS);
   static  void     post_root(POST_ARGS);
   static  void     post_rs(POST_ARGS);
   static  void     post_rv(POST_ARGS);
   static  void     post_section(POST_ARGS);
   static  void     post_sh(POST_ARGS);
   static  void     post_sh_head(POST_ARGS);
   static  void     post_sh_name(POST_ARGS);
   static  void     post_sh_see_also(POST_ARGS);
   static  void     post_sh_authors(POST_ARGS);
   static  void     post_sm(POST_ARGS);
   static  void     post_st(POST_ARGS);
   static  void     post_std(POST_ARGS);
   static  void     post_sx(POST_ARGS);
   static  void     post_tag(POST_ARGS);
   static  void     post_tg(POST_ARGS);
   static  void     post_useless(POST_ARGS);
   static  void     post_xr(POST_ARGS);
   static  void     post_xx(POST_ARGS);
   
 static  v_post   posts_an[] = { post_an, NULL };  static  const v_post mdoc_valids[MDOC_MAX - MDOC_Dd] = {
 static  v_post   posts_at[] = { post_at, NULL };          post_dd,        /* Dd */
 static  v_post   posts_bd[] = { hwarn_eq0, bwarn_ge1, NULL };          post_dt,        /* Dt */
 static  v_post   posts_bf[] = { hwarn_le1, post_bf, NULL };          post_os,        /* Os */
 static  v_post   posts_bl[] = { bwarn_ge1, post_bl, NULL };          post_sh,        /* Sh */
 static  v_post   posts_bool[] = { eerr_eq1, ebool, NULL };          post_section,   /* Ss */
 static  v_post   posts_eoln[] = { post_eoln, NULL };          post_par,       /* Pp */
 static  v_post   posts_dt[] = { post_dt, NULL };          post_display,   /* D1 */
 static  v_post   posts_fo[] = { hwarn_eq1, bwarn_ge1, NULL };          post_display,   /* Dl */
 static  v_post   posts_it[] = { post_it, NULL };          post_display,   /* Bd */
 static  v_post   posts_lb[] = { eerr_eq1, post_lb, NULL };          NULL,           /* Ed */
 static  v_post   posts_nd[] = { berr_ge1, NULL };          post_bl,        /* Bl */
 static  v_post   posts_nm[] = { post_nm, NULL };          NULL,           /* El */
 static  v_post   posts_notext[] = { eerr_eq0, NULL };          post_it,        /* It */
 static  v_post   posts_rs[] = { berr_ge1, herr_eq0, post_rs, NULL };          post_delim_nb,  /* Ad */
 static  v_post   posts_sh[] = { herr_ge1, bwarn_ge1, post_sh, NULL };          post_an,        /* An */
 static  v_post   posts_sp[] = { eerr_le1, NULL };          NULL,           /* Ap */
 static  v_post   posts_ss[] = { herr_ge1, NULL };          post_defaults,  /* Ar */
 static  v_post   posts_st[] = { eerr_eq1, post_st, NULL };          NULL,           /* Cd */
 static  v_post   posts_text[] = { eerr_ge1, NULL };          post_tag,       /* Cm */
 static  v_post   posts_text1[] = { eerr_eq1, NULL };          post_tag,       /* Dv */
 static  v_post   posts_vt[] = { post_vt, NULL };          post_er,        /* Er */
 static  v_post   posts_wline[] = { bwarn_ge1, herr_eq0, NULL };          post_tag,       /* Ev */
 static  v_post   posts_wtext[] = { ewarn_ge1, NULL };          post_ex,        /* Ex */
 static  v_pre    pres_an[] = { pre_an, NULL };          post_fa,        /* Fa */
 static  v_pre    pres_bd[] = { pre_display, pre_bd, NULL };          NULL,           /* Fd */
 static  v_pre    pres_bl[] = { pre_bl, NULL };          post_tag,       /* Fl */
 static  v_pre    pres_d1[] = { pre_display, NULL };          post_fn,        /* Fn */
 static  v_pre    pres_dd[] = { pre_dd, NULL };          post_delim_nb,  /* Ft */
 static  v_pre    pres_dt[] = { pre_dt, NULL };          post_tag,       /* Ic */
 static  v_pre    pres_er[] = { NULL, NULL };          post_delim_nb,  /* In */
 static  v_pre    pres_ex[] = { NULL, NULL };          post_tag,       /* Li */
 static  v_pre    pres_fd[] = { NULL, NULL };          post_nd,        /* Nd */
 static  v_pre    pres_it[] = { pre_it, NULL };          post_nm,        /* Nm */
 static  v_pre    pres_os[] = { pre_os, NULL };          post_delim_nb,  /* Op */
 static  v_pre    pres_rv[] = { pre_rv, NULL };          post_abort,     /* Ot */
 static  v_pre    pres_sh[] = { pre_sh, NULL };          post_defaults,  /* Pa */
 static  v_pre    pres_ss[] = { pre_ss, NULL };          post_rv,        /* Rv */
           post_st,        /* St */
 const   struct valids mdoc_valids[MDOC_MAX] = {          post_delim_nb,  /* Va */
         { NULL, NULL },                         /* Ap */          post_delim_nb,  /* Vt */
         { pres_dd, posts_text },                /* Dd */          post_xr,        /* Xr */
         { pres_dt, posts_dt },                  /* Dt */          NULL,           /* %A */
         { pres_os, NULL },                      /* Os */          post_hyph,      /* %B */ /* FIXME: can be used outside Rs/Re. */
         { pres_sh, posts_sh },                  /* Sh */          NULL,           /* %D */
         { pres_ss, posts_ss },                  /* Ss */          NULL,           /* %I */
         { NULL, posts_notext },                 /* Pp */          NULL,           /* %J */
         { pres_d1, posts_wline },               /* D1 */          post_hyph,      /* %N */
         { pres_d1, posts_wline },               /* Dl */          post_hyph,      /* %O */
         { pres_bd, posts_bd },                  /* Bd */          NULL,           /* %P */
         { NULL, NULL },                         /* Ed */          post_hyph,      /* %R */
         { pres_bl, posts_bl },                  /* Bl */          post_hyph,      /* %T */ /* FIXME: can be used outside Rs/Re. */
         { NULL, NULL },                         /* El */          NULL,           /* %V */
         { pres_it, posts_it },                  /* It */          NULL,           /* Ac */
         { NULL, posts_text },                   /* Ad */          NULL,           /* Ao */
         { pres_an, posts_an },                  /* An */          post_delim_nb,  /* Aq */
         { NULL, NULL },                         /* Ar */          post_at,        /* At */
         { NULL, posts_text },                   /* Cd */          NULL,           /* Bc */
         { NULL, NULL },                         /* Cm */          post_bf,        /* Bf */
         { NULL, NULL },                         /* Dv */          NULL,           /* Bo */
         { pres_er, posts_text },                /* Er */          NULL,           /* Bq */
         { NULL, NULL },                         /* Ev */          post_xx,        /* Bsx */
         { pres_ex, NULL },                      /* Ex */          post_bx,        /* Bx */
         { NULL, NULL },                         /* Fa */          post_obsolete,  /* Db */
         { pres_fd, posts_wtext },               /* Fd */          NULL,           /* Dc */
         { NULL, NULL },                         /* Fl */          NULL,           /* Do */
         { NULL, posts_text },                   /* Fn */          NULL,           /* Dq */
         { NULL, posts_wtext },                  /* Ft */          NULL,           /* Ec */
         { NULL, posts_text },                   /* Ic */          NULL,           /* Ef */
         { NULL, posts_text1 },                  /* In */          post_em,        /* Em */
         { NULL, NULL },                         /* Li */          NULL,           /* Eo */
         { NULL, posts_nd },                     /* Nd */          post_xx,        /* Fx */
         { NULL, posts_nm },                     /* Nm */          post_tag,       /* Ms */
         { NULL, posts_wline },                  /* Op */          post_tag,       /* No */
         { NULL, NULL },                         /* Ot */          post_ns,        /* Ns */
         { NULL, NULL },                         /* Pa */          post_xx,        /* Nx */
         { pres_rv, NULL },                      /* Rv */          post_xx,        /* Ox */
         { NULL, posts_st },                     /* St */          NULL,           /* Pc */
         { NULL, NULL },                         /* Va */          NULL,           /* Pf */
         { NULL, posts_vt },                     /* Vt */          NULL,           /* Po */
         { NULL, posts_wtext },                  /* Xr */          post_delim_nb,  /* Pq */
         { NULL, posts_text },                   /* %A */          NULL,           /* Qc */
         { NULL, posts_text },                   /* %B */ /* FIXME: can be used outside Rs/Re. */          post_delim_nb,  /* Ql */
         { NULL, posts_text },                   /* %D */ /* FIXME: check date with mandoc_a2time(). */          NULL,           /* Qo */
         { NULL, posts_text },                   /* %I */          post_delim_nb,  /* Qq */
         { NULL, posts_text },                   /* %J */          NULL,           /* Re */
         { NULL, posts_text },                   /* %N */          post_rs,        /* Rs */
         { NULL, posts_text },                   /* %O */          NULL,           /* Sc */
         { NULL, posts_text },                   /* %P */          NULL,           /* So */
         { NULL, posts_text },                   /* %R */          post_delim_nb,  /* Sq */
         { NULL, posts_text },                   /* %T */ /* FIXME: can be used outside Rs/Re. */          post_sm,        /* Sm */
         { NULL, posts_text },                   /* %V */          post_sx,        /* Sx */
         { NULL, NULL },                         /* Ac */          post_em,        /* Sy */
         { NULL, NULL },                         /* Ao */          post_useless,   /* Tn */
         { NULL, posts_wline },                  /* Aq */          post_xx,        /* Ux */
         { NULL, posts_at },                     /* At */          NULL,           /* Xc */
         { NULL, NULL },                         /* Bc */          NULL,           /* Xo */
         { NULL, posts_bf },                     /* Bf */          post_fo,        /* Fo */
         { NULL, NULL },                         /* Bo */          NULL,           /* Fc */
         { NULL, posts_wline },                  /* Bq */          NULL,           /* Oo */
         { NULL, NULL },                         /* Bsx */          NULL,           /* Oc */
         { NULL, NULL },                         /* Bx */          post_bk,        /* Bk */
         { NULL, posts_bool },                   /* Db */          NULL,           /* Ek */
         { NULL, NULL },                         /* Dc */          post_eoln,      /* Bt */
         { NULL, NULL },                         /* Do */          post_obsolete,  /* Hf */
         { NULL, posts_wline },                  /* Dq */          post_obsolete,  /* Fr */
         { NULL, NULL },                         /* Ec */          post_eoln,      /* Ud */
         { NULL, NULL },                         /* Ef */          post_lb,        /* Lb */
         { NULL, NULL },                         /* Em */          post_abort,     /* Lp */
         { NULL, NULL },                         /* Eo */          post_delim_nb,  /* Lk */
         { NULL, NULL },                         /* Fx */          post_defaults,  /* Mt */
         { NULL, posts_text },                   /* Ms */          post_delim_nb,  /* Brq */
         { NULL, posts_notext },                 /* No */          NULL,           /* Bro */
         { NULL, posts_notext },                 /* Ns */          NULL,           /* Brc */
         { NULL, NULL },                         /* Nx */          NULL,           /* %C */
         { NULL, NULL },                         /* Ox */          post_es,        /* Es */
         { NULL, NULL },                         /* Pc */          post_en,        /* En */
         { NULL, posts_text1 },                  /* Pf */          post_xx,        /* Dx */
         { NULL, NULL },                         /* Po */          NULL,           /* %Q */
         { NULL, posts_wline },                  /* Pq */          NULL,           /* %U */
         { NULL, NULL },                         /* Qc */          NULL,           /* Ta */
         { NULL, posts_wline },                  /* Ql */          post_tg,        /* Tg */
         { NULL, NULL },                         /* Qo */  
         { NULL, posts_wline },                  /* Qq */  
         { NULL, NULL },                         /* Re */  
         { NULL, posts_rs },                     /* Rs */  
         { NULL, NULL },                         /* Sc */  
         { NULL, NULL },                         /* So */  
         { NULL, posts_wline },                  /* Sq */  
         { NULL, posts_bool },                   /* Sm */  
         { NULL, posts_text },                   /* Sx */  
         { NULL, posts_text },                   /* Sy */  
         { NULL, posts_text },                   /* Tn */  
         { NULL, NULL },                         /* Ux */  
         { NULL, NULL },                         /* Xc */  
         { NULL, NULL },                         /* Xo */  
         { NULL, posts_fo },                     /* Fo */  
         { NULL, NULL },                         /* Fc */  
         { NULL, NULL },                         /* Oo */  
         { NULL, NULL },                         /* Oc */  
         { NULL, posts_wline },                  /* Bk */  
         { NULL, NULL },                         /* Ek */  
         { NULL, posts_eoln },                   /* Bt */  
         { NULL, NULL },                         /* Hf */  
         { NULL, NULL },                         /* Fr */  
         { NULL, posts_eoln },                   /* Ud */  
         { NULL, posts_lb },                     /* Lb */  
         { NULL, posts_notext },                 /* Lp */  
         { NULL, posts_text },                   /* Lk */  
         { NULL, posts_text },                   /* Mt */  
         { NULL, posts_wline },                  /* Brq */  
         { NULL, NULL },                         /* Bro */  
         { NULL, NULL },                         /* Brc */  
         { NULL, posts_text },                   /* %C */  
         { NULL, NULL },                         /* Es */  
         { NULL, NULL },                         /* En */  
         { NULL, NULL },                         /* Dx */  
         { NULL, posts_text },                   /* %Q */  
         { NULL, posts_notext },                 /* br */  
         { NULL, posts_sp },                     /* sp */  
         { NULL, posts_text1 },                  /* %U */  
 };  };
   
   #define RSORD_MAX 14 /* Number of `Rs' blocks. */
   
 int  static  const enum roff_tok rsord[RSORD_MAX] = {
 mdoc_valid_pre(struct mdoc *mdoc, const struct mdoc_node *n)          MDOC__A,
 {          MDOC__T,
         v_pre           *p;          MDOC__B,
         int              line, pos;          MDOC__I,
         const char      *tp;          MDOC__J,
           MDOC__R,
           MDOC__N,
           MDOC__V,
           MDOC__U,
           MDOC__P,
           MDOC__Q,
           MDOC__C,
           MDOC__D,
           MDOC__O
   };
   
         if (MDOC_TEXT == n->type) {  static  const char * const secnames[SEC__MAX] = {
                 tp = n->string;          NULL,
                 line = n->line;          "NAME",
                 pos = n->pos;          "LIBRARY",
                 return(check_text(mdoc, line, pos, tp));          "SYNOPSIS",
         }          "DESCRIPTION",
           "CONTEXT",
           "IMPLEMENTATION NOTES",
           "RETURN VALUES",
           "ENVIRONMENT",
           "FILES",
           "EXIT STATUS",
           "EXAMPLES",
           "DIAGNOSTICS",
           "COMPATIBILITY",
           "ERRORS",
           "SEE ALSO",
           "STANDARDS",
           "HISTORY",
           "AUTHORS",
           "CAVEATS",
           "BUGS",
           "SECURITY CONSIDERATIONS",
           NULL
   };
   
         if ( ! check_args(mdoc, n))  static  int       fn_prio = TAG_STRONG;
                 return(0);  
         if (NULL == mdoc_valids[n->tok].pre)  
                 return(1);  
         for (p = mdoc_valids[n->tok].pre; *p; p++)  
                 if ( ! (*p)(mdoc, n))  
                         return(0);  
         return(1);  
 }  
   
   
 int  /* Validate the subtree rooted at mdoc->last. */
 mdoc_valid_post(struct mdoc *mdoc)  void
   mdoc_validate(struct roff_man *mdoc)
 {  {
         v_post          *p;          struct roff_node *n, *np;
           const v_post *p;
   
         if (MDOC_VALID & mdoc->last->flags)          /*
                 return(1);           * Translate obsolete macros to modern macros first
         mdoc->last->flags |= MDOC_VALID;           * such that later code does not need to look
            * for the obsolete versions.
            */
   
         if (MDOC_TEXT == mdoc->last->type)          n = mdoc->last;
                 return(1);          switch (n->tok) {
         if (MDOC_ROOT == mdoc->last->type)          case MDOC_Lp:
                 return(post_root(mdoc));                  n->tok = MDOC_Pp;
                   break;
           case MDOC_Ot:
                   post_obsolete(mdoc);
                   n->tok = MDOC_Ft;
                   break;
           default:
                   break;
           }
   
         if (NULL == mdoc_valids[mdoc->last->tok].post)          /*
                 return(1);           * Iterate over all children, recursing into each one
         for (p = mdoc_valids[mdoc->last->tok].post; *p; p++)           * in turn, depth-first.
                 if ( ! (*p)(mdoc))           */
                         return(0);  
   
         return(1);          mdoc->last = mdoc->last->child;
 }          while (mdoc->last != NULL) {
                   mdoc_validate(mdoc);
                   if (mdoc->last == n)
                           mdoc->last = mdoc->last->child;
                   else
                           mdoc->last = mdoc->last->next;
           }
   
           /* Finally validate the macro itself. */
   
 static inline int          mdoc->last = n;
 warn_count(struct mdoc *m, const char *k,          mdoc->next = ROFF_NEXT_SIBLING;
                 int want, const char *v, int has)          switch (n->type) {
 {          case ROFFT_TEXT:
                   np = n->parent;
                   if (n->sec != SEC_SYNOPSIS ||
                       (np->tok != MDOC_Cd && np->tok != MDOC_Fd))
                           check_text(mdoc, n->line, n->pos, n->string);
                   if ((n->flags & NODE_NOFILL) == 0 &&
                       (np->tok != MDOC_It || np->type != ROFFT_HEAD ||
                        np->parent->parent->norm->Bl.type != LIST_diag))
                           check_text_em(mdoc, n->line, n->pos, n->string);
                   if (np->tok == MDOC_It || (np->type == ROFFT_BODY &&
                       (np->tok == MDOC_Sh || np->tok == MDOC_Ss)))
                           check_toptext(mdoc, n->line, n->pos, n->string);
                   break;
           case ROFFT_COMMENT:
           case ROFFT_EQN:
           case ROFFT_TBL:
                   break;
           case ROFFT_ROOT:
                   post_root(mdoc);
                   break;
           default:
                   check_args(mdoc, mdoc->last);
   
         return(mdoc_vmsg(m, MANDOCERR_ARGCOUNT,                  /*
                                 m->last->line, m->last->pos,                   * Closing delimiters are not special at the
                                 "%s %s %d (have %d)", v, k, want, has));                   * beginning of a block, opening delimiters
 }                   * are not special at the end.
                    */
   
                   if (n->child != NULL)
                           n->child->flags &= ~NODE_DELIMC;
                   if (n->last != NULL)
                           n->last->flags &= ~NODE_DELIMO;
   
 static inline int                  /* Call the macro's postprocessor. */
 err_count(struct mdoc *m, const char *k,  
                 int want, const char *v, int has)  
 {  
   
         mdoc_vmsg(m, MANDOCERR_SYNTARGCOUNT,                  if (n->tok < ROFF_MAX) {
                         m->last->line, m->last->pos,                          roff_validate(mdoc);
                         "%s %s %d (have %d)",                          break;
                         v, k, want, has);                  }
         return(0);  
                   assert(n->tok >= MDOC_Dd && n->tok < MDOC_MAX);
                   p = mdoc_valids + (n->tok - MDOC_Dd);
                   if (*p)
                           (*p)(mdoc);
                   if (mdoc->last == n)
                           mdoc_state(mdoc, n);
                   break;
           }
 }  }
   
   static void
   check_args(struct roff_man *mdoc, struct roff_node *n)
   {
           int              i;
   
 /*          if (NULL == n->args)
  * Build these up with macros because they're basically the same check                  return;
  * for different inequalities.  Yes, this could be done with functions,  
  * but this is reasonable for now.  
  */  
   
 #define CHECK_CHILD_DEFN(lvl, name, ineq)                       \          assert(n->args->argc);
 static int                                                      \          for (i = 0; i < (int)n->args->argc; i++)
 lvl##_child_##name(struct mdoc *mdoc, const char *p, int sz)    \                  check_argv(mdoc, n, &n->args->argv[i]);
 {                                                               \  
         if (mdoc->last->nchild ineq sz)                         \  
                 return(1);                                      \  
         return(lvl##_count(mdoc, #ineq, sz, p, mdoc->last->nchild)); \  
 }  }
   
 #define CHECK_BODY_DEFN(name, lvl, func, num)                   \  static void
 static int                                                      \  check_argv(struct roff_man *mdoc, struct roff_node *n, struct mdoc_argv *v)
 b##lvl##_##name(POST_ARGS)                                      \  {
 {                                                               \          int              i;
         if (MDOC_BODY != mdoc->last->type)                      \  
                 return(1);                                      \  
         return(func(mdoc, "multi-line arguments", (num)));      \  
 }  
   
 #define CHECK_ELEM_DEFN(name, lvl, func, num)                   \          for (i = 0; i < (int)v->sz; i++)
 static int                                                      \                  check_text(mdoc, v->line, v->pos, v->value[i]);
 e##lvl##_##name(POST_ARGS)                                      \  
 {                                                               \  
         assert(MDOC_ELEM == mdoc->last->type);                  \  
         return(func(mdoc, "line arguments", (num)));            \  
 }  }
   
 #define CHECK_HEAD_DEFN(name, lvl, func, num)                   \  static void
 static int                                                      \  check_text(struct roff_man *mdoc, int ln, int pos, char *p)
 h##lvl##_##name(POST_ARGS)                                      \  {
 {                                                               \          char            *cp;
         if (MDOC_HEAD != mdoc->last->type)                      \  
                 return(1);                                      \  
         return(func(mdoc, "line arguments", (num)));            \  
 }  
   
           if (mdoc->last->flags & NODE_NOFILL)
                   return;
   
 CHECK_CHILD_DEFN(warn, gt, >)                   /* warn_child_gt() */          for (cp = p; NULL != (p = strchr(p, '\t')); p++)
 CHECK_CHILD_DEFN(err, gt, >)                    /* err_child_gt() */                  mandoc_msg(MANDOCERR_FI_TAB, ln, pos + (int)(p - cp), NULL);
 CHECK_CHILD_DEFN(warn, eq, ==)                  /* warn_child_eq() */  }
 CHECK_CHILD_DEFN(err, eq, ==)                   /* err_child_eq() */  
 CHECK_CHILD_DEFN(err, lt, <)                    /* err_child_lt() */  
 CHECK_CHILD_DEFN(warn, lt, <)                   /* warn_child_lt() */  
 CHECK_BODY_DEFN(ge1, warn, warn_child_gt, 0)    /* bwarn_ge1() */  
 CHECK_BODY_DEFN(ge1, err, err_child_gt, 0)      /* berr_ge1() */  
 CHECK_ELEM_DEFN(ge1, warn, warn_child_gt, 0)    /* ewarn_ge1() */  
 CHECK_ELEM_DEFN(eq1, err, err_child_eq, 1)      /* eerr_eq1() */  
 CHECK_ELEM_DEFN(le1, err, err_child_lt, 2)      /* eerr_le1() */  
 CHECK_ELEM_DEFN(eq0, err, err_child_eq, 0)      /* eerr_eq0() */  
 CHECK_ELEM_DEFN(ge1, err, err_child_gt, 0)      /* eerr_ge1() */  
 CHECK_HEAD_DEFN(eq0, err, err_child_eq, 0)      /* herr_eq0() */  
 CHECK_HEAD_DEFN(le1, warn, warn_child_lt, 2)    /* hwarn_le1() */  
 CHECK_HEAD_DEFN(ge1, err, err_child_gt, 0)      /* herr_ge1() */  
 CHECK_HEAD_DEFN(eq1, warn, warn_child_eq, 1)    /* hwarn_eq1() */  
 CHECK_HEAD_DEFN(eq0, warn, warn_child_eq, 0)    /* hwarn_eq0() */  
   
   static void
 static int  check_text_em(struct roff_man *mdoc, int ln, int pos, char *p)
 check_stdarg(PRE_ARGS)  
 {  {
           const struct roff_node  *np, *nn;
           char                    *cp;
   
         if (n->args && 1 == n->args->argc)          np = mdoc->last->prev;
                 if (MDOC_Std == n->args->argv[0].arg)          nn = mdoc->last->next;
                         return(1);  
         return(mdoc_nmsg(mdoc, n, MANDOCERR_NOARGV));  
 }  
   
           /* Look for em-dashes wrongly encoded as "--". */
   
 static int          for (cp = p; *cp != '\0'; cp++) {
 check_args(struct mdoc *m, const struct mdoc_node *n)                  if (cp[0] != '-' || cp[1] != '-')
 {                          continue;
         int              i;                  cp++;
   
         if (NULL == n->args)                  /* Skip input sequences of more than two '-'. */
                 return(1);  
   
         assert(n->args->argc);                  if (cp[1] == '-') {
         for (i = 0; i < (int)n->args->argc; i++)                          while (cp[1] == '-')
                 if ( ! check_argv(m, n, &n->args->argv[i]))                                  cp++;
                         return(0);                          continue;
                   }
   
         return(1);                  /* Skip "--" directly attached to something else. */
 }  
   
                   if ((cp - p > 1 && cp[-2] != ' ') ||
                       (cp[1] != '\0' && cp[1] != ' '))
                           continue;
   
 static int                  /* Require a letter right before or right afterwards. */
 check_argv(struct mdoc *m, const struct mdoc_node *n,  
                 const struct mdoc_argv *v)  
 {  
         int              i;  
   
         for (i = 0; i < (int)v->sz; i++)                  if ((cp - p > 2 ?
                 if ( ! check_text(m, v->line, v->pos, v->value[i]))                       isalpha((unsigned char)cp[-3]) :
                         return(0);                       np != NULL &&
                        np->type == ROFFT_TEXT &&
         if (MDOC_Std == v->arg) {                       *np->string != '\0' &&
                 if (v->sz || m->meta.name)                       isalpha((unsigned char)np->string[
                         return(1);                         strlen(np->string) - 1])) ||
                 if ( ! mdoc_nmsg(m, n, MANDOCERR_NONAME))                      (cp[1] != '\0' && cp[2] != '\0' ?
                         return(0);                       isalpha((unsigned char)cp[2]) :
                        nn != NULL &&
                        nn->type == ROFFT_TEXT &&
                        isalpha((unsigned char)*nn->string))) {
                           mandoc_msg(MANDOCERR_DASHDASH,
                               ln, pos + (int)(cp - p) - 1, NULL);
                           break;
                   }
         }          }
   
         return(1);  
 }  }
   
   static void
 static int  check_toptext(struct roff_man *mdoc, int ln, int pos, const char *p)
 check_text(struct mdoc *mdoc, int line, int pos, const char *p)  
 {  {
         int              c;          const char      *cp, *cpr;
   
         for ( ; *p; p++, pos++) {          if (*p == '\0')
                 if ('\t' == *p) {                  return;
                         if ( ! (MDOC_LITERAL & mdoc->flags))  
                                 if ( ! mdoc_pmsg(mdoc, line, pos, MANDOCERR_BADCHAR))  
                                         return(0);  
                 } else if ( ! isprint((u_char)*p) && ASCII_HYPH != *p)  
                         if ( ! mdoc_pmsg(mdoc, line, pos, MANDOCERR_BADCHAR))  
                                 return(0);  
   
                 if ('\\' != *p)          if ((cp = strstr(p, "OpenBSD")) != NULL)
                         continue;                  mandoc_msg(MANDOCERR_BX, ln, pos + (int)(cp - p), "Ox");
           if ((cp = strstr(p, "NetBSD")) != NULL)
                   mandoc_msg(MANDOCERR_BX, ln, pos + (int)(cp - p), "Nx");
           if ((cp = strstr(p, "FreeBSD")) != NULL)
                   mandoc_msg(MANDOCERR_BX, ln, pos + (int)(cp - p), "Fx");
           if ((cp = strstr(p, "DragonFly")) != NULL)
                   mandoc_msg(MANDOCERR_BX, ln, pos + (int)(cp - p), "Dx");
   
                 c = mandoc_special(p);          cp = p;
                 if (c) {          while ((cp = strstr(cp + 1, "()")) != NULL) {
                         p += c - 1;                  for (cpr = cp - 1; cpr >= p; cpr--)
                         pos += c - 1;                          if (*cpr != '_' && !isalnum((unsigned char)*cpr))
                         continue;                                  break;
                   if ((cpr < p || *cpr == ' ') && cpr + 1 < cp) {
                           cpr++;
                           mandoc_msg(MANDOCERR_FUNC, ln, pos + (int)(cpr - p),
                               "%.*s()", (int)(cp - cpr), cpr);
                 }                  }
   
                 c = mdoc_pmsg(mdoc, line, pos, MANDOCERR_BADESCAPE);  
                 if ( ! (MDOC_IGN_ESCAPE & mdoc->pflags) && ! c)  
                         return(c);  
         }          }
   }
   
         return(1);  static void
   post_abort(POST_ARGS)
   {
           abort();
 }  }
   
   static void
   post_delim(POST_ARGS)
   {
           const struct roff_node  *nch;
           const char              *lc;
           enum mdelim              delim;
           enum roff_tok            tok;
   
           tok = mdoc->last->tok;
           nch = mdoc->last->last;
           if (nch == NULL || nch->type != ROFFT_TEXT)
                   return;
           lc = strchr(nch->string, '\0') - 1;
           if (lc < nch->string)
                   return;
           delim = mdoc_isdelim(lc);
           if (delim == DELIM_NONE || delim == DELIM_OPEN)
                   return;
           if (*lc == ')' && (tok == MDOC_Nd || tok == MDOC_Sh ||
               tok == MDOC_Ss || tok == MDOC_Fo))
                   return;
   
           mandoc_msg(MANDOCERR_DELIM, nch->line,
               nch->pos + (int)(lc - nch->string), "%s%s %s", roff_name[tok],
               nch == mdoc->last->child ? "" : " ...", nch->string);
   }
   
 static int  static void
 check_parent(PRE_ARGS, enum mdoct tok, enum mdoc_type t)  post_delim_nb(POST_ARGS)
 {  {
           const struct roff_node  *nch;
           const char              *lc, *cp;
           int                      nw;
           enum mdelim              delim;
           enum roff_tok            tok;
   
         assert(n->parent);          /*
         if ((MDOC_ROOT == t || tok == n->parent->tok) &&           * Find candidates: at least two bytes,
                         (t == n->parent->type))           * the last one a closing or middle delimiter.
                 return(1);           */
   
         mdoc_vmsg(mdoc, MANDOCERR_SYNTCHILD,          tok = mdoc->last->tok;
                                 n->line, n->pos, "want parent %s",          nch = mdoc->last->last;
                                 MDOC_ROOT == t ? "<root>" :          if (nch == NULL || nch->type != ROFFT_TEXT)
                                         mdoc_macronames[tok]);                  return;
         return(0);          lc = strchr(nch->string, '\0') - 1;
 }          if (lc <= nch->string)
                   return;
           delim = mdoc_isdelim(lc);
           if (delim == DELIM_NONE || delim == DELIM_OPEN)
                   return;
   
           /*
            * Reduce false positives by allowing various cases.
            */
   
           /* Escaped delimiters. */
           if (lc > nch->string + 1 && lc[-2] == '\\' &&
               (lc[-1] == '&' || lc[-1] == 'e'))
                   return;
   
 static int          /* Specific byte sequences. */
 pre_display(PRE_ARGS)          switch (*lc) {
 {          case ')':
         struct mdoc_node *node;                  for (cp = lc; cp >= nch->string; cp--)
                           if (*cp == '(')
                                   return;
                   break;
           case '.':
                   if (lc > nch->string + 1 && lc[-2] == '.' && lc[-1] == '.')
                           return;
                   if (lc[-1] == '.')
                           return;
                   break;
           case ';':
                   if (tok == MDOC_Vt)
                           return;
                   break;
           case '?':
                   if (lc[-1] == '?')
                           return;
                   break;
           case ']':
                   for (cp = lc; cp >= nch->string; cp--)
                           if (*cp == '[')
                                   return;
                   break;
           case '|':
                   if (lc == nch->string + 1 && lc[-1] == '|')
                           return;
           default:
                   break;
           }
   
         /* Display elements (`Bd', `D1'...) cannot be nested. */          /* Exactly two non-alphanumeric bytes. */
           if (lc == nch->string + 1 && !isalnum((unsigned char)lc[-1]))
                   return;
   
         if (MDOC_BLOCK != n->type)          /* At least three alphabetic words with a sentence ending. */
                 return(1);          if (strchr("!.:?", *lc) != NULL && (tok == MDOC_Em ||
               tok == MDOC_Li || tok == MDOC_Pq || tok == MDOC_Sy)) {
         /* LINTED */                  nw = 0;
         for (node = mdoc->last->parent; node; node = node->parent)                  for (cp = lc - 1; cp >= nch->string; cp--) {
                 if (MDOC_BLOCK == node->type)                          if (*cp == ' ') {
                         if (MDOC_Bd == node->tok)                                  nw++;
                                   if (cp > nch->string && cp[-1] == ',')
                                           cp--;
                           } else if (isalpha((unsigned int)*cp)) {
                                   if (nw > 1)
                                           return;
                           } else
                                 break;                                  break;
         if (NULL == node)                  }
                 return(1);          }
   
         mdoc_nmsg(mdoc, n, MANDOCERR_NESTEDDISP);          mandoc_msg(MANDOCERR_DELIM_NB, nch->line,
         return(0);              nch->pos + (int)(lc - nch->string), "%s%s %s", roff_name[tok],
               nch == mdoc->last->child ? "" : " ...", nch->string);
 }  }
   
   static void
 static int  post_bl_norm(POST_ARGS)
 pre_bl(PRE_ARGS)  
 {  {
         int              pos, type, width, offset;          struct roff_node *n;
           struct mdoc_argv *argv, *wa;
           int               i;
           enum mdocargt     mdoclt;
           enum mdoc_list    lt;
   
         if (MDOC_BLOCK != n->type)          n = mdoc->last->parent;
                 return(1);          n->norm->Bl.type = LIST__NONE;
         if (NULL == n->args) {  
                 mdoc_nmsg(mdoc, n, MANDOCERR_LISTTYPE);  
                 return(0);  
         }  
   
         /* Make sure that only one type of list is specified.  */          /*
            * First figure out which kind of list to use: bind ourselves to
            * the first mentioned list type and warn about any remaining
            * ones.  If we find no list type, we default to LIST_item.
            */
   
         type = offset = width = -1;          wa = (n->args == NULL) ? NULL : n->args->argv;
           mdoclt = MDOC_ARG_MAX;
         /* LINTED */          for (i = 0; n->args && i < (int)n->args->argc; i++) {
         for (pos = 0; pos < (int)n->args->argc; pos++)                  argv = n->args->argv + i;
                 switch (n->args->argv[pos].arg) {                  lt = LIST__NONE;
                 case (MDOC_Bullet):                  switch (argv->arg) {
                         /* FALLTHROUGH */                  /* Set list types. */
                 case (MDOC_Dash):                  case MDOC_Bullet:
                         /* FALLTHROUGH */                          lt = LIST_bullet;
                 case (MDOC_Enum):                          break;
                         /* FALLTHROUGH */                  case MDOC_Dash:
                 case (MDOC_Hyphen):                          lt = LIST_dash;
                         /* FALLTHROUGH */                          break;
                 case (MDOC_Item):                  case MDOC_Enum:
                         /* FALLTHROUGH */                          lt = LIST_enum;
                 case (MDOC_Tag):                          break;
                         /* FALLTHROUGH */                  case MDOC_Hyphen:
                 case (MDOC_Diag):                          lt = LIST_hyphen;
                         /* FALLTHROUGH */                          break;
                 case (MDOC_Hang):                  case MDOC_Item:
                         /* FALLTHROUGH */                          lt = LIST_item;
                 case (MDOC_Ohang):                          break;
                         /* FALLTHROUGH */                  case MDOC_Tag:
                 case (MDOC_Inset):                          lt = LIST_tag;
                         /* FALLTHROUGH */                          break;
                 case (MDOC_Column):                  case MDOC_Diag:
                         if (type < 0) {                          lt = LIST_diag;
                                 type = n->args->argv[pos].arg;                          break;
                   case MDOC_Hang:
                           lt = LIST_hang;
                           break;
                   case MDOC_Ohang:
                           lt = LIST_ohang;
                           break;
                   case MDOC_Inset:
                           lt = LIST_inset;
                           break;
                   case MDOC_Column:
                           lt = LIST_column;
                           break;
                   /* Set list arguments. */
                   case MDOC_Compact:
                           if (n->norm->Bl.comp)
                                   mandoc_msg(MANDOCERR_ARG_REP,
                                       argv->line, argv->pos, "Bl -compact");
                           n->norm->Bl.comp = 1;
                           break;
                   case MDOC_Width:
                           wa = argv;
                           if (0 == argv->sz) {
                                   mandoc_msg(MANDOCERR_ARG_EMPTY,
                                       argv->line, argv->pos, "Bl -width");
                                   n->norm->Bl.width = "0n";
                                 break;                                  break;
                         }                          }
                         if (mdoc_nmsg(mdoc, n, MANDOCERR_LISTREP))                          if (NULL != n->norm->Bl.width)
                                   mandoc_msg(MANDOCERR_ARG_REP,
                                       argv->line, argv->pos,
                                       "Bl -width %s", argv->value[0]);
                           rewrite_macro2len(mdoc, argv->value);
                           n->norm->Bl.width = argv->value[0];
                           break;
                   case MDOC_Offset:
                           if (0 == argv->sz) {
                                   mandoc_msg(MANDOCERR_ARG_EMPTY,
                                       argv->line, argv->pos, "Bl -offset");
                                 break;                                  break;
                         return(0);                          }
                 case (MDOC_Compact):                          if (NULL != n->norm->Bl.offs)
                         if (type >= 0)                                  mandoc_msg(MANDOCERR_ARG_REP,
                                 break;                                      argv->line, argv->pos,
                         if (mdoc_nmsg(mdoc, n, MANDOCERR_LISTFIRST))                                      "Bl -offset %s", argv->value[0]);
                                 break;                          rewrite_macro2len(mdoc, argv->value);
                         return(0);                          n->norm->Bl.offs = argv->value[0];
                 case (MDOC_Width):  
                         if (width >= 0)  
                                 if ( ! mdoc_nmsg(mdoc, n, MANDOCERR_ARGVREP))  
                                         return(0);  
                         if (type < 0 && ! mdoc_nmsg(mdoc, n, MANDOCERR_LISTFIRST))  
                                 return(0);  
                         width = n->args->argv[pos].arg;  
                         break;                          break;
                 case (MDOC_Offset):  
                         if (offset >= 0)  
                                 if ( ! mdoc_nmsg(mdoc, n, MANDOCERR_ARGVREP))  
                                         return(0);  
                         if (type < 0 && ! mdoc_nmsg(mdoc, n, MANDOCERR_LISTFIRST))  
                                 return(0);  
                         offset = n->args->argv[pos].arg;  
                         break;  
                 default:                  default:
                         break;                          continue;
                 }                  }
                   if (LIST__NONE == lt)
                           continue;
                   mdoclt = argv->arg;
   
         if (type < 0) {                  /* Check: multiple list types. */
                 mdoc_nmsg(mdoc, n, MANDOCERR_LISTTYPE);  
                 return(0);                  if (LIST__NONE != n->norm->Bl.type) {
                           mandoc_msg(MANDOCERR_BL_REP, n->line, n->pos,
                               "Bl -%s", mdoc_argnames[argv->arg]);
                           continue;
                   }
   
                   /* The list type should come first. */
   
                   if (n->norm->Bl.width ||
                       n->norm->Bl.offs ||
                       n->norm->Bl.comp)
                           mandoc_msg(MANDOCERR_BL_LATETYPE,
                               n->line, n->pos, "Bl -%s",
                               mdoc_argnames[n->args->argv[0].arg]);
   
                   n->norm->Bl.type = lt;
                   if (LIST_column == lt) {
                           n->norm->Bl.ncols = argv->sz;
                           n->norm->Bl.cols = (void *)argv->value;
                   }
         }          }
   
         /*          /* Allow lists to default to LIST_item. */
   
           if (LIST__NONE == n->norm->Bl.type) {
                   mandoc_msg(MANDOCERR_BL_NOTYPE, n->line, n->pos, "Bl");
                   n->norm->Bl.type = LIST_item;
                   mdoclt = MDOC_Item;
           }
   
           /*
          * Validate the width field.  Some list types don't need width           * Validate the width field.  Some list types don't need width
          * types and should be warned about them.  Others should have it           * types and should be warned about them.  Others should have it
          * and must also be warned.           * and must also be warned.  Yet others have a default and need
            * no warning.
          */           */
   
         switch (type) {          switch (n->norm->Bl.type) {
         case (MDOC_Tag):          case LIST_tag:
                 if (width < 0 && ! mdoc_nmsg(mdoc, n, MANDOCERR_NOWIDTHARG))                  if (n->norm->Bl.width == NULL)
                         return(0);                          mandoc_msg(MANDOCERR_BL_NOWIDTH,
                               n->line, n->pos, "Bl -tag");
                 break;                  break;
         case (MDOC_Column):          case LIST_column:
                 /* FALLTHROUGH */          case LIST_diag:
         case (MDOC_Diag):          case LIST_ohang:
                 /* FALLTHROUGH */          case LIST_inset:
         case (MDOC_Ohang):          case LIST_item:
                 /* FALLTHROUGH */                  if (n->norm->Bl.width != NULL)
         case (MDOC_Inset):                          mandoc_msg(MANDOCERR_BL_SKIPW, wa->line, wa->pos,
                 /* FALLTHROUGH */                              "Bl -%s", mdoc_argnames[mdoclt]);
         case (MDOC_Item):                  n->norm->Bl.width = NULL;
                 if (width >= 0 && ! mdoc_nmsg(mdoc, n, MANDOCERR_WIDTHARG))  
                         return(0);  
                 break;                  break;
           case LIST_bullet:
           case LIST_dash:
           case LIST_hyphen:
                   if (n->norm->Bl.width == NULL)
                           n->norm->Bl.width = "2n";
                   break;
           case LIST_enum:
                   if (n->norm->Bl.width == NULL)
                           n->norm->Bl.width = "3n";
                   break;
         default:          default:
                 break;                  break;
         }          }
   
         return(1);  
 }  }
   
   static void
 static int  post_bd(POST_ARGS)
 pre_bd(PRE_ARGS)  
 {  {
         int              i, type, err;          struct roff_node *n;
           struct mdoc_argv *argv;
           int               i;
           enum mdoc_disp    dt;
   
         if (MDOC_BLOCK != n->type)          n = mdoc->last;
                 return(1);          for (i = 0; n->args && i < (int)n->args->argc; i++) {
         if (NULL == n->args) {                  argv = n->args->argv + i;
                 mdoc_nmsg(mdoc, n, MANDOCERR_DISPTYPE);                  dt = DISP__NONE;
                 return(0);  
         }  
   
         /* Make sure that only one type of display is specified.  */                  switch (argv->arg) {
                   case MDOC_Centred:
         /* LINTED */                          dt = DISP_centered;
         for (i = 0, err = type = 0; ! err &&                          break;
                         i < (int)n->args->argc; i++)                  case MDOC_Ragged:
                 switch (n->args->argv[i].arg) {                          dt = DISP_ragged;
                 case (MDOC_Centred):                          break;
                         /* FALLTHROUGH */                  case MDOC_Unfilled:
                 case (MDOC_Ragged):                          dt = DISP_unfilled;
                         /* FALLTHROUGH */                          break;
                 case (MDOC_Unfilled):                  case MDOC_Filled:
                         /* FALLTHROUGH */                          dt = DISP_filled;
                 case (MDOC_Filled):                          break;
                         /* FALLTHROUGH */                  case MDOC_Literal:
                 case (MDOC_Literal):                          dt = DISP_literal;
                         if (0 == type++)                          break;
                   case MDOC_File:
                           mandoc_msg(MANDOCERR_BD_FILE, n->line, n->pos, NULL);
                           break;
                   case MDOC_Offset:
                           if (0 == argv->sz) {
                                   mandoc_msg(MANDOCERR_ARG_EMPTY,
                                       argv->line, argv->pos, "Bd -offset");
                                 break;                                  break;
                         if ( ! mdoc_nmsg(mdoc, n, MANDOCERR_DISPREP))                          }
                                 return(0);                          if (NULL != n->norm->Bd.offs)
                                   mandoc_msg(MANDOCERR_ARG_REP,
                                       argv->line, argv->pos,
                                       "Bd -offset %s", argv->value[0]);
                           rewrite_macro2len(mdoc, argv->value);
                           n->norm->Bd.offs = argv->value[0];
                         break;                          break;
                 default:                  case MDOC_Compact:
                           if (n->norm->Bd.comp)
                                   mandoc_msg(MANDOCERR_ARG_REP,
                                       argv->line, argv->pos, "Bd -compact");
                           n->norm->Bd.comp = 1;
                         break;                          break;
                   default:
                           abort();
                 }                  }
                   if (DISP__NONE == dt)
                           continue;
   
         if (type)                  if (DISP__NONE == n->norm->Bd.type)
                 return(1);                          n->norm->Bd.type = dt;
         mdoc_nmsg(mdoc, n, MANDOCERR_DISPTYPE);                  else
         return(0);                          mandoc_msg(MANDOCERR_BD_REP, n->line, n->pos,
                               "Bd -%s", mdoc_argnames[argv->arg]);
           }
   
           if (DISP__NONE == n->norm->Bd.type) {
                   mandoc_msg(MANDOCERR_BD_NOTYPE, n->line, n->pos, "Bd");
                   n->norm->Bd.type = DISP_ragged;
           }
 }  }
   
   /*
    * Stand-alone line macros.
    */
   
 static int  static void
 pre_ss(PRE_ARGS)  post_an_norm(POST_ARGS)
 {  {
           struct roff_node *n;
           struct mdoc_argv *argv;
           size_t   i;
   
         if (MDOC_BLOCK != n->type)          n = mdoc->last;
                 return(1);          if (n->args == NULL)
         return(check_parent(mdoc, n, MDOC_Sh, MDOC_BODY));                  return;
 }  
   
           for (i = 1; i < n->args->argc; i++) {
                   argv = n->args->argv + i;
                   mandoc_msg(MANDOCERR_AN_REP, argv->line, argv->pos,
                       "An -%s", mdoc_argnames[argv->arg]);
           }
   
 static int          argv = n->args->argv;
 pre_sh(PRE_ARGS)          if (argv->arg == MDOC_Split)
                   n->norm->An.auth = AUTH_split;
           else if (argv->arg == MDOC_Nosplit)
                   n->norm->An.auth = AUTH_nosplit;
           else
                   abort();
   }
   
   static void
   post_eoln(POST_ARGS)
 {  {
           struct roff_node        *n;
   
         if (MDOC_BLOCK != n->type)          post_useless(mdoc);
                 return(1);          n = mdoc->last;
         return(check_parent(mdoc, n, MDOC_MAX, MDOC_ROOT));          if (n->child != NULL)
 }                  mandoc_msg(MANDOCERR_ARG_SKIP, n->line,
                       n->pos, "%s %s", roff_name[n->tok], n->child->string);
   
           while (n->child != NULL)
                   roff_node_delete(mdoc, n->child);
   
           roff_word_alloc(mdoc, n->line, n->pos, n->tok == MDOC_Bt ?
               "is currently in beta test." : "currently under development.");
           mdoc->last->flags |= NODE_EOS | NODE_NOSRC;
           mdoc->last = n;
   }
   
 static int  static int
 pre_it(PRE_ARGS)  build_list(struct roff_man *mdoc, int tok)
 {  {
           struct roff_node        *n;
           int                      ic;
   
         if (MDOC_BLOCK != n->type)          n = mdoc->last->next;
                 return(1);          for (ic = 1;; ic++) {
         /*                  roff_elem_alloc(mdoc, n->line, n->pos, tok);
          * FIXME: this can probably be lifted if we make the It into                  mdoc->last->flags |= NODE_NOSRC;
          * something else on-the-fly?                  roff_node_relink(mdoc, n);
          */                  n = mdoc->last = mdoc->last->parent;
         return(check_parent(mdoc, n, MDOC_Bl, MDOC_BODY));                  mdoc->next = ROFF_NEXT_SIBLING;
                   if (n->next == NULL)
                           return ic;
                   if (ic > 1 || n->next->next != NULL) {
                           roff_word_alloc(mdoc, n->line, n->pos, ",");
                           mdoc->last->flags |= NODE_DELIMC | NODE_NOSRC;
                   }
                   n = mdoc->last->next;
                   if (n->next == NULL) {
                           roff_word_alloc(mdoc, n->line, n->pos, "and");
                           mdoc->last->flags |= NODE_NOSRC;
                   }
           }
 }  }
   
   static void
   post_ex(POST_ARGS)
   {
           struct roff_node        *n;
           int                      ic;
   
 static int          post_std(mdoc);
 pre_an(PRE_ARGS)  
           n = mdoc->last;
           mdoc->next = ROFF_NEXT_CHILD;
           roff_word_alloc(mdoc, n->line, n->pos, "The");
           mdoc->last->flags |= NODE_NOSRC;
   
           if (mdoc->last->next != NULL)
                   ic = build_list(mdoc, MDOC_Nm);
           else if (mdoc->meta.name != NULL) {
                   roff_elem_alloc(mdoc, n->line, n->pos, MDOC_Nm);
                   mdoc->last->flags |= NODE_NOSRC;
                   roff_word_alloc(mdoc, n->line, n->pos, mdoc->meta.name);
                   mdoc->last->flags |= NODE_NOSRC;
                   mdoc->last = mdoc->last->parent;
                   mdoc->next = ROFF_NEXT_SIBLING;
                   ic = 1;
           } else {
                   mandoc_msg(MANDOCERR_EX_NONAME, n->line, n->pos, "Ex");
                   ic = 0;
           }
   
           roff_word_alloc(mdoc, n->line, n->pos,
               ic > 1 ? "utilities exit\\~0" : "utility exits\\~0");
           mdoc->last->flags |= NODE_NOSRC;
           roff_word_alloc(mdoc, n->line, n->pos,
               "on success, and\\~>0 if an error occurs.");
           mdoc->last->flags |= NODE_EOS | NODE_NOSRC;
           mdoc->last = n;
   }
   
   static void
   post_lb(POST_ARGS)
 {  {
           struct roff_node        *n;
           const char              *p;
   
         if (NULL == n->args || 1 == n->args->argc)          post_delim_nb(mdoc);
                 return(1);  
         mdoc_vmsg(mdoc, MANDOCERR_SYNTARGCOUNT,          n = mdoc->last;
                                 n->line, n->pos,          assert(n->child->type == ROFFT_TEXT);
                                 "line arguments == 1 (have %d)",          mdoc->next = ROFF_NEXT_CHILD;
                                 n->args->argc);  
         return(0);          if ((p = mdoc_a2lib(n->child->string)) != NULL) {
                   n->child->flags |= NODE_NOPRT;
                   roff_word_alloc(mdoc, n->line, n->pos, p);
                   mdoc->last->flags = NODE_NOSRC;
                   mdoc->last = n;
                   return;
           }
   
           mandoc_msg(MANDOCERR_LB_BAD, n->child->line,
               n->child->pos, "Lb %s", n->child->string);
   
           roff_word_alloc(mdoc, n->line, n->pos, "library");
           mdoc->last->flags = NODE_NOSRC;
           roff_word_alloc(mdoc, n->line, n->pos, "\\(lq");
           mdoc->last->flags = NODE_DELIMO | NODE_NOSRC;
           mdoc->last = mdoc->last->next;
           roff_word_alloc(mdoc, n->line, n->pos, "\\(rq");
           mdoc->last->flags = NODE_DELIMC | NODE_NOSRC;
           mdoc->last = n;
 }  }
   
   static void
   post_rv(POST_ARGS)
   {
           struct roff_node        *n;
           int                      ic;
   
 static int          post_std(mdoc);
 pre_rv(PRE_ARGS)  
           n = mdoc->last;
           mdoc->next = ROFF_NEXT_CHILD;
           if (n->child != NULL) {
                   roff_word_alloc(mdoc, n->line, n->pos, "The");
                   mdoc->last->flags |= NODE_NOSRC;
                   ic = build_list(mdoc, MDOC_Fn);
                   roff_word_alloc(mdoc, n->line, n->pos,
                       ic > 1 ? "functions return" : "function returns");
                   mdoc->last->flags |= NODE_NOSRC;
                   roff_word_alloc(mdoc, n->line, n->pos,
                       "the value\\~0 if successful;");
           } else
                   roff_word_alloc(mdoc, n->line, n->pos, "Upon successful "
                       "completion, the value\\~0 is returned;");
           mdoc->last->flags |= NODE_NOSRC;
   
           roff_word_alloc(mdoc, n->line, n->pos, "otherwise "
               "the value\\~\\-1 is returned and the global variable");
           mdoc->last->flags |= NODE_NOSRC;
           roff_elem_alloc(mdoc, n->line, n->pos, MDOC_Va);
           mdoc->last->flags |= NODE_NOSRC;
           roff_word_alloc(mdoc, n->line, n->pos, "errno");
           mdoc->last->flags |= NODE_NOSRC;
           mdoc->last = mdoc->last->parent;
           mdoc->next = ROFF_NEXT_SIBLING;
           roff_word_alloc(mdoc, n->line, n->pos,
               "is set to indicate the error.");
           mdoc->last->flags |= NODE_EOS | NODE_NOSRC;
           mdoc->last = n;
   }
   
   static void
   post_std(POST_ARGS)
 {  {
           struct roff_node *n;
   
         return(check_stdarg(mdoc, n));          post_delim(mdoc);
   
           n = mdoc->last;
           if (n->args && n->args->argc == 1)
                   if (n->args->argv[0].arg == MDOC_Std)
                           return;
   
           mandoc_msg(MANDOCERR_ARG_STD, n->line, n->pos,
               "%s", roff_name[n->tok]);
 }  }
   
   static void
   post_st(POST_ARGS)
   {
           struct roff_node         *n, *nch;
           const char               *p;
   
 static int          n = mdoc->last;
 post_dt(POST_ARGS)          nch = n->child;
           assert(nch->type == ROFFT_TEXT);
   
           if ((p = mdoc_a2st(nch->string)) == NULL) {
                   mandoc_msg(MANDOCERR_ST_BAD,
                       nch->line, nch->pos, "St %s", nch->string);
                   roff_node_delete(mdoc, n);
                   return;
           }
   
           nch->flags |= NODE_NOPRT;
           mdoc->next = ROFF_NEXT_CHILD;
           roff_word_alloc(mdoc, nch->line, nch->pos, p);
           mdoc->last->flags |= NODE_NOSRC;
           mdoc->last= n;
   }
   
   static void
   post_tg(POST_ARGS)
 {  {
         const struct mdoc_node *nn;          struct roff_node *n;    /* The .Tg node. */
         const char      *p;          struct roff_node *nch;  /* The first child of the .Tg node. */
           struct roff_node *nn;   /* The next node after the .Tg node. */
           struct roff_node *np;   /* The parent of the next node. */
           struct roff_node *nt;   /* The TEXT node containing the tag. */
           size_t            len;  /* The number of bytes in the tag. */
   
         if (NULL != (nn = mdoc->last->child))          /* Find the next node. */
                 for (p = nn->string; *p; p++) {          n = mdoc->last;
                         if (toupper((u_char)*p) == *p)          for (nn = n; nn != NULL; nn = nn->parent) {
                                 continue;                  if (nn->next != NULL) {
                         if ( ! mdoc_nmsg(mdoc, nn, MANDOCERR_UPPERCASE))                          nn = nn->next;
                                 return(0);  
                         break;                          break;
                 }                  }
           }
   
         return(1);          /* Find the tag. */
 }          nt = nch = n->child;
           if (nch == NULL && nn != NULL && nn->child != NULL &&
               nn->child->type == ROFFT_TEXT)
                   nt = nn->child;
   
           /* Validate the tag. */
           if (nt == NULL || *nt->string == '\0')
                   mandoc_msg(MANDOCERR_MACRO_EMPTY, n->line, n->pos, "Tg");
           if (nt == NULL) {
                   roff_node_delete(mdoc, n);
                   return;
           }
           len = strcspn(nt->string, " \t\\");
           if (nt->string[len] != '\0')
                   mandoc_msg(MANDOCERR_TG_SPC, nt->line,
                       nt->pos + len, "Tg %s", nt->string);
   
 static int          /* Keep only the first argument. */
 pre_dt(PRE_ARGS)          if (nch != NULL && nch->next != NULL) {
 {                  mandoc_msg(MANDOCERR_ARG_EXCESS, nch->next->line,
                       nch->next->pos, "Tg ... %s", nch->next->string);
                   while (nch->next != NULL)
                           roff_node_delete(mdoc, nch->next);
           }
   
         if (0 == mdoc->meta.date || mdoc->meta.os)          /* Drop the macro if the first argument is invalid. */
                 if ( ! mdoc_nmsg(mdoc, n, MANDOCERR_PROLOGOOO))          if (len == 0 || nt->string[len] != '\0') {
                         return(0);                  roff_node_delete(mdoc, n);
         if (mdoc->meta.title)                  return;
                 if ( ! mdoc_nmsg(mdoc, n, MANDOCERR_PROLOGREP))          }
                         return(0);  
         return(1);  
 }  
   
           /* By default, tag the .Tg node itself. */
           if (nn == NULL || nn->flags & NODE_ID)
                   nn = n;
   
 static int          /* Explicit tagging of specific macros. */
 pre_os(PRE_ARGS)          switch (nn->tok) {
           case MDOC_Sh:
           case MDOC_Ss:
           case MDOC_Fo:
                   nn = nn->head->child == NULL ? n : nn->head;
                   break;
           case MDOC_It:
                   np = nn->parent;
                   while (np->tok != MDOC_Bl)
                           np = np->parent;
                   switch (np->norm->Bl.type) {
                   case LIST_column:
                           break;
                   case LIST_diag:
                   case LIST_hang:
                   case LIST_inset:
                   case LIST_ohang:
                   case LIST_tag:
                           nn = nn->head;
                           break;
                   case LIST_bullet:
                   case LIST_dash:
                   case LIST_enum:
                   case LIST_hyphen:
                   case LIST_item:
                           nn = nn->body->child == NULL ? n : nn->body;
                           break;
                   default:
                           abort();
                   }
                   break;
           case MDOC_Bd:
           case MDOC_Bl:
           case MDOC_D1:
           case MDOC_Dl:
                   nn = nn->body->child == NULL ? n : nn->body;
                   break;
           case MDOC_Pp:
                   break;
           case MDOC_Cm:
           case MDOC_Dv:
           case MDOC_Em:
           case MDOC_Er:
           case MDOC_Ev:
           case MDOC_Fl:
           case MDOC_Fn:
           case MDOC_Ic:
           case MDOC_Li:
           case MDOC_Ms:
           case MDOC_No:
           case MDOC_Sy:
                   if (nn->child == NULL)
                           nn = n;
                   break;
           default:
                   nn = n;
                   break;
           }
           tag_put(nt->string, TAG_MANUAL, nn);
           if (nn != n)
                   n->flags |= NODE_NOPRT;
   }
   
   static void
   post_obsolete(POST_ARGS)
 {  {
           struct roff_node *n;
   
         if (NULL == mdoc->meta.title || 0 == mdoc->meta.date)          n = mdoc->last;
                 if ( ! mdoc_nmsg(mdoc, n, MANDOCERR_PROLOGOOO))          if (n->type == ROFFT_ELEM || n->type == ROFFT_BLOCK)
                         return(0);                  mandoc_msg(MANDOCERR_MACRO_OBS, n->line, n->pos,
         if (mdoc->meta.os)                      "%s", roff_name[n->tok]);
                 if ( ! mdoc_nmsg(mdoc, n, MANDOCERR_PROLOGREP))  
                         return(0);  
         return(1);  
 }  }
   
   static void
 static int  post_useless(POST_ARGS)
 pre_dd(PRE_ARGS)  
 {  {
           struct roff_node *n;
   
         if (mdoc->meta.title || mdoc->meta.os)          n = mdoc->last;
                 if ( ! mdoc_nmsg(mdoc, n, MANDOCERR_PROLOGOOO))          mandoc_msg(MANDOCERR_MACRO_USELESS, n->line, n->pos,
                         return(0);              "%s", roff_name[n->tok]);
         if (mdoc->meta.date)  
                 if ( ! mdoc_nmsg(mdoc, n, MANDOCERR_PROLOGREP))  
                         return(0);  
         return(1);  
 }  }
   
   /*
    * Block macros.
    */
   
 static int  static void
 post_bf(POST_ARGS)  post_bf(POST_ARGS)
 {  {
         char             *p;          struct roff_node *np, *nch;
         struct mdoc_node *head;  
   
         if (MDOC_BLOCK != mdoc->last->type)          /*
                 return(1);           * Unlike other data pointers, these are "housed" by the HEAD
            * element, which contains the goods.
            */
   
         head = mdoc->last->head;          np = mdoc->last;
           if (np->type != ROFFT_HEAD)
                   return;
   
         if (mdoc->last->args && head->child) {          assert(np->parent->type == ROFFT_BLOCK);
                 /* FIXME: this should provide a default. */          assert(np->parent->tok == MDOC_Bf);
                 mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_SYNTARGVCOUNT);  
                 return(0);  
         } else if (mdoc->last->args)  
                 return(1);  
   
         if (NULL == head->child || MDOC_TEXT != head->child->type) {          /* Check the number of arguments. */
                 /* FIXME: this should provide a default. */  
                 mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_SYNTARGVCOUNT);          nch = np->child;
                 return(0);          if (np->parent->args == NULL) {
                   if (nch == NULL) {
                           mandoc_msg(MANDOCERR_BF_NOFONT,
                               np->line, np->pos, "Bf");
                           return;
                   }
                   nch = nch->next;
         }          }
           if (nch != NULL)
                   mandoc_msg(MANDOCERR_ARG_EXCESS,
                       nch->line, nch->pos, "Bf ... %s", nch->string);
   
         p = head->child->string;          /* Extract argument into data. */
   
         if (0 == strcmp(p, "Em"))          if (np->parent->args != NULL) {
                 return(1);                  switch (np->parent->args->argv[0].arg) {
         else if (0 == strcmp(p, "Li"))                  case MDOC_Emphasis:
                 return(1);                          np->norm->Bf.font = FONT_Em;
         else if (0 == strcmp(p, "Sy"))                          break;
                 return(1);                  case MDOC_Literal:
                           np->norm->Bf.font = FONT_Li;
                           break;
                   case MDOC_Symbolic:
                           np->norm->Bf.font = FONT_Sy;
                           break;
                   default:
                           abort();
                   }
                   return;
           }
   
         mdoc_nmsg(mdoc, head, MANDOCERR_FONTTYPE);          /* Extract parameter into data. */
         return(0);  
           if ( ! strcmp(np->child->string, "Em"))
                   np->norm->Bf.font = FONT_Em;
           else if ( ! strcmp(np->child->string, "Li"))
                   np->norm->Bf.font = FONT_Li;
           else if ( ! strcmp(np->child->string, "Sy"))
                   np->norm->Bf.font = FONT_Sy;
           else
                   mandoc_msg(MANDOCERR_BF_BADFONT, np->child->line,
                       np->child->pos, "Bf %s", np->child->string);
 }  }
   
   static void
 static int  post_fname(POST_ARGS)
 post_lb(POST_ARGS)  
 {  {
           struct roff_node        *n, *nch;
           const char              *cp;
           size_t                   pos;
   
         if (mdoc_a2lib(mdoc->last->child->string))          n = mdoc->last;
                 return(1);          nch = n->child;
         return(mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_BADLIB));          cp = nch->string;
           if (*cp == '(') {
                   if (cp[strlen(cp + 1)] == ')')
                           return;
                   pos = 0;
           } else {
                   pos = strcspn(cp, "()");
                   if (cp[pos] == '\0') {
                           if (n->sec == SEC_DESCRIPTION ||
                               n->sec == SEC_CUSTOM)
                                   tag_put(NULL, fn_prio++, n);
                           return;
                   }
           }
           mandoc_msg(MANDOCERR_FN_PAREN, nch->line, nch->pos + pos, "%s", cp);
 }  }
   
   static void
   post_fn(POST_ARGS)
   {
           post_fname(mdoc);
           post_fa(mdoc);
   }
   
 static int  static void
 post_eoln(POST_ARGS)  post_fo(POST_ARGS)
 {  {
           const struct roff_node  *n;
   
         if (NULL == mdoc->last->child)          n = mdoc->last;
                 return(1);  
         return(mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_ARGSLOST));          if (n->type != ROFFT_HEAD)
                   return;
   
           if (n->child == NULL) {
                   mandoc_msg(MANDOCERR_FO_NOHEAD, n->line, n->pos, "Fo");
                   return;
           }
           if (n->child != n->last) {
                   mandoc_msg(MANDOCERR_ARG_EXCESS,
                       n->child->next->line, n->child->next->pos,
                       "Fo ... %s", n->child->next->string);
                   while (n->child != n->last)
                           roff_node_delete(mdoc, n->last);
           } else
                   post_delim(mdoc);
   
           post_fname(mdoc);
 }  }
   
   static void
   post_fa(POST_ARGS)
   {
           const struct roff_node *n;
           const char *cp;
   
 static int          for (n = mdoc->last->child; n != NULL; n = n->next) {
 post_vt(POST_ARGS)                  for (cp = n->string; *cp != '\0'; cp++) {
                           /* Ignore callbacks and alterations. */
                           if (*cp == '(' || *cp == '{')
                                   break;
                           if (*cp != ',')
                                   continue;
                           mandoc_msg(MANDOCERR_FA_COMMA, n->line,
                               n->pos + (int)(cp - n->string), "%s", n->string);
                           break;
                   }
           }
           post_delim_nb(mdoc);
   }
   
   static void
   post_nm(POST_ARGS)
 {  {
         const struct mdoc_node *n;          struct roff_node        *n;
   
         /*          n = mdoc->last;
          * The Vt macro comes in both ELEM and BLOCK form, both of which  
          * have different syntaxes (yet more context-sensitive  
          * behaviour).  ELEM types must have a child; BLOCK types,  
          * specifically the BODY, should only have TEXT children.  
          */  
   
         if (MDOC_ELEM == mdoc->last->type)          if (n->sec == SEC_NAME && n->child != NULL &&
                 return(eerr_ge1(mdoc));              n->child->type == ROFFT_TEXT && mdoc->meta.msec != NULL)
         if (MDOC_BODY != mdoc->last->type)                  mandoc_xr_add(mdoc->meta.msec, n->child->string, -1, -1);
                 return(1);  
   
         for (n = mdoc->last->child; n; n = n->next)  
                 if (MDOC_TEXT != n->type)  
                         if ( ! mdoc_nmsg(mdoc, n, MANDOCERR_CHILD))  
                                 return(0);  
   
         return(1);          if (n->last != NULL && n->last->tok == MDOC_Pp)
                   roff_node_relink(mdoc, n->last);
   
           if (mdoc->meta.name == NULL)
                   deroff(&mdoc->meta.name, n);
   
           if (mdoc->meta.name == NULL ||
               (mdoc->lastsec == SEC_NAME && n->child == NULL))
                   mandoc_msg(MANDOCERR_NM_NONAME, n->line, n->pos, "Nm");
   
           switch (n->type) {
           case ROFFT_ELEM:
                   post_delim_nb(mdoc);
                   break;
           case ROFFT_HEAD:
                   post_delim(mdoc);
                   break;
           default:
                   return;
           }
   
           if ((n->child != NULL && n->child->type == ROFFT_TEXT) ||
               mdoc->meta.name == NULL)
                   return;
   
           mdoc->next = ROFF_NEXT_CHILD;
           roff_word_alloc(mdoc, n->line, n->pos, mdoc->meta.name);
           mdoc->last->flags |= NODE_NOSRC;
           mdoc->last = n;
 }  }
   
   static void
   post_nd(POST_ARGS)
   {
           struct roff_node        *n;
   
 static int          n = mdoc->last;
 post_nm(POST_ARGS)  
           if (n->type != ROFFT_BODY)
                   return;
   
           if (n->sec != SEC_NAME)
                   mandoc_msg(MANDOCERR_ND_LATE, n->line, n->pos, "Nd");
   
           if (n->child == NULL)
                   mandoc_msg(MANDOCERR_ND_EMPTY, n->line, n->pos, "Nd");
           else
                   post_delim(mdoc);
   
           post_hyph(mdoc);
   }
   
   static void
   post_display(POST_ARGS)
 {  {
           struct roff_node *n, *np;
   
         if (mdoc->last->child)          n = mdoc->last;
                 return(1);          switch (n->type) {
         if (mdoc->meta.name)          case ROFFT_BODY:
                 return(1);                  if (n->end != ENDBODY_NOT) {
         return(mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_NONAME));                          if (n->tok == MDOC_Bd &&
                               n->body->parent->args == NULL)
                                   roff_node_delete(mdoc, n);
                   } else if (n->child == NULL)
                           mandoc_msg(MANDOCERR_BLK_EMPTY, n->line, n->pos,
                               "%s", roff_name[n->tok]);
                   else if (n->tok == MDOC_D1)
                           post_hyph(mdoc);
                   break;
           case ROFFT_BLOCK:
                   if (n->tok == MDOC_Bd) {
                           if (n->args == NULL) {
                                   mandoc_msg(MANDOCERR_BD_NOARG,
                                       n->line, n->pos, "Bd");
                                   mdoc->next = ROFF_NEXT_SIBLING;
                                   while (n->body->child != NULL)
                                           roff_node_relink(mdoc,
                                               n->body->child);
                                   roff_node_delete(mdoc, n);
                                   break;
                           }
                           post_bd(mdoc);
                           post_prevpar(mdoc);
                   }
                   for (np = n->parent; np != NULL; np = np->parent) {
                           if (np->type == ROFFT_BLOCK && np->tok == MDOC_Bd) {
                                   mandoc_msg(MANDOCERR_BD_NEST, n->line,
                                       n->pos, "%s in Bd", roff_name[n->tok]);
                                   break;
                           }
                   }
                   break;
           default:
                   break;
           }
 }  }
   
   static void
   post_defaults(POST_ARGS)
   {
           struct roff_node *n;
   
 static int          n = mdoc->last;
           if (n->child != NULL) {
                   post_delim_nb(mdoc);
                   return;
           }
           mdoc->next = ROFF_NEXT_CHILD;
           switch (n->tok) {
           case MDOC_Ar:
                   roff_word_alloc(mdoc, n->line, n->pos, "file");
                   mdoc->last->flags |= NODE_NOSRC;
                   roff_word_alloc(mdoc, n->line, n->pos, "...");
                   break;
           case MDOC_Pa:
           case MDOC_Mt:
                   roff_word_alloc(mdoc, n->line, n->pos, "~");
                   break;
           default:
                   abort();
           }
           mdoc->last->flags |= NODE_NOSRC;
           mdoc->last = n;
   }
   
   static void
 post_at(POST_ARGS)  post_at(POST_ARGS)
 {  {
           struct roff_node        *n, *nch;
           const char              *att;
   
         if (NULL == mdoc->last->child)          n = mdoc->last;
                 return(1);          nch = n->child;
         assert(MDOC_TEXT == mdoc->last->child->type);  
         if (mdoc_a2att(mdoc->last->child->string))  
                 return(1);  
         return(mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_BADATT));  
 }  
   
           /*
            * If we have a child, look it up in the standard keys.  If a
            * key exist, use that instead of the child; if it doesn't,
            * prefix "AT&T UNIX " to the existing data.
            */
   
 static int          att = NULL;
           if (nch != NULL && ((att = mdoc_a2att(nch->string)) == NULL))
                   mandoc_msg(MANDOCERR_AT_BAD,
                       nch->line, nch->pos, "At %s", nch->string);
   
           mdoc->next = ROFF_NEXT_CHILD;
           if (att != NULL) {
                   roff_word_alloc(mdoc, nch->line, nch->pos, att);
                   nch->flags |= NODE_NOPRT;
           } else
                   roff_word_alloc(mdoc, n->line, n->pos, "AT&T UNIX");
           mdoc->last->flags |= NODE_NOSRC;
           mdoc->last = n;
   }
   
   static void
 post_an(POST_ARGS)  post_an(POST_ARGS)
 {  {
           struct roff_node *np, *nch;
   
         if (mdoc->last->args) {          post_an_norm(mdoc);
                 if (NULL == mdoc->last->child)  
                         return(1);  
                 return(mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_ARGCOUNT));  
         }  
   
         if (mdoc->last->child)          np = mdoc->last;
                 return(1);          nch = np->child;
         return(mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_NOARGS));          if (np->norm->An.auth == AUTH__NONE) {
                   if (nch == NULL)
                           mandoc_msg(MANDOCERR_MACRO_EMPTY,
                               np->line, np->pos, "An");
                   else
                           post_delim_nb(mdoc);
           } else if (nch != NULL)
                   mandoc_msg(MANDOCERR_ARG_EXCESS,
                       nch->line, nch->pos, "An ... %s", nch->string);
 }  }
   
   static void
   post_em(POST_ARGS)
   {
           post_tag(mdoc);
           tag_put(NULL, TAG_FALLBACK, mdoc->last);
   }
   
 static int  static void
 post_it(POST_ARGS)  post_en(POST_ARGS)
 {  {
         /* FIXME: use mdoc_list! */          post_obsolete(mdoc);
         int               type, i, cols;          if (mdoc->last->type == ROFFT_BLOCK)
         struct mdoc_node *n, *c;                  mdoc->last->norm->Es = mdoc->last_es;
   }
   
         if (MDOC_BLOCK != mdoc->last->type)  static void
                 return(1);  post_er(POST_ARGS)
   {
           struct roff_node *n;
   
         n = mdoc->last->parent->parent;          n = mdoc->last;
         if (NULL == n->args) {          if (n->sec == SEC_ERRORS &&
                 mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_LISTTYPE);              (n->parent->tok == MDOC_It ||
                 return(0);               (n->parent->tok == MDOC_Bq &&
         }                n->parent->parent->parent->tok == MDOC_It)))
                   tag_put(NULL, TAG_STRONG, n);
           post_delim_nb(mdoc);
   }
   
         /* Some types require block-head, some not. */  static void
   post_tag(POST_ARGS)
   {
           struct roff_node *n;
   
         /* LINTED */          n = mdoc->last;
         for (cols = type = -1, i = 0; -1 == type &&          if ((n->prev == NULL ||
                         i < (int)n->args->argc; i++)               (n->prev->type == ROFFT_TEXT &&
                 switch (n->args->argv[i].arg) {                strcmp(n->prev->string, "|") == 0)) &&
                 case (MDOC_Tag):              (n->parent->tok == MDOC_It ||
                         /* FALLTHROUGH */               (n->parent->tok == MDOC_Xo &&
                 case (MDOC_Diag):                n->parent->parent->prev == NULL &&
                         /* FALLTHROUGH */                n->parent->parent->parent->tok == MDOC_It)))
                 case (MDOC_Hang):                  tag_put(NULL, TAG_STRONG, n);
                         /* FALLTHROUGH */          post_delim_nb(mdoc);
                 case (MDOC_Ohang):  }
                         /* FALLTHROUGH */  
                 case (MDOC_Inset):  static void
                         /* FALLTHROUGH */  post_es(POST_ARGS)
                 case (MDOC_Bullet):  {
                         /* FALLTHROUGH */          post_obsolete(mdoc);
                 case (MDOC_Dash):          mdoc->last_es = mdoc->last;
                         /* FALLTHROUGH */  }
                 case (MDOC_Enum):  
                         /* FALLTHROUGH */  static void
                 case (MDOC_Hyphen):  post_xx(POST_ARGS)
                         /* FALLTHROUGH */  {
                 case (MDOC_Item):          struct roff_node        *n;
                         type = n->args->argv[i].arg;          const char              *os;
           char                    *v;
   
           post_delim_nb(mdoc);
   
           n = mdoc->last;
           switch (n->tok) {
           case MDOC_Bsx:
                   os = "BSD/OS";
                   break;
           case MDOC_Dx:
                   os = "DragonFly";
                   break;
           case MDOC_Fx:
                   os = "FreeBSD";
                   break;
           case MDOC_Nx:
                   os = "NetBSD";
                   if (n->child == NULL)
                         break;                          break;
                 case (MDOC_Column):                  v = n->child->string;
                         type = n->args->argv[i].arg;                  if ((v[0] != '0' && v[0] != '1') || v[1] != '.' ||
                         cols = (int)n->args->argv[i].sz;                      v[2] < '0' || v[2] > '9' ||
                       v[3] < 'a' || v[3] > 'z' || v[4] != '\0')
                         break;                          break;
                 default:                  n->child->flags |= NODE_NOPRT;
                         break;                  mdoc->next = ROFF_NEXT_CHILD;
                 }                  roff_word_alloc(mdoc, n->child->line, n->child->pos, v);
                   v = mdoc->last->string;
         if (-1 == type) {                  v[3] = toupper((unsigned char)v[3]);
                 mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_LISTTYPE);                  mdoc->last->flags |= NODE_NOSRC;
                 return(0);                  mdoc->last = n;
                   break;
           case MDOC_Ox:
                   os = "OpenBSD";
                   break;
           case MDOC_Ux:
                   os = "UNIX";
                   break;
           default:
                   abort();
         }          }
           mdoc->next = ROFF_NEXT_CHILD;
           roff_word_alloc(mdoc, n->line, n->pos, os);
           mdoc->last->flags |= NODE_NOSRC;
           mdoc->last = n;
   }
   
         switch (type) {  static void
         case (MDOC_Tag):  post_it(POST_ARGS)
                 if (NULL == mdoc->last->head->child)  {
                         if ( ! mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_NOARGS))          struct roff_node *nbl, *nit, *nch;
                                 return(0);          int               i, cols;
           enum mdoc_list    lt;
   
           post_prevpar(mdoc);
   
           nit = mdoc->last;
           if (nit->type != ROFFT_BLOCK)
                   return;
   
           nbl = nit->parent->parent;
           lt = nbl->norm->Bl.type;
   
           switch (lt) {
           case LIST_tag:
           case LIST_hang:
           case LIST_ohang:
           case LIST_inset:
           case LIST_diag:
                   if (nit->head->child == NULL)
                           mandoc_msg(MANDOCERR_IT_NOHEAD,
                               nit->line, nit->pos, "Bl -%s It",
                               mdoc_argnames[nbl->args->argv[0].arg]);
                 break;                  break;
         case (MDOC_Hang):          case LIST_bullet:
           case LIST_dash:
           case LIST_enum:
           case LIST_hyphen:
                   if (nit->body == NULL || nit->body->child == NULL)
                           mandoc_msg(MANDOCERR_IT_NOBODY,
                               nit->line, nit->pos, "Bl -%s It",
                               mdoc_argnames[nbl->args->argv[0].arg]);
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
         case (MDOC_Ohang):          case LIST_item:
                 /* FALLTHROUGH */                  if ((nch = nit->head->child) != NULL)
         case (MDOC_Inset):                          mandoc_msg(MANDOCERR_ARG_SKIP,
                 /* FALLTHROUGH */                              nit->line, nit->pos, "It %s",
         case (MDOC_Diag):                              nch->type == ROFFT_TEXT ? nch->string :
                 if (NULL == mdoc->last->head->child)                              roff_name[nch->tok]);
                         if ( ! mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_NOARGS))  
                                 return(0);  
                 if (NULL == mdoc->last->body->child)  
                         if ( ! mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_NOBODY))  
                                 return(0);  
                 break;                  break;
         case (MDOC_Bullet):          case LIST_column:
                 /* FALLTHROUGH */                  cols = (int)nbl->norm->Bl.ncols;
         case (MDOC_Dash):  
                 /* FALLTHROUGH */  
         case (MDOC_Enum):  
                 /* FALLTHROUGH */  
         case (MDOC_Hyphen):  
                 /* FALLTHROUGH */  
         case (MDOC_Item):  
                 if (mdoc->last->head->child)  
                         if ( ! mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_ARGSLOST))  
                                 return(0);  
                 if (NULL == mdoc->last->body->child)  
                         if ( ! mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_NOBODY))  
                                 return(0);  
                 break;  
         case (MDOC_Column):  
                 assert(NULL == mdoc->last->head->child);  
                 if (NULL == mdoc->last->body->child)  
                         if ( ! mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_NOBODY))  
                                 return(0);  
   
                 /* Count up the number of columns.  */                  assert(nit->head->child == NULL);
                 c = mdoc->last->child;  
                 for (i = 0; c; c = c->next)  
                         if (MDOC_BODY == c->type)  
                                 i++;  
   
                 if (i < cols) {                  if (nit->head->next->child == NULL &&
                         if ( ! mdoc_vmsg(mdoc, MANDOCERR_ARGCOUNT,                      nit->head->next->next == NULL) {
                                         mdoc->last->line,                          mandoc_msg(MANDOCERR_MACRO_EMPTY,
                                         mdoc->last->pos,                              nit->line, nit->pos, "It");
                                         "columns == %d (have %d)",                          roff_node_delete(mdoc, nit);
                                         cols, i))  
                                 return(0);  
                         break;                          break;
                 } else if (i == cols || i == cols + 1)                  }
                         break;  
   
                 mdoc_vmsg(mdoc, MANDOCERR_SYNTARGCOUNT,                  i = 0;
                                 mdoc->last->line, mdoc->last->pos,                  for (nch = nit->child; nch != NULL; nch = nch->next) {
                                 "columns == %d (have %d)", cols, i);                          if (nch->type != ROFFT_BODY)
                 return(0);                                  continue;
         default:                          if (i++ && nch->flags & NODE_LINE)
                                   mandoc_msg(MANDOCERR_TA_LINE,
                                       nch->line, nch->pos, "Ta");
                   }
                   if (i < cols || i > cols + 1)
                           mandoc_msg(MANDOCERR_BL_COL, nit->line, nit->pos,
                               "%d columns, %d cells", cols, i);
                   else if (nit->head->next->child != NULL &&
                       nit->head->next->child->flags & NODE_LINE)
                           mandoc_msg(MANDOCERR_IT_NOARG,
                               nit->line, nit->pos, "Bl -column It");
                 break;                  break;
           default:
                   abort();
         }          }
   }
   
         return(1);  static void
   post_bl_block(POST_ARGS)
   {
           struct roff_node *n, *ni, *nc;
   
           post_prevpar(mdoc);
   
           n = mdoc->last;
           for (ni = n->body->child; ni != NULL; ni = ni->next) {
                   if (ni->body == NULL)
                           continue;
                   nc = ni->body->last;
                   while (nc != NULL) {
                           switch (nc->tok) {
                           case MDOC_Pp:
                           case ROFF_br:
                                   break;
                           default:
                                   nc = NULL;
                                   continue;
                           }
                           if (ni->next == NULL) {
                                   mandoc_msg(MANDOCERR_PAR_MOVE, nc->line,
                                       nc->pos, "%s", roff_name[nc->tok]);
                                   roff_node_relink(mdoc, nc);
                           } else if (n->norm->Bl.comp == 0 &&
                               n->norm->Bl.type != LIST_column) {
                                   mandoc_msg(MANDOCERR_PAR_SKIP,
                                       nc->line, nc->pos,
                                       "%s before It", roff_name[nc->tok]);
                                   roff_node_delete(mdoc, nc);
                           } else
                                   break;
                           nc = ni->body->last;
                   }
           }
 }  }
   
   /*
    * If the argument of -offset or -width is a macro,
    * replace it with the associated default width.
    */
   static void
   rewrite_macro2len(struct roff_man *mdoc, char **arg)
   {
           size_t            width;
           enum roff_tok     tok;
   
 static int          if (*arg == NULL)
 post_bl_head(POST_ARGS)                  return;
           else if ( ! strcmp(*arg, "Ds"))
                   width = 6;
           else if ((tok = roffhash_find(mdoc->mdocmac, *arg, 0)) == TOKEN_NONE)
                   return;
           else
                   width = macro2len(tok);
   
           free(*arg);
           mandoc_asprintf(arg, "%zun", width);
   }
   
   static void
   post_bl_head(POST_ARGS)
 {  {
         int                     i;          struct roff_node *nbl, *nh, *nch, *nnext;
         const struct mdoc_node *n;          struct mdoc_argv *argv;
         const struct mdoc_argv *a;          int               i, j;
   
         n = mdoc->last->parent;          post_bl_norm(mdoc);
         assert(n->args);  
   
         for (i = 0; i < (int)n->args->argc; i++) {          nh = mdoc->last;
                 a = &n->args->argv[i];          if (nh->norm->Bl.type != LIST_column) {
                 if (a->arg == MDOC_Column) {                  if ((nch = nh->child) == NULL)
                         if (a->sz && mdoc->last->nchild)                          return;
                                 return(mdoc_nmsg(mdoc, n, MANDOCERR_COLUMNS));                  mandoc_msg(MANDOCERR_ARG_EXCESS,
                         return(1);                      nch->line, nch->pos, "Bl ... %s", nch->string);
                   while (nch != NULL) {
                           roff_node_delete(mdoc, nch);
                           nch = nh->child;
                 }                  }
                   return;
         }          }
   
         if (0 == (i = mdoc->last->nchild))          /*
                 return(1);           * Append old-style lists, where the column width specifiers
         return(warn_count(mdoc, "==", 0, "line arguments", i));           * trail as macro parameters, to the new-style ("normal-form")
 }           * lists where they're argument values following -column.
            */
   
           if (nh->child == NULL)
                   return;
   
 static int          nbl = nh->parent;
           for (j = 0; j < (int)nbl->args->argc; j++)
                   if (nbl->args->argv[j].arg == MDOC_Column)
                           break;
   
           assert(j < (int)nbl->args->argc);
   
           /*
            * Accommodate for new-style groff column syntax.  Shuffle the
            * child nodes, all of which must be TEXT, as arguments for the
            * column field.  Then, delete the head children.
            */
   
           argv = nbl->args->argv + j;
           i = argv->sz;
           for (nch = nh->child; nch != NULL; nch = nch->next)
                   argv->sz++;
           argv->value = mandoc_reallocarray(argv->value,
               argv->sz, sizeof(char *));
   
           nh->norm->Bl.ncols = argv->sz;
           nh->norm->Bl.cols = (void *)argv->value;
   
           for (nch = nh->child; nch != NULL; nch = nnext) {
                   argv->value[i++] = nch->string;
                   nch->string = NULL;
                   nnext = nch->next;
                   roff_node_delete(NULL, nch);
           }
           nh->child = NULL;
   }
   
   static void
 post_bl(POST_ARGS)  post_bl(POST_ARGS)
 {  {
         struct mdoc_node        *n;          struct roff_node        *nbody;           /* of the Bl */
           struct roff_node        *nchild, *nnext;  /* of the Bl body */
           const char              *prev_Er;
           int                      order;
   
         if (MDOC_HEAD == mdoc->last->type)          nbody = mdoc->last;
                 return(post_bl_head(mdoc));          switch (nbody->type) {
         if (MDOC_BODY != mdoc->last->type)          case ROFFT_BLOCK:
                 return(1);                  post_bl_block(mdoc);
         if (NULL == mdoc->last->child)                  return;
                 return(1);          case ROFFT_HEAD:
                   post_bl_head(mdoc);
                   return;
           case ROFFT_BODY:
                   break;
           default:
                   return;
           }
           if (nbody->end != ENDBODY_NOT)
                   return;
   
         /*          /*
          * We only allow certain children of `Bl'.  This is usually on           * Up to the first item, move nodes before the list,
          * `It', but apparently `Sm' occurs here and there, so we let           * but leave transparent nodes where they are
          * that one through, too.           * if they precede an item.
            * The next non-transparent node is kept in nchild.
            * It only needs to be updated after a non-transparent
            * node was moved out, and at the very beginning
            * when no node at all was moved yet.
          */           */
   
         /* LINTED */          nchild = mdoc->last;
         for (n = mdoc->last->child; n; n = n->next) {          for (;;) {
                 if (MDOC_BLOCK == n->type && MDOC_It == n->tok)                  if (nchild == mdoc->last)
                         continue;                          nchild = roff_node_child(nbody);
                 if (MDOC_Sm == n->tok)                  if (nchild == NULL) {
                         continue;                          mdoc->last = nbody;
                 mdoc_nmsg(mdoc, n, MANDOCERR_SYNTCHILD);                          mandoc_msg(MANDOCERR_BLK_EMPTY,
                 return(0);                              nbody->line, nbody->pos, "Bl");
                           return;
                   }
                   if (nchild->tok == MDOC_It) {
                           mdoc->last = nbody;
                           break;
                   }
                   mandoc_msg(MANDOCERR_BL_MOVE, nbody->child->line,
                       nbody->child->pos, "%s", roff_name[nbody->child->tok]);
                   if (nbody->parent->prev == NULL) {
                           mdoc->last = nbody->parent->parent;
                           mdoc->next = ROFF_NEXT_CHILD;
                   } else {
                           mdoc->last = nbody->parent->prev;
                           mdoc->next = ROFF_NEXT_SIBLING;
                   }
                   roff_node_relink(mdoc, nbody->child);
         }          }
   
         return(1);          /*
 }           * We have reached the first item,
            * so moving nodes out is no longer possible.
            * But in .Bl -column, the first rows may be implicit,
            * that is, they may not start with .It macros.
            * Such rows may be followed by nodes generated on the
            * roff level, for example .TS.
            * Wrap such roff nodes into an implicit row.
            */
   
           while (nchild != NULL) {
                   if (nchild->tok == MDOC_It) {
                           nchild = roff_node_next(nchild);
                           continue;
                   }
                   nnext = nchild->next;
                   mdoc->last = nchild->prev;
                   mdoc->next = ROFF_NEXT_SIBLING;
                   roff_block_alloc(mdoc, nchild->line, nchild->pos, MDOC_It);
                   roff_head_alloc(mdoc, nchild->line, nchild->pos, MDOC_It);
                   mdoc->next = ROFF_NEXT_SIBLING;
                   roff_body_alloc(mdoc, nchild->line, nchild->pos, MDOC_It);
                   while (nchild->tok != MDOC_It) {
                           roff_node_relink(mdoc, nchild);
                           if (nnext == NULL)
                                   break;
                           nchild = nnext;
                           nnext = nchild->next;
                           mdoc->next = ROFF_NEXT_SIBLING;
                   }
                   mdoc->last = nbody;
           }
   
 static int          if (mdoc->meta.os_e != MANDOC_OS_NETBSD)
 ebool(struct mdoc *mdoc)                  return;
 {  
         struct mdoc_node *n;  
   
         /* LINTED */          prev_Er = NULL;
         for (n = mdoc->last->child; n; n = n->next) {          for (nchild = nbody->child; nchild != NULL; nchild = nchild->next) {
                 if (MDOC_TEXT != n->type)                  if (nchild->tok != MDOC_It)
                         break;  
                 if (0 == strcmp(n->string, "on"))  
                         continue;                          continue;
                 if (0 == strcmp(n->string, "off"))                  if ((nnext = nchild->head->child) == NULL)
                         continue;                          continue;
                 break;                  if (nnext->type == ROFFT_BLOCK)
                           nnext = nnext->body->child;
                   if (nnext == NULL || nnext->tok != MDOC_Er)
                           continue;
                   nnext = nnext->child;
                   if (prev_Er != NULL) {
                           order = strcmp(prev_Er, nnext->string);
                           if (order > 0)
                                   mandoc_msg(MANDOCERR_ER_ORDER,
                                       nnext->line, nnext->pos,
                                       "Er %s %s (NetBSD)",
                                       prev_Er, nnext->string);
                           else if (order == 0)
                                   mandoc_msg(MANDOCERR_ER_REP,
                                       nnext->line, nnext->pos,
                                       "Er %s (NetBSD)", prev_Er);
                   }
                   prev_Er = nnext->string;
         }          }
   }
   
         if (NULL == n)  static void
                 return(1);  post_bk(POST_ARGS)
         return(mdoc_nmsg(mdoc, n, MANDOCERR_BADBOOL));  {
           struct roff_node        *n;
   
           n = mdoc->last;
   
           if (n->type == ROFFT_BLOCK && n->body->child == NULL) {
                   mandoc_msg(MANDOCERR_BLK_EMPTY, n->line, n->pos, "Bk");
                   roff_node_delete(mdoc, n);
           }
 }  }
   
   static void
   post_sm(POST_ARGS)
   {
           struct roff_node        *nch;
   
 static int          nch = mdoc->last->child;
   
           if (nch == NULL) {
                   mdoc->flags ^= MDOC_SMOFF;
                   return;
           }
   
           assert(nch->type == ROFFT_TEXT);
   
           if ( ! strcmp(nch->string, "on")) {
                   mdoc->flags &= ~MDOC_SMOFF;
                   return;
           }
           if ( ! strcmp(nch->string, "off")) {
                   mdoc->flags |= MDOC_SMOFF;
                   return;
           }
   
           mandoc_msg(MANDOCERR_SM_BAD, nch->line, nch->pos,
               "%s %s", roff_name[mdoc->last->tok], nch->string);
           roff_node_relink(mdoc, nch);
           return;
   }
   
   static void
 post_root(POST_ARGS)  post_root(POST_ARGS)
 {  {
           struct roff_node *n;
   
         if (NULL == mdoc->first->child)          /* Add missing prologue data. */
                 mdoc_nmsg(mdoc, mdoc->first, MANDOCERR_NODOCBODY);  
         else if ( ! (MDOC_PBODY & mdoc->flags))  
                 mdoc_nmsg(mdoc, mdoc->first, MANDOCERR_NODOCPROLOG);  
         else if (MDOC_BLOCK != mdoc->first->child->type)  
                 mdoc_nmsg(mdoc, mdoc->first, MANDOCERR_NODOCBODY);  
         else if (MDOC_Sh != mdoc->first->child->tok)  
                 mdoc_nmsg(mdoc, mdoc->first, MANDOCERR_NODOCBODY);  
         else  
                 return(1);  
   
         return(0);          if (mdoc->meta.date == NULL)
                   mdoc->meta.date = mandoc_normdate(NULL, NULL);
   
           if (mdoc->meta.title == NULL) {
                   mandoc_msg(MANDOCERR_DT_NOTITLE, 0, 0, "EOF");
                   mdoc->meta.title = mandoc_strdup("UNTITLED");
           }
   
           if (mdoc->meta.vol == NULL)
                   mdoc->meta.vol = mandoc_strdup("LOCAL");
   
           if (mdoc->meta.os == NULL) {
                   mandoc_msg(MANDOCERR_OS_MISSING, 0, 0, NULL);
                   mdoc->meta.os = mandoc_strdup("");
           } else if (mdoc->meta.os_e &&
               (mdoc->meta.rcsids & (1 << mdoc->meta.os_e)) == 0)
                   mandoc_msg(MANDOCERR_RCS_MISSING, 0, 0,
                       mdoc->meta.os_e == MANDOC_OS_OPENBSD ?
                       "(OpenBSD)" : "(NetBSD)");
   
           if (mdoc->meta.arch != NULL &&
               arch_valid(mdoc->meta.arch, mdoc->meta.os_e) == 0) {
                   n = mdoc->meta.first->child;
                   while (n->tok != MDOC_Dt ||
                       n->child == NULL ||
                       n->child->next == NULL ||
                       n->child->next->next == NULL)
                           n = n->next;
                   n = n->child->next->next;
                   mandoc_msg(MANDOCERR_ARCH_BAD, n->line, n->pos,
                       "Dt ... %s %s", mdoc->meta.arch,
                       mdoc->meta.os_e == MANDOC_OS_OPENBSD ?
                       "(OpenBSD)" : "(NetBSD)");
           }
   
           /* Check that we begin with a proper `Sh'. */
   
           n = mdoc->meta.first->child;
           while (n != NULL &&
               (n->type == ROFFT_COMMENT ||
                (n->tok >= MDOC_Dd &&
                 mdoc_macro(n->tok)->flags & MDOC_PROLOGUE)))
                   n = n->next;
   
           if (n == NULL)
                   mandoc_msg(MANDOCERR_DOC_EMPTY, 0, 0, NULL);
           else if (n->tok != MDOC_Sh)
                   mandoc_msg(MANDOCERR_SEC_BEFORE, n->line, n->pos,
                       "%s", roff_name[n->tok]);
 }  }
   
   static void
   post_rs(POST_ARGS)
   {
           struct roff_node *np, *nch, *next, *prev;
           int               i, j;
   
 static int          np = mdoc->last;
 post_st(POST_ARGS)  
           if (np->type != ROFFT_BODY)
                   return;
   
           if (np->child == NULL) {
                   mandoc_msg(MANDOCERR_RS_EMPTY, np->line, np->pos, "Rs");
                   return;
           }
   
           /*
            * The full `Rs' block needs special handling to order the
            * sub-elements according to `rsord'.  Pick through each element
            * and correctly order it.  This is an insertion sort.
            */
   
           next = NULL;
           for (nch = np->child->next; nch != NULL; nch = next) {
                   /* Determine order number of this child. */
                   for (i = 0; i < RSORD_MAX; i++)
                           if (rsord[i] == nch->tok)
                                   break;
   
                   if (i == RSORD_MAX) {
                           mandoc_msg(MANDOCERR_RS_BAD, nch->line, nch->pos,
                               "%s", roff_name[nch->tok]);
                           i = -1;
                   } else if (nch->tok == MDOC__J || nch->tok == MDOC__B)
                           np->norm->Rs.quote_T++;
   
                   /*
                    * Remove this child from the chain.  This somewhat
                    * repeats roff_node_unlink(), but since we're
                    * just re-ordering, there's no need for the
                    * full unlink process.
                    */
   
                   if ((next = nch->next) != NULL)
                           next->prev = nch->prev;
   
                   if ((prev = nch->prev) != NULL)
                           prev->next = nch->next;
   
                   nch->prev = nch->next = NULL;
   
                   /*
                    * Scan back until we reach a node that's
                    * to be ordered before this child.
                    */
   
                   for ( ; prev ; prev = prev->prev) {
                           /* Determine order of `prev'. */
                           for (j = 0; j < RSORD_MAX; j++)
                                   if (rsord[j] == prev->tok)
                                           break;
                           if (j == RSORD_MAX)
                                   j = -1;
   
                           if (j <= i)
                                   break;
                   }
   
                   /*
                    * Set this child back into its correct place
                    * in front of the `prev' node.
                    */
   
                   nch->prev = prev;
   
                   if (prev == NULL) {
                           np->child->prev = nch;
                           nch->next = np->child;
                           np->child = nch;
                   } else {
                           if (prev->next)
                                   prev->next->prev = nch;
                           nch->next = prev->next;
                           prev->next = nch;
                   }
           }
   }
   
   /*
    * For some arguments of some macros,
    * convert all breakable hyphens into ASCII_HYPH.
    */
   static void
   post_hyph(POST_ARGS)
 {  {
           struct roff_node        *n, *nch;
           char                    *cp;
   
         if (mdoc_a2st(mdoc->last->child->string))          n = mdoc->last;
                 return(1);          for (nch = n->child; nch != NULL; nch = nch->next) {
         return(mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_BADSTANDARD));                  if (nch->type != ROFFT_TEXT)
                           continue;
                   cp = nch->string;
                   if (*cp == '\0')
                           continue;
                   while (*(++cp) != '\0')
                           if (*cp == '-' &&
                               isalpha((unsigned char)cp[-1]) &&
                               isalpha((unsigned char)cp[1])) {
                                   if (n->tag == NULL && n->flags & NODE_ID)
                                           n->tag = mandoc_strdup(nch->string);
                                   *cp = ASCII_HYPH;
                           }
           }
 }  }
   
   static void
   post_ns(POST_ARGS)
   {
           struct roff_node        *n;
   
 static int          n = mdoc->last;
 post_rs(POST_ARGS)          if (n->flags & NODE_LINE ||
               (n->next != NULL && n->next->flags & NODE_DELIMC))
                   mandoc_msg(MANDOCERR_NS_SKIP, n->line, n->pos, NULL);
   }
   
   static void
   post_sx(POST_ARGS)
 {  {
         struct mdoc_node        *nn;          post_delim(mdoc);
           post_hyph(mdoc);
   }
   
         if (MDOC_BODY != mdoc->last->type)  static void
                 return(1);  post_sh(POST_ARGS)
   {
           post_section(mdoc);
   
         for (nn = mdoc->last->child; nn; nn = nn->next)          switch (mdoc->last->type) {
                 switch (nn->tok) {          case ROFFT_HEAD:
                 case(MDOC__U):                  post_sh_head(mdoc);
                         /* FALLTHROUGH */                  break;
                 case(MDOC__Q):          case ROFFT_BODY:
                         /* FALLTHROUGH */                  switch (mdoc->lastsec)  {
                 case(MDOC__C):                  case SEC_NAME:
                         /* FALLTHROUGH */                          post_sh_name(mdoc);
                 case(MDOC__A):  
                         /* FALLTHROUGH */  
                 case(MDOC__B):  
                         /* FALLTHROUGH */  
                 case(MDOC__D):  
                         /* FALLTHROUGH */  
                 case(MDOC__I):  
                         /* FALLTHROUGH */  
                 case(MDOC__J):  
                         /* FALLTHROUGH */  
                 case(MDOC__N):  
                         /* FALLTHROUGH */  
                 case(MDOC__O):  
                         /* FALLTHROUGH */  
                 case(MDOC__P):  
                         /* FALLTHROUGH */  
                 case(MDOC__R):  
                         /* FALLTHROUGH */  
                 case(MDOC__T):  
                         /* FALLTHROUGH */  
                 case(MDOC__V):  
                         break;                          break;
                   case SEC_SEE_ALSO:
                           post_sh_see_also(mdoc);
                           break;
                   case SEC_AUTHORS:
                           post_sh_authors(mdoc);
                           break;
                 default:                  default:
                         mdoc_nmsg(mdoc, nn, MANDOCERR_SYNTCHILD);                          break;
                         return(0);  
                 }                  }
                   break;
         return(1);          default:
                   break;
           }
 }  }
   
   static void
 static int  post_sh_name(POST_ARGS)
 post_sh(POST_ARGS)  
 {  {
           struct roff_node *n;
           int hasnm, hasnd;
   
         if (MDOC_HEAD == mdoc->last->type)          hasnm = hasnd = 0;
                 return(post_sh_head(mdoc));  
         if (MDOC_BODY == mdoc->last->type)  
                 return(post_sh_body(mdoc));  
   
         return(1);          for (n = mdoc->last->child; n != NULL; n = n->next) {
                   switch (n->tok) {
                   case MDOC_Nm:
                           if (hasnm && n->child != NULL)
                                   mandoc_msg(MANDOCERR_NAMESEC_PUNCT,
                                       n->line, n->pos,
                                       "Nm %s", n->child->string);
                           hasnm = 1;
                           continue;
                   case MDOC_Nd:
                           hasnd = 1;
                           if (n->next != NULL)
                                   mandoc_msg(MANDOCERR_NAMESEC_ND,
                                       n->line, n->pos, NULL);
                           break;
                   case TOKEN_NONE:
                           if (n->type == ROFFT_TEXT &&
                               n->string[0] == ',' && n->string[1] == '\0' &&
                               n->next != NULL && n->next->tok == MDOC_Nm) {
                                   n = n->next;
                                   continue;
                           }
                           /* FALLTHROUGH */
                   default:
                           mandoc_msg(MANDOCERR_NAMESEC_BAD,
                               n->line, n->pos, "%s", roff_name[n->tok]);
                           continue;
                   }
                   break;
           }
   
           if ( ! hasnm)
                   mandoc_msg(MANDOCERR_NAMESEC_NONM,
                       mdoc->last->line, mdoc->last->pos, NULL);
           if ( ! hasnd)
                   mandoc_msg(MANDOCERR_NAMESEC_NOND,
                       mdoc->last->line, mdoc->last->pos, NULL);
 }  }
   
   static void
 static int  post_sh_see_also(POST_ARGS)
 post_sh_body(POST_ARGS)  
 {  {
         struct mdoc_node *n;          const struct roff_node  *n;
           const char              *name, *sec;
           const char              *lastname, *lastsec, *lastpunct;
           int                      cmp;
   
         if (SEC_NAME != mdoc->lastsec)          n = mdoc->last->child;
                 return(1);          lastname = lastsec = lastpunct = NULL;
           while (n != NULL) {
                   if (n->tok != MDOC_Xr ||
                       n->child == NULL ||
                       n->child->next == NULL)
                           break;
   
         /*                  /* Process one .Xr node. */
          * Warn if the NAME section doesn't contain the `Nm' and `Nd'  
          * macros (can have multiple `Nm' and one `Nd').  Note that the  
          * children of the BODY declaration can also be "text".  
          */  
   
         if (NULL == (n = mdoc->last->child))                  name = n->child->string;
                 return(mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_BADNAMESEC));                  sec = n->child->next->string;
                   if (lastsec != NULL) {
                           if (lastpunct[0] != ',' || lastpunct[1] != '\0')
                                   mandoc_msg(MANDOCERR_XR_PUNCT, n->line,
                                       n->pos, "%s before %s(%s)",
                                       lastpunct, name, sec);
                           cmp = strcmp(lastsec, sec);
                           if (cmp > 0)
                                   mandoc_msg(MANDOCERR_XR_ORDER, n->line,
                                       n->pos, "%s(%s) after %s(%s)",
                                       name, sec, lastname, lastsec);
                           else if (cmp == 0 &&
                               strcasecmp(lastname, name) > 0)
                                   mandoc_msg(MANDOCERR_XR_ORDER, n->line,
                                       n->pos, "%s after %s", name, lastname);
                   }
                   lastname = name;
                   lastsec = sec;
   
         for ( ; n && n->next; n = n->next) {                  /* Process the following node. */
                 if (MDOC_ELEM == n->type && MDOC_Nm == n->tok)  
                   n = n->next;
                   if (n == NULL)
                           break;
                   if (n->tok == MDOC_Xr) {
                           lastpunct = "none";
                         continue;                          continue;
                 if (MDOC_TEXT == n->type)                  }
                         continue;                  if (n->type != ROFFT_TEXT)
                 if ( ! mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_BADNAMESEC))                          break;
                         return(0);                  for (name = n->string; *name != '\0'; name++)
                           if (isalpha((const unsigned char)*name))
                                   return;
                   lastpunct = n->string;
                   if (n->next == NULL || n->next->tok == MDOC_Rs)
                           mandoc_msg(MANDOCERR_XR_PUNCT, n->line,
                               n->pos, "%s after %s(%s)",
                               lastpunct, lastname, lastsec);
                   n = n->next;
         }          }
   }
   
         assert(n);  static int
         if (MDOC_BLOCK == n->type && MDOC_Nd == n->tok)  child_an(const struct roff_node *n)
                 return(1);  {
         return(mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_BADNAMESEC));  
           for (n = n->child; n != NULL; n = n->next)
                   if ((n->tok == MDOC_An && n->child != NULL) || child_an(n))
                           return 1;
           return 0;
 }  }
   
   static void
   post_sh_authors(POST_ARGS)
   {
   
           if ( ! child_an(mdoc->last))
                   mandoc_msg(MANDOCERR_AN_MISSING,
                       mdoc->last->line, mdoc->last->pos, NULL);
   }
   
   /*
    * Return an upper bound for the string distance (allowing
    * transpositions).  Not a full Levenshtein implementation
    * because Levenshtein is quadratic in the string length
    * and this function is called for every standard name,
    * so the check for each custom name would be cubic.
    * The following crude heuristics is linear, resulting
    * in quadratic behaviour for checking one custom name,
    * which does not cause measurable slowdown.
    */
 static int  static int
   similar(const char *s1, const char *s2)
   {
           const int       maxdist = 3;
           int             dist = 0;
   
           while (s1[0] != '\0' && s2[0] != '\0') {
                   if (s1[0] == s2[0]) {
                           s1++;
                           s2++;
                           continue;
                   }
                   if (++dist > maxdist)
                           return INT_MAX;
                   if (s1[1] == s2[1]) {  /* replacement */
                           s1++;
                           s2++;
                   } else if (s1[0] == s2[1] && s1[1] == s2[0]) {
                           s1 += 2;        /* transposition */
                           s2 += 2;
                   } else if (s1[0] == s2[1])  /* insertion */
                           s2++;
                   else if (s1[1] == s2[0])  /* deletion */
                           s1++;
                   else
                           return INT_MAX;
           }
           dist += strlen(s1) + strlen(s2);
           return dist > maxdist ? INT_MAX : dist;
   }
   
   static void
 post_sh_head(POST_ARGS)  post_sh_head(POST_ARGS)
 {  {
         char                    buf[BUFSIZ];          struct roff_node        *nch;
         enum mdoc_sec           sec;          const char              *goodsec;
         const struct mdoc_node *n;          const char *const       *testsec;
           int                      dist, mindist;
           enum roff_sec            sec;
   
         /*          /*
          * Process a new section.  Sections are either "named" or           * Process a new section.  Sections are either "named" or
          * "custom"; custom sections are user-defined, while named ones           * "custom".  Custom sections are user-defined, while named ones
          * usually follow a conventional order and may only appear in           * follow a conventional order and may only appear in certain
          * certain manual sections.           * manual sections.
          */           */
   
         buf[0] = '\0';          sec = mdoc->last->sec;
   
         /*          /* The NAME should be first. */
          * FIXME: yes, these can use a dynamic buffer, but I don't do so  
          * in the interests of simplicity.  
          */  
   
         for (n = mdoc->last->child; n; n = n->next) {          if (sec != SEC_NAME && mdoc->lastnamed == SEC_NONE)
                 /* XXX - copied from compact(). */                  mandoc_msg(MANDOCERR_NAMESEC_FIRST,
                 assert(MDOC_TEXT == n->type);                      mdoc->last->line, mdoc->last->pos, "Sh %s",
                       sec != SEC_CUSTOM ? secnames[sec] :
                       (nch = mdoc->last->child) == NULL ? "" :
                       nch->type == ROFFT_TEXT ? nch->string :
                       roff_name[nch->tok]);
   
                 if (strlcat(buf, n->string, BUFSIZ) >= BUFSIZ) {          /* The SYNOPSIS gets special attention in other areas. */
                         mdoc_nmsg(mdoc, n, MANDOCERR_MEM);  
                         return(0);          if (sec == SEC_SYNOPSIS) {
                 }                  roff_setreg(mdoc->roff, "nS", 1, '=');
                 if (NULL == n->next)                  mdoc->flags |= MDOC_SYNOPSIS;
                         continue;          } else {
                 if (strlcat(buf, " ", BUFSIZ) >= BUFSIZ) {                  roff_setreg(mdoc->roff, "nS", 0, '=');
                         mdoc_nmsg(mdoc, n, MANDOCERR_MEM);                  mdoc->flags &= ~MDOC_SYNOPSIS;
                         return(0);  
                 }  
         }          }
           if (sec == SEC_DESCRIPTION)
                   fn_prio = TAG_STRONG;
   
         sec = mdoc_str2sec(buf);          /* Mark our last section. */
   
         /*          mdoc->lastsec = sec;
          * Check: NAME should always be first, CUSTOM has no roles,  
          * non-CUSTOM has a conventional order to be followed.  
          */  
   
         if (SEC_NAME != sec && SEC_NONE == mdoc->lastnamed)          /* We don't care about custom sections after this. */
                 if ( ! mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_NAMESECFIRST))  
                         return(0);  
   
         if (SEC_CUSTOM == sec)          if (sec == SEC_CUSTOM) {
                 return(1);                  if ((nch = mdoc->last->child) == NULL ||
                       nch->type != ROFFT_TEXT || nch->next != NULL)
                           return;
                   goodsec = NULL;
                   mindist = INT_MAX;
                   for (testsec = secnames + 1; *testsec != NULL; testsec++) {
                           dist = similar(nch->string, *testsec);
                           if (dist < mindist) {
                                   goodsec = *testsec;
                                   mindist = dist;
                           }
                   }
                   if (goodsec != NULL)
                           mandoc_msg(MANDOCERR_SEC_TYPO, nch->line, nch->pos,
                               "Sh %s instead of %s", nch->string, goodsec);
                   return;
           }
   
           /*
            * Check whether our non-custom section is being repeated or is
            * out of order.
            */
   
         if (sec == mdoc->lastnamed)          if (sec == mdoc->lastnamed)
                 if ( ! mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_SECREP))                  mandoc_msg(MANDOCERR_SEC_REP, mdoc->last->line,
                         return(0);                      mdoc->last->pos, "Sh %s", secnames[sec]);
   
         if (sec < mdoc->lastnamed)          if (sec < mdoc->lastnamed)
                 if ( ! mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_SECOOO))                  mandoc_msg(MANDOCERR_SEC_ORDER, mdoc->last->line,
                         return(0);                      mdoc->last->pos, "Sh %s", secnames[sec]);
   
         /*          /* Mark the last named section. */
          * Check particular section/manual conventions.  LIBRARY can  
          * only occur in manual section 2, 3, and 9.  
          */  
   
           mdoc->lastnamed = sec;
   
           /* Check particular section/manual conventions. */
   
           if (mdoc->meta.msec == NULL)
                   return;
   
           goodsec = NULL;
         switch (sec) {          switch (sec) {
         case (SEC_LIBRARY):          case SEC_ERRORS:
                 assert(mdoc->meta.msec);                  if (*mdoc->meta.msec == '4')
                           break;
                   goodsec = "2, 3, 4, 9";
                   /* FALLTHROUGH */
           case SEC_RETURN_VALUES:
           case SEC_LIBRARY:
                 if (*mdoc->meta.msec == '2')                  if (*mdoc->meta.msec == '2')
                         break;                          break;
                 if (*mdoc->meta.msec == '3')                  if (*mdoc->meta.msec == '3')
                         break;                          break;
                   if (NULL == goodsec)
                           goodsec = "2, 3, 9";
                   /* FALLTHROUGH */
           case SEC_CONTEXT:
                 if (*mdoc->meta.msec == '9')                  if (*mdoc->meta.msec == '9')
                         break;                          break;
                 return(mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_SECMSEC));                  if (NULL == goodsec)
                           goodsec = "9";
                   mandoc_msg(MANDOCERR_SEC_MSEC,
                       mdoc->last->line, mdoc->last->pos,
                       "Sh %s for %s only", secnames[sec], goodsec);
                   break;
         default:          default:
                 break;                  break;
         }          }
   }
   
         return(1);  static void
   post_xr(POST_ARGS)
   {
           struct roff_node *n, *nch;
   
           n = mdoc->last;
           nch = n->child;
           if (nch->next == NULL) {
                   mandoc_msg(MANDOCERR_XR_NOSEC,
                       n->line, n->pos, "Xr %s", nch->string);
           } else {
                   assert(nch->next == n->last);
                   if(mandoc_xr_add(nch->next->string, nch->string,
                       nch->line, nch->pos))
                           mandoc_msg(MANDOCERR_XR_SELF,
                               nch->line, nch->pos, "Xr %s %s",
                               nch->string, nch->next->string);
           }
           post_delim_nb(mdoc);
   }
   
   static void
   post_section(POST_ARGS)
   {
           struct roff_node *n, *nch;
           char             *cp, *tag;
   
           n = mdoc->last;
           switch (n->type) {
           case ROFFT_BLOCK:
                   post_prevpar(mdoc);
                   return;
           case ROFFT_HEAD:
                   tag = NULL;
                   deroff(&tag, n);
                   if (tag != NULL) {
                           for (cp = tag; *cp != '\0'; cp++)
                                   if (*cp == ' ')
                                           *cp = '_';
                           if ((nch = n->child) != NULL &&
                               nch->type == ROFFT_TEXT &&
                               strcmp(nch->string, tag) == 0)
                                   tag_put(NULL, TAG_WEAK, n);
                           else
                                   tag_put(tag, TAG_FALLBACK, n);
                           free(tag);
                   }
                   post_delim(mdoc);
                   post_hyph(mdoc);
                   return;
           case ROFFT_BODY:
                   break;
           default:
                   return;
           }
           if ((nch = n->child) != NULL &&
               (nch->tok == MDOC_Pp || nch->tok == ROFF_br ||
                nch->tok == ROFF_sp)) {
                   mandoc_msg(MANDOCERR_PAR_SKIP, nch->line, nch->pos,
                       "%s after %s", roff_name[nch->tok],
                       roff_name[n->tok]);
                   roff_node_delete(mdoc, nch);
           }
           if ((nch = n->last) != NULL &&
               (nch->tok == MDOC_Pp || nch->tok == ROFF_br)) {
                   mandoc_msg(MANDOCERR_PAR_SKIP, nch->line, nch->pos,
                       "%s at the end of %s", roff_name[nch->tok],
                       roff_name[n->tok]);
                   roff_node_delete(mdoc, nch);
           }
   }
   
   static void
   post_prevpar(POST_ARGS)
   {
           struct roff_node *n, *np;
   
           n = mdoc->last;
           if (n->type != ROFFT_ELEM && n->type != ROFFT_BLOCK)
                   return;
           if ((np = roff_node_prev(n)) == NULL)
                   return;
   
           /*
            * Don't allow `Pp' prior to a paragraph-type
            * block: `Pp' or non-compact `Bd' or `Bl'.
            */
   
           if (np->tok != MDOC_Pp && np->tok != ROFF_br)
                   return;
           if (n->tok == MDOC_Bl && n->norm->Bl.comp)
                   return;
           if (n->tok == MDOC_Bd && n->norm->Bd.comp)
                   return;
           if (n->tok == MDOC_It && n->parent->norm->Bl.comp)
                   return;
   
           mandoc_msg(MANDOCERR_PAR_SKIP, np->line, np->pos,
               "%s before %s", roff_name[np->tok], roff_name[n->tok]);
           roff_node_delete(mdoc, np);
   }
   
   static void
   post_par(POST_ARGS)
   {
           struct roff_node *np;
   
           fn_prio = TAG_STRONG;
           post_prevpar(mdoc);
   
           np = mdoc->last;
           if (np->child != NULL)
                   mandoc_msg(MANDOCERR_ARG_SKIP, np->line, np->pos,
                       "%s %s", roff_name[np->tok], np->child->string);
   }
   
   static void
   post_dd(POST_ARGS)
   {
           struct roff_node *n;
   
           n = mdoc->last;
           n->flags |= NODE_NOPRT;
   
           if (mdoc->meta.date != NULL) {
                   mandoc_msg(MANDOCERR_PROLOG_REP, n->line, n->pos, "Dd");
                   free(mdoc->meta.date);
           } else if (mdoc->flags & MDOC_PBODY)
                   mandoc_msg(MANDOCERR_PROLOG_LATE, n->line, n->pos, "Dd");
           else if (mdoc->meta.title != NULL)
                   mandoc_msg(MANDOCERR_PROLOG_ORDER,
                       n->line, n->pos, "Dd after Dt");
           else if (mdoc->meta.os != NULL)
                   mandoc_msg(MANDOCERR_PROLOG_ORDER,
                       n->line, n->pos, "Dd after Os");
   
           if (mdoc->quick && n != NULL)
                   mdoc->meta.date = mandoc_strdup("");
           else
                   mdoc->meta.date = mandoc_normdate(n->child, n);
   }
   
   static void
   post_dt(POST_ARGS)
   {
           struct roff_node *nn, *n;
           const char       *cp;
           char             *p;
   
           n = mdoc->last;
           n->flags |= NODE_NOPRT;
   
           if (mdoc->flags & MDOC_PBODY) {
                   mandoc_msg(MANDOCERR_DT_LATE, n->line, n->pos, "Dt");
                   return;
           }
   
           if (mdoc->meta.title != NULL)
                   mandoc_msg(MANDOCERR_PROLOG_REP, n->line, n->pos, "Dt");
           else if (mdoc->meta.os != NULL)
                   mandoc_msg(MANDOCERR_PROLOG_ORDER,
                       n->line, n->pos, "Dt after Os");
   
           free(mdoc->meta.title);
           free(mdoc->meta.msec);
           free(mdoc->meta.vol);
           free(mdoc->meta.arch);
   
           mdoc->meta.title = NULL;
           mdoc->meta.msec = NULL;
           mdoc->meta.vol = NULL;
           mdoc->meta.arch = NULL;
   
           /* Mandatory first argument: title. */
   
           nn = n->child;
           if (nn == NULL || *nn->string == '\0') {
                   mandoc_msg(MANDOCERR_DT_NOTITLE, n->line, n->pos, "Dt");
                   mdoc->meta.title = mandoc_strdup("UNTITLED");
           } else {
                   mdoc->meta.title = mandoc_strdup(nn->string);
   
                   /* Check that all characters are uppercase. */
   
                   for (p = nn->string; *p != '\0'; p++)
                           if (islower((unsigned char)*p)) {
                                   mandoc_msg(MANDOCERR_TITLE_CASE, nn->line,
                                       nn->pos + (int)(p - nn->string),
                                       "Dt %s", nn->string);
                                   break;
                           }
           }
   
           /* Mandatory second argument: section. */
   
           if (nn != NULL)
                   nn = nn->next;
   
           if (nn == NULL) {
                   mandoc_msg(MANDOCERR_MSEC_MISSING, n->line, n->pos,
                       "Dt %s", mdoc->meta.title);
                   mdoc->meta.vol = mandoc_strdup("LOCAL");
                   return;  /* msec and arch remain NULL. */
           }
   
           mdoc->meta.msec = mandoc_strdup(nn->string);
   
           /* Infer volume title from section number. */
   
           cp = mandoc_a2msec(nn->string);
           if (cp == NULL) {
                   mandoc_msg(MANDOCERR_MSEC_BAD,
                       nn->line, nn->pos, "Dt ... %s", nn->string);
                   mdoc->meta.vol = mandoc_strdup(nn->string);
           } else {
                   mdoc->meta.vol = mandoc_strdup(cp);
                   if (mdoc->filesec != '\0' &&
                       mdoc->filesec != *nn->string &&
                       *nn->string >= '1' && *nn->string <= '9')
                           mandoc_msg(MANDOCERR_MSEC_FILE, nn->line, nn->pos,
                               "*.%c vs Dt ... %c", mdoc->filesec, *nn->string);
           }
   
           /* Optional third argument: architecture. */
   
           if ((nn = nn->next) == NULL)
                   return;
   
           for (p = nn->string; *p != '\0'; p++)
                   *p = tolower((unsigned char)*p);
           mdoc->meta.arch = mandoc_strdup(nn->string);
   
           /* Ignore fourth and later arguments. */
   
           if ((nn = nn->next) != NULL)
                   mandoc_msg(MANDOCERR_ARG_EXCESS,
                       nn->line, nn->pos, "Dt ... %s", nn->string);
   }
   
   static void
   post_bx(POST_ARGS)
   {
           struct roff_node        *n, *nch;
           const char              *macro;
   
           post_delim_nb(mdoc);
   
           n = mdoc->last;
           nch = n->child;
   
           if (nch != NULL) {
                   macro = !strcmp(nch->string, "Open") ? "Ox" :
                       !strcmp(nch->string, "Net") ? "Nx" :
                       !strcmp(nch->string, "Free") ? "Fx" :
                       !strcmp(nch->string, "DragonFly") ? "Dx" : NULL;
                   if (macro != NULL)
                           mandoc_msg(MANDOCERR_BX,
                               n->line, n->pos, "%s", macro);
                   mdoc->last = nch;
                   nch = nch->next;
                   mdoc->next = ROFF_NEXT_SIBLING;
                   roff_elem_alloc(mdoc, n->line, n->pos, MDOC_Ns);
                   mdoc->last->flags |= NODE_NOSRC;
                   mdoc->next = ROFF_NEXT_SIBLING;
           } else
                   mdoc->next = ROFF_NEXT_CHILD;
           roff_word_alloc(mdoc, n->line, n->pos, "BSD");
           mdoc->last->flags |= NODE_NOSRC;
   
           if (nch == NULL) {
                   mdoc->last = n;
                   return;
           }
   
           roff_elem_alloc(mdoc, n->line, n->pos, MDOC_Ns);
           mdoc->last->flags |= NODE_NOSRC;
           mdoc->next = ROFF_NEXT_SIBLING;
           roff_word_alloc(mdoc, n->line, n->pos, "-");
           mdoc->last->flags |= NODE_NOSRC;
           roff_elem_alloc(mdoc, n->line, n->pos, MDOC_Ns);
           mdoc->last->flags |= NODE_NOSRC;
           mdoc->last = n;
   
           /*
            * Make `Bx's second argument always start with an uppercase
            * letter.  Groff checks if it's an "accepted" term, but we just
            * uppercase blindly.
            */
   
           *nch->string = (char)toupper((unsigned char)*nch->string);
   }
   
   static void
   post_os(POST_ARGS)
   {
   #ifndef OSNAME
           struct utsname    utsname;
           static char      *defbuf;
   #endif
           struct roff_node *n;
   
           n = mdoc->last;
           n->flags |= NODE_NOPRT;
   
           if (mdoc->meta.os != NULL)
                   mandoc_msg(MANDOCERR_PROLOG_REP, n->line, n->pos, "Os");
           else if (mdoc->flags & MDOC_PBODY)
                   mandoc_msg(MANDOCERR_PROLOG_LATE, n->line, n->pos, "Os");
   
           post_delim(mdoc);
   
           /*
            * Set the operating system by way of the `Os' macro.
            * The order of precedence is:
            * 1. the argument of the `Os' macro, unless empty
            * 2. the -Ios=foo command line argument, if provided
            * 3. -DOSNAME="\"foo\"", if provided during compilation
            * 4. "sysname release" from uname(3)
            */
   
           free(mdoc->meta.os);
           mdoc->meta.os = NULL;
           deroff(&mdoc->meta.os, n);
           if (mdoc->meta.os)
                   goto out;
   
           if (mdoc->os_s != NULL) {
                   mdoc->meta.os = mandoc_strdup(mdoc->os_s);
                   goto out;
           }
   
   #ifdef OSNAME
           mdoc->meta.os = mandoc_strdup(OSNAME);
   #else /*!OSNAME */
           if (defbuf == NULL) {
                   if (uname(&utsname) == -1) {
                           mandoc_msg(MANDOCERR_OS_UNAME, n->line, n->pos, "Os");
                           defbuf = mandoc_strdup("UNKNOWN");
                   } else
                           mandoc_asprintf(&defbuf, "%s %s",
                               utsname.sysname, utsname.release);
           }
           mdoc->meta.os = mandoc_strdup(defbuf);
   #endif /*!OSNAME*/
   
   out:
           if (mdoc->meta.os_e == MANDOC_OS_OTHER) {
                   if (strstr(mdoc->meta.os, "OpenBSD") != NULL)
                           mdoc->meta.os_e = MANDOC_OS_OPENBSD;
                   else if (strstr(mdoc->meta.os, "NetBSD") != NULL)
                           mdoc->meta.os_e = MANDOC_OS_NETBSD;
           }
   
           /*
            * This is the earliest point where we can check
            * Mdocdate conventions because we don't know
            * the operating system earlier.
            */
   
           if (n->child != NULL)
                   mandoc_msg(MANDOCERR_OS_ARG, n->child->line, n->child->pos,
                       "Os %s (%s)", n->child->string,
                       mdoc->meta.os_e == MANDOC_OS_OPENBSD ?
                       "OpenBSD" : "NetBSD");
   
           while (n->tok != MDOC_Dd)
                   if ((n = n->prev) == NULL)
                           return;
           if ((n = n->child) == NULL)
                   return;
           if (strncmp(n->string, "$" "Mdocdate", 9)) {
                   if (mdoc->meta.os_e == MANDOC_OS_OPENBSD)
                           mandoc_msg(MANDOCERR_MDOCDATE_MISSING, n->line,
                               n->pos, "Dd %s (OpenBSD)", n->string);
           } else {
                   if (mdoc->meta.os_e == MANDOC_OS_NETBSD)
                           mandoc_msg(MANDOCERR_MDOCDATE, n->line,
                               n->pos, "Dd %s (NetBSD)", n->string);
           }
   }
   
   enum roff_sec
   mdoc_a2sec(const char *p)
   {
           int              i;
   
           for (i = 0; i < (int)SEC__MAX; i++)
                   if (secnames[i] && 0 == strcmp(p, secnames[i]))
                           return (enum roff_sec)i;
   
           return SEC_CUSTOM;
   }
   
   static size_t
   macro2len(enum roff_tok macro)
   {
   
           switch (macro) {
           case MDOC_Ad:
                   return 12;
           case MDOC_Ao:
                   return 12;
           case MDOC_An:
                   return 12;
           case MDOC_Aq:
                   return 12;
           case MDOC_Ar:
                   return 12;
           case MDOC_Bo:
                   return 12;
           case MDOC_Bq:
                   return 12;
           case MDOC_Cd:
                   return 12;
           case MDOC_Cm:
                   return 10;
           case MDOC_Do:
                   return 10;
           case MDOC_Dq:
                   return 12;
           case MDOC_Dv:
                   return 12;
           case MDOC_Eo:
                   return 12;
           case MDOC_Em:
                   return 10;
           case MDOC_Er:
                   return 17;
           case MDOC_Ev:
                   return 15;
           case MDOC_Fa:
                   return 12;
           case MDOC_Fl:
                   return 10;
           case MDOC_Fo:
                   return 16;
           case MDOC_Fn:
                   return 16;
           case MDOC_Ic:
                   return 10;
           case MDOC_Li:
                   return 16;
           case MDOC_Ms:
                   return 6;
           case MDOC_Nm:
                   return 10;
           case MDOC_No:
                   return 12;
           case MDOC_Oo:
                   return 10;
           case MDOC_Op:
                   return 14;
           case MDOC_Pa:
                   return 32;
           case MDOC_Pf:
                   return 12;
           case MDOC_Po:
                   return 12;
           case MDOC_Pq:
                   return 12;
           case MDOC_Ql:
                   return 16;
           case MDOC_Qo:
                   return 12;
           case MDOC_So:
                   return 12;
           case MDOC_Sq:
                   return 12;
           case MDOC_Sy:
                   return 6;
           case MDOC_Sx:
                   return 16;
           case MDOC_Tn:
                   return 10;
           case MDOC_Va:
                   return 12;
           case MDOC_Vt:
                   return 12;
           case MDOC_Xr:
                   return 10;
           default:
                   break;
           };
           return 0;
 }  }

Legend:
Removed from v.1.87  
changed lines
  Added in v.1.386

CVSweb