[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.7 and 1.248

version 1.7, 2009/06/10 20:18:43 version 1.248, 2014/09/11 23:53:30
Line 1 
Line 1 
 /*      $Id$ */  /*      $Id$ */
 /*  /*
  * Copyright (c) 2008, 2009 Kristaps Dzonsons <kristaps@kth.se>   * Copyright (c) 2008-2012 Kristaps Dzonsons <kristaps@bsd.lv>
    * Copyright (c) 2010-2014 Ingo Schwarze <schwarze@openbsd.org>
    * 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
Line 14 
Line 16 
  * 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.
  */   */
   #include "config.h"
   
 #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>
 #include <stdarg.h>  #include <limits.h>
   #include <stdio.h>
 #include <stdlib.h>  #include <stdlib.h>
 #include <string.h>  #include <string.h>
   #include <time.h>
   
   #include "mdoc.h"
   #include "mandoc.h"
   #include "mandoc_aux.h"
 #include "libmdoc.h"  #include "libmdoc.h"
   #include "libmandoc.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 PRE_ARGS  struct mdoc *mdoc, struct mdoc_node *n
 #define POST_ARGS       struct mdoc *mdoc  #define POST_ARGS struct mdoc *mdoc
   
 enum    merr {  enum    check_ineq {
         ETOOLONG,          CHECK_LT,
         EESCAPE,          CHECK_GT,
         EPRINT,          CHECK_EQ
         ENODATA,  
         ENOPROLOGUE,  
         ELINE,  
         EATT,  
         ENAME,  
         ELISTTYPE,  
         EDISPTYPE,  
         EMULTIDISP,  
         EMULTILIST,  
         EARGREP,  
         EBOOL,  
         ENESTDISP  
 };  };
   
 enum    mwarn {  enum    check_lvl {
         WPRINT,          CHECK_WARN,
         WESCAPE,          CHECK_ERROR,
         WWRONGMSEC,  
         WSECOOO,  
         WSECREP,  
         WBADSTAND,  
         WNAMESECINC,  
         WNOMULTILINE,  
         WMULTILINE,  
         WLINE,  
         WNOLINE,  
         WPROLOOO,  
         WPROLREP,  
         WARGVAL,  
         WBADSEC,  
         WBADMSEC  
 };  };
   
 typedef int     (*v_pre)(PRE_ARGS);  typedef int     (*v_pre)(PRE_ARGS);
 typedef int     (*v_post)(POST_ARGS);  typedef int     (*v_post)(POST_ARGS);
   
 struct  valids {  struct  valids {
         v_pre   *pre;          v_pre    pre;
         v_post  *post;          v_post   post;
 };  };
   
 static  int     pwarn(struct mdoc *, int, int, enum mwarn);  static  int      check_count(struct mdoc *, enum mdoc_type,
 static  int     perr(struct mdoc *, int, int, enum merr);                          enum check_lvl, enum check_ineq, int);
 static  int     check_parent(PRE_ARGS, int, enum mdoc_type);  static  void     check_text(struct mdoc *, int, int, char *);
 static  int     check_msec(PRE_ARGS, ...);  static  void     check_argv(struct mdoc *,
 static  int     check_sec(PRE_ARGS, ...);                          struct mdoc_node *, struct mdoc_argv *);
 static  int     check_stdarg(PRE_ARGS);  static  void     check_args(struct mdoc *, struct mdoc_node *);
 static  int     check_text(struct mdoc *, int, int, const char *);  static  int      child_an(const struct mdoc_node *);
 static  int     check_argv(struct mdoc *,  static  enum mdoc_sec   a2sec(const char *);
                         const struct mdoc_node *,  static  size_t          macro2len(enum mdoct);
                         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     count_child(struct mdoc *);  
 static  int     warn_print(struct mdoc *, int, 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     pre_an(PRE_ARGS);  
 static  int     pre_bd(PRE_ARGS);  
 static  int     pre_bl(PRE_ARGS);  
 static  int     pre_cd(PRE_ARGS);  
 static  int     pre_dd(PRE_ARGS);  
 static  int     pre_display(PRE_ARGS);  
 static  int     pre_dt(PRE_ARGS);  
 static  int     pre_er(PRE_ARGS);  
 static  int     pre_ex(PRE_ARGS);  
 static  int     pre_fd(PRE_ARGS);  
 static  int     pre_it(PRE_ARGS);  
 static  int     pre_lb(PRE_ARGS);  
 static  int     pre_os(PRE_ARGS);  
 static  int     pre_prologue(PRE_ARGS);  
 static  int     pre_rv(PRE_ARGS);  
 static  int     pre_sh(PRE_ARGS);  
 static  int     pre_ss(PRE_ARGS);  
 static  int     herr_ge1(POST_ARGS);  
 static  int     hwarn_le1(POST_ARGS);  
 static  int     herr_eq0(POST_ARGS);  
 static  int     eerr_eq0(POST_ARGS);  
 static  int     eerr_le2(POST_ARGS);  
 static  int     eerr_eq1(POST_ARGS);  
 static  int     eerr_ge1(POST_ARGS);  
 static  int     ewarn_eq0(POST_ARGS);  
 static  int     ewarn_eq1(POST_ARGS);  
 static  int     bwarn_ge1(POST_ARGS);  
 static  int     hwarn_eq1(POST_ARGS);  
 static  int     ewarn_ge1(POST_ARGS);  
 static  int     ebool(POST_ARGS);  
 static  int     post_an(POST_ARGS);  
 static  int     post_args(POST_ARGS);  
 static  int     post_at(POST_ARGS);  
 static  int     post_bf(POST_ARGS);  
 static  int     post_bl(POST_ARGS);  
 static  int     post_it(POST_ARGS);  
 static  int     post_nm(POST_ARGS);  
 static  int     post_root(POST_ARGS);  
 static  int     post_sh(POST_ARGS);  
 static  int     post_sh_body(POST_ARGS);  
 static  int     post_sh_head(POST_ARGS);  
 static  int     post_st(POST_ARGS);  
   
 #define vwarn(m, t) nwarn((m), (m)->last, (t))  static  int      ebool(POST_ARGS);
 #define verr(m, t) nerr((m), (m)->last, (t))  static  int      berr_ge1(POST_ARGS);
 #define nwarn(m, n, t) pwarn((m), (n)->line, (n)->pos, (t))  static  int      bwarn_ge1(POST_ARGS);
 #define nerr(m, n, t) perr((m), (n)->line, (n)->pos, (t))  static  int      ewarn_eq0(POST_ARGS);
   static  int      ewarn_eq1(POST_ARGS);
   static  int      ewarn_ge1(POST_ARGS);
   static  int      ewarn_le1(POST_ARGS);
   static  int      hwarn_eq0(POST_ARGS);
   static  int      hwarn_eq1(POST_ARGS);
   static  int      hwarn_ge1(POST_ARGS);
   
 static  v_pre   pres_an[] = { pre_an, NULL };  static  int      post_an(POST_ARGS);
 static  v_pre   pres_bd[] = { pre_display, pre_bd, NULL };  static  int      post_at(POST_ARGS);
 static  v_pre   pres_bl[] = { pre_bl, NULL };  static  int      post_bf(POST_ARGS);
 static  v_pre   pres_cd[] = { pre_cd, NULL };  static  int      post_bk(POST_ARGS);
 static  v_pre   pres_dd[] = { pre_prologue, pre_dd, NULL };  static  int      post_bl(POST_ARGS);
 static  v_pre   pres_d1[] = { pre_display, NULL };  static  int      post_bl_block(POST_ARGS);
 static  v_pre   pres_dt[] = { pre_prologue, pre_dt, NULL };  static  int      post_bl_block_width(POST_ARGS);
 static  v_pre   pres_er[] = { pre_er, NULL };  static  int      post_bl_block_tag(POST_ARGS);
 static  v_pre   pres_ex[] = { pre_ex, NULL };  static  int      post_bl_head(POST_ARGS);
 static  v_pre   pres_fd[] = { pre_fd, NULL };  static  int      post_bx(POST_ARGS);
 static  v_pre   pres_it[] = { pre_it, NULL };  static  int      post_d1(POST_ARGS);
 static  v_pre   pres_lb[] = { pre_lb, NULL };  static  int      post_defaults(POST_ARGS);
 static  v_pre   pres_os[] = { pre_prologue, pre_os, NULL };  static  int      post_dd(POST_ARGS);
 static  v_pre   pres_rv[] = { pre_rv, NULL };  static  int      post_dt(POST_ARGS);
 static  v_pre   pres_sh[] = { pre_sh, NULL };  static  int      post_en(POST_ARGS);
 static  v_pre   pres_ss[] = { pre_ss, NULL };  static  int      post_es(POST_ARGS);
 static  v_post  posts_bool[] = { eerr_eq1, ebool, NULL };  static  int      post_eoln(POST_ARGS);
 static  v_post  posts_bd[] = { herr_eq0, bwarn_ge1, NULL };  static  int      post_ex(POST_ARGS);
 static  v_post  posts_text[] = { eerr_ge1, NULL };  static  int      post_fo(POST_ARGS);
 static  v_post  posts_wtext[] = { ewarn_ge1, NULL };  static  int      post_hyph(POST_ARGS);
 static  v_post  posts_notext[] = { eerr_eq0, NULL };  static  int      post_hyphtext(POST_ARGS);
 static  v_post  posts_wline[] = { bwarn_ge1, herr_eq0, NULL };  static  int      post_ignpar(POST_ARGS);
 static  v_post  posts_sh[] = { herr_ge1, bwarn_ge1, post_sh, NULL };  static  int      post_it(POST_ARGS);
 static  v_post  posts_bl[] = { herr_eq0, bwarn_ge1, post_bl, NULL };  static  int      post_lb(POST_ARGS);
 static  v_post  posts_it[] = { post_it, NULL };  static  int      post_literal(POST_ARGS);
 static  v_post  posts_in[] = { ewarn_eq1, NULL };  static  int      post_nd(POST_ARGS);
 static  v_post  posts_ss[] = { herr_ge1, NULL };  static  int      post_nm(POST_ARGS);
 static  v_post  posts_pf[] = { eerr_eq1, NULL };  static  int      post_ns(POST_ARGS);
 static  v_post  posts_lb[] = { eerr_eq1, NULL };  static  int      post_os(POST_ARGS);
 static  v_post  posts_st[] = { eerr_eq1, post_st, NULL };  static  int      post_par(POST_ARGS);
 static  v_post  posts_pp[] = { ewarn_eq0, NULL };  static  int      post_root(POST_ARGS);
 static  v_post  posts_ex[] = { eerr_eq0, post_args, NULL };  static  int      post_rs(POST_ARGS);
 static  v_post  posts_rv[] = { eerr_eq0, post_args, NULL };  static  int      post_sh(POST_ARGS);
 static  v_post  posts_an[] = { post_an, NULL };  static  int      post_sh_head(POST_ARGS);
 static  v_post  posts_at[] = { post_at, NULL };  static  int      post_sh_name(POST_ARGS);
 static  v_post  posts_xr[] = { eerr_ge1, eerr_le2, NULL };  static  int      post_sh_see_also(POST_ARGS);
 static  v_post  posts_nm[] = { post_nm, NULL };  static  int      post_sh_authors(POST_ARGS);
 static  v_post  posts_bf[] = { hwarn_le1, post_bf, NULL };  static  int      post_st(POST_ARGS);
 static  v_post  posts_fo[] = { hwarn_eq1, bwarn_ge1, NULL };  static  int      post_vt(POST_ARGS);
   static  int      pre_an(PRE_ARGS);
   static  int      pre_bd(PRE_ARGS);
   static  int      pre_bl(PRE_ARGS);
   static  int      pre_dd(PRE_ARGS);
   static  int      pre_display(PRE_ARGS);
   static  int      pre_dt(PRE_ARGS);
   static  int      pre_literal(PRE_ARGS);
   static  int      pre_obsolete(PRE_ARGS);
   static  int      pre_os(PRE_ARGS);
   static  int      pre_par(PRE_ARGS);
   static  int      pre_std(PRE_ARGS);
   
 const   struct valids mdoc_valids[MDOC_MAX] = {  static  const struct valids mdoc_valids[MDOC_MAX] = {
         { NULL, NULL },                         /* \" */          { NULL, NULL },                         /* Ap */
         { pres_dd, posts_text },                /* Dd */          { pre_dd, post_dd },                    /* Dd */
         { pres_dt, NULL },                      /* Dt */          { pre_dt, post_dt },                    /* Dt */
         { pres_os, NULL },                      /* Os */          { pre_os, post_os },                    /* Os */
         { pres_sh, posts_sh },                  /* Sh */          { NULL, post_sh },                      /* Sh */
         { pres_ss, posts_ss },                  /* Ss */          { NULL, post_ignpar },                  /* Ss */
         { NULL, posts_pp },                     /* Pp */          { pre_par, post_par },                  /* Pp */
         { pres_d1, posts_wline },               /* D1 */          { pre_display, post_d1 },               /* D1 */
         { pres_d1, posts_wline },               /* Dl */          { pre_literal, post_literal },          /* Dl */
         { pres_bd, posts_bd },                  /* Bd */          { pre_bd, post_literal },               /* Bd */
         { NULL, NULL },                         /* Ed */          { NULL, NULL },                         /* Ed */
         { pres_bl, posts_bl },                  /* Bl */          { pre_bl, post_bl },                    /* Bl */
         { NULL, NULL },                         /* El */          { NULL, NULL },                         /* El */
         { pres_it, posts_it },                  /* It */          { pre_par, post_it },                   /* It */
         { NULL, posts_text },                   /* Ad */          { NULL, NULL },                         /* Ad */
         { pres_an, posts_an },                  /* An */          { pre_an, post_an },                    /* An */
         { NULL, NULL },                         /* Ar */          { NULL, post_defaults },                /* Ar */
         { pres_cd, posts_text },                /* Cd */          { NULL, NULL },                         /* Cd */
         { NULL, NULL },                         /* Cm */          { NULL, NULL },                         /* Cm */
         { NULL, NULL },                         /* Dv */          { NULL, NULL },                         /* Dv */
         { pres_er, posts_text },                /* Er */          { NULL, NULL },                         /* Er */
         { NULL, NULL },                         /* Ev */          { NULL, NULL },                         /* Ev */
         { pres_ex, posts_ex },                  /* Ex */          { pre_std, post_ex },                   /* Ex */
         { NULL, NULL },                         /* Fa */          { NULL, NULL },                         /* Fa */
         { pres_fd, posts_wtext },               /* Fd */          { NULL, ewarn_ge1 },                    /* Fd */
         { NULL, NULL },                         /* Fl */          { NULL, NULL },                         /* Fl */
         { NULL, posts_text },                   /* Fn */          { NULL, NULL },                         /* Fn */
         { NULL, posts_wtext },                  /* Ft */          { NULL, NULL },                         /* Ft */
         { NULL, posts_text },                   /* Ic */          { NULL, NULL },                         /* Ic */
         { NULL, posts_in },                     /* In */          { NULL, ewarn_eq1 },                    /* In */
         { NULL, NULL },                         /* Li */          { NULL, post_defaults },                /* Li */
         { NULL, posts_wtext },                  /* Nd */          { NULL, post_nd },                      /* Nd */
         { NULL, posts_nm },                     /* Nm */          { NULL, post_nm },                      /* Nm */
         { NULL, posts_wline },                  /* Op */          { NULL, NULL },                         /* Op */
         { NULL, NULL },                         /* Ot */          { pre_obsolete, NULL },                 /* Ot */
         { NULL, NULL },                         /* Pa */          { NULL, post_defaults },                /* Pa */
         { pres_rv, posts_rv },                  /* Rv */          { pre_std, NULL },                      /* Rv */
         { NULL, posts_st },                     /* St */          { NULL, post_st },                      /* St */
         { NULL, NULL },                         /* Va */          { NULL, NULL },                         /* Va */
         { NULL, posts_text },                   /* Vt */          { NULL, post_vt },                      /* Vt */
         { NULL, posts_xr },                     /* Xr */          { NULL, ewarn_ge1 },                    /* Xr */
         { NULL, posts_text },                   /* %A */          { NULL, ewarn_ge1 },                    /* %A */
         { NULL, posts_text },                   /* %B */          { NULL, post_hyphtext },                /* %B */ /* FIXME: can be used outside Rs/Re. */
         { NULL, posts_text },                   /* %D */          { NULL, ewarn_ge1 },                    /* %D */
         { NULL, posts_text },                   /* %I */          { NULL, ewarn_ge1 },                    /* %I */
         { NULL, posts_text },                   /* %J */          { NULL, ewarn_ge1 },                    /* %J */
         { NULL, posts_text },                   /* %N */          { NULL, post_hyphtext },                /* %N */
         { NULL, posts_text },                   /* %O */          { NULL, post_hyphtext },                /* %O */
         { NULL, posts_text },                   /* %P */          { NULL, ewarn_ge1 },                    /* %P */
         { NULL, posts_text },                   /* %R */          { NULL, post_hyphtext },                /* %R */
         { NULL, posts_text },                   /* %T */          { NULL, post_hyphtext },                /* %T */ /* FIXME: can be used outside Rs/Re. */
         { NULL, posts_text },                   /* %V */          { NULL, ewarn_ge1 },                    /* %V */
         { NULL, NULL },                         /* Ac */          { NULL, NULL },                         /* Ac */
         { NULL, NULL },                         /* Ao */          { NULL, NULL },                         /* Ao */
         { NULL, posts_wline },                  /* Aq */          { NULL, NULL },                         /* Aq */
         { NULL, posts_at },                     /* At */          { NULL, post_at },                      /* At */
         { NULL, NULL },                         /* Bc */          { NULL, NULL },                         /* Bc */
         { NULL, posts_bf },                     /* Bf */          { NULL, post_bf },                      /* Bf */
         { NULL, NULL },                         /* Bo */          { NULL, NULL },                         /* Bo */
         { NULL, posts_wline },                  /* Bq */          { NULL, NULL },                         /* Bq */
         { NULL, NULL },                         /* Bsx */          { NULL, NULL },                         /* Bsx */
         { NULL, NULL },                         /* Bx */          { NULL, post_bx },                      /* Bx */
         { NULL, posts_bool },                   /* Db */          { NULL, ebool },                        /* Db */
         { NULL, NULL },                         /* Dc */          { NULL, NULL },                         /* Dc */
         { NULL, NULL },                         /* Do */          { NULL, NULL },                         /* Do */
         { NULL, posts_wline },                  /* Dq */          { NULL, NULL },                         /* Dq */
         { NULL, NULL },                         /* Ec */          { NULL, NULL },                         /* Ec */
         { NULL, NULL },                         /* Ef */          { NULL, NULL },                         /* Ef */
         { NULL, NULL },                         /* Em */          { NULL, NULL },                         /* Em */
         { NULL, NULL },                         /* Eo */          { NULL, NULL },                         /* Eo */
         { NULL, NULL },                         /* Fx */          { NULL, NULL },                         /* Fx */
         { NULL, posts_text },                   /* Ms */          { NULL, NULL },                         /* Ms */
         { NULL, posts_notext },                 /* No */          { NULL, ewarn_eq0 },                    /* No */
         { NULL, posts_notext },                 /* Ns */          { NULL, post_ns },                      /* Ns */
         { NULL, NULL },                         /* Nx */          { NULL, NULL },                         /* Nx */
         { NULL, NULL },                         /* Ox */          { NULL, NULL },                         /* Ox */
         { NULL, NULL },                         /* Pc */          { NULL, NULL },                         /* Pc */
         { NULL, posts_pf },                     /* Pf */          { NULL, ewarn_eq1 },                    /* Pf */
         { NULL, NULL },                         /* Po */          { NULL, NULL },                         /* Po */
         { NULL, posts_wline },                  /* Pq */          { NULL, NULL },                         /* Pq */
         { NULL, NULL },                         /* Qc */          { NULL, NULL },                         /* Qc */
         { NULL, posts_wline },                  /* Ql */          { NULL, NULL },                         /* Ql */
         { NULL, NULL },                         /* Qo */          { NULL, NULL },                         /* Qo */
         { NULL, posts_wline },                  /* Qq */          { NULL, NULL },                         /* Qq */
         { NULL, NULL },                         /* Re */          { NULL, NULL },                         /* Re */
         { NULL, posts_wline },                  /* Rs */          { NULL, post_rs },                      /* Rs */
         { NULL, NULL },                         /* Sc */          { NULL, NULL },                         /* Sc */
         { NULL, NULL },                         /* So */          { NULL, NULL },                         /* So */
         { NULL, posts_wline },                  /* Sq */          { NULL, NULL },                         /* Sq */
         { NULL, posts_bool },                   /* Sm */          { NULL, ebool },                        /* Sm */
         { NULL, posts_text },                   /* Sx */          { NULL, post_hyph },                    /* Sx */
         { NULL, posts_text },                   /* Sy */          { NULL, NULL },                         /* Sy */
         { NULL, posts_text },                   /* Tn */          { NULL, NULL },                         /* Tn */
         { NULL, NULL },                         /* Ux */          { NULL, NULL },                         /* Ux */
         { NULL, NULL },                         /* Xc */          { NULL, NULL },                         /* Xc */
         { NULL, NULL },                         /* Xo */          { NULL, NULL },                         /* Xo */
         { NULL, posts_fo },                     /* Fo */          { NULL, post_fo },                      /* Fo */
         { NULL, NULL },                         /* Fc */          { NULL, NULL },                         /* Fc */
         { NULL, NULL },                         /* Oo */          { NULL, NULL },                         /* Oo */
         { NULL, NULL },                         /* Oc */          { NULL, NULL },                         /* Oc */
         { NULL, posts_wline },                  /* Bk */          { NULL, post_bk },                      /* Bk */
         { NULL, NULL },                         /* Ek */          { NULL, NULL },                         /* Ek */
         { NULL, posts_notext },                 /* Bt */          { NULL, post_eoln },                    /* Bt */
         { NULL, NULL },                         /* Hf */          { NULL, NULL },                         /* Hf */
         { NULL, NULL },                         /* Fr */          { pre_obsolete, NULL },                 /* Fr */
         { NULL, posts_notext },                 /* Ud */          { NULL, post_eoln },                    /* Ud */
         { pres_lb, posts_lb },                  /* Lb */          { NULL, post_lb },                      /* Lb */
         { NULL, NULL },                         /* Ap */          { pre_par, post_par },                  /* Lp */
         { NULL, posts_pp },                     /* Lp */          { NULL, NULL },                         /* Lk */
         { NULL, posts_text },                   /* Lk */          { NULL, post_defaults },                /* Mt */
         { NULL, posts_text },                   /* Mt */          { NULL, NULL },                         /* Brq */
         { NULL, posts_wline },                  /* Brq */          { NULL, NULL },                         /* Bro */
         { NULL, NULL },                         /* Bro */          { NULL, NULL },                         /* Brc */
         { NULL, NULL },                         /* Brc */          { NULL, ewarn_ge1 },                    /* %C */
         { NULL, posts_text },                   /* %C */          { pre_obsolete, post_es },              /* Es */
         { NULL, NULL },                         /* Es */          { pre_obsolete, post_en },              /* En */
         { NULL, NULL },                         /* En */  
         { NULL, NULL },                         /* Dx */          { NULL, NULL },                         /* Dx */
         { NULL, posts_text },                   /* %Q */          { NULL, ewarn_ge1 },                    /* %Q */
           { NULL, post_par },                     /* br */
           { NULL, post_par },                     /* sp */
           { NULL, ewarn_eq1 },                    /* %U */
           { NULL, NULL },                         /* Ta */
           { NULL, NULL },                         /* ll */
 };  };
   
   #define RSORD_MAX 14 /* Number of `Rs' blocks. */
   
 #ifdef __linux__  static  const enum mdoct rsord[RSORD_MAX] = {
 extern  size_t  strlcat(char *, const char *, size_t);          MDOC__A,
 #endif          MDOC__T,
           MDOC__B,
           MDOC__I,
           MDOC__J,
           MDOC__R,
           MDOC__N,
           MDOC__V,
           MDOC__U,
           MDOC__P,
           MDOC__Q,
           MDOC__C,
           MDOC__D,
           MDOC__O
   };
   
   static  const char * const secnames[SEC__MAX] = {
           NULL,
           "NAME",
           "LIBRARY",
           "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
   };
   
   
 int  int
 mdoc_valid_pre(struct mdoc *mdoc,  mdoc_valid_pre(struct mdoc *mdoc, struct mdoc_node *n)
                 const struct mdoc_node *n)  
 {  {
         v_pre           *p;          v_pre    p;
         int              line, pos;  
         const char      *tp;  
   
         if (MDOC_TEXT == n->type) {          switch (n->type) {
                 tp = n->string;          case MDOC_TEXT:
                 line = n->line;                  check_text(mdoc, n->line, n->pos, n->string);
                 pos = n->pos;                  /* FALLTHROUGH */
                 return(check_text(mdoc, line, pos, tp));          case MDOC_TBL:
                   /* FALLTHROUGH */
           case MDOC_EQN:
                   /* FALLTHROUGH */
           case MDOC_ROOT:
                   return(1);
           default:
                   break;
         }          }
   
         if ( ! check_args(mdoc, n))          check_args(mdoc, n);
                 return(0);          p = mdoc_valids[n->tok].pre;
         if (NULL == mdoc_valids[n->tok].pre)          return(*p ? (*p)(mdoc, n) : 1);
                 return(1);  
         for (p = mdoc_valids[n->tok].pre; *p; p++)  
                 if ( ! (*p)(mdoc, n))  
                         return(0);  
         return(1);  
 }  }
   
   
 int  int
 mdoc_valid_post(struct mdoc *mdoc)  mdoc_valid_post(struct mdoc *mdoc)
 {  {
         v_post          *p;          struct mdoc_node *n;
           v_post p;
   
         /*          n = mdoc->last;
          * This check occurs after the macro's children have been filled          if (n->flags & MDOC_VALID)
          * in: postfix validation.  Since this happens when we're  
          * rewinding the scope tree, it's possible to have multiple  
          * invocations (as by design, for now), we set bit MDOC_VALID to  
          * indicate that we've validated.  
          */  
   
         if (MDOC_VALID & mdoc->last->flags)  
                 return(1);                  return(1);
         mdoc->last->flags |= MDOC_VALID;          n->flags |= MDOC_VALID;
   
         if (MDOC_TEXT == mdoc->last->type)          switch (n->type) {
           case MDOC_TEXT:
                   /* FALLTHROUGH */
           case MDOC_EQN:
                   /* FALLTHROUGH */
           case MDOC_TBL:
                 return(1);                  return(1);
         if (MDOC_ROOT == mdoc->last->type)          case MDOC_ROOT:
                 return(post_root(mdoc));                  return(post_root(mdoc));
           default:
         if (NULL == mdoc_valids[mdoc->last->tok].post)                  p = mdoc_valids[n->tok].post;
                 return(1);                  return(*p ? (*p)(mdoc) : 1);
         for (p = mdoc_valids[mdoc->last->tok].post; *p; p++)          }
                 if ( ! (*p)(mdoc))  
                         return(0);  
   
         return(1);  
 }  }
   
   
 static int  static int
 perr(struct mdoc *m, int line, int pos, enum merr type)  check_count(struct mdoc *mdoc, enum mdoc_type type,
                   enum check_lvl lvl, enum check_ineq ineq, int val)
 {  {
         char             *p;          const char      *p;
           enum mandocerr   t;
         p = NULL;  
         switch (type) {          if (mdoc->last->type != type)
         case (ETOOLONG):                  return(1);
                 p = "text argument too long";  
           switch (ineq) {
           case CHECK_LT:
                   p = "less than ";
                   if (mdoc->last->nchild < val)
                           return(1);
                 break;                  break;
         case (EESCAPE):          case CHECK_GT:
                 p = "invalid escape sequence";                  p = "more than ";
                   if (mdoc->last->nchild > val)
                           return(1);
                 break;                  break;
         case (EPRINT):          case CHECK_EQ:
                 p = "invalid character";                  p = "";
                   if (val == mdoc->last->nchild)
                           return(1);
                 break;                  break;
         case (ENESTDISP):          default:
                 p = "displays may not be nested";                  abort();
                 break;                  /* NOTREACHED */
         case (EBOOL):  
                 p = "expected boolean value";  
                 break;  
         case (EARGREP):  
                 p = "argument repeated";  
                 break;  
         case (EMULTIDISP):  
                 p = "multiple display types specified";  
                 break;  
         case (EMULTILIST):  
                 p = "multiple list types specified";  
                 break;  
         case (ELISTTYPE):  
                 p = "missing list type";  
                 break;  
         case (EDISPTYPE):  
                 p = "missing display type";  
                 break;  
         case (ELINE):  
                 p = "expected line arguments";  
                 break;  
         case (ENOPROLOGUE):  
                 p = "document has no prologue";  
                 break;  
         case (ENODATA):  
                 p = "document has no data";  
                 break;  
         case (EATT):  
                 p = "expected valid AT&T symbol";  
                 break;  
         case (ENAME):  
                 p = "default name not yet set";  
                 break;  
         }          }
         assert(p);  
         return(mdoc_perr(m, line, pos, p));          t = lvl == CHECK_WARN ? MANDOCERR_ARGCWARN : MANDOCERR_ARGCOUNT;
           mandoc_vmsg(t, mdoc->parse, mdoc->last->line,
               mdoc->last->pos, "want %s%d children (have %d)",
               p, val, mdoc->last->nchild);
           return(1);
 }  }
   
   
 static int  static int
 pwarn(struct mdoc *m, int line, int pos, enum mwarn type)  berr_ge1(POST_ARGS)
 {  {
         char             *p;  
         enum mdoc_warn    c;  
   
         c = WARN_SYNTAX;          return(check_count(mdoc, MDOC_BODY, CHECK_ERROR, CHECK_GT, 0));
         p = NULL;  
         switch (type) {  
         case (WBADMSEC):  
                 p = "inappropriate manual section";  
                 c = WARN_COMPAT;  
                 break;  
         case (WBADSEC):  
                 p = "inappropriate document section";  
                 c = WARN_COMPAT;  
                 break;  
         case (WARGVAL):  
                 p = "argument value suggested";  
                 c = WARN_COMPAT;  
                 break;  
         case (WPROLREP):  
                 p = "prologue macros repeated";  
                 c = WARN_COMPAT;  
                 break;  
         case (WPROLOOO):  
                 p = "prologue macros out-of-order";  
                 c = WARN_COMPAT;  
                 break;  
         case (WPRINT):  
                 p = "invalid character";  
                 break;  
         case (WESCAPE):  
                 p = "invalid escape sequence";  
                 break;  
         case (WNOLINE):  
                 p = "suggested no line arguments";  
                 break;  
         case (WLINE):  
                 p = "suggested line arguments";  
                 break;  
         case (WMULTILINE):  
                 p = "suggested multi-line arguments";  
                 break;  
         case (WNOMULTILINE):  
                 p = "suggested no multi-line arguments";  
                 break;  
         case (WWRONGMSEC):  
                 p = "document section in wrong manual section";  
                 c = WARN_COMPAT;  
                 break;  
         case (WSECOOO):  
                 p = "document section out of conventional order";  
                 break;  
         case (WSECREP):  
                 p = "document section repeated";  
                 break;  
         case (WBADSTAND):  
                 p = "unknown standard";  
                 break;  
         case (WNAMESECINC):  
                 p = "NAME section contents incomplete/badly-ordered";  
                 break;  
         }  
         assert(p);  
         return(mdoc_pwarn(m, line, pos, c, p));  
 }  }
   
   
 static int  static int
 warn_print(struct mdoc *m, int ln, int pos)  bwarn_ge1(POST_ARGS)
 {  {
         if (MDOC_IGN_CHARS & m->pflags)          return(check_count(mdoc, MDOC_BODY, CHECK_WARN, CHECK_GT, 0));
                 return(pwarn(m, ln, pos, WPRINT));  
         return(perr(m, ln, pos, EPRINT));  
 }  }
   
   static int
 static inline int  ewarn_eq0(POST_ARGS)
 warn_count(struct mdoc *m, const char *k,  
                 int want, const char *v, int has)  
 {  {
           return(check_count(mdoc, MDOC_ELEM, CHECK_WARN, CHECK_EQ, 0));
         return(mdoc_warn(m, WARN_SYNTAX,  
                 "suggests %s %s %d (has %d)", v, k, want, has));  
 }  }
   
   static int
 static inline int  ewarn_eq1(POST_ARGS)
 err_count(struct mdoc *m, const char *k,  
                 int want, const char *v, int has)  
 {  {
           return(check_count(mdoc, MDOC_ELEM, CHECK_WARN, CHECK_EQ, 1));
         return(mdoc_err(m,  
                 "requires %s %s %d (has %d)", v, k, want, has));  
 }  }
   
   static int
 static inline int  ewarn_ge1(POST_ARGS)
 count_child(struct mdoc *mdoc)  
 {  {
         int               i;          return(check_count(mdoc, MDOC_ELEM, CHECK_WARN, CHECK_GT, 0));
         struct mdoc_node *n;  
   
         for (i = 0, n = mdoc->last->child; n; n = n->next, i++)  
                 /* Do nothing */ ;  
   
         return(i);  
 }  }
   
   static int
 /*  ewarn_le1(POST_ARGS)
  * Build these up with macros because they're basically the same check  {
  * for different inequalities.  Yes, this could be done with functions,          return(check_count(mdoc, MDOC_ELEM, CHECK_WARN, CHECK_LT, 2));
  * but this is reasonable for now.  
  */  
   
 #define CHECK_CHILD_DEFN(lvl, name, ineq)                       \  
 static int                                                      \  
 lvl##_child_##name(struct mdoc *mdoc, const char *p, int sz)    \  
 {                                                               \  
         int i;                                                  \  
         if ((i = count_child(mdoc)) ineq sz)                    \  
                 return(1);                                      \  
         return(lvl##_count(mdoc, #ineq, sz, p, i));             \  
 }  }
   
 #define CHECK_BODY_DEFN(name, lvl, func, num)                   \  
 static int                                                      \  
 b##lvl##_##name(POST_ARGS)                                      \  
 {                                                               \  
         if (MDOC_BODY != mdoc->last->type)                      \  
                 return(1);                                      \  
         return(func(mdoc, "multi-line arguments", (num)));      \  
 }  
   
 #define CHECK_ELEM_DEFN(name, lvl, func, num)                   \  
 static int                                                      \  
 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 int                                                      \  
 h##lvl##_##name(POST_ARGS)                                      \  
 {                                                               \  
         if (MDOC_HEAD != mdoc->last->type)                      \  
                 return(1);                                      \  
         return(func(mdoc, "line arguments", (num)));            \  
 }  
   
   
 CHECK_CHILD_DEFN(warn, gt, >)                   /* warn_child_gt() */  
 CHECK_CHILD_DEFN(err, gt, >)                    /* err_child_gt() */  
 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_ELEM_DEFN(eq1, warn, warn_child_eq, 1)    /* ewarn_eq1() */  
 CHECK_ELEM_DEFN(eq0, warn, warn_child_eq, 0)    /* ewarn_eq0() */  
 CHECK_ELEM_DEFN(ge1, warn, warn_child_gt, 0)    /* ewarn_gt1() */  
 CHECK_ELEM_DEFN(eq1, err, err_child_eq, 1)      /* eerr_eq1() */  
 CHECK_ELEM_DEFN(le2, err, err_child_lt, 3)      /* eerr_le2() */  
 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() */  
   
   
 static int  static int
 check_stdarg(PRE_ARGS)  hwarn_eq0(POST_ARGS)
 {  {
           return(check_count(mdoc, MDOC_HEAD, CHECK_WARN, CHECK_EQ, 0));
         if (n->args && 1 == n->args->argc)  
                 if (MDOC_Std == n->args->argv[0].arg)  
                         return(1);  
         return(nwarn(mdoc, n, WARGVAL));  
 }  }
   
   
 static int  static int
 check_sec(PRE_ARGS, ...)  hwarn_eq1(POST_ARGS)
 {  {
         enum mdoc_sec    sec;          return(check_count(mdoc, MDOC_HEAD, CHECK_WARN, CHECK_EQ, 1));
         va_list          ap;  
   
         va_start(ap, n);  
   
         for (;;) {  
                 /* LINTED */  
                 sec = (enum mdoc_sec)va_arg(ap, int);  
                 if (SEC_CUSTOM == sec)  
                         break;  
                 if (sec != mdoc->lastsec)  
                         continue;  
                 va_end(ap);  
                 return(1);  
         }  
   
         va_end(ap);  
         return(nwarn(mdoc, n, WBADSEC));  
 }  }
   
   
 static int  static int
 check_msec(PRE_ARGS, ...)  hwarn_ge1(POST_ARGS)
 {  {
         va_list          ap;          return(check_count(mdoc, MDOC_HEAD, CHECK_WARN, CHECK_GT, 0));
         int              msec;  
   
         va_start(ap, n);  
         for (;;) {  
                 /* LINTED */  
                 if (0 == (msec = va_arg(ap, int)))  
                         break;  
                 if (msec != mdoc->meta.msec)  
                         continue;  
                 va_end(ap);  
                 return(1);  
         }  
   
         va_end(ap);  
         return(nwarn(mdoc, n, WBADMSEC));  
 }  }
   
   static void
 static int  check_args(struct mdoc *mdoc, struct mdoc_node *n)
 check_args(struct mdoc *m, const struct mdoc_node *n)  
 {  {
         int              i;          int              i;
   
         if (NULL == n->args)          if (NULL == n->args)
                 return(1);                  return;
   
         assert(n->args->argc);          assert(n->args->argc);
         for (i = 0; i < (int)n->args->argc; i++)          for (i = 0; i < (int)n->args->argc; i++)
                 if ( ! check_argv(m, n, &n->args->argv[i]))                  check_argv(mdoc, n, &n->args->argv[i]);
                         return(0);  
   
         return(1);  
 }  }
   
   static void
 static int  check_argv(struct mdoc *mdoc, struct mdoc_node *n, struct mdoc_argv *v)
 check_argv(struct mdoc *m, const struct mdoc_node *n,  
                 const struct mdoc_argv *v)  
 {  {
         int              i;          int              i;
   
         for (i = 0; i < (int)v->sz; i++)          for (i = 0; i < (int)v->sz; i++)
                 if ( ! check_text(m, v->line, v->pos, v->value[i]))                  check_text(mdoc, v->line, v->pos, v->value[i]);
                         return(0);  
   
         if (MDOC_Std == v->arg) {  
                 /* `Nm' name must be set. */  
                 if (v->sz || m->meta.name)  
                         return(1);  
                 return(nerr(m, n, ENAME));  
         }  
   
         return(1);  
 }  }
   
   static void
 static int  check_text(struct mdoc *mdoc, int ln, int pos, char *p)
 check_text(struct mdoc *mdoc, int line, int pos, const char *p)  
 {  {
         size_t           c;          char            *cp;
   
         /* FIXME: indicate deprecated escapes \*(xx and \*x. */          if (MDOC_LITERAL & mdoc->flags)
                   return;
   
         for ( ; *p; p++) {          for (cp = p; NULL != (p = strchr(p, '\t')); p++)
                 if ('\t' == *p) {                  mandoc_msg(MANDOCERR_FI_TAB, mdoc->parse,
                         if ( ! (MDOC_LITERAL & mdoc->flags))                      ln, pos + (int)(p - cp), NULL);
                                 if ( ! warn_print(mdoc, line, pos))  
                                         return(0);  
                 } else if ( ! isprint((u_char)*p))  
                         if ( ! warn_print(mdoc, line, pos))  
                                 return(0);  
   
                 if ('\\' != *p)  
                         continue;  
   
                 c = mdoc_isescape(p);  
                 if (c) {  
                         p += (int)c - 1;  
                         continue;  
                 }  
                 if ( ! (MDOC_IGN_ESCAPE & mdoc->pflags))  
                         return(perr(mdoc, line, pos, EESCAPE));  
                 if ( ! pwarn(mdoc, line, pos, WESCAPE))  
                         return(0);  
         }  
   
         return(1);  
 }  }
   
   
   
   
 static int  static int
 check_parent(PRE_ARGS, int tok, enum mdoc_type t)  
 {  
   
         assert(n->parent);  
         if ((MDOC_ROOT == t || tok == n->parent->tok) &&  
                         (t == n->parent->type))  
                 return(1);  
   
         return(mdoc_nerr(mdoc, n, "require parent %s",  
                 MDOC_ROOT == t ? "<root>" : mdoc_macronames[tok]));  
 }  
   
   
   
 static int  
 pre_display(PRE_ARGS)  pre_display(PRE_ARGS)
 {  {
         struct mdoc_node *node;          struct mdoc_node *node;
   
         /* Display elements (`Bd', `D1'...) cannot be nested. */  
   
         if (MDOC_BLOCK != n->type)          if (MDOC_BLOCK != n->type)
                 return(1);                  return(1);
   
         /* LINTED */          for (node = mdoc->last->parent; node; node = node->parent)
         for (node = mdoc->last->parent; node; node = node->parent)  
                 if (MDOC_BLOCK == node->type)                  if (MDOC_BLOCK == node->type)
                         if (MDOC_Bd == node->tok)                          if (MDOC_Bd == node->tok)
                                 break;                                  break;
         if (NULL == node)  
                 return(1);  
   
         return(nerr(mdoc, n, ENESTDISP));          if (node)
                   mandoc_vmsg(MANDOCERR_BD_NEST,
                       mdoc->parse, n->line, n->pos,
                       "%s in Bd", mdoc_macronames[n->tok]);
   
           return(1);
 }  }
   
   
 static int  static int
 pre_bl(PRE_ARGS)  pre_bl(PRE_ARGS)
 {  {
         int              i, type, width, offset;          struct mdoc_node *np;
           struct mdoc_argv *argv, *wa;
           int               i;
           enum mdocargt     mdoclt;
           enum mdoc_list    lt;
   
         if (MDOC_BLOCK != n->type)          if (MDOC_BLOCK != n->type) {
                   if (ENDBODY_NOT != n->end) {
                           assert(n->pending);
                           np = n->pending->parent;
                   } else
                           np = n->parent;
   
                   assert(np);
                   assert(MDOC_BLOCK == np->type);
                   assert(MDOC_Bl == np->tok);
                 return(1);                  return(1);
         if (NULL == n->args)          }
                 return(nerr(mdoc, n, ELISTTYPE));  
   
         /* 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 (i = 0; i < (int)n->args->argc; i++)                  argv = n->args->argv + i;
                 switch (n->args->argv[i].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 (-1 == type) {                          lt = LIST_diag;
                                 type = n->args->argv[i].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,
                                       mdoc->parse, 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,
                                       mdoc->parse, argv->line,
                                       argv->pos, "Bl -width");
                                   n->norm->Bl.width = "0n";
                                 break;                                  break;
                         }                          }
                         return(nerr(mdoc, n, EMULTILIST));                          if (NULL != n->norm->Bl.width)
                 case (MDOC_Width):                                  mandoc_vmsg(MANDOCERR_ARG_REP,
                         if (-1 == width) {                                      mdoc->parse, argv->line,
                                 width = n->args->argv[i].arg;                                      argv->pos, "Bl -width %s",
                                       argv->value[0]);
                           n->norm->Bl.width = argv->value[0];
                           break;
                   case MDOC_Offset:
                           if (0 == argv->sz) {
                                   mandoc_msg(MANDOCERR_ARG_EMPTY,
                                       mdoc->parse, argv->line,
                                       argv->pos, "Bl -offset");
                                 break;                                  break;
                         }                          }
                         return(nerr(mdoc, n, EARGREP));                          if (NULL != n->norm->Bl.offs)
                 case (MDOC_Offset):                                  mandoc_vmsg(MANDOCERR_ARG_REP,
                         if (-1 == offset) {                                      mdoc->parse, argv->line,
                                 offset = n->args->argv[i].arg;                                      argv->pos, "Bl -offset %s",
                                 break;                                      argv->value[0]);
                         }                          n->norm->Bl.offs = argv->value[0];
                         return(nerr(mdoc, n, EARGREP));  
                 default:  
                         break;                          break;
                   default:
                           continue;
                 }                  }
                   if (LIST__NONE == lt)
                           continue;
                   mdoclt = argv->arg;
   
         if (-1 == type)                  /* Check: multiple list types. */
                 return(nerr(mdoc, n, ELISTTYPE));  
   
         switch (type) {                  if (LIST__NONE != n->norm->Bl.type) {
         case (MDOC_Column):                          mandoc_vmsg(MANDOCERR_BL_REP,
                               mdoc->parse, 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_vmsg(MANDOCERR_BL_LATETYPE,
                               mdoc->parse, 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, mdoc->parse,
                       n->line, n->pos, "Bl");
                   n->norm->Bl.type = LIST_item;
           }
   
           /*
            * Validate the width field.  Some list types don't need width
            * types and should be warned about them.  Others should have it
            * and must also be warned.  Yet others have a default and need
            * no warning.
            */
   
           switch (n->norm->Bl.type) {
           case LIST_tag:
                   if (NULL == n->norm->Bl.width)
                           mandoc_msg(MANDOCERR_BL_NOWIDTH, mdoc->parse,
                               n->line, n->pos, "Bl -tag");
                   break;
           case LIST_column:
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
         case (MDOC_Diag):          case LIST_diag:
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
         case (MDOC_Inset):          case LIST_ohang:
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
         case (MDOC_Item):          case LIST_inset:
                 if (-1 == width)                  /* FALLTHROUGH */
                         break;          case LIST_item:
                 return(mdoc_nwarn(mdoc, n, WARN_SYNTAX,                  if (n->norm->Bl.width)
                                 "superfluous %s argument",                          mandoc_vmsg(MANDOCERR_BL_SKIPW, mdoc->parse,
                                 mdoc_argnames[MDOC_Width]));                              wa->line, wa->pos, "Bl -%s",
         case (MDOC_Tag):                              mdoc_argnames[mdoclt]);
                 if (-1 != width)                  break;
                         break;          case LIST_bullet:
                 return(mdoc_nwarn(mdoc, n, WARN_SYNTAX,                  /* FALLTHROUGH */
                                 "suggest %s argument",          case LIST_dash:
                                 mdoc_argnames[MDOC_Width]));                  /* FALLTHROUGH */
           case LIST_hyphen:
                   if (NULL == n->norm->Bl.width)
                           n->norm->Bl.width = "2n";
                   break;
           case LIST_enum:
                   if (NULL == n->norm->Bl.width)
                           n->norm->Bl.width = "3n";
                   break;
         default:          default:
                 break;                  break;
         }          }
   
         return(1);          return(pre_par(mdoc, n));
 }  }
   
   
 static int  static int
 pre_bd(PRE_ARGS)  pre_bd(PRE_ARGS)
 {  {
         int              i, type, err;          struct mdoc_node *np;
           struct mdoc_argv *argv;
           int               i;
           enum mdoc_disp    dt;
   
         if (MDOC_BLOCK != n->type)          pre_literal(mdoc, n);
   
           if (MDOC_BLOCK != n->type) {
                   if (ENDBODY_NOT != n->end) {
                           assert(n->pending);
                           np = n->pending->parent;
                   } else
                           np = n->parent;
   
                   assert(np);
                   assert(MDOC_BLOCK == np->type);
                   assert(MDOC_Bd == np->tok);
                 return(1);                  return(1);
         if (NULL == n->args)          }
                 return(nerr(mdoc, n, EDISPTYPE));  
   
         /* Make sure that only one type of display is specified.  */          for (i = 0; n->args && i < (int)n->args->argc; i++) {
                   argv = n->args->argv + i;
                   dt = DISP__NONE;
   
         /* LINTED */                  switch (argv->arg) {
         for (i = 0, err = type = 0; ! err &&                  case MDOC_Centred:
                         i < (int)n->args->argc; i++)                          dt = DISP_centered;
                 switch (n->args->argv[i].arg) {                          break;
                 case (MDOC_Ragged):                  case MDOC_Ragged:
                         /* FALLTHROUGH */                          dt = DISP_ragged;
                 case (MDOC_Unfilled):                          break;
                         /* FALLTHROUGH */                  case MDOC_Unfilled:
                 case (MDOC_Filled):                          dt = DISP_unfilled;
                         /* FALLTHROUGH */                          break;
                 case (MDOC_Literal):                  case MDOC_Filled:
                         /* FALLTHROUGH */                          dt = DISP_filled;
                 case (MDOC_File):                          break;
                         if (0 == type++)                  case MDOC_Literal:
                           dt = DISP_literal;
                           break;
                   case MDOC_File:
                           mandoc_msg(MANDOCERR_BD_FILE, mdoc->parse,
                               n->line, n->pos, NULL);
                           return(0);
                   case MDOC_Offset:
                           if (0 == argv->sz) {
                                   mandoc_msg(MANDOCERR_ARG_EMPTY,
                                       mdoc->parse, argv->line,
                                       argv->pos, "Bd -offset");
                                 break;                                  break;
                         return(nerr(mdoc, n, EMULTIDISP));                          }
                 default:                          if (NULL != n->norm->Bd.offs)
                                   mandoc_vmsg(MANDOCERR_ARG_REP,
                                       mdoc->parse, argv->line,
                                       argv->pos, "Bd -offset %s",
                                       argv->value[0]);
                           n->norm->Bd.offs = argv->value[0];
                         break;                          break;
                   case MDOC_Compact:
                           if (n->norm->Bd.comp)
                                   mandoc_msg(MANDOCERR_ARG_REP,
                                       mdoc->parse, argv->line,
                                       argv->pos, "Bd -compact");
                           n->norm->Bd.comp = 1;
                           break;
                   default:
                           abort();
                           /* NOTREACHED */
                 }                  }
                   if (DISP__NONE == dt)
                           continue;
   
         if (type)                  if (DISP__NONE == n->norm->Bd.type)
                 return(1);                          n->norm->Bd.type = dt;
         return(nerr(mdoc, n, EDISPTYPE));                  else
 }                          mandoc_vmsg(MANDOCERR_BD_REP,
                               mdoc->parse, n->line, n->pos,
                               "Bd -%s", mdoc_argnames[argv->arg]);
           }
   
           if (DISP__NONE == n->norm->Bd.type) {
                   mandoc_msg(MANDOCERR_BD_NOTYPE, mdoc->parse,
                       n->line, n->pos, "Bd");
                   n->norm->Bd.type = DISP_ragged;
           }
   
           return(pre_par(mdoc, n));
   }
   
 static int  static int
 pre_ss(PRE_ARGS)  pre_an(PRE_ARGS)
 {  {
           struct mdoc_argv *argv;
           size_t   i;
   
         if (MDOC_BLOCK != n->type)          if (n->args == NULL)
                 return(1);                  return(1);
         return(check_parent(mdoc, n, MDOC_Sh, MDOC_BODY));  
 }  
   
           for (i = 1; i < n->args->argc; i++) {
                   argv = n->args->argv + i;
                   mandoc_vmsg(MANDOCERR_AN_REP,
                       mdoc->parse, 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();
   
         if (MDOC_BLOCK != n->type)          return(1);
                 return(1);  
         return(check_parent(mdoc, n, -1, MDOC_ROOT));  
 }  }
   
   
 static int  static int
 pre_it(PRE_ARGS)  pre_std(PRE_ARGS)
 {  {
   
         if (MDOC_BLOCK != n->type)          if (n->args && 1 == n->args->argc)
                 return(1);                  if (MDOC_Std == n->args->argv[0].arg)
         return(check_parent(mdoc, n, MDOC_Bl, MDOC_BODY));                          return(1);
   
           mandoc_msg(MANDOCERR_ARG_STD, mdoc->parse,
               n->line, n->pos, mdoc_macronames[n->tok]);
           return(1);
 }  }
   
   
 static int  static int
 pre_an(PRE_ARGS)  pre_obsolete(PRE_ARGS)
 {  {
   
         if (NULL == n->args || 1 == n->args->argc)          if (MDOC_ELEM == n->type || MDOC_BLOCK == n->type)
                 return(1);                  mandoc_msg(MANDOCERR_MACRO_OBS, mdoc->parse,
         return(mdoc_nerr(mdoc, n, "only one argument allowed"));                      n->line, n->pos, mdoc_macronames[n->tok]);
           return(1);
 }  }
   
   
 static int  static int
 pre_lb(PRE_ARGS)  pre_dt(PRE_ARGS)
 {  {
   
         return(check_sec(mdoc, n, SEC_LIBRARY, SEC_CUSTOM));          if (mdoc->meta.title != NULL)
                   mandoc_msg(MANDOCERR_PROLOG_REP, mdoc->parse,
                       n->line, n->pos, "Dt");
           else if (mdoc->meta.os != NULL)
                   mandoc_msg(MANDOCERR_PROLOG_ORDER, mdoc->parse,
                       n->line, n->pos, "Dt after Os");
           return(1);
 }  }
   
   
 static int  static int
 pre_rv(PRE_ARGS)  pre_os(PRE_ARGS)
 {  {
   
         if ( ! check_msec(mdoc, n, 2, 3, 0))          if (mdoc->meta.os != NULL)
                 return(0);                  mandoc_msg(MANDOCERR_PROLOG_REP, mdoc->parse,
         return(check_stdarg(mdoc, n));                      n->line, n->pos, "Os");
           else if (mdoc->flags & MDOC_PBODY)
                   mandoc_msg(MANDOCERR_PROLOG_LATE, mdoc->parse,
                       n->line, n->pos, "Os");
           return(1);
 }  }
   
   
 static int  static int
 pre_ex(PRE_ARGS)  pre_dd(PRE_ARGS)
 {  {
   
         if ( ! check_msec(mdoc, n, 1, 6, 8, 0))          if (mdoc->meta.date != NULL)
                 return(0);                  mandoc_msg(MANDOCERR_PROLOG_REP, mdoc->parse,
         return(check_stdarg(mdoc, n));                      n->line, n->pos, "Dd");
           else if (mdoc->flags & MDOC_PBODY)
                   mandoc_msg(MANDOCERR_PROLOG_LATE, mdoc->parse,
                       n->line, n->pos, "Dd");
           else if (mdoc->meta.title != NULL)
                   mandoc_msg(MANDOCERR_PROLOG_ORDER, mdoc->parse,
                       n->line, n->pos, "Dd after Dt");
           else if (mdoc->meta.os != NULL)
                   mandoc_msg(MANDOCERR_PROLOG_ORDER, mdoc->parse,
                       n->line, n->pos, "Dd after Os");
           return(1);
 }  }
   
   
 static int  static int
 pre_er(PRE_ARGS)  post_bf(POST_ARGS)
 {  {
           struct mdoc_node *np, *nch;
           enum mdocargt     arg;
   
         return(check_msec(mdoc, n, 2, 3, 9, 0));          /*
 }           * Unlike other data pointers, these are "housed" by the HEAD
            * element, which contains the goods.
            */
   
           if (MDOC_HEAD != mdoc->last->type) {
                   if (ENDBODY_NOT != mdoc->last->end) {
                           assert(mdoc->last->pending);
                           np = mdoc->last->pending->parent->head;
                   } else if (MDOC_BLOCK != mdoc->last->type) {
                           np = mdoc->last->parent->head;
                   } else
                           np = mdoc->last->head;
   
                   assert(np);
                   assert(MDOC_HEAD == np->type);
                   assert(MDOC_Bf == np->tok);
                   return(1);
           }
   
           np = mdoc->last;
           assert(MDOC_BLOCK == np->parent->type);
           assert(MDOC_Bf == np->parent->tok);
   
           /* Check the number of arguments. */
   
           nch = np->child;
           if (NULL == np->parent->args) {
                   if (NULL == nch) {
                           mandoc_msg(MANDOCERR_BF_NOFONT, mdoc->parse,
                               np->line, np->pos, "Bf");
                           return(1);
                   }
                   nch = nch->next;
           }
           if (NULL != nch)
                   mandoc_vmsg(MANDOCERR_ARG_EXCESS, mdoc->parse,
                       nch->line, nch->pos, "Bf ... %s", nch->string);
   
           /* Extract argument into data. */
   
           if (np->parent->args) {
                   arg = np->parent->args->argv[0].arg;
                   if (MDOC_Emphasis == arg)
                           np->norm->Bf.font = FONT_Em;
                   else if (MDOC_Literal == arg)
                           np->norm->Bf.font = FONT_Li;
                   else if (MDOC_Symbolic == arg)
                           np->norm->Bf.font = FONT_Sy;
                   else
                           abort();
                   return(1);
           }
   
           /* Extract parameter into data. */
   
           if (0 == strcmp(np->child->string, "Em"))
                   np->norm->Bf.font = FONT_Em;
           else if (0 == strcmp(np->child->string, "Li"))
                   np->norm->Bf.font = FONT_Li;
           else if (0 == strcmp(np->child->string, "Sy"))
                   np->norm->Bf.font = FONT_Sy;
           else
                   mandoc_vmsg(MANDOCERR_BF_BADFONT, mdoc->parse,
                       np->child->line, np->child->pos,
                       "Bf %s", np->child->string);
   
           return(1);
   }
   
 static int  static int
 pre_cd(PRE_ARGS)  post_lb(POST_ARGS)
 {  {
           struct mdoc_node        *n;
           const char              *stdlibname;
           char                    *libname;
   
         return(check_msec(mdoc, n, 4, 0));          check_count(mdoc, MDOC_ELEM, CHECK_WARN, CHECK_EQ, 1);
 }  
   
           n = mdoc->last->child;
   
           assert(n);
           assert(MDOC_TEXT == n->type);
   
           if (NULL == (stdlibname = mdoc_a2lib(n->string)))
                   mandoc_asprintf(&libname,
                       "library \\(lq%s\\(rq", n->string);
           else
                   libname = mandoc_strdup(stdlibname);
   
           free(n->string);
           n->string = libname;
           return(1);
   }
   
 static int  static int
 pre_prologue(PRE_ARGS)  post_eoln(POST_ARGS)
 {  {
           const struct mdoc_node *n;
   
         return(check_sec(mdoc, n, SEC_PROLOGUE, SEC_CUSTOM));          n = mdoc->last;
           if (n->child)
                   mandoc_vmsg(MANDOCERR_ARG_SKIP,
                       mdoc->parse, n->line, n->pos,
                       "%s %s", mdoc_macronames[n->tok],
                       n->child->string);
           return(1);
 }  }
   
   
 static int  static int
 pre_dt(PRE_ARGS)  post_fo(POST_ARGS)
 {  {
   
         if (0 == mdoc->meta.date || mdoc->meta.os)          hwarn_eq1(mdoc);
                 if ( ! nwarn(mdoc, n, WPROLOOO))          bwarn_ge1(mdoc);
                         return(0);  
         if (mdoc->meta.title)  
                 if ( ! nwarn(mdoc, n, WPROLREP))  
                         return(0);  
         return(1);          return(1);
 }  }
   
   
 static int  static int
 pre_os(PRE_ARGS)  post_vt(POST_ARGS)
 {  {
           const struct mdoc_node *n;
   
         if (NULL == mdoc->meta.title || 0 == mdoc->meta.date)          /*
                 if ( ! nwarn(mdoc, n, WPROLOOO))           * The Vt macro comes in both ELEM and BLOCK form, both of which
                         return(0);           * have different syntaxes (yet more context-sensitive
         if (mdoc->meta.os)           * behaviour).  ELEM types must have a child, which is already
                 if ( ! nwarn(mdoc, n, WPROLREP))           * guaranteed by the in_line parsing routine; BLOCK types,
                         return(0);           * specifically the BODY, should only have TEXT children.
            */
   
           if (MDOC_BODY != mdoc->last->type)
                   return(1);
   
           for (n = mdoc->last->child; n; n = n->next)
                   if (MDOC_TEXT != n->type)
                           mandoc_msg(MANDOCERR_VT_CHILD, mdoc->parse,
                               n->line, n->pos, mdoc_macronames[n->tok]);
   
         return(1);          return(1);
 }  }
   
   
 static int  static int
 pre_dd(PRE_ARGS)  post_nm(POST_ARGS)
 {  {
   
         if (mdoc->meta.title || mdoc->meta.os)          if (NULL != mdoc->meta.name)
                 if ( ! nwarn(mdoc, n, WPROLOOO))                  return(1);
                         return(0);  
         if (mdoc->meta.date)          mdoc_deroff(&mdoc->meta.name, mdoc->last);
                 if ( ! nwarn(mdoc, n, WPROLREP))  
                         return(0);          if (NULL == mdoc->meta.name)
                   mandoc_msg(MANDOCERR_NM_NONAME, mdoc->parse,
                       mdoc->last->line, mdoc->last->pos, "Nm");
         return(1);          return(1);
 }  }
   
   static int
   post_nd(POST_ARGS)
   {
   
           berr_ge1(mdoc);
           return(post_hyph(mdoc));
   }
   
 static int  static int
 post_bf(POST_ARGS)  post_d1(POST_ARGS)
 {  {
         char             *p;  
         struct mdoc_node *head;  
   
         if (MDOC_BLOCK != mdoc->last->type)          bwarn_ge1(mdoc);
                 return(1);          return(post_hyph(mdoc));
   }
   
         head = mdoc->last->head;  static int
   post_literal(POST_ARGS)
   {
   
         if (NULL == mdoc->last->args) {          if (mdoc->last->tok == MDOC_Bd)
                 if (NULL == head->child ||                  hwarn_eq0(mdoc);
                                 MDOC_TEXT != head->child->type)          bwarn_ge1(mdoc);
                         return(mdoc_err(mdoc, "text argument expected"));  
   
                 p = head->child->string;          /*
                 if (0 == strcmp(p, "Em"))           * The `Dl' (note "el" not "one") and `Bd' macros unset the
                         return(1);           * MDOC_LITERAL flag as they leave.  Note that `Bd' only sets
                 else if (0 == strcmp(p, "Li"))           * this in literal mode, but it doesn't hurt to just switch it
                         return(1);           * off in general since displays can't be nested.
                 else if (0 == strcmp(p, "Sm"))           */
                         return(1);  
                 return(mdoc_nerr(mdoc, head->child, "invalid font"));  
         }  
   
         if (head->child)          if (MDOC_BODY == mdoc->last->type)
                 return(mdoc_err(mdoc, "one argument expected"));                  mdoc->flags &= ~MDOC_LITERAL;
   
         return(1);          return(1);
 }  }
   
   
 static int  static int
 post_nm(POST_ARGS)  post_defaults(POST_ARGS)
 {  {
           struct mdoc_node *nn;
   
           /*
            * The `Ar' defaults to "file ..." if no value is provided as an
            * argument; the `Mt' and `Pa' macros use "~"; the `Li' just
            * gets an empty string.
            */
   
         if (mdoc->last->child)          if (mdoc->last->child)
                 return(1);                  return(1);
         if (mdoc->meta.name)  
                 return(1);  
         return(verr(mdoc, ENAME));  
 }  
   
           nn = mdoc->last;
           mdoc->next = MDOC_NEXT_CHILD;
   
           switch (nn->tok) {
           case MDOC_Ar:
                   if ( ! mdoc_word_alloc(mdoc, nn->line, nn->pos, "file"))
                           return(0);
                   if ( ! mdoc_word_alloc(mdoc, nn->line, nn->pos, "..."))
                           return(0);
                   break;
           case MDOC_Li:
                   if ( ! mdoc_word_alloc(mdoc, nn->line, nn->pos, ""))
                           return(0);
                   break;
           case MDOC_Pa:
                   /* FALLTHROUGH */
           case MDOC_Mt:
                   if ( ! mdoc_word_alloc(mdoc, nn->line, nn->pos, "~"))
                           return(0);
                   break;
           default:
                   abort();
                   /* NOTREACHED */
           }
   
           mdoc->last = nn;
           return(1);
   }
   
 static int  static int
 post_at(POST_ARGS)  post_at(POST_ARGS)
 {  {
           struct mdoc_node        *n;
           const char              *std_att;
           char                    *att;
   
         if (NULL == mdoc->last->child)          n = mdoc->last;
           if (n->child == NULL) {
                   mdoc->next = MDOC_NEXT_CHILD;
                   if ( ! mdoc_word_alloc(mdoc, n->line, n->pos, "AT&T UNIX"))
                           return(0);
                   mdoc->last = n;
                 return(1);                  return(1);
         if (MDOC_TEXT != mdoc->last->child->type)          }
                 return(verr(mdoc, EATT));  
         if (mdoc_a2att(mdoc->last->child->string))  
                 return(1);  
         return(verr(mdoc, EATT));  
 }  
   
           /*
            * 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.
            */
   
           n = n->child;
           assert(MDOC_TEXT == n->type);
           if (NULL == (std_att = mdoc_a2att(n->string))) {
                   mandoc_vmsg(MANDOCERR_AT_BAD, mdoc->parse,
                       n->line, n->pos, "At %s", n->string);
                   mandoc_asprintf(&att, "AT&T UNIX %s", n->string);
           } else
                   att = mandoc_strdup(std_att);
   
           free(n->string);
           n->string = att;
           return(1);
   }
   
 static int  static int
 post_an(POST_ARGS)  post_an(POST_ARGS)
 {  {
           struct mdoc_node *np;
   
         if (mdoc->last->args) {          np = mdoc->last;
                 if (NULL == mdoc->last->child)          if (AUTH__NONE == np->norm->An.auth) {
                         return(1);                  if (0 == np->child)
                 return(verr(mdoc, ELINE));                          check_count(mdoc, MDOC_ELEM, CHECK_WARN, CHECK_GT, 0);
         }          } else if (np->child)
                   check_count(mdoc, MDOC_ELEM, CHECK_WARN, CHECK_EQ, 0);
   
         if (mdoc->last->child)          return(1);
                 return(1);  
         return(verr(mdoc, ELINE));  
 }  }
   
   
 static int  static int
 post_args(POST_ARGS)  post_en(POST_ARGS)
 {  {
   
         if (mdoc->last->args)          if (MDOC_BLOCK == mdoc->last->type)
                 return(1);                  mdoc->last->norm->Es = mdoc->last_es;
         return(verr(mdoc, ELINE));          return(1);
 }  }
   
   static int
   post_es(POST_ARGS)
   {
   
           mdoc->last_es = mdoc->last;
           return(1);
   }
   
 static int  static int
 post_it(POST_ARGS)  post_it(POST_ARGS)
 {  {
         int               type, i, cols;          int               i, cols;
         struct mdoc_node *n, *c;          enum mdoc_list    lt;
           struct mdoc_node *nbl, *nit, *nch;
   
         if (MDOC_BLOCK != mdoc->last->type)          nit = mdoc->last;
           if (MDOC_BLOCK != nit->type)
                 return(1);                  return(1);
   
         n = mdoc->last->parent->parent;          nbl = nit->parent->parent;
         if (NULL == n->args)          lt = nbl->norm->Bl.type;
                 return(verr(mdoc, ELISTTYPE));  
   
         /* Some types require block-head, some not. */          switch (lt) {
           case LIST_tag:
         /* LINTED */  
         for (cols = type = -1, i = 0; -1 == type &&  
                         i < (int)n->args->argc; i++)  
                 switch (n->args->argv[i].arg) {  
                 case (MDOC_Tag):  
                         /* FALLTHROUGH */  
                 case (MDOC_Diag):  
                         /* FALLTHROUGH */  
                 case (MDOC_Hang):  
                         /* FALLTHROUGH */  
                 case (MDOC_Ohang):  
                         /* FALLTHROUGH */  
                 case (MDOC_Inset):  
                         /* FALLTHROUGH */  
                 case (MDOC_Bullet):  
                         /* FALLTHROUGH */  
                 case (MDOC_Dash):  
                         /* FALLTHROUGH */  
                 case (MDOC_Enum):  
                         /* FALLTHROUGH */  
                 case (MDOC_Hyphen):  
                         /* FALLTHROUGH */  
                 case (MDOC_Item):  
                         type = n->args->argv[i].arg;  
                         break;  
                 case (MDOC_Column):  
                         type = n->args->argv[i].arg;  
                         cols = (int)n->args->argv[i].sz;  
                         break;  
                 default:  
                         break;  
                 }  
   
         if (-1 == type)  
                 return(verr(mdoc, ELISTTYPE));  
   
         switch (type) {  
         case (MDOC_Tag):  
                 if (NULL == mdoc->last->head->child)  
                         if ( ! vwarn(mdoc, WLINE))  
                                 return(0);  
                 break;  
         case (MDOC_Hang):  
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
         case (MDOC_Ohang):          case LIST_hang:
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
         case (MDOC_Inset):          case LIST_ohang:
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
         case (MDOC_Diag):          case LIST_inset:
                 if (NULL == mdoc->last->head->child)                  /* FALLTHROUGH */
                         if ( ! vwarn(mdoc, WLINE))          case LIST_diag:
                                 return(0);                  if (NULL == nit->head->child)
                 if (NULL == mdoc->last->body->child)                          mandoc_vmsg(MANDOCERR_IT_NOHEAD,
                         if ( ! vwarn(mdoc, WMULTILINE))                              mdoc->parse, nit->line, nit->pos,
                                 return(0);                              "Bl -%s It",
                               mdoc_argnames[nbl->args->argv[0].arg]);
                 break;                  break;
         case (MDOC_Bullet):          case LIST_bullet:
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
         case (MDOC_Dash):          case LIST_dash:
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
         case (MDOC_Enum):          case LIST_enum:
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
         case (MDOC_Hyphen):          case LIST_hyphen:
                   if (NULL == nit->body->child)
                           mandoc_vmsg(MANDOCERR_IT_NOBODY,
                               mdoc->parse, nit->line, nit->pos,
                               "Bl -%s It",
                               mdoc_argnames[nbl->args->argv[0].arg]);
                 /* FALLTHROUGH */                  /* FALLTHROUGH */
         case (MDOC_Item):          case LIST_item:
                 if (mdoc->last->head->child)                  if (NULL != nit->head->child)
                         if ( ! vwarn(mdoc, WNOLINE))                          mandoc_vmsg(MANDOCERR_ARG_SKIP,
                                 return(0);                              mdoc->parse, nit->line, nit->pos,
                 if (NULL == mdoc->last->body->child)                              "It %s", nit->head->child->string);
                         if ( ! vwarn(mdoc, WMULTILINE))  
                                 return(0);  
                 break;                  break;
         case (MDOC_Column):          case LIST_column:
                 if (NULL == mdoc->last->head->child)                  cols = (int)nbl->norm->Bl.ncols;
                         if ( ! vwarn(mdoc, WLINE))  
                                 return(0);                  assert(NULL == nit->head->child);
                 if (mdoc->last->body->child)  
                         if ( ! vwarn(mdoc, WNOMULTILINE))                  for (i = 0, nch = nit->child; nch; nch = nch->next)
                                 return(0);                          if (MDOC_BODY == nch->type)
                 c = mdoc->last->child;                                  i++;
                 for (i = 0; c && MDOC_HEAD == c->type; c = c->next)  
                         i++;                  if (i < cols || i > cols + 1)
                 if (i == cols)                          mandoc_vmsg(MANDOCERR_ARGCOUNT,
                         break;                              mdoc->parse, nit->line, nit->pos,
                 return(mdoc_err(mdoc, "column mismatch (have "                              "columns == %d (have %d)", cols, i);
                                         "%d, want %d)", i, cols));                  break;
         default:          default:
                   abort();
           }
   
           return(1);
   }
   
   static int
   post_bl_block(POST_ARGS)
   {
           struct mdoc_node *n, *ni, *nc;
   
           /*
            * These are fairly complicated, so we've broken them into two
            * functions.  post_bl_block_tag() is called when a -tag is
            * specified, but no -width (it must be guessed).  The second
            * when a -width is specified (macro indicators must be
            * rewritten into real lengths).
            */
   
           n = mdoc->last;
   
           if (LIST_tag == n->norm->Bl.type &&
               NULL == n->norm->Bl.width) {
                   if ( ! post_bl_block_tag(mdoc))
                           return(0);
                   assert(n->norm->Bl.width);
           } else if (NULL != n->norm->Bl.width) {
                   if ( ! post_bl_block_width(mdoc))
                           return(0);
                   assert(n->norm->Bl.width);
           }
   
           for (ni = n->body->child; ni; ni = ni->next) {
                   if (NULL == ni->body)
                           continue;
                   nc = ni->body->last;
                   while (NULL != nc) {
                           switch (nc->tok) {
                           case MDOC_Pp:
                                   /* FALLTHROUGH */
                           case MDOC_Lp:
                                   /* FALLTHROUGH */
                           case MDOC_br:
                                   break;
                           default:
                                   nc = NULL;
                                   continue;
                           }
                           if (NULL == ni->next) {
                                   mandoc_msg(MANDOCERR_PAR_MOVE,
                                       mdoc->parse, nc->line, nc->pos,
                                       mdoc_macronames[nc->tok]);
                                   if ( ! mdoc_node_relink(mdoc, nc))
                                           return(0);
                           } else if (0 == n->norm->Bl.comp &&
                               LIST_column != n->norm->Bl.type) {
                                   mandoc_vmsg(MANDOCERR_PAR_SKIP,
                                       mdoc->parse, nc->line, nc->pos,
                                       "%s before It",
                                       mdoc_macronames[nc->tok]);
                                   mdoc_node_delete(mdoc, nc);
                           } else
                                   break;
                           nc = ni->body->last;
                   }
           }
           return(1);
   }
   
   static int
   post_bl_block_width(POST_ARGS)
   {
           size_t            width;
           int               i;
           enum mdoct        tok;
           struct mdoc_node *n;
           char              buf[24];
   
           n = mdoc->last;
   
           /*
            * Calculate the real width of a list from the -width string,
            * which may contain a macro (with a known default width), a
            * literal string, or a scaling width.
            *
            * If the value to -width is a macro, then we re-write it to be
            * the macro's width as set in share/tmac/mdoc/doc-common.
            */
   
           if (0 == strcmp(n->norm->Bl.width, "Ds"))
                   width = 6;
           else if (MDOC_MAX == (tok = mdoc_hash_find(n->norm->Bl.width)))
                   return(1);
           else
                   width = macro2len(tok);
   
           /* The value already exists: free and reallocate it. */
   
           assert(n->args);
   
           for (i = 0; i < (int)n->args->argc; i++)
                   if (MDOC_Width == n->args->argv[i].arg)
                           break;
   
           assert(i < (int)n->args->argc);
   
           (void)snprintf(buf, sizeof(buf), "%un", (unsigned int)width);
           free(n->args->argv[i].value[0]);
           n->args->argv[i].value[0] = mandoc_strdup(buf);
   
           /* Set our width! */
           n->norm->Bl.width = n->args->argv[i].value[0];
           return(1);
   }
   
   static int
   post_bl_block_tag(POST_ARGS)
   {
           struct mdoc_node *n, *nn;
           size_t            sz, ssz;
           int               i;
           char              buf[24];
   
           /*
            * Calculate the -width for a `Bl -tag' list if it hasn't been
            * provided.  Uses the first head macro.  NOTE AGAIN: this is
            * ONLY if the -width argument has NOT been provided.  See
            * post_bl_block_width() for converting the -width string.
            */
   
           sz = 10;
           n = mdoc->last;
   
           for (nn = n->body->child; nn; nn = nn->next) {
                   if (MDOC_It != nn->tok)
                           continue;
   
                   assert(MDOC_BLOCK == nn->type);
                   nn = nn->head->child;
   
                   if (nn == NULL)
                           break;
   
                   if (MDOC_TEXT == nn->type) {
                           sz = strlen(nn->string) + 1;
                           break;
                   }
   
                   if (0 != (ssz = macro2len(nn->tok)))
                           sz = ssz;
   
                 break;                  break;
         }          }
   
           /* Defaults to ten ens. */
   
           (void)snprintf(buf, sizeof(buf), "%un", (unsigned int)sz);
   
           /*
            * We have to dynamically add this to the macro's argument list.
            * We're guaranteed that a MDOC_Width doesn't already exist.
            */
   
           assert(n->args);
           i = (int)(n->args->argc)++;
   
           n->args->argv = mandoc_reallocarray(n->args->argv,
               n->args->argc, sizeof(struct mdoc_argv));
   
           n->args->argv[i].arg = MDOC_Width;
           n->args->argv[i].line = n->line;
           n->args->argv[i].pos = n->pos;
           n->args->argv[i].sz = 1;
           n->args->argv[i].value = mandoc_malloc(sizeof(char *));
           n->args->argv[i].value[0] = mandoc_strdup(buf);
   
           /* Set our width! */
           n->norm->Bl.width = n->args->argv[i].value[0];
         return(1);          return(1);
 }  }
   
   static int
   post_bl_head(POST_ARGS)
   {
           struct mdoc_node *np, *nn, *nnp;
           struct mdoc_argv *argv;
           int               i, j;
   
           if (LIST_column != mdoc->last->norm->Bl.type)
                   /* FIXME: this should be ERROR class... */
                   return(hwarn_eq0(mdoc));
   
           /*
            * Append old-style lists, where the column width specifiers
            * trail as macro parameters, to the new-style ("normal-form")
            * lists where they're argument values following -column.
            */
   
           if (mdoc->last->child == NULL)
                   return(1);
   
           np = mdoc->last->parent;
           assert(np->args);
   
           for (j = 0; j < (int)np->args->argc; j++)
                   if (MDOC_Column == np->args->argv[j].arg)
                           break;
   
           assert(j < (int)np->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 = np->args->argv + j;
           i = argv->sz;
           argv->sz += mdoc->last->nchild;
           argv->value = mandoc_reallocarray(argv->value,
               argv->sz, sizeof(char *));
   
           mdoc->last->norm->Bl.ncols = argv->sz;
           mdoc->last->norm->Bl.cols = (void *)argv->value;
   
           for (nn = mdoc->last->child; nn; i++) {
                   argv->value[i] = nn->string;
                   nn->string = NULL;
                   nnp = nn;
                   nn = nn->next;
                   mdoc_node_delete(NULL, nnp);
           }
   
           mdoc->last->nchild = 0;
           mdoc->last->child = NULL;
   
           return(1);
   }
   
 static int  static int
 post_bl(POST_ARGS)  post_bl(POST_ARGS)
 {  {
         struct mdoc_node        *n;          struct mdoc_node        *nparent, *nprev; /* of the Bl block */
           struct mdoc_node        *nblock, *nbody;  /* of the Bl */
           struct mdoc_node        *nchild, *nnext;  /* of the Bl body */
   
         if (MDOC_BODY != mdoc->last->type)          nbody = mdoc->last;
           switch (nbody->type) {
           case MDOC_BLOCK:
                   return(post_bl_block(mdoc));
           case MDOC_HEAD:
                   return(post_bl_head(mdoc));
           case MDOC_BODY:
                   break;
           default:
                 return(1);                  return(1);
         if (NULL == mdoc->last->child)          }
                 return(1);  
   
         /* LINTED */          bwarn_ge1(mdoc);
         for (n = mdoc->last->child; n; n = n->next) {  
                 if (MDOC_BLOCK == n->type)          nchild = nbody->child;
                         if (MDOC_It == n->tok)          while (NULL != nchild) {
                                 continue;                  if (MDOC_It == nchild->tok || MDOC_Sm == nchild->tok) {
                 return(mdoc_nerr(mdoc, n, "bad child of parent %s",                          nchild = nchild->next;
                                 mdoc_macronames[mdoc->last->tok]));                          continue;
                   }
   
                   mandoc_msg(MANDOCERR_BL_MOVE, mdoc->parse,
                       nchild->line, nchild->pos,
                       mdoc_macronames[nchild->tok]);
   
                   /*
                    * Move the node out of the Bl block.
                    * First, collect all required node pointers.
                    */
   
                   nblock  = nbody->parent;
                   nprev   = nblock->prev;
                   nparent = nblock->parent;
                   nnext   = nchild->next;
   
                   /*
                    * Unlink this child.
                    */
   
                   assert(NULL == nchild->prev);
                   if (0 == --nbody->nchild) {
                           nbody->child = NULL;
                           nbody->last  = NULL;
                           assert(NULL == nnext);
                   } else {
                           nbody->child = nnext;
                           nnext->prev = NULL;
                   }
   
                   /*
                    * Relink this child.
                    */
   
                   nchild->parent = nparent;
                   nchild->prev   = nprev;
                   nchild->next   = nblock;
   
                   nblock->prev = nchild;
                   nparent->nchild++;
                   if (NULL == nprev)
                           nparent->child = nchild;
                   else
                           nprev->next = nchild;
   
                   nchild = nnext;
         }          }
   
         return(1);          return(1);
 }  }
   
   static int
   post_bk(POST_ARGS)
   {
   
           hwarn_eq0(mdoc);
           bwarn_ge1(mdoc);
           return(1);
   }
   
 static int  static int
 ebool(struct mdoc *mdoc)  ebool(struct mdoc *mdoc)
 {  {
         struct mdoc_node *n;          struct mdoc_node        *nch;
           enum mdoct               tok;
   
         /* LINTED */          tok = mdoc->last->tok;
         for (n = mdoc->last->child; n; n = n->next) {          nch = mdoc->last->child;
                 if (MDOC_TEXT != n->type)  
                         break;          if (NULL == nch) {
                 if (0 == strcmp(n->string, "on"))                  if (MDOC_Sm == tok)
                         continue;                          mdoc->flags ^= MDOC_SMOFF;
                 if (0 == strcmp(n->string, "off"))                  return(1);
                         continue;  
                 break;  
         }          }
   
         if (NULL == n)          check_count(mdoc, MDOC_ELEM, CHECK_WARN, CHECK_LT, 2);
   
           assert(MDOC_TEXT == nch->type);
   
           if (0 == strcmp(nch->string, "on")) {
                   if (MDOC_Sm == tok)
                           mdoc->flags &= ~MDOC_SMOFF;
                 return(1);                  return(1);
         return(nerr(mdoc, n, EBOOL));          }
           if (0 == strcmp(nch->string, "off")) {
                   if (MDOC_Sm == tok)
                           mdoc->flags |= MDOC_SMOFF;
                   return(1);
           }
   
           mandoc_vmsg(MANDOCERR_SM_BAD,
               mdoc->parse, nch->line, nch->pos,
               "%s %s", mdoc_macronames[tok], nch->string);
           return(mdoc_node_relink(mdoc, nch));
 }  }
   
   
 static int  static int
 post_root(POST_ARGS)  post_root(POST_ARGS)
 {  {
           struct mdoc_node *n;
   
         if (NULL == mdoc->first->child)          /* Add missing prologue data. */
                 return(verr(mdoc, ENODATA));  
         if (SEC_PROLOGUE == mdoc->lastnamed)  
                 return(verr(mdoc, ENOPROLOGUE));  
   
         if (MDOC_BLOCK != mdoc->first->child->type)          if (mdoc->meta.date == NULL)
                 return(verr(mdoc, ENODATA));                  mdoc->meta.date = mdoc->quick ?
         if (MDOC_Sh != mdoc->first->child->tok)                      mandoc_strdup("") :
                 return(verr(mdoc, ENODATA));                      mandoc_normdate(mdoc->parse, NULL, 0, 0);
   
           if (mdoc->meta.title == NULL) {
                   mandoc_msg(MANDOCERR_DT_NOTITLE,
                       mdoc->parse, 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,
                       mdoc->parse, 0, 0, NULL);
                   mdoc->meta.os = mandoc_strdup("");
           }
   
           /* Check that we begin with a proper `Sh'. */
   
           n = mdoc->first->child;
           while (n != NULL && mdoc_macros[n->tok].flags & MDOC_PROLOGUE)
                   n = n->next;
   
           if (n == NULL)
                   mandoc_msg(MANDOCERR_DOC_EMPTY, mdoc->parse, 0, 0, NULL);
           else if (n->tok != MDOC_Sh)
                   mandoc_msg(MANDOCERR_SEC_BEFORE, mdoc->parse,
                       n->line, n->pos, mdoc_macronames[n->tok]);
   
         return(1);          return(1);
 }  }
   
   
 static int  static int
 post_st(POST_ARGS)  post_st(POST_ARGS)
 {  {
           struct mdoc_node         *n, *nch;
           const char               *p;
   
         if (mdoc_a2st(mdoc->last->child->string))          n = mdoc->last;
           nch = n->child;
   
           if (NULL == nch) {
                   mandoc_msg(MANDOCERR_MACRO_EMPTY, mdoc->parse,
                       n->line, n->pos, mdoc_macronames[n->tok]);
                   mdoc_node_delete(mdoc, n);
                 return(1);                  return(1);
         return(vwarn(mdoc, WBADSTAND));          }
   
           assert(MDOC_TEXT == nch->type);
   
           if (NULL == (p = mdoc_a2st(nch->string))) {
                   mandoc_vmsg(MANDOCERR_ST_BAD, mdoc->parse,
                       nch->line, nch->pos, "St %s", nch->string);
                   mdoc_node_delete(mdoc, n);
           } else {
                   free(nch->string);
                   nch->string = mandoc_strdup(p);
           }
   
           return(1);
 }  }
   
   static int
   post_rs(POST_ARGS)
   {
           struct mdoc_node *nn, *next, *prev;
           int               i, j;
   
           switch (mdoc->last->type) {
           case MDOC_HEAD:
                   check_count(mdoc, MDOC_HEAD, CHECK_WARN, CHECK_EQ, 0);
                   return(1);
           case MDOC_BODY:
                   if (mdoc->last->child)
                           break;
                   check_count(mdoc, MDOC_BODY, CHECK_WARN, CHECK_GT, 0);
                   return(1);
           default:
                   return(1);
           }
   
           /*
            * 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 (nn = mdoc->last->child->next; nn; nn = next) {
                   /* Determine order of `nn'. */
                   for (i = 0; i < RSORD_MAX; i++)
                           if (rsord[i] == nn->tok)
                                   break;
   
                   if (i == RSORD_MAX) {
                           mandoc_msg(MANDOCERR_RS_BAD,
                               mdoc->parse, nn->line, nn->pos,
                               mdoc_macronames[nn->tok]);
                           i = -1;
                   } else if (MDOC__J == nn->tok || MDOC__B == nn->tok)
                           mdoc->last->norm->Rs.quote_T++;
   
                   /*
                    * Remove `nn' from the chain.  This somewhat
                    * repeats mdoc_node_unlink(), but since we're
                    * just re-ordering, there's no need for the
                    * full unlink process.
                    */
   
                   if (NULL != (next = nn->next))
                           next->prev = nn->prev;
   
                   if (NULL != (prev = nn->prev))
                           prev->next = nn->next;
   
                   nn->prev = nn->next = NULL;
   
                   /*
                    * Scan back until we reach a node that's
                    * ordered before `nn'.
                    */
   
                   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 `nn' back into its correct place in front
                    * of the `prev' node.
                    */
   
                   nn->prev = prev;
   
                   if (prev) {
                           if (prev->next)
                                   prev->next->prev = nn;
                           nn->next = prev->next;
                           prev->next = nn;
                   } else {
                           mdoc->last->child->prev = nn;
                           nn->next = mdoc->last->child;
                           mdoc->last->child = nn;
                   }
           }
   
           return(1);
   }
   
   /*
    * For some arguments of some macros,
    * convert all breakable hyphens into ASCII_HYPH.
    */
 static int  static int
   post_hyph(POST_ARGS)
   {
           struct mdoc_node        *n, *nch;
           char                    *cp;
   
           n = mdoc->last;
           switch (n->type) {
           case MDOC_HEAD:
                   if (MDOC_Sh == n->tok || MDOC_Ss == n->tok)
                           break;
                   return(1);
           case MDOC_BODY:
                   if (MDOC_D1 == n->tok || MDOC_Nd == n->tok)
                           break;
                   return(1);
           case MDOC_ELEM:
                   break;
           default:
                   return(1);
           }
   
           for (nch = n->child; nch; nch = nch->next) {
                   if (MDOC_TEXT != nch->type)
                           continue;
                   cp = nch->string;
                   if ('\0' == *cp)
                           continue;
                   while ('\0' != *(++cp))
                           if ('-' == *cp &&
                               isalpha((unsigned char)cp[-1]) &&
                               isalpha((unsigned char)cp[1]))
                                   *cp = ASCII_HYPH;
           }
           return(1);
   }
   
   static int
   post_hyphtext(POST_ARGS)
   {
   
           ewarn_ge1(mdoc);
           return(post_hyph(mdoc));
   }
   
   static int
   post_ns(POST_ARGS)
   {
   
           if (MDOC_LINE & mdoc->last->flags)
                   mandoc_msg(MANDOCERR_NS_SKIP, mdoc->parse,
                       mdoc->last->line, mdoc->last->pos, NULL);
           return(1);
   }
   
   static int
 post_sh(POST_ARGS)  post_sh(POST_ARGS)
 {  {
   
         if (MDOC_HEAD == mdoc->last->type)          post_ignpar(mdoc);
   
           switch (mdoc->last->type) {
           case MDOC_HEAD:
                 return(post_sh_head(mdoc));                  return(post_sh_head(mdoc));
         if (MDOC_BODY == mdoc->last->type)          case MDOC_BODY:
                 return(post_sh_body(mdoc));                  switch (mdoc->lastsec)  {
                   case SEC_NAME:
                           return(post_sh_name(mdoc));
                   case SEC_SEE_ALSO:
                           return(post_sh_see_also(mdoc));
                   case SEC_AUTHORS:
                           return(post_sh_authors(mdoc));
                   default:
                           break;
                   }
                   break;
           default:
                   break;
           }
   
         return(1);          return(1);
 }  }
   
   
 static int  static int
 post_sh_body(POST_ARGS)  post_sh_name(POST_ARGS)
 {  {
         struct mdoc_node *n;          struct mdoc_node *n;
   
         if (SEC_NAME != mdoc->lastnamed)  
                 return(1);  
   
         /*          /*
          * Warn if the NAME section doesn't contain the `Nm' and `Nd'           * Warn if the NAME section doesn't contain the `Nm' and `Nd'
          * macros (can have multiple `Nm' and one `Nd').  Note that the           * macros (can have multiple `Nm' and one `Nd').  Note that the
          * children of the BODY declaration can also be "text".           * children of the BODY declaration can also be "text".
          */           */
   
         if (NULL == (n = mdoc->last->child))          if (NULL == (n = mdoc->last->child)) {
                 return(vwarn(mdoc, WNAMESECINC));                  mandoc_msg(MANDOCERR_NAMESEC_BAD, mdoc->parse,
                       mdoc->last->line, mdoc->last->pos, "empty");
                   return(1);
           }
   
         for ( ; n && n->next; n = n->next) {          for ( ; n && n->next; n = n->next) {
                 if (MDOC_ELEM == n->type && MDOC_Nm == n->tok)                  if (MDOC_ELEM == n->type && MDOC_Nm == n->tok)
                         continue;                          continue;
                 if (MDOC_TEXT == n->type)                  if (MDOC_TEXT == n->type)
                         continue;                          continue;
                 if ( ! vwarn(mdoc, WNAMESECINC))                  mandoc_msg(MANDOCERR_NAMESEC_BAD, mdoc->parse,
                         return(0);                      n->line, n->pos, mdoc_macronames[n->tok]);
         }          }
   
         if (MDOC_ELEM == n->type && MDOC_Nd == n->tok)          assert(n);
           if (MDOC_BLOCK == n->type && MDOC_Nd == n->tok)
                 return(1);                  return(1);
         return(vwarn(mdoc, WNAMESECINC));  
           mandoc_msg(MANDOCERR_NAMESEC_BAD, mdoc->parse,
               n->line, n->pos, mdoc_macronames[n->tok]);
           return(1);
 }  }
   
   static int
   post_sh_see_also(POST_ARGS)
   {
           const struct mdoc_node  *n;
           const char              *name, *sec;
           const char              *lastname, *lastsec, *lastpunct;
           int                      cmp;
   
           n = mdoc->last->child;
           lastname = lastsec = lastpunct = NULL;
           while (n != NULL) {
                   if (n->tok != MDOC_Xr || n->nchild < 2)
                           break;
   
                   /* Process one .Xr node. */
   
                   name = n->child->string;
                   sec = n->child->next->string;
                   if (lastsec != NULL) {
                           if (lastpunct[0] != ',' || lastpunct[1] != '\0')
                                   mandoc_vmsg(MANDOCERR_XR_PUNCT,
                                       mdoc->parse, n->line, n->pos,
                                       "%s before %s(%s)", lastpunct,
                                       name, sec);
                           cmp = strcmp(lastsec, sec);
                           if (cmp > 0)
                                   mandoc_vmsg(MANDOCERR_XR_ORDER,
                                       mdoc->parse, n->line, n->pos,
                                       "%s(%s) after %s(%s)", name,
                                       sec, lastname, lastsec);
                           else if (cmp == 0 && strcmp(lastname, name) > 0)
                                   mandoc_vmsg(MANDOCERR_XR_ORDER,
                                       mdoc->parse, n->line, n->pos,
                                       "%s after %s", name, lastname);
                   }
                   lastname = name;
                   lastsec = sec;
   
                   /* Process the following node. */
   
                   n = n->next;
                   if (n == NULL)
                           break;
                   if (n->tok == MDOC_Xr) {
                           lastpunct = "none";
                           continue;
                   }
                   if (n->type != MDOC_TEXT)
                           break;
                   for (name = n->string; *name != '\0'; name++)
                           if (isalpha((const unsigned char)*name))
                                   return(1);
                   lastpunct = n->string;
                   if (n->next == NULL)
                           mandoc_vmsg(MANDOCERR_XR_PUNCT, mdoc->parse,
                               n->line, n->pos, "%s after %s(%s)",
                               lastpunct, lastname, lastsec);
                   n = n->next;
           }
           return(1);
   }
   
 static int  static int
   child_an(const struct mdoc_node *n)
   {
   
           for (n = n->child; n != NULL; n = n->next)
                   if ((n->tok == MDOC_An && n->nchild) || child_an(n))
                           return(1);
           return(0);
   }
   
   static int
   post_sh_authors(POST_ARGS)
   {
   
           if ( ! child_an(mdoc->last))
                   mandoc_msg(MANDOCERR_AN_MISSING, mdoc->parse,
                       mdoc->last->line, mdoc->last->pos, NULL);
           return(1);
   }
   
   static int
 post_sh_head(POST_ARGS)  post_sh_head(POST_ARGS)
 {  {
         char                    buf[64];          struct mdoc_node *n;
         enum mdoc_sec           sec;          const char      *goodsec;
         const struct mdoc_node *n;          char            *secname;
           enum mdoc_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.
          */           */
   
         assert(MDOC_Sh == mdoc->last->tok);          secname = NULL;
           sec = SEC_CUSTOM;
           mdoc_deroff(&secname, mdoc->last);
           sec = NULL == secname ? SEC_CUSTOM : a2sec(secname);
   
         /* This is just concat() inlined, which is irritating. */          /* The NAME should be first. */
   
         buf[0] = 0;          if (SEC_NAME != sec && SEC_NONE == mdoc->lastnamed)
         for (n = mdoc->last->child; n; n = n->next) {                  mandoc_vmsg(MANDOCERR_NAMESEC_FIRST, mdoc->parse,
                 assert(MDOC_TEXT == n->type);                      mdoc->last->line, mdoc->last->pos,
                 if (strlcat(buf, n->string, 64) >= 64)                      "Sh %s", secname);
                         return(nerr(mdoc, n, ETOOLONG));  
                 if (NULL == n->next)          /* The SYNOPSIS gets special attention in other areas. */
                         continue;  
                 if (strlcat(buf, " ", 64) >= 64)          if (SEC_SYNOPSIS == sec) {
                         return(nerr(mdoc, n, ETOOLONG));                  roff_setreg(mdoc->roff, "nS", 1, '=');
                   mdoc->flags |= MDOC_SYNOPSIS;
           } else {
                   roff_setreg(mdoc->roff, "nS", 0, '=');
                   mdoc->flags &= ~MDOC_SYNOPSIS;
         }          }
   
         sec = mdoc_atosec(buf);          /* Mark our last section. */
   
         /* The NAME section should always be first. */          mdoc->lastsec = sec;
   
         if (SEC_BODY == mdoc->lastnamed && SEC_NAME != sec)          /*
                 return(vwarn(mdoc, WSECOOO));           * Set the section attribute for the current HEAD, for its
         if (SEC_CUSTOM == sec)           * parent BLOCK, and for the HEAD children; the latter can
            * only be TEXT nodes, so no recursion is needed.
            * For other blocks and elements, including .Sh BODY, this is
            * done when allocating the node data structures, but for .Sh
            * BLOCK and HEAD, the section is still unknown at that time.
            */
   
           mdoc->last->parent->sec = sec;
           mdoc->last->sec = sec;
           for (n = mdoc->last->child; n; n = n->next)
                   n->sec = sec;
   
           /* We don't care about custom sections after this. */
   
           if (SEC_CUSTOM == sec) {
                   free(secname);
                 return(1);                  return(1);
           }
   
         /* Check for repeated or out-of-order sections. */          /*
            * Check whether our non-custom section is being repeated or is
            * out of order.
            */
   
         if (sec == mdoc->lastnamed)          if (sec == mdoc->lastnamed)
                 return(vwarn(mdoc, WSECREP));                  mandoc_vmsg(MANDOCERR_SEC_REP, mdoc->parse,
                       mdoc->last->line, mdoc->last->pos,
                       "Sh %s", secname);
   
         if (sec < mdoc->lastnamed)          if (sec < mdoc->lastnamed)
                 return(vwarn(mdoc, WSECOOO));                  mandoc_vmsg(MANDOCERR_SEC_ORDER, mdoc->parse,
                       mdoc->last->line, mdoc->last->pos,
                       "Sh %s", secname);
   
         /* Check particular section/manual section conventions. */          /* Mark the last named section. */
   
           mdoc->lastnamed = sec;
   
           /* Check particular section/manual conventions. */
   
           if (mdoc->meta.msec == NULL) {
                   free(secname);
                   return(1);
           }
   
           goodsec = NULL;
         switch (sec) {          switch (sec) {
         case (SEC_LIBRARY):          case SEC_ERRORS:
                 switch (mdoc->meta.msec) {                  if (*mdoc->meta.msec == '4')
                 case (2):  
                         /* FALLTHROUGH */  
                 case (3):  
                         break;                          break;
                 default:                  goodsec = "2, 3, 4, 9";
                         return(vwarn(mdoc, WWRONGMSEC));                  /* FALLTHROUGH */
                 }          case SEC_RETURN_VALUES:
                   /* FALLTHROUGH */
           case SEC_LIBRARY:
                   if (*mdoc->meta.msec == '2')
                           break;
                   if (*mdoc->meta.msec == '3')
                           break;
                   if (NULL == goodsec)
                           goodsec = "2, 3, 9";
                   /* FALLTHROUGH */
           case SEC_CONTEXT:
                   if (*mdoc->meta.msec == '9')
                           break;
                   if (NULL == goodsec)
                           goodsec = "9";
                   mandoc_vmsg(MANDOCERR_SEC_MSEC, mdoc->parse,
                       mdoc->last->line, mdoc->last->pos,
                       "Sh %s for %s only", secname, goodsec);
                 break;                  break;
         default:          default:
                 break;                  break;
         }          }
   
           free(secname);
         return(1);          return(1);
 }  }
   
   static int
   post_ignpar(POST_ARGS)
   {
           struct mdoc_node *np;
   
           hwarn_ge1(mdoc);
           post_hyph(mdoc);
   
           if (MDOC_BODY != mdoc->last->type)
                   return(1);
   
           if (NULL != (np = mdoc->last->child))
                   if (MDOC_Pp == np->tok || MDOC_Lp == np->tok) {
                           mandoc_vmsg(MANDOCERR_PAR_SKIP,
                               mdoc->parse, np->line, np->pos,
                               "%s after %s", mdoc_macronames[np->tok],
                               mdoc_macronames[mdoc->last->tok]);
                           mdoc_node_delete(mdoc, np);
                   }
   
           if (NULL != (np = mdoc->last->last))
                   if (MDOC_Pp == np->tok || MDOC_Lp == np->tok) {
                           mandoc_vmsg(MANDOCERR_PAR_SKIP, mdoc->parse,
                               np->line, np->pos, "%s at the end of %s",
                               mdoc_macronames[np->tok],
                               mdoc_macronames[mdoc->last->tok]);
                           mdoc_node_delete(mdoc, np);
                   }
   
           return(1);
   }
   
 static int  static int
 pre_fd(PRE_ARGS)  pre_par(PRE_ARGS)
 {  {
   
         return(check_sec(mdoc, n, SEC_SYNOPSIS, SEC_CUSTOM));          if (NULL == mdoc->last)
                   return(1);
           if (MDOC_ELEM != n->type && MDOC_BLOCK != n->type)
                   return(1);
   
           /*
            * Don't allow prior `Lp' or `Pp' prior to a paragraph-type
            * block:  `Lp', `Pp', or non-compact `Bd' or `Bl'.
            */
   
           if (MDOC_Pp != mdoc->last->tok &&
               MDOC_Lp != mdoc->last->tok &&
               MDOC_br != mdoc->last->tok)
                   return(1);
           if (MDOC_Bl == n->tok && n->norm->Bl.comp)
                   return(1);
           if (MDOC_Bd == n->tok && n->norm->Bd.comp)
                   return(1);
           if (MDOC_It == n->tok && n->parent->norm->Bl.comp)
                   return(1);
   
           mandoc_vmsg(MANDOCERR_PAR_SKIP, mdoc->parse,
               mdoc->last->line, mdoc->last->pos,
               "%s before %s", mdoc_macronames[mdoc->last->tok],
               mdoc_macronames[n->tok]);
           mdoc_node_delete(mdoc, mdoc->last);
           return(1);
   }
   
   static int
   post_par(POST_ARGS)
   {
           struct mdoc_node *np;
   
           if (mdoc->last->tok == MDOC_sp)
                   ewarn_le1(mdoc);
           else
                   ewarn_eq0(mdoc);
   
           if (MDOC_ELEM != mdoc->last->type &&
               MDOC_BLOCK != mdoc->last->type)
                   return(1);
   
           if (NULL == (np = mdoc->last->prev)) {
                   np = mdoc->last->parent;
                   if (MDOC_Sh != np->tok && MDOC_Ss != np->tok)
                           return(1);
           } else {
                   if (MDOC_Pp != np->tok && MDOC_Lp != np->tok &&
                       (MDOC_br != mdoc->last->tok ||
                        (MDOC_sp != np->tok && MDOC_br != np->tok)))
                           return(1);
           }
   
           mandoc_vmsg(MANDOCERR_PAR_SKIP, mdoc->parse,
               mdoc->last->line, mdoc->last->pos,
               "%s after %s", mdoc_macronames[mdoc->last->tok],
               mdoc_macronames[np->tok]);
           mdoc_node_delete(mdoc, mdoc->last);
           return(1);
   }
   
   static int
   pre_literal(PRE_ARGS)
   {
   
           pre_display(mdoc, n);
   
           if (MDOC_BODY != n->type)
                   return(1);
   
           /*
            * The `Dl' (note "el" not "one") and `Bd -literal' and `Bd
            * -unfilled' macros set MDOC_LITERAL on entrance to the body.
            */
   
           switch (n->tok) {
           case MDOC_Dl:
                   mdoc->flags |= MDOC_LITERAL;
                   break;
           case MDOC_Bd:
                   if (DISP_literal == n->norm->Bd.type)
                           mdoc->flags |= MDOC_LITERAL;
                   if (DISP_unfilled == n->norm->Bd.type)
                           mdoc->flags |= MDOC_LITERAL;
                   break;
           default:
                   abort();
                   /* NOTREACHED */
           }
   
           return(1);
   }
   
   static int
   post_dd(POST_ARGS)
   {
           struct mdoc_node *n;
           char             *datestr;
   
           if (mdoc->meta.date)
                   free(mdoc->meta.date);
   
           n = mdoc->last;
           if (NULL == n->child || '\0' == n->child->string[0]) {
                   mdoc->meta.date = mdoc->quick ? mandoc_strdup("") :
                       mandoc_normdate(mdoc->parse, NULL, n->line, n->pos);
                   goto out;
           }
   
           datestr = NULL;
           mdoc_deroff(&datestr, n);
           if (mdoc->quick)
                   mdoc->meta.date = datestr;
           else {
                   mdoc->meta.date = mandoc_normdate(mdoc->parse,
                       datestr, n->line, n->pos);
                   free(datestr);
           }
   out:
           mdoc_node_delete(mdoc, n);
           return(1);
   }
   
   static int
   post_dt(POST_ARGS)
   {
           struct mdoc_node *nn, *n;
           const char       *cp;
           char             *p;
   
           n = mdoc->last;
   
           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;
   
           /* First check that all characters are uppercase. */
   
           if (NULL != (nn = n->child))
                   for (p = nn->string; *p; p++) {
                           if (toupper((unsigned char)*p) == *p)
                                   continue;
                           mandoc_vmsg(MANDOCERR_TITLE_CASE,
                               mdoc->parse, nn->line,
                               nn->pos + (p - nn->string),
                               "Dt %s", nn->string);
                           break;
                   }
   
           /* No argument: msec and arch remain NULL. */
   
           if (NULL == (nn = n->child)) {
                   mandoc_msg(MANDOCERR_DT_NOTITLE,
                       mdoc->parse, n->line, n->pos, "Dt");
                   mdoc->meta.title = mandoc_strdup("UNTITLED");
                   mdoc->meta.vol = mandoc_strdup("LOCAL");
                   goto out;
           }
   
           /* One argument: msec and arch remain NULL. */
   
           mdoc->meta.title = mandoc_strdup(
               '\0' == nn->string[0] ? "UNTITLED" : nn->string);
   
           if (NULL == (nn = nn->next)) {
                   mandoc_vmsg(MANDOCERR_MSEC_MISSING,
                       mdoc->parse, n->line, n->pos,
                       "Dt %s", mdoc->meta.title);
                   mdoc->meta.vol = mandoc_strdup("LOCAL");
                   goto out;
           }
   
           /* Handles: `.Dt TITLE SEC'
            * title = TITLE,
            * volume = SEC is msec ? format(msec) : SEC,
            * msec = SEC is msec ? atoi(msec) : 0,
            * arch = NULL
            */
   
           cp = mandoc_a2msec(nn->string);
           if (cp) {
                   mdoc->meta.vol = mandoc_strdup(cp);
                   mdoc->meta.msec = mandoc_strdup(nn->string);
           } else {
                   mandoc_vmsg(MANDOCERR_MSEC_BAD, mdoc->parse,
                       nn->line, nn->pos, "Dt ... %s", nn->string);
                   mdoc->meta.vol = mandoc_strdup(nn->string);
                   mdoc->meta.msec = mandoc_strdup(nn->string);
           }
   
           if (NULL == (nn = nn->next))
                   goto out;
   
           /* Handles: `.Dt TITLE SEC VOL'
            * title = TITLE,
            * volume = VOL is vol ? format(VOL) :
            *          VOL is arch ? format(arch) :
            *          VOL
            */
   
           cp = mdoc_a2vol(nn->string);
           if (cp) {
                   free(mdoc->meta.vol);
                   mdoc->meta.vol = mandoc_strdup(cp);
           } else {
                   cp = mdoc_a2arch(nn->string);
                   if (NULL == cp) {
                           mandoc_vmsg(MANDOCERR_ARCH_BAD, mdoc->parse,
                               nn->line, nn->pos, "Dt ... %s", nn->string);
                           free(mdoc->meta.vol);
                           mdoc->meta.vol = mandoc_strdup(nn->string);
                   } else
                           mdoc->meta.arch = mandoc_strdup(cp);
           }
   
           /* Ignore any subsequent parameters... */
           /* FIXME: warn about subsequent parameters. */
   out:
           mdoc_node_delete(mdoc, n);
           return(1);
   }
   
   static int
   post_bx(POST_ARGS)
   {
           struct mdoc_node        *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.
            */
   
           n = mdoc->last->child;
           if (n && NULL != (n = n->next))
                   *n->string = (char)toupper((unsigned char)*n->string);
   
           return(1);
   }
   
   static int
   post_os(POST_ARGS)
   {
   #ifndef OSNAME
           struct utsname    utsname;
           static char      *defbuf;
   #endif
           struct mdoc_node *n;
   
           n = mdoc->last;
   
           /*
            * 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;
           mdoc_deroff(&mdoc->meta.os, n);
           if (mdoc->meta.os)
                   goto out;
   
           if (mdoc->defos) {
                   mdoc->meta.os = mandoc_strdup(mdoc->defos);
                   goto out;
           }
   
   #ifdef OSNAME
           mdoc->meta.os = mandoc_strdup(OSNAME);
   #else /*!OSNAME */
           if (NULL == defbuf) {
                   if (-1 == uname(&utsname)) {
                           mandoc_msg(MANDOCERR_OS_UNAME, mdoc->parse,
                               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:
           mdoc_node_delete(mdoc, n);
           return(1);
   }
   
   /*
    * If no argument is provided,
    * fill in the name of the current manual page.
    */
   static int
   post_ex(POST_ARGS)
   {
           struct mdoc_node *n;
   
           n = mdoc->last;
   
           if (n->child)
                   return(1);
   
           if (mdoc->meta.name == NULL) {
                   mandoc_msg(MANDOCERR_EX_NONAME, mdoc->parse,
                       n->line, n->pos, "Ex");
                   return(1);
           }
   
           mdoc->next = MDOC_NEXT_CHILD;
   
           if ( ! mdoc_word_alloc(mdoc, n->line, n->pos, mdoc->meta.name))
                   return(0);
   
           mdoc->last = n;
           return(1);
   }
   
   static enum mdoc_sec
   a2sec(const char *p)
   {
           int              i;
   
           for (i = 0; i < (int)SEC__MAX; i++)
                   if (secnames[i] && 0 == strcmp(p, secnames[i]))
                           return((enum mdoc_sec)i);
   
           return(SEC_CUSTOM);
   }
   
   static size_t
   macro2len(enum mdoct 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.7  
changed lines
  Added in v.1.248

CVSweb