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

Diff for /mandoc/term.c between version 1.51 and 1.236

version 1.51, 2009/03/09 14:19:59 version 1.236, 2014/11/21 01:52:53
Line 1 
Line 1 
 /* $Id$ */  /*      $Id$ */
 /*  /*
  * Copyright (c) 2009 Kristaps Dzonsons <kristaps@kth.se>   * Copyright (c) 2008, 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
    * Copyright (c) 2010-2014 Ingo Schwarze <schwarze@openbsd.org>
  *   *
  * Permission to use, copy, modify, and distribute this software for any   * Permission to use, copy, modify, and distribute this software for any
  * purpose with or without fee is hereby granted, provided that the   * purpose with or without fee is hereby granted, provided that the above
  * above copyright notice and this permission notice appear in all   * copyright notice and this permission notice appear in all copies.
  * copies.  
  *   *
  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL   * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED   * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE   * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL   * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR   * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER   * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR   * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  * PERFORMANCE OF THIS SOFTWARE.  
  */   */
   #include "config.h"
   
 #include <sys/types.h>  #include <sys/types.h>
   
 #include <assert.h>  #include <assert.h>
 #include <ctype.h>  #include <ctype.h>
 #include <err.h>  
 #include <stdio.h>  #include <stdio.h>
 #include <stdlib.h>  #include <stdlib.h>
 #include <string.h>  #include <string.h>
   
   #include "mandoc.h"
   #include "mandoc_aux.h"
   #include "out.h"
 #include "term.h"  #include "term.h"
   #include "main.h"
   
 /*  static  size_t           cond_width(const struct termp *, int, int *);
  * Performs actions on nodes of the abstract syntax tree.  Both pre- and  static  void             adjbuf(struct termp *p, size_t);
  * post-fix operations are defined here.  static  void             bufferc(struct termp *, char);
  */  static  void             encode(struct termp *, const char *, size_t);
   static  void             encode1(struct termp *, int);
   
 /* FIXME: macro arguments can be escaped. */  
   
 #define TTYPE_PROG        0  void
 #define TTYPE_CMD_FLAG    1  term_free(struct termp *p)
 #define TTYPE_CMD_ARG     2  
 #define TTYPE_SECTION     3  
 #define TTYPE_FUNC_DECL   4  
 #define TTYPE_VAR_DECL    5  
 #define TTYPE_FUNC_TYPE   6  
 #define TTYPE_FUNC_NAME   7  
 #define TTYPE_FUNC_ARG    8  
 #define TTYPE_LINK        9  
 #define TTYPE_SSECTION    10  
 #define TTYPE_FILE        11  
 #define TTYPE_EMPH        12  
 #define TTYPE_CONFIG      13  
 #define TTYPE_CMD         14  
 #define TTYPE_INCLUDE     15  
 #define TTYPE_SYMB        16  
 #define TTYPE_SYMBOL      17  
 #define TTYPE_DIAG        18  
 #define TTYPE_LINK_ANCHOR 19  
 #define TTYPE_LINK_TEXT   20  
 #define TTYPE_NMAX        21  
   
 /*  
  * These define "styles" for element types, like command arguments or  
  * executable names.  This is useful when multiple macros must decorate  
  * the same thing (like .Ex -std cmd and .Nm cmd).  
  */  
   
 /* TODO: abstract this into mdocterm.c. */  
   
 const   int ttypes[TTYPE_NMAX] = {  
         TERMP_BOLD,             /* TTYPE_PROG */  
         TERMP_BOLD,             /* TTYPE_CMD_FLAG */  
         TERMP_UNDERLINE,        /* TTYPE_CMD_ARG */  
         TERMP_BOLD,             /* TTYPE_SECTION */  
         TERMP_BOLD,             /* TTYPE_FUNC_DECL */  
         TERMP_UNDERLINE,        /* TTYPE_VAR_DECL */  
         TERMP_UNDERLINE,        /* TTYPE_FUNC_TYPE */  
         TERMP_BOLD,             /* TTYPE_FUNC_NAME */  
         TERMP_UNDERLINE,        /* TTYPE_FUNC_ARG */  
         TERMP_UNDERLINE,        /* TTYPE_LINK */  
         TERMP_BOLD,             /* TTYPE_SSECTION */  
         TERMP_UNDERLINE,        /* TTYPE_FILE */  
         TERMP_UNDERLINE,        /* TTYPE_EMPH */  
         TERMP_BOLD,             /* TTYPE_CONFIG */  
         TERMP_BOLD,             /* TTYPE_CMD */  
         TERMP_BOLD,             /* TTYPE_INCLUDE */  
         TERMP_BOLD,             /* TTYPE_SYMB */  
         TERMP_BOLD,             /* TTYPE_SYMBOL */  
         TERMP_BOLD,             /* TTYPE_DIAG */  
         TERMP_UNDERLINE,        /* TTYPE_LINK_ANCHOR */  
         TERMP_BOLD              /* TTYPE_LINK_TEXT */  
 };  
   
 static  int               arg_hasattr(int, const struct mdoc_node *);  
 static  int               arg_getattr(int, const struct mdoc_node *);  
 static  size_t            arg_offset(const struct mdoc_argv *);  
 static  size_t            arg_width(const struct mdoc_argv *);  
 static  int               arg_listtype(const struct mdoc_node *);  
   
 /*  
  * What follows describes prefix and postfix operations for the abstract  
  * syntax tree descent.  
  */  
   
 #define DECL_ARGS \  
         struct termp *p, \  
         struct termpair *pair, \  
         const struct mdoc_meta *meta, \  
         const struct mdoc_node *node  
   
 #define DECL_PRE(name) \  
 static  int               name##_pre(DECL_ARGS)  
 #define DECL_POST(name) \  
 static  void              name##_post(DECL_ARGS)  
 #define DECL_PREPOST(name) \  
 DECL_PRE(name); \  
 DECL_POST(name);  
   
 DECL_PREPOST(termp__t);  
 DECL_PREPOST(termp_aq);  
 DECL_PREPOST(termp_bd);  
 DECL_PREPOST(termp_bq);  
 DECL_PREPOST(termp_d1);  
 DECL_PREPOST(termp_dq);  
 DECL_PREPOST(termp_fd);  
 DECL_PREPOST(termp_fn);  
 DECL_PREPOST(termp_fo);  
 DECL_PREPOST(termp_ft);  
 DECL_PREPOST(termp_in);  
 DECL_PREPOST(termp_it);  
 DECL_PREPOST(termp_lb);  
 DECL_PREPOST(termp_op);  
 DECL_PREPOST(termp_pf);  
 DECL_PREPOST(termp_pq);  
 DECL_PREPOST(termp_qq);  
 DECL_PREPOST(termp_sh);  
 DECL_PREPOST(termp_ss);  
 DECL_PREPOST(termp_sq);  
 DECL_PREPOST(termp_vt);  
   
 DECL_PRE(termp_ap);  
 DECL_PRE(termp_ar);  
 DECL_PRE(termp_at);  
 DECL_PRE(termp_bf);  
 DECL_PRE(termp_bsx);  
 DECL_PRE(termp_bt);  
 DECL_PRE(termp_cd);  
 DECL_PRE(termp_cm);  
 DECL_PRE(termp_em);  
 DECL_PRE(termp_ex);  
 DECL_PRE(termp_fa);  
 DECL_PRE(termp_fl);  
 DECL_PRE(termp_fx);  
 DECL_PRE(termp_ic);  
 DECL_PRE(termp_lk);  
 DECL_PRE(termp_ms);  
 DECL_PRE(termp_mt);  
 DECL_PRE(termp_nd);  
 DECL_PRE(termp_nm);  
 DECL_PRE(termp_ns);  
 DECL_PRE(termp_nx);  
 DECL_PRE(termp_ox);  
 DECL_PRE(termp_pa);  
 DECL_PRE(termp_pp);  
 DECL_PRE(termp_rs);  
 DECL_PRE(termp_rv);  
 DECL_PRE(termp_sm);  
 DECL_PRE(termp_st);  
 DECL_PRE(termp_sx);  
 DECL_PRE(termp_sy);  
 DECL_PRE(termp_ud);  
 DECL_PRE(termp_ux);  
 DECL_PRE(termp_va);  
 DECL_PRE(termp_xr);  
   
 DECL_POST(termp___);  
 DECL_POST(termp_bl);  
 DECL_POST(termp_bx);  
   
 const   struct termact __termacts[MDOC_MAX] = {  
         { NULL, NULL }, /* \" */  
         { NULL, NULL }, /* Dd */  
         { NULL, NULL }, /* Dt */  
         { NULL, NULL }, /* Os */  
         { termp_sh_pre, termp_sh_post }, /* Sh */  
         { termp_ss_pre, termp_ss_post }, /* Ss */  
         { termp_pp_pre, NULL }, /* Pp */  
         { termp_d1_pre, termp_d1_post }, /* D1 */  
         { termp_d1_pre, termp_d1_post }, /* Dl */  
         { termp_bd_pre, termp_bd_post }, /* Bd */  
         { NULL, NULL }, /* Ed */  
         { NULL, termp_bl_post }, /* Bl */  
         { NULL, NULL }, /* El */  
         { termp_it_pre, termp_it_post }, /* It */  
         { NULL, NULL }, /* Ad */  
         { NULL, NULL }, /* An */  
         { termp_ar_pre, NULL }, /* Ar */  
         { termp_cd_pre, NULL }, /* Cd */  
         { termp_cm_pre, NULL }, /* Cm */  
         { NULL, NULL }, /* Dv */  
         { NULL, NULL }, /* Er */  
         { NULL, NULL }, /* Ev */  
         { termp_ex_pre, NULL }, /* Ex */  
         { termp_fa_pre, NULL }, /* Fa */  
         { termp_fd_pre, termp_fd_post }, /* Fd */  
         { termp_fl_pre, NULL }, /* Fl */  
         { termp_fn_pre, termp_fn_post }, /* Fn */  
         { termp_ft_pre, termp_ft_post }, /* Ft */  
         { termp_ic_pre, NULL }, /* Ic */  
         { termp_in_pre, termp_in_post }, /* In */  
         { NULL, NULL }, /* Li */  
         { termp_nd_pre, NULL }, /* Nd */  
         { termp_nm_pre, NULL }, /* Nm */  
         { termp_op_pre, termp_op_post }, /* Op */  
         { NULL, NULL }, /* Ot */  
         { termp_pa_pre, NULL }, /* Pa */  
         { termp_rv_pre, NULL }, /* Rv */  
         { termp_st_pre, NULL }, /* St */  
         { termp_va_pre, NULL }, /* Va */  
         { termp_vt_pre, termp_vt_post }, /* Vt */  
         { termp_xr_pre, NULL }, /* Xr */  
         { NULL, termp____post }, /* %A */  
         { NULL, termp____post }, /* %B */  
         { NULL, termp____post }, /* %D */  
         { NULL, termp____post }, /* %I */  
         { NULL, termp____post }, /* %J */  
         { NULL, termp____post }, /* %N */  
         { NULL, termp____post }, /* %O */  
         { NULL, termp____post }, /* %P */  
         { NULL, termp____post }, /* %R */  
         { termp__t_pre, termp__t_post }, /* %T */  
         { NULL, termp____post }, /* %V */  
         { NULL, NULL }, /* Ac */  
         { termp_aq_pre, termp_aq_post }, /* Ao */  
         { termp_aq_pre, termp_aq_post }, /* Aq */  
         { termp_at_pre, NULL }, /* At */  
         { NULL, NULL }, /* Bc */  
         { termp_bf_pre, NULL }, /* Bf */  
         { termp_bq_pre, termp_bq_post }, /* Bo */  
         { termp_bq_pre, termp_bq_post }, /* Bq */  
         { termp_bsx_pre, NULL }, /* Bsx */  
         { NULL, termp_bx_post }, /* Bx */  
         { NULL, NULL }, /* Db */  
         { NULL, NULL }, /* Dc */  
         { termp_dq_pre, termp_dq_post }, /* Do */  
         { termp_dq_pre, termp_dq_post }, /* Dq */  
         { NULL, NULL }, /* Ec */  
         { NULL, NULL }, /* Ef */  
         { termp_em_pre, NULL }, /* Em */  
         { NULL, NULL }, /* Eo */  
         { termp_fx_pre, NULL }, /* Fx */  
         { termp_ms_pre, NULL }, /* Ms */  
         { NULL, NULL }, /* No */  
         { termp_ns_pre, NULL }, /* Ns */  
         { termp_nx_pre, NULL }, /* Nx */  
         { termp_ox_pre, NULL }, /* Ox */  
         { NULL, NULL }, /* Pc */  
         { termp_pf_pre, termp_pf_post }, /* Pf */  
         { termp_pq_pre, termp_pq_post }, /* Po */  
         { termp_pq_pre, termp_pq_post }, /* Pq */  
         { NULL, NULL }, /* Qc */  
         { termp_sq_pre, termp_sq_post }, /* Ql */  
         { termp_qq_pre, termp_qq_post }, /* Qo */  
         { termp_qq_pre, termp_qq_post }, /* Qq */  
         { NULL, NULL }, /* Re */  
         { termp_rs_pre, NULL }, /* Rs */  
         { NULL, NULL }, /* Sc */  
         { termp_sq_pre, termp_sq_post }, /* So */  
         { termp_sq_pre, termp_sq_post }, /* Sq */  
         { termp_sm_pre, NULL }, /* Sm */  
         { termp_sx_pre, NULL }, /* Sx */  
         { termp_sy_pre, NULL }, /* Sy */  
         { NULL, NULL }, /* Tn */  
         { termp_ux_pre, NULL }, /* Ux */  
         { NULL, NULL }, /* Xc */  
         { NULL, NULL }, /* Xo */  
         { termp_fo_pre, termp_fo_post }, /* Fo */  
         { NULL, NULL }, /* Fc */  
         { termp_op_pre, termp_op_post }, /* Oo */  
         { NULL, NULL }, /* Oc */  
         { NULL, NULL }, /* Bk */  
         { NULL, NULL }, /* Ek */  
         { termp_bt_pre, NULL }, /* Bt */  
         { NULL, NULL }, /* Hf */  
         { NULL, NULL }, /* Fr */  
         { termp_ud_pre, NULL }, /* Ud */  
         { termp_lb_pre, termp_lb_post }, /* Lb */  
         { termp_ap_pre, NULL }, /* Lb */  
         { termp_pp_pre, NULL }, /* Pp */  
         { termp_lk_pre, NULL }, /* Lk */  
         { termp_mt_pre, NULL }, /* Mt */  
 };  
   
 const struct termact *termacts = __termacts;  
   
   
 static size_t  
 arg_width(const struct mdoc_argv *arg)  
 {  {
         size_t           v;  
         int              i, len;  
   
         assert(*arg->value);          free(p->buf);
         if (0 == strcmp(*arg->value, "indent"))          free(p);
                 return(INDENT);  
         if (0 == strcmp(*arg->value, "indent-two"))  
                 return(INDENT * 2);  
   
         len = (int)strlen(*arg->value);  
         assert(len > 0);  
   
         for (i = 0; i < len - 1; i++)  
                 if ( ! isdigit((u_char)(*arg->value)[i]))  
                         break;  
   
         if (i == len - 1) {  
                 if ('n' == (*arg->value)[len - 1]) {  
                         v = (size_t)atoi(*arg->value);  
                         return(v);  
                 }  
   
         }  
         return(strlen(*arg->value) + 1);  
 }  }
   
   void
 static int  term_begin(struct termp *p, term_margin head,
 arg_listtype(const struct mdoc_node *n)                  term_margin foot, const void *arg)
 {  {
         int              i, len;  
   
         assert(MDOC_BLOCK == n->type);          p->headf = head;
           p->footf = foot;
         len = (int)(n->args ? n->args->argc : 0);          p->argf = arg;
           (*p->begin)(p);
         for (i = 0; i < len; i++)  
                 switch (n->args->argv[i].arg) {  
                 case (MDOC_Bullet):  
                         /* FALLTHROUGH */  
                 case (MDOC_Dash):  
                         /* FALLTHROUGH */  
                 case (MDOC_Enum):  
                         /* FALLTHROUGH */  
                 case (MDOC_Hyphen):  
                         /* FALLTHROUGH */  
                 case (MDOC_Tag):  
                         /* FALLTHROUGH */  
                 case (MDOC_Inset):  
                         /* FALLTHROUGH */  
                 case (MDOC_Diag):  
                         /* FALLTHROUGH */  
                 case (MDOC_Item):  
                         /* FALLTHROUGH */  
                 case (MDOC_Ohang):  
                         return(n->args->argv[i].arg);  
                 default:  
                         break;  
                 }  
   
         errx(1, "list type not supported");  
         /* NOTREACHED */  
 }  }
   
   void
 static size_t  term_end(struct termp *p)
 arg_offset(const struct mdoc_argv *arg)  
 {  {
   
         /* TODO */          (*p->end)(p);
         assert(*arg->value);  
         if (0 == strcmp(*arg->value, "indent"))  
                 return(INDENT);  
         if (0 == strcmp(*arg->value, "indent-two"))  
                 return(INDENT * 2);  
         return(strlen(*arg->value));  
 }  }
   
   /*
 static int   * Flush a chunk of text.  By default, break the output line each time
 arg_hasattr(int arg, const struct mdoc_node *n)   * the right margin is reached, and continue output on the next line
    * at the same offset as the chunk itself.  By default, also break the
    * output line at the end of the chunk.
    * The following flags may be specified:
    *
    *  - TERMP_NOBREAK: Do not break the output line at the right margin,
    *    but only at the max right margin.  Also, do not break the output
    *    line at the end of the chunk, such that the next call can pad to
    *    the next column.  However, if less than p->trailspace blanks,
    *    which can be 0, 1, or 2, remain to the right margin, the line
    *    will be broken.
    *  - TERMP_BRIND: If the chunk does not fit and the output line has
    *    to be broken, start the next line at the right margin instead
    *    of at the offset.  Used together with TERMP_NOBREAK for the tags
    *    in various kinds of tagged lists.
    *  - TERMP_DANGLE: Do not break the output line at the right margin,
    *    append the next chunk after it even if this one is too long.
    *    To be used together with TERMP_NOBREAK.
    *  - TERMP_HANG: Like TERMP_DANGLE, and also suppress padding before
    *    the next chunk if this column is not full.
    */
   void
   term_flushln(struct termp *p)
 {  {
           size_t           i;     /* current input position in p->buf */
           int              ntab;  /* number of tabs to prepend */
           size_t           vis;   /* current visual position on output */
           size_t           vbl;   /* number of blanks to prepend to output */
           size_t           vend;  /* end of word visual position on output */
           size_t           bp;    /* visual right border position */
           size_t           dv;    /* temporary for visual pos calculations */
           size_t           j;     /* temporary loop index for p->buf */
           size_t           jhy;   /* last hyph before overflow w/r/t j */
           size_t           maxvis; /* output position of visible boundary */
           size_t           rmargin; /* the rightmost of the two margins */
   
         return(-1 != arg_getattr(arg, n));          /*
 }           * First, establish the maximum columns of "visible" content.
            * This is usually the difference between the right-margin and
            * an indentation, but can be, for tagged lists or columns, a
            * small set of values.
            *
            * The following unsigned-signed subtractions look strange,
            * but they are actually correct.  If the int p->overstep
            * is negative, it gets sign extended.  Subtracting that
            * very large size_t effectively adds a small number to dv.
            */
           rmargin = p->rmargin > p->offset ? p->rmargin : p->offset;
           dv = p->rmargin - p->offset;
           maxvis = (int)dv > p->overstep ? dv - (size_t)p->overstep : 0;
   
           if (p->flags & TERMP_NOBREAK) {
                   dv = p->maxrmargin > p->offset ?
                        p->maxrmargin - p->offset : 0;
                   bp = (int)dv > p->overstep ?
                        dv - (size_t)p->overstep : 0;
           } else
                   bp = maxvis;
   
 static int          /*
 arg_getattr(int arg, const struct mdoc_node *n)           * Calculate the required amount of padding.
 {           */
         int              i;          vbl = p->offset + p->overstep > p->viscol ?
                 p->offset + p->overstep - p->viscol : 0;
   
         if (NULL == n->args)          vis = vend = 0;
                 return(-1);          i = 0;
         for (i = 0; i < (int)n->args->argc; i++)  
                 if (n->args->argv[i].arg == arg)  
                         return(i);  
         return(-1);  
 }  
   
           while (i < p->col) {
                   /*
                    * Handle literal tab characters: collapse all
                    * subsequent tabs into a single huge set of spaces.
                    */
                   ntab = 0;
                   while (i < p->col && '\t' == p->buf[i]) {
                           vend = (vis / p->tabwidth + 1) * p->tabwidth;
                           vbl += vend - vis;
                           vis = vend;
                           ntab++;
                           i++;
                   }
   
 /* ARGSUSED */                  /*
 static int                   * Count up visible word characters.  Control sequences
 termp_dq_pre(DECL_ARGS)                   * (starting with the CSI) aren't counted.  A space
 {                   * generates a non-printing word, which is valid (the
                    * space is printed according to regular spacing rules).
                    */
   
         if (MDOC_BODY != node->type)                  for (j = i, jhy = 0; j < p->col; j++) {
                 return(1);                          if (' ' == p->buf[j] || '\t' == p->buf[j])
                                   break;
   
         word(p, "``");                          /* Back over the the last printed character. */
         p->flags |= TERMP_NOSPACE;                          if (8 == p->buf[j]) {
         return(1);                                  assert(j);
 }                                  vend -= (*p->width)(p, p->buf[j - 1]);
                                   continue;
                           }
   
                           /* Regular word. */
                           /* Break at the hyphen point if we overrun. */
                           if (vend > vis && vend < bp &&
                               (ASCII_HYPH == p->buf[j] ||
                                ASCII_BREAK == p->buf[j]))
                                   jhy = j;
   
 /* ARGSUSED */                          /*
 static void                           * Hyphenation now decided, put back a real
 termp_dq_post(DECL_ARGS)                           * hyphen such that we get the correct width.
 {                           */
                           if (ASCII_HYPH == p->buf[j])
                                   p->buf[j] = '-';
   
         if (MDOC_BODY != node->type)                          vend += (*p->width)(p, p->buf[j]);
                 return;                  }
   
         p->flags |= TERMP_NOSPACE;                  /*
         word(p, "''");                   * Find out whether we would exceed the right margin.
 }                   * If so, break to the next line.
                    */
                   if (vend > bp && 0 == jhy && vis > 0) {
                           vend -= vis;
                           (*p->endline)(p);
                           p->viscol = 0;
                           if (TERMP_BRIND & p->flags) {
                                   vbl = rmargin;
                                   vend += rmargin - p->offset;
                           } else
                                   vbl = p->offset;
   
                           /* use pending tabs on the new line */
   
 /* ARGSUSED */                          if (0 < ntab)
 static int                                  vbl += ntab * p->tabwidth;
 termp_it_pre_block(DECL_ARGS)  
 {  
   
         newln(p);                          /*
         if ( ! arg_hasattr(MDOC_Compact, node->parent->parent))                           * Remove the p->overstep width.
                 if (node->prev || node->parent->parent->prev)                           * Again, if p->overstep is negative,
                         vspace(p);                           * sign extension does the right thing.
                            */
   
         return(1);                          bp += (size_t)p->overstep;
 }                          p->overstep = 0;
                   }
   
                   /* Write out the [remaining] word. */
                   for ( ; i < p->col; i++) {
                           if (vend > bp && jhy > 0 && i > jhy)
                                   break;
                           if ('\t' == p->buf[i])
                                   break;
                           if (' ' == p->buf[i]) {
                                   j = i;
                                   while (i < p->col && ' ' == p->buf[i])
                                           i++;
                                   dv = (i - j) * (*p->width)(p, ' ');
                                   vbl += dv;
                                   vend += dv;
                                   break;
                           }
                           if (ASCII_NBRSP == p->buf[i]) {
                                   vbl += (*p->width)(p, ' ');
                                   continue;
                           }
                           if (ASCII_BREAK == p->buf[i])
                                   continue;
   
 /* ARGSUSED */                          /*
 static int                           * Now we definitely know there will be
 termp_it_pre(DECL_ARGS)                           * printable characters to output,
 {                           * so write preceding white space now.
         const struct mdoc_node *bl;                           */
         char             buf[7];                          if (vbl) {
         int              i, type;                                  (*p->advance)(p, vbl);
         size_t           width, offset;                                  p->viscol += vbl;
                                   vbl = 0;
                           }
   
         if (MDOC_BLOCK == node->type)                          (*p->letter)(p, p->buf[i]);
                 return(termp_it_pre_block(p, pair, meta, node));                          if (8 == p->buf[i])
                                   p->viscol -= (*p->width)(p, p->buf[i-1]);
         /* Get ptr to list block, type, etc. */                          else
                                   p->viscol += (*p->width)(p, p->buf[i]);
         bl = node->parent->parent->parent;                  }
         type = arg_listtype(bl);                  vis = vend;
   
         /* Save parent attributes. */  
   
         pair->offset = p->offset;  
         pair->rmargin = p->rmargin;  
         pair->flag = p->flags;  
   
         /* Get list width and offset. */  
   
         i = arg_getattr(MDOC_Width, bl);  
         width = i >= 0 ? arg_width(&bl->args->argv[i]) : 0;  
   
         i = arg_getattr(MDOC_Offset, bl);  
         offset = i >= 0 ? arg_offset(&bl->args->argv[i]) : 0;  
   
         /*  
          * List-type can override the width in the case of fixed-head  
          * values (bullet, dash/hyphen, enum).  Tags need a non-zero  
          * offset.  
          */  
   
         switch (type) {  
         case (MDOC_Bullet):  
                 /* FALLTHROUGH */  
         case (MDOC_Dash):  
                 /* FALLTHROUGH */  
         case (MDOC_Enum):  
                 /* FALLTHROUGH */  
         case (MDOC_Hyphen):  
                 width = width > 4 ? width : 4;  
                 break;  
         case (MDOC_Tag):  
                 if (width)  
                         break;  
                 errx(1, "need non-zero %s for list type",  
                                 mdoc_argnames[MDOC_Width]);  
         default:  
                 break;  
         }          }
   
         /*  
          * Whitespace control.  Inset bodies need an initial space.  
          */  
   
         switch (type) {  
         case (MDOC_Diag):  
                 /* FALLTHROUGH */  
         case (MDOC_Inset):  
                 if (MDOC_BODY == node->type)  
                         p->flags &= ~TERMP_NOSPACE;  
                 else  
                         p->flags |= TERMP_NOSPACE;  
                 break;  
         default:  
                 p->flags |= TERMP_NOSPACE;  
                 break;  
         }  
   
         /*          /*
          * Style flags.  Diagnostic heads need TTYPE_DIAG.           * If there was trailing white space, it was not printed;
            * so reset the cursor position accordingly.
          */           */
           if (vis > vbl)
                   vis -= vbl;
           else
                   vis = 0;
   
         switch (type) {          p->col = 0;
         case (MDOC_Diag):          p->overstep = 0;
                 if (MDOC_HEAD == node->type)  
                         p->flags |= ttypes[TTYPE_DIAG];  
                 break;  
         default:  
                 break;  
         }  
   
         /*          if ( ! (TERMP_NOBREAK & p->flags)) {
          * Pad and break control.  This is the tricker part.  Lists with                  p->viscol = 0;
          * set right-margins for the head get TERMP_NOBREAK because, if                  (*p->endline)(p);
          * they overrun the margin, they wrap to the new margin.                  return;
          * Correspondingly, the body for these types don't left-pad, as  
          * the head will pad out to to the right.  
          */  
   
         switch (type) {  
         case (MDOC_Bullet):  
                 /* FALLTHROUGH */  
         case (MDOC_Dash):  
                 /* FALLTHROUGH */  
         case (MDOC_Enum):  
                 /* FALLTHROUGH */  
         case (MDOC_Hyphen):  
                 /* FALLTHROUGH */  
         case (MDOC_Tag):  
                 if (MDOC_HEAD == node->type)  
                         p->flags |= TERMP_NOBREAK;  
                 else  
                         p->flags |= TERMP_NOLPAD;  
                 if (MDOC_HEAD == node->type && MDOC_Tag == type)  
                         if (NULL == node->next ||  
                                         NULL == node->next->child)  
                                 p->flags |= TERMP_NONOBREAK;  
                 break;  
         case (MDOC_Diag):  
                 if (MDOC_HEAD == node->type)  
                         p->flags |= TERMP_NOBREAK;  
                 break;  
         default:  
                 break;  
         }          }
   
         /*          if (TERMP_HANG & p->flags) {
          * Margin control.  Set-head-width lists have their right                  p->overstep = (int)(vis - maxvis +
          * margins shortened.  The body for these lists has the offset                      p->trailspace * (*p->width)(p, ' '));
          * necessarily lengthened.  Everybody gets the offset.  
          */  
   
         p->offset += offset;                  /*
                    * If we have overstepped the margin, temporarily move
                    * it to the right and flag the rest of the line to be
                    * shorter.
                    * If there is a request to keep the columns together,
                    * allow negative overstep when the column is not full.
                    */
                   if (p->trailspace && p->overstep < 0)
                           p->overstep = 0;
                   return;
   
         switch (type) {          } else if (TERMP_DANGLE & p->flags)
         case (MDOC_Bullet):  
                 /* FALLTHROUGH */  
         case (MDOC_Dash):  
                 /* FALLTHROUGH */  
         case (MDOC_Enum):  
                 /* FALLTHROUGH */  
         case (MDOC_Hyphen):  
                 /* FALLTHROUGH */  
         case (MDOC_Tag):  
                 if (MDOC_HEAD == node->type)  
                         p->rmargin = p->offset + width;  
                 else  
                         p->offset += width;  
                 /* FALLTHROUGH */  
         default:  
                 break;  
         }  
   
         /*  
          * The dash, hyphen, bullet and enum lists all have a special  
          * HEAD character.  Print it now.  
          */  
   
         if (MDOC_HEAD == node->type)  
                 switch (type) {  
                 case (MDOC_Bullet):  
                         word(p, "\\[bu]");  
                         break;  
                 case (MDOC_Dash):  
                         /* FALLTHROUGH */  
                 case (MDOC_Hyphen):  
                         word(p, "\\-");  
                         break;  
                 case (MDOC_Enum):  
                         /* TODO: have a wordfmt or something. */  
                         (pair->ppair->ppair->count)++;  
                         (void)snprintf(buf, sizeof(buf), "%d.",  
                                         pair->ppair->ppair->count);  
                         word(p, buf);  
                         break;  
                 default:  
                         break;  
                 }  
   
         /*  
          * If we're not going to process our header children, indicate  
          * so here.  
          */  
   
         if (MDOC_HEAD == node->type)  
                 switch (type) {  
                 case (MDOC_Bullet):  
                         /* FALLTHROUGH */  
                 case (MDOC_Item):  
                         /* FALLTHROUGH */  
                 case (MDOC_Dash):  
                         /* FALLTHROUGH */  
                 case (MDOC_Hyphen):  
                         /* FALLTHROUGH */  
                 case (MDOC_Enum):  
                         return(0);  
                 default:  
                         break;  
         }  
   
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static void  
 termp_it_post(DECL_ARGS)  
 {  
         int                type;  
   
         if (MDOC_BODY != node->type && MDOC_HEAD != node->type)  
                 return;                  return;
   
         type = arg_listtype(node->parent->parent->parent);          /* If the column was overrun, break the line. */
           if (maxvis < vis + p->trailspace * (*p->width)(p, ' ')) {
         switch (type) {                  (*p->endline)(p);
         case (MDOC_Diag):                  p->viscol = 0;
                 /* FALLTHROUGH */  
         case (MDOC_Item):  
                 /* FALLTHROUGH */  
         case (MDOC_Inset):  
                 if (MDOC_BODY != node->type)  
                         break;  
                 flushln(p);  
                 break;  
         default:  
                 flushln(p);  
                 break;  
         }          }
   
         p->offset = pair->offset;  
         p->rmargin = pair->rmargin;  
         p->flags = pair->flag;  
 }  }
   
   /*
 /* ARGSUSED */   * A newline only breaks an existing line; it won't assert vertical
 static int   * space.  All data in the output buffer is flushed prior to the newline
 termp_nm_pre(DECL_ARGS)   * assertion.
    */
   void
   term_newln(struct termp *p)
 {  {
   
         if (SEC_SYNOPSIS == node->sec)  
                 newln(p);  
   
         TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_PROG]);  
         if (NULL == node->child)  
                 word(p, meta->name);  
   
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_fl_pre(DECL_ARGS)  
 {  
   
         TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_CMD_FLAG]);  
         word(p, "\\-");  
         p->flags |= TERMP_NOSPACE;          p->flags |= TERMP_NOSPACE;
         return(1);          if (p->col || p->viscol)
                   term_flushln(p);
 }  }
   
   /*
 /* ARGSUSED */   * Asserts a vertical space (a full, empty line-break between lines).
 static int   * Note that if used twice, this will cause two blank spaces and so on.
 termp_ar_pre(DECL_ARGS)   * All data in the output buffer is flushed prior to the newline
    * assertion.
    */
   void
   term_vspace(struct termp *p)
 {  {
   
         TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_CMD_ARG]);          term_newln(p);
         return(1);          p->viscol = 0;
           if (0 < p->skipvsp)
                   p->skipvsp--;
           else
                   (*p->endline)(p);
 }  }
   
   void
 /* ARGSUSED */  term_fontlast(struct termp *p)
 static int  
 termp_ns_pre(DECL_ARGS)  
 {  {
           enum termfont    f;
   
         p->flags |= TERMP_NOSPACE;          f = p->fontl;
         return(1);          p->fontl = p->fontq[p->fonti];
           p->fontq[p->fonti] = f;
 }  }
   
   void
 /* ARGSUSED */  term_fontrepl(struct termp *p, enum termfont f)
 static int  
 termp_pp_pre(DECL_ARGS)  
 {  {
   
         vspace(p);          p->fontl = p->fontq[p->fonti];
         return(1);          p->fontq[p->fonti] = f;
 }  }
   
   void
 /* ARGSUSED */  term_fontpush(struct termp *p, enum termfont f)
 static int  
 termp_st_pre(DECL_ARGS)  
 {  {
         const char      *cp;  
   
         if (node->child) {          assert(p->fonti + 1 < 10);
                 if (MDOC_TEXT != node->child->type)          p->fontl = p->fontq[p->fonti];
                         errx(1, "expected text line arguments");          p->fontq[++p->fonti] = f;
                 if ((cp = mdoc_a2st(node->child->string)))  
                         word(p, cp);  
         }  
         return(0);  
 }  }
   
   const void *
 /* ARGSUSED */  term_fontq(struct termp *p)
 static int  
 termp_rs_pre(DECL_ARGS)  
 {  {
   
         if (MDOC_BLOCK == node->type && node->prev)          return(&p->fontq[p->fonti]);
                 vspace(p);  
         return(1);  
 }  }
   
   enum termfont
 /* ARGSUSED */  term_fonttop(struct termp *p)
 static int  
 termp_rv_pre(DECL_ARGS)  
 {  {
         int              i;  
   
         if (-1 == (i = arg_getattr(MDOC_Std, node)))          return(p->fontq[p->fonti]);
                 errx(1, "expected -std argument");  
         if (1 != node->args->argv[i].sz)  
                 errx(1, "expected -std argument");  
   
         newln(p);  
         word(p, "The");  
   
         p->flags |= ttypes[TTYPE_FUNC_NAME];  
         word(p, *node->args->argv[i].value);  
         p->flags &= ~ttypes[TTYPE_FUNC_NAME];  
   
         word(p, "() function returns the value 0 if successful;");  
         word(p, "otherwise the value -1 is returned and the");  
         word(p, "global variable");  
   
         p->flags |= ttypes[TTYPE_VAR_DECL];  
         word(p, "errno");  
         p->flags &= ~ttypes[TTYPE_VAR_DECL];  
   
         word(p, "is set to indicate the error.");  
   
         return(1);  
 }  }
   
   void
 /* ARGSUSED */  term_fontpopq(struct termp *p, const void *key)
 static int  
 termp_ex_pre(DECL_ARGS)  
 {  {
         int              i;  
   
         if (-1 == (i = arg_getattr(MDOC_Std, node)))          while (p->fonti >= 0 && key < (void *)(p->fontq + p->fonti))
                 errx(1, "expected -std argument");                  p->fonti--;
         if (1 != node->args->argv[i].sz)          assert(p->fonti >= 0);
                 errx(1, "expected -std argument");  
   
         word(p, "The");  
         p->flags |= ttypes[TTYPE_PROG];  
         word(p, *node->args->argv[i].value);  
         p->flags &= ~ttypes[TTYPE_PROG];  
         word(p, "utility exits 0 on success, and >0 if an error occurs.");  
   
         return(1);  
 }  }
   
   void
 /* ARGSUSED */  term_fontpop(struct termp *p)
 static int  
 termp_nd_pre(DECL_ARGS)  
 {  {
   
         word(p, "\\-");          assert(p->fonti);
         return(1);          p->fonti--;
 }  }
   
   /*
 /* ARGSUSED */   * Handle pwords, partial words, which may be either a single word or a
 static void   * phrase that cannot be broken down (such as a literal string).  This
 termp_bl_post(DECL_ARGS)   * handles word styling.
    */
   void
   term_word(struct termp *p, const char *word)
 {  {
           const char       nbrsp[2] = { ASCII_NBRSP, 0 };
           const char      *seq, *cp;
           int              sz, uc;
           size_t           ssz;
           enum mandoc_esc  esc;
   
         if (MDOC_BLOCK == node->type)          if ( ! (TERMP_NOSPACE & p->flags)) {
                 newln(p);                  if ( ! (TERMP_KEEP & p->flags)) {
 }                          bufferc(p, ' ');
                           if (TERMP_SENTENCE & p->flags)
                                   bufferc(p, ' ');
                   } else
                           bufferc(p, ASCII_NBRSP);
           }
           if (TERMP_PREKEEP & p->flags)
                   p->flags |= TERMP_KEEP;
   
           if ( ! (p->flags & TERMP_NONOSPACE))
                   p->flags &= ~TERMP_NOSPACE;
           else
                   p->flags |= TERMP_NOSPACE;
   
 /* ARGSUSED */          p->flags &= ~TERMP_SENTENCE;
 static void  
 termp_op_post(DECL_ARGS)  
 {  
   
         if (MDOC_BODY != node->type)          while ('\0' != *word) {
                 return;                  if ('\\' != *word) {
         p->flags |= TERMP_NOSPACE;                          if (TERMP_SKIPCHAR & p->flags) {
         word(p, "\\(rB");                                  p->flags &= ~TERMP_SKIPCHAR;
 }                                  word++;
                                   continue;
                           }
                           if (TERMP_NBRWORD & p->flags) {
                                   if (' ' == *word) {
                                           encode(p, nbrsp, 1);
                                           word++;
                                           continue;
                                   }
                                   ssz = strcspn(word, "\\ ");
                           } else
                                   ssz = strcspn(word, "\\");
                           encode(p, word, ssz);
                           word += (int)ssz;
                           continue;
                   }
   
                   word++;
                   esc = mandoc_escape(&word, &seq, &sz);
                   if (ESCAPE_ERROR == esc)
                           continue;
   
 /* ARGSUSED */                  switch (esc) {
 static int                  case ESCAPE_UNICODE:
 termp_xr_pre(DECL_ARGS)                          uc = mchars_num2uc(seq + 1, sz - 1);
 {                          break;
         const struct mdoc_node *n;                  case ESCAPE_NUMBERED:
                           uc = mchars_num2char(seq, sz);
                           if (uc < 0)
                                   continue;
                           break;
                   case ESCAPE_SPECIAL:
                           if (p->enc == TERMENC_ASCII) {
                                   cp = mchars_spec2str(p->symtab,
                                       seq, sz, &ssz);
                                   if (cp != NULL)
                                           encode(p, cp, ssz);
                           } else {
                                   uc = mchars_spec2cp(p->symtab, seq, sz);
                                   if (uc > 0)
                                           encode1(p, uc);
                           }
                           continue;
                   case ESCAPE_FONTBOLD:
                           term_fontrepl(p, TERMFONT_BOLD);
                           continue;
                   case ESCAPE_FONTITALIC:
                           term_fontrepl(p, TERMFONT_UNDER);
                           continue;
                   case ESCAPE_FONTBI:
                           term_fontrepl(p, TERMFONT_BI);
                           continue;
                   case ESCAPE_FONT:
                           /* FALLTHROUGH */
                   case ESCAPE_FONTROMAN:
                           term_fontrepl(p, TERMFONT_NONE);
                           continue;
                   case ESCAPE_FONTPREV:
                           term_fontlast(p);
                           continue;
                   case ESCAPE_NOSPACE:
                           if (TERMP_SKIPCHAR & p->flags)
                                   p->flags &= ~TERMP_SKIPCHAR;
                           else if ('\0' == *word)
                                   p->flags |= TERMP_NOSPACE;
                           continue;
                   case ESCAPE_SKIPCHAR:
                           p->flags |= TERMP_SKIPCHAR;
                           continue;
                   default:
                           continue;
                   }
   
         if (NULL == (n = node->child))                  /*
                 errx(1, "expected text line argument");                   * Common handling for Unicode and numbered
         if (MDOC_TEXT != n->type)                   * character escape sequences.
                 errx(1, "expected text line argument");                   */
   
         word(p, n->string);                  if (p->enc == TERMENC_ASCII) {
                           cp = ascii_uc2str(uc);
         if (NULL == (n = n->next))                          encode(p, cp, strlen(cp));
                 return(0);                  } else {
         if (MDOC_TEXT != n->type)                          if ((uc < 0x20 && uc != 0x09) ||
                 errx(1, "expected text line argument");                              (uc > 0x7E && uc < 0xA0))
                                   uc = 0xFFFD;
         p->flags |= TERMP_NOSPACE;                          encode1(p, uc);
         word(p, "(");                  }
         p->flags |= TERMP_NOSPACE;          }
         word(p, n->string);          p->flags &= ~TERMP_NBRWORD;
         p->flags |= TERMP_NOSPACE;  
         word(p, ")");  
   
         return(0);  
 }  }
   
   
 /* ARGSUSED */  
 static int  
 termp_vt_pre(DECL_ARGS)  
 {  
   
         /* FIXME: this can be "type name". */  
         TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_VAR_DECL]);  
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static void  static void
 termp_vt_post(DECL_ARGS)  adjbuf(struct termp *p, size_t sz)
 {  {
   
         if (node->sec == SEC_SYNOPSIS)          if (0 == p->maxcols)
                 vspace(p);                  p->maxcols = 1024;
 }          while (sz >= p->maxcols)
                   p->maxcols <<= 2;
   
           p->buf = mandoc_reallocarray(p->buf, p->maxcols, sizeof(int));
 /* ARGSUSED */  
 static int  
 termp_fd_pre(DECL_ARGS)  
 {  
   
         /*  
          * FIXME: this naming is bad.  This value is used, in general,  
          * for the #include header or other preprocessor statement.  
          */  
         TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_FUNC_DECL]);  
         return(1);  
 }  }
   
   
 /* ARGSUSED */  
 static void  static void
 termp_fd_post(DECL_ARGS)  bufferc(struct termp *p, char c)
 {  {
   
         if (node->sec != SEC_SYNOPSIS)          if (p->col + 1 >= p->maxcols)
                 return;                  adjbuf(p, p->col + 1);
         newln(p);  
         if (node->next && MDOC_Fd != node->next->tok)  
                 vspace(p);  
 }  
   
           p->buf[p->col++] = c;
 /* ARGSUSED */  
 static int  
 termp_sh_pre(DECL_ARGS)  
 {  
   
         switch (node->type) {  
         case (MDOC_HEAD):  
                 vspace(p);  
                 TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_SECTION]);  
                 break;  
         case (MDOC_BODY):  
                 p->offset = INDENT;  
                 break;  
         default:  
                 break;  
         }  
         return(1);  
 }  }
   
   /*
 /* ARGSUSED */   * See encode().
    * Do this for a single (probably unicode) value.
    * Does not check for non-decorated glyphs.
    */
 static void  static void
 termp_sh_post(DECL_ARGS)  encode1(struct termp *p, int c)
 {  {
           enum termfont     f;
   
         switch (node->type) {          if (TERMP_SKIPCHAR & p->flags) {
         case (MDOC_HEAD):                  p->flags &= ~TERMP_SKIPCHAR;
                 newln(p);                  return;
                 break;  
         case (MDOC_BODY):  
                 newln(p);  
                 p->offset = 0;  
                 break;  
         default:  
                 break;  
         }          }
 }  
   
           if (p->col + 6 >= p->maxcols)
                   adjbuf(p, p->col + 6);
   
 /* ARGSUSED */          f = term_fonttop(p);
 static int  
 termp_op_pre(DECL_ARGS)  
 {  
   
         switch (node->type) {          if (TERMFONT_UNDER == f || TERMFONT_BI == f) {
         case (MDOC_BODY):                  p->buf[p->col++] = '_';
                 word(p, "\\(lB");                  p->buf[p->col++] = 8;
                 p->flags |= TERMP_NOSPACE;  
                 break;  
         default:  
                 break;  
         }          }
         return(1);          if (TERMFONT_BOLD == f || TERMFONT_BI == f) {
 }                  if (ASCII_HYPH == c)
                           p->buf[p->col++] = '-';
                   else
 /* ARGSUSED */                          p->buf[p->col++] = c;
 static int                  p->buf[p->col++] = 8;
 termp_bt_pre(DECL_ARGS)  
 {  
   
         word(p, "is currently in beta test.");  
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_lb_pre(DECL_ARGS)  
 {  
         const char      *lb;  
   
         if (NULL == node->child)  
                 errx(1, "expected text line argument");  
         if (MDOC_TEXT != node->child->type)  
                 errx(1, "expected text line argument");  
   
         if ((lb = mdoc_a2lib(node->child->string))) {  
                 word(p, lb);  
                 return(0);  
         }          }
           p->buf[p->col++] = c;
         word(p, "library");  
         return(1);  
 }  }
   
   
 /* ARGSUSED */  
 static void  static void
 termp_lb_post(DECL_ARGS)  encode(struct termp *p, const char *word, size_t sz)
 {  {
           size_t            i;
   
         newln(p);          if (TERMP_SKIPCHAR & p->flags) {
 }                  p->flags &= ~TERMP_SKIPCHAR;
   
   
 /* ARGSUSED */  
 static int  
 termp_ud_pre(DECL_ARGS)  
 {  
   
         word(p, "currently under development.");  
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_d1_pre(DECL_ARGS)  
 {  
   
         if (MDOC_BODY != node->type)  
                 return(1);  
         newln(p);  
         p->offset += (pair->offset = INDENT);  
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static void  
 termp_d1_post(DECL_ARGS)  
 {  
   
         if (MDOC_BODY != node->type)  
                 return;                  return;
         newln(p);          }
         p->offset -= pair->offset;  
 }  
   
           /*
            * Encode and buffer a string of characters.  If the current
            * font mode is unset, buffer directly, else encode then buffer
            * character by character.
            */
   
 /* ARGSUSED */          if (TERMFONT_NONE == term_fonttop(p)) {
 static int                  if (p->col + sz >= p->maxcols)
 termp_aq_pre(DECL_ARGS)                          adjbuf(p, p->col + sz);
 {                  for (i = 0; i < sz; i++)
                           p->buf[p->col++] = word[i];
         if (MDOC_BODY != node->type)  
                 return(1);  
         word(p, "\\(la");  
         p->flags |= TERMP_NOSPACE;  
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static void  
 termp_aq_post(DECL_ARGS)  
 {  
   
         if (MDOC_BODY != node->type)  
                 return;                  return;
         p->flags |= TERMP_NOSPACE;          }
         word(p, "\\(ra");  
 }  
   
           /* Pre-buffer, assuming worst-case. */
   
 /* ARGSUSED */          if (p->col + 1 + (sz * 5) >= p->maxcols)
 static int                  adjbuf(p, p->col + 1 + (sz * 5));
 termp_ft_pre(DECL_ARGS)  
 {  
   
         if (SEC_SYNOPSIS == node->sec)          for (i = 0; i < sz; i++) {
                 if (node->prev && MDOC_Fo == node->prev->tok)                  if (ASCII_HYPH == word[i] ||
                         vspace(p);                      isgraph((unsigned char)word[i]))
         TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_FUNC_TYPE]);                          encode1(p, word[i]);
         return(1);                  else
                           p->buf[p->col++] = word[i];
           }
 }  }
   
   void
 /* ARGSUSED */  term_setwidth(struct termp *p, const char *wstr)
 static void  
 termp_ft_post(DECL_ARGS)  
 {  {
           struct roffsu    su;
           size_t           width;
           int              iop;
   
         if (SEC_SYNOPSIS == node->sec)          iop = 0;
                 newln(p);          width = 0;
 }          if (NULL != wstr) {
                   switch (*wstr) {
                   case '+':
 /* ARGSUSED */                          iop = 1;
 static int                          wstr++;
 termp_fn_pre(DECL_ARGS)                          break;
 {                  case '-':
         const struct mdoc_node *n;                          iop = -1;
                           wstr++;
         if (NULL == node->child)                          break;
                 errx(1, "expected text line arguments");                  default:
         if (MDOC_TEXT != node->child->type)                          break;
                 errx(1, "expected text line arguments");                  }
                   if (a2roffsu(wstr, &su, SCALE_MAX))
         /* FIXME: can be "type funcname" "type varname"... */                          width = term_hspan(p, &su);
                   else
         p->flags |= ttypes[TTYPE_FUNC_NAME];                          iop = 0;
         word(p, node->child->string);  
         p->flags &= ~ttypes[TTYPE_FUNC_NAME];  
   
         word(p, "(");  
   
         p->flags |= TERMP_NOSPACE;  
         for (n = node->child->next; n; n = n->next) {  
                 if (MDOC_TEXT != n->type)  
                         errx(1, "expected text line arguments");  
                 p->flags |= ttypes[TTYPE_FUNC_ARG];  
                 word(p, n->string);  
                 p->flags &= ~ttypes[TTYPE_FUNC_ARG];  
                 if (n->next)  
                         word(p, ",");  
         }          }
           (*p->setwidth)(p, iop, width);
         word(p, ")");  
   
         if (SEC_SYNOPSIS == node->sec)  
                 word(p, ";");  
   
         return(0);  
 }  }
   
   size_t
 /* ARGSUSED */  term_len(const struct termp *p, size_t sz)
 static void  
 termp_fn_post(DECL_ARGS)  
 {  {
   
         if (node->sec == SEC_SYNOPSIS && node->next)          return((*p->width)(p, ' ') * sz);
                 vspace(p);  
   
 }  }
   
   static size_t
 /* ARGSUSED */  cond_width(const struct termp *p, int c, int *skip)
 static int  
 termp_sx_pre(DECL_ARGS)  
 {  {
   
         TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_LINK]);          if (*skip) {
         return(1);                  (*skip) = 0;
                   return(0);
           } else
                   return((*p->width)(p, c));
 }  }
   
   size_t
 /* ARGSUSED */  term_strlen(const struct termp *p, const char *cp)
 static int  
 termp_fa_pre(DECL_ARGS)  
 {  {
         struct mdoc_node *n;          size_t           sz, rsz, i;
           int              ssz, skip, uc;
           const char      *seq, *rhs;
           enum mandoc_esc  esc;
           static const char rej[] = { '\\', ASCII_NBRSP, ASCII_HYPH,
                           ASCII_BREAK, '\0' };
   
         if (node->parent->tok != MDOC_Fo) {          /*
                 TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_FUNC_ARG]);           * Account for escaped sequences within string length
                 return(1);           * calculations.  This follows the logic in term_word() as we
         }           * must calculate the width of produced strings.
            */
   
         for (n = node->child; n; n = n->next) {          sz = 0;
                 if (MDOC_TEXT != n->type)          skip = 0;
                         errx(1, "expected text line arguments");          while ('\0' != *cp) {
                   rsz = strcspn(cp, rej);
                   for (i = 0; i < rsz; i++)
                           sz += cond_width(p, *cp++, &skip);
   
                 p->flags |= ttypes[TTYPE_FUNC_ARG];                  switch (*cp) {
                 word(p, n->string);                  case '\\':
                 p->flags &= ~ttypes[TTYPE_FUNC_ARG];                          cp++;
                           esc = mandoc_escape(&cp, &seq, &ssz);
                           if (ESCAPE_ERROR == esc)
                                   continue;
   
                 if (n->next)                          rhs = NULL;
                         word(p, ",");  
         }  
   
         if (node->next && node->next->tok == MDOC_Fa)                          switch (esc) {
                 word(p, ",");                          case ESCAPE_UNICODE:
                                   uc = mchars_num2uc(seq + 1, ssz - 1);
                                   break;
                           case ESCAPE_NUMBERED:
                                   uc = mchars_num2char(seq, ssz);
                                   if (uc < 0)
                                           continue;
                                   break;
                           case ESCAPE_SPECIAL:
                                   if (p->enc == TERMENC_ASCII) {
                                           rhs = mchars_spec2str(p->symtab,
                                               seq, ssz, &rsz);
                                           if (rhs != NULL)
                                                   break;
                                   } else {
                                           uc = mchars_spec2cp(p->symtab,
                                               seq, ssz);
                                           if (uc > 0)
                                                   sz += cond_width(p, uc, &skip);
                                   }
                                   continue;
                           case ESCAPE_SKIPCHAR:
                                   skip = 1;
                                   continue;
                           default:
                                   continue;
                           }
   
         return(0);                          /*
 }                           * Common handling for Unicode and numbered
                            * character escape sequences.
                            */
   
                           if (rhs == NULL) {
                                   if (p->enc == TERMENC_ASCII) {
                                           rhs = ascii_uc2str(uc);
                                           rsz = strlen(rhs);
                                   } else {
                                           if ((uc < 0x20 && uc != 0x09) ||
                                               (uc > 0x7E && uc < 0xA0))
                                                   uc = 0xFFFD;
                                           sz += cond_width(p, uc, &skip);
                                           continue;
                                   }
                           }
   
 /* ARGSUSED */                          if (skip) {
 static int                                  skip = 0;
 termp_va_pre(DECL_ARGS)                                  break;
 {                          }
   
         TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_VAR_DECL]);                          /*
         return(1);                           * Common handling for all escape sequences
 }                           * printing more than one character.
                            */
   
                           for (i = 0; i < rsz; i++)
 /* ARGSUSED */                                  sz += (*p->width)(p, *rhs++);
 static int                          break;
 termp_bd_pre(DECL_ARGS)                  case ASCII_NBRSP:
 {                          sz += cond_width(p, ' ', &skip);
         const struct mdoc_node  *n;                          cp++;
         int                      i, type;                          break;
                   case ASCII_HYPH:
         if (MDOC_BLOCK == node->type) {                          sz += cond_width(p, '-', &skip);
                 if (node->prev)                          cp++;
                         vspace(p);  
                 return(1);  
         } else if (MDOC_BODY != node->type)  
                 return(1);  
   
         if (NULL == node->parent->args)  
                 errx(1, "missing display type");  
   
         pair->offset = p->offset;  
   
         for (type = -1, i = 0;  
                         i < (int)node->parent->args->argc; i++) {  
                 switch (node->parent->args->argv[i].arg) {  
                 case (MDOC_Ragged):  
                         /* FALLTHROUGH */                          /* FALLTHROUGH */
                 case (MDOC_Filled):                  case ASCII_BREAK:
                         /* FALLTHROUGH */  
                 case (MDOC_Unfilled):  
                         /* FALLTHROUGH */  
                 case (MDOC_Literal):  
                         type = node->parent->args->argv[i].arg;  
                         i = (int)node->parent->args->argc;  
                         break;                          break;
                 default:                  default:
                         break;                          break;
                 }                  }
         }          }
   
         if (NULL == node->parent->args)          return(sz);
                 errx(1, "missing display type");  
   
         i = arg_getattr(MDOC_Offset, node->parent);  
         if (-1 != i) {  
                 if (1 != node->parent->args->argv[i].sz)  
                         errx(1, "expected single value");  
                 p->offset += arg_offset(&node->parent->args->argv[i]);  
         }  
   
         switch (type) {  
         case (MDOC_Literal):  
                 /* FALLTHROUGH */  
         case (MDOC_Unfilled):  
                 break;  
         default:  
                 return(1);  
         }  
   
         p->flags |= TERMP_LITERAL;  
   
         for (n = node->child; n; n = n->next) {  
                 if (MDOC_TEXT != n->type) {  
                         warnx("non-text children not yet allowed");  
                         continue;  
                 }  
                 word(p, n->string);  
                 flushln(p);  
         }  
   
         return(0);  
 }  }
   
   size_t
 /* ARGSUSED */  term_vspan(const struct termp *p, const struct roffsu *su)
 static void  
 termp_bd_post(DECL_ARGS)  
 {  {
           double           r;
   
         if (MDOC_BODY != node->type)          switch (su->unit) {
                 return;          case SCALE_CM:
                   r = su->scale * 2.0;
         if ( ! (p->flags & TERMP_LITERAL))  
                 flushln(p);  
   
         p->flags &= ~TERMP_LITERAL;  
         p->offset = pair->offset;  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_qq_pre(DECL_ARGS)  
 {  
   
         if (MDOC_BODY != node->type)  
                 return(1);  
         word(p, "\"");  
         p->flags |= TERMP_NOSPACE;  
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static void  
 termp_qq_post(DECL_ARGS)  
 {  
   
         if (MDOC_BODY != node->type)  
                 return;  
         p->flags |= TERMP_NOSPACE;  
         word(p, "\"");  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_bsx_pre(DECL_ARGS)  
 {  
   
         word(p, "BSDI BSD/OS");  
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static void  
 termp_bx_post(DECL_ARGS)  
 {  
   
         if (node->child)  
                 p->flags |= TERMP_NOSPACE;  
         word(p, "BSD");  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_ox_pre(DECL_ARGS)  
 {  
   
         word(p, "OpenBSD");  
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_ux_pre(DECL_ARGS)  
 {  
   
         word(p, "UNIX");  
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_fx_pre(DECL_ARGS)  
 {  
   
         word(p, "FreeBSD");  
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_nx_pre(DECL_ARGS)  
 {  
   
         word(p, "NetBSD");  
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_sq_pre(DECL_ARGS)  
 {  
   
         if (MDOC_BODY != node->type)  
                 return(1);  
         word(p, "`");  
         p->flags |= TERMP_NOSPACE;  
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static void  
 termp_sq_post(DECL_ARGS)  
 {  
   
         if (MDOC_BODY != node->type)  
                 return;  
         p->flags |= TERMP_NOSPACE;  
         word(p, "\'");  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_pf_pre(DECL_ARGS)  
 {  
   
         p->flags |= TERMP_IGNDELIM;  
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static void  
 termp_pf_post(DECL_ARGS)  
 {  
   
         p->flags &= ~TERMP_IGNDELIM;  
         p->flags |= TERMP_NOSPACE;  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_ss_pre(DECL_ARGS)  
 {  
   
         switch (node->type) {  
         case (MDOC_HEAD):  
                 vspace(p);  
                 TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_SSECTION]);  
                 p->offset = INDENT / 2;  
                 break;                  break;
         default:          case SCALE_IN:
                   r = su->scale * 6.0;
                 break;                  break;
         }          case SCALE_PC:
                   r = su->scale;
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static void  
 termp_ss_post(DECL_ARGS)  
 {  
   
         switch (node->type) {  
         case (MDOC_HEAD):  
                 newln(p);  
                 p->offset = INDENT;  
                 break;                  break;
           case SCALE_PT:
                   r = su->scale / 8.0;
                   break;
           case SCALE_MM:
                   r = su->scale / 1000.0;
                   break;
           case SCALE_VS:
                   r = su->scale;
                   break;
         default:          default:
                   r = su->scale - 1.0;
                 break;                  break;
         }          }
 }  
   
           if (r < 0.0)
 /* ARGSUSED */                  r = 0.0;
 static int          return((size_t)(r + 0.0005));
 termp_pa_pre(DECL_ARGS)  
 {  
   
         TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_FILE]);  
         return(1);  
 }  }
   
   size_t
 /* ARGSUSED */  term_hspan(const struct termp *p, const struct roffsu *su)
 static int  
 termp_em_pre(DECL_ARGS)  
 {  {
           double           v;
   
         TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_EMPH]);          v = (*p->hspan)(p, su);
         return(1);          if (v < 0.0)
                   v = 0.0;
           return((size_t)(v + 0.0005));
 }  }
   
   
 /* ARGSUSED */  
 static int  
 termp_cd_pre(DECL_ARGS)  
 {  
   
         TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_CONFIG]);  
         newln(p);  
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_cm_pre(DECL_ARGS)  
 {  
   
         TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_CMD_FLAG]);  
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_ic_pre(DECL_ARGS)  
 {  
   
         TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_CMD]);  
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_in_pre(DECL_ARGS)  
 {  
   
         TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_INCLUDE]);  
         word(p, "#include");  
         word(p, "<");  
         p->flags |= TERMP_NOSPACE;  
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static void  
 termp_in_post(DECL_ARGS)  
 {  
   
         p->flags |= TERMP_NOSPACE;  
         word(p, ">");  
   
         newln(p);  
         if (SEC_SYNOPSIS != node->sec)  
                 return;  
         if (node->next && MDOC_In != node->next->tok)  
                 vspace(p);  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_at_pre(DECL_ARGS)  
 {  
         const char      *att;  
   
         att = NULL;  
   
         if (node->child) {  
                 if (MDOC_TEXT != node->child->type)  
                         errx(1, "expected text line argument");  
                 att = mdoc_a2att(node->child->string);  
         }  
   
         if (NULL == att)  
                 att = "AT&T UNIX";  
   
         word(p, att);  
         return(0);  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_bq_pre(DECL_ARGS)  
 {  
   
         if (MDOC_BODY != node->type)  
                 return(1);  
         word(p, "[");  
         p->flags |= TERMP_NOSPACE;  
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static void  
 termp_bq_post(DECL_ARGS)  
 {  
   
         if (MDOC_BODY != node->type)  
                 return;  
         word(p, "]");  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_pq_pre(DECL_ARGS)  
 {  
   
         if (MDOC_BODY != node->type)  
                 return(1);  
         word(p, "\\&(");  
         p->flags |= TERMP_NOSPACE;  
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static void  
 termp_pq_post(DECL_ARGS)  
 {  
   
         if (MDOC_BODY != node->type)  
                 return;  
         word(p, ")");  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_fo_pre(DECL_ARGS)  
 {  
         const struct mdoc_node *n;  
   
         if (MDOC_BODY == node->type) {  
                 word(p, "(");  
                 p->flags |= TERMP_NOSPACE;  
                 return(1);  
         } else if (MDOC_HEAD != node->type)  
                 return(1);  
   
         /* XXX - groff shows only first parameter */  
   
         p->flags |= ttypes[TTYPE_FUNC_NAME];  
         for (n = node->child; n; n = n->next) {  
                 if (MDOC_TEXT != n->type)  
                         errx(1, "expected text line argument");  
                 word(p, n->string);  
         }  
         p->flags &= ~ttypes[TTYPE_FUNC_NAME];  
   
         return(0);  
 }  
   
   
 /* ARGSUSED */  
 static void  
 termp_fo_post(DECL_ARGS)  
 {  
   
         if (MDOC_BODY != node->type)  
                 return;  
         word(p, ")");  
         word(p, ";");  
         newln(p);  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_bf_pre(DECL_ARGS)  
 {  
         const struct mdoc_node  *n;  
   
         if (MDOC_HEAD == node->type) {  
                 return(0);  
         } else if (MDOC_BLOCK != node->type)  
                 return(1);  
   
         if (NULL == (n = node->head->child)) {  
                 if (arg_hasattr(MDOC_Emphasis, node))  
                         TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_EMPH]);  
                 else if (arg_hasattr(MDOC_Symbolic, node))  
                         TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_SYMB]);  
   
                 return(1);  
         }  
   
         if (MDOC_TEXT != n->type)  
                 errx(1, "expected text line arguments");  
   
         if (0 == strcmp("Em", n->string))  
                 TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_EMPH]);  
         else if (0 == strcmp("Sy", n->string))  
                 TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_EMPH]);  
   
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_sy_pre(DECL_ARGS)  
 {  
   
         TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_SYMB]);  
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_ms_pre(DECL_ARGS)  
 {  
   
         TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_SYMBOL]);  
         return(1);  
 }  
   
   
   
 /* ARGSUSED */  
 static int  
 termp_sm_pre(DECL_ARGS)  
 {  
   
 #if notyet  
         assert(node->child);  
         if (0 == strcmp("off", node->child->data.text.string)) {  
                 p->flags &= ~TERMP_NONOSPACE;  
                 p->flags &= ~TERMP_NOSPACE;  
         } else {  
                 p->flags |= TERMP_NONOSPACE;  
                 p->flags |= TERMP_NOSPACE;  
         }  
 #endif  
   
         return(0);  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_ap_pre(DECL_ARGS)  
 {  
   
         p->flags |= TERMP_NOSPACE;  
         word(p, "\\(aq");  
         p->flags |= TERMP_NOSPACE;  
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp__t_pre(DECL_ARGS)  
 {  
   
         /* FIXME: titles are underlined. */  
         word(p, "\"");  
         p->flags |= TERMP_NOSPACE;  
         return(1);  
 }  
   
   
 /* ARGSUSED */  
 static void  
 termp__t_post(DECL_ARGS)  
 {  
   
         p->flags |= TERMP_NOSPACE;  
         /* FIXME: titles are underlined. */  
         word(p, "\"");  
         word(p, node->next ? "," : ".");  
 }  
   
   
 /* ARGSUSED */  
 static void  
 termp____post(DECL_ARGS)  
 {  
   
         p->flags |= TERMP_NOSPACE;  
         word(p, node->next ? "," : ".");  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_lk_pre(DECL_ARGS)  
 {  
         const struct mdoc_node *n;  
   
         if (NULL == (n = node->child))  
                 errx(1, "expected text line argument");  
         if (MDOC_TEXT != n->type)  
                 errx(1, "expected text line argument");  
   
         p->flags |= ttypes[TTYPE_LINK_ANCHOR];  
         word(p, n->string);  
         p->flags &= ~ttypes[TTYPE_LINK_ANCHOR];  
         p->flags |= TERMP_NOSPACE;  
         word(p, ":");  
   
         p->flags |= ttypes[TTYPE_LINK_TEXT];  
         for ( ; n; n = n->next) {  
                 if (MDOC_TEXT != n->type)  
                         errx(1, "expected text line argument");  
                 word(p, n->string);  
         }  
         p->flags &= ~ttypes[TTYPE_LINK_TEXT];  
   
         return(0);  
 }  
   
   
 /* ARGSUSED */  
 static int  
 termp_mt_pre(DECL_ARGS)  
 {  
   
         TERMPAIR_SETFLAG(p, pair, ttypes[TTYPE_LINK_ANCHOR]);  
         return(1);  
 }  
   
Legend:
Removed from v.1.51  
changed lines
  Added in v.1.236
CVSweb