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

Diff for /mandoc/mdoc_argv.c between version 1.34 and 1.104

version 1.34, 2010/03/29 19:28:04 version 1.104, 2015/04/19 14:00:19
Line 1 
Line 1 
 /*      $Id$ */  /*      $Id$ */
 /*  /*
  * Copyright (c) 2008, 2009 Kristaps Dzonsons <kristaps@kth.se>   * Copyright (c) 2008, 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
    * Copyright (c) 2012, 2014, 2015 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 above   * purpose with or without fee is hereby granted, provided that the above
  * copyright notice and this permission notice appear in all copies.   * copyright notice and this permission notice appear in all copies.
  *   *
  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES   * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHORS DISCLAIM ALL WARRANTIES
  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF   * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR   * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR
  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES   * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN   * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF   * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.   * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */   */
 #ifdef HAVE_CONFIG_H  
 #include "config.h"  #include "config.h"
 #endif  
   
 #include <sys/types.h>  #include <sys/types.h>
   
 #include <assert.h>  #include <assert.h>
 #include <ctype.h>  
 #include <stdlib.h>  #include <stdlib.h>
 #include <stdio.h>  #include <stdio.h>
 #include <string.h>  #include <string.h>
   
 #include "libmdoc.h"  #include "mandoc_aux.h"
   #include "mandoc.h"
   #include "roff.h"
   #include "mdoc.h"
 #include "libmandoc.h"  #include "libmandoc.h"
   #include "libmdoc.h"
   
 /*  #define MULTI_STEP       5 /* pre-allocate argument values */
  * Routines to parse arguments of macros.  Arguments follow the syntax  #define DELIMSZ          6 /* max possible size of a delimiter */
  * of `-arg [val [valN...]]'.  Arguments come in all types:  quoted  
  * arguments, multiple arguments per value, no-value arguments, etc.  
  *  
  * There's no limit to the number or arguments that may be allocated.  
  */  
   
 #define ARGV_NONE       (1 << 0)  enum    argsflag {
 #define ARGV_SINGLE     (1 << 1)          ARGSFL_NONE = 0,
 #define ARGV_MULTI      (1 << 2)          ARGSFL_DELIM, /* handle delimiters of [[::delim::][ ]+]+ */
 #define ARGV_OPT_SINGLE (1 << 3)          ARGSFL_TABSEP /* handle tab/`Ta' separated phrases */
   };
   
 #define MULTI_STEP       5  enum    argvflag {
           ARGV_NONE, /* no args to flag (e.g., -split) */
           ARGV_SINGLE, /* one arg to flag (e.g., -file xxx)  */
           ARGV_MULTI /* multiple args (e.g., -column xxx yyy) */
   };
   
 static  int              argv_a2arg(int, const char *);  struct  mdocarg {
 static  int              args(struct mdoc *, int, int *,          enum argsflag    flags;
                                 char *, int, char **);          const enum mdocargt *argvs;
 static  int              argv(struct mdoc *, int,  };
   
   static  void             argn_free(struct mdoc_arg *, int);
   static  enum margserr    args(struct roff_man *, int, int *,
                                   char *, enum argsflag, char **);
   static  int              args_checkpunct(const char *, int);
   static  void             argv_multi(struct roff_man *, int,
                                 struct mdoc_argv *, int *, char *);                                  struct mdoc_argv *, int *, char *);
 static  int              argv_single(struct mdoc *, int,  static  void             argv_single(struct roff_man *, int,
                                 struct mdoc_argv *, int *, char *);                                  struct mdoc_argv *, int *, char *);
 static  int              argv_opt_single(struct mdoc *, int,  
                                 struct mdoc_argv *, int *, char *);  
 static  int              argv_multi(struct mdoc *, int,  
                                 struct mdoc_argv *, int *, char *);  
   
 /* Per-argument flags. */  static  const enum argvflag argvflags[MDOC_ARG_MAX] = {
   
 static  int mdoc_argvflags[MDOC_ARG_MAX] = {  
         ARGV_NONE,      /* MDOC_Split */          ARGV_NONE,      /* MDOC_Split */
         ARGV_NONE,      /* MDOC_Nosplit */          ARGV_NONE,      /* MDOC_Nosplit */
         ARGV_NONE,      /* MDOC_Ragged */          ARGV_NONE,      /* MDOC_Ragged */
         ARGV_NONE,      /* MDOC_Unfilled */          ARGV_NONE,      /* MDOC_Unfilled */
         ARGV_NONE,      /* MDOC_Literal */          ARGV_NONE,      /* MDOC_Literal */
         ARGV_SINGLE,    /* MDOC_File */          ARGV_SINGLE,    /* MDOC_File */
         ARGV_OPT_SINGLE, /* MDOC_Offset */          ARGV_SINGLE,    /* MDOC_Offset */
         ARGV_NONE,      /* MDOC_Bullet */          ARGV_NONE,      /* MDOC_Bullet */
         ARGV_NONE,      /* MDOC_Dash */          ARGV_NONE,      /* MDOC_Dash */
         ARGV_NONE,      /* MDOC_Hyphen */          ARGV_NONE,      /* MDOC_Hyphen */
Line 87  static int mdoc_argvflags[MDOC_ARG_MAX] = {
Line 89  static int mdoc_argvflags[MDOC_ARG_MAX] = {
         ARGV_NONE       /* MDOC_Symbolic */          ARGV_NONE       /* MDOC_Symbolic */
 };  };
   
 static  int mdoc_argflags[MDOC_MAX] = {  static  const enum mdocargt args_Ex[] = {
         0, /* Ap */          MDOC_Std,
         0, /* Dd */          MDOC_ARG_MAX
         0, /* Dt */  
         0, /* Os */  
         0, /* Sh */  
         0, /* Ss */  
         ARGS_DELIM, /* Pp */  
         ARGS_DELIM, /* D1 */  
         ARGS_DELIM, /* Dl */  
         0, /* Bd */  
         0, /* Ed */  
         0, /* Bl */  
         0, /* El */  
         0, /* It */  
         ARGS_DELIM, /* Ad */  
         ARGS_DELIM, /* An */  
         ARGS_DELIM, /* Ar */  
         0, /* Cd */  
         ARGS_DELIM, /* Cm */  
         ARGS_DELIM, /* Dv */  
         ARGS_DELIM, /* Er */  
         ARGS_DELIM, /* Ev */  
         0, /* Ex */  
         ARGS_DELIM, /* Fa */  
         0, /* Fd */  
         ARGS_DELIM, /* Fl */  
         ARGS_DELIM, /* Fn */  
         ARGS_DELIM, /* Ft */  
         ARGS_DELIM, /* Ic */  
         0, /* In */  
         ARGS_DELIM, /* Li */  
         0, /* Nd */  
         ARGS_DELIM, /* Nm */  
         ARGS_DELIM, /* Op */  
         0, /* Ot */  
         ARGS_DELIM, /* Pa */  
         0, /* Rv */  
         ARGS_DELIM, /* St */  
         ARGS_DELIM, /* Va */  
         ARGS_DELIM, /* Vt */  
         ARGS_DELIM, /* Xr */  
         0, /* %A */  
         0, /* %B */  
         0, /* %D */  
         0, /* %I */  
         0, /* %J */  
         0, /* %N */  
         0, /* %O */  
         0, /* %P */  
         0, /* %R */  
         0, /* %T */  
         0, /* %V */  
         ARGS_DELIM, /* Ac */  
         0, /* Ao */  
         ARGS_DELIM, /* Aq */  
         ARGS_DELIM, /* At */  
         ARGS_DELIM, /* Bc */  
         0, /* Bf */  
         0, /* Bo */  
         ARGS_DELIM, /* Bq */  
         ARGS_DELIM, /* Bsx */  
         ARGS_DELIM, /* Bx */  
         0, /* Db */  
         ARGS_DELIM, /* Dc */  
         0, /* Do */  
         ARGS_DELIM, /* Dq */  
         ARGS_DELIM, /* Ec */  
         0, /* Ef */  
         ARGS_DELIM, /* Em */  
         0, /* Eo */  
         ARGS_DELIM, /* Fx */  
         ARGS_DELIM, /* Ms */  
         ARGS_DELIM, /* No */  
         ARGS_DELIM, /* Ns */  
         ARGS_DELIM, /* Nx */  
         ARGS_DELIM, /* Ox */  
         ARGS_DELIM, /* Pc */  
         ARGS_DELIM, /* Pf */  
         0, /* Po */  
         ARGS_DELIM, /* Pq */  
         ARGS_DELIM, /* Qc */  
         ARGS_DELIM, /* Ql */  
         0, /* Qo */  
         ARGS_DELIM, /* Qq */  
         0, /* Re */  
         0, /* Rs */  
         ARGS_DELIM, /* Sc */  
         0, /* So */  
         ARGS_DELIM, /* Sq */  
         0, /* Sm */  
         ARGS_DELIM, /* Sx */  
         ARGS_DELIM, /* Sy */  
         ARGS_DELIM, /* Tn */  
         ARGS_DELIM, /* Ux */  
         ARGS_DELIM, /* Xc */  
         0, /* Xo */  
         0, /* Fo */  
         0, /* Fc */  
         0, /* Oo */  
         ARGS_DELIM, /* Oc */  
         0, /* Bk */  
         0, /* Ek */  
         0, /* Bt */  
         0, /* Hf */  
         0, /* Fr */  
         0, /* Ud */  
         0, /* Lb */  
         ARGS_DELIM, /* Lp */  
         ARGS_DELIM, /* Lk */  
         ARGS_DELIM, /* Mt */  
         ARGS_DELIM, /* Brq */  
         0, /* Bro */  
         ARGS_DELIM, /* Brc */  
         0, /* %C */  
         0, /* Es */  
         0, /* En */  
         0, /* Dx */  
         0, /* %Q */  
         0, /* br */  
         0, /* sp */  
         0, /* %U */  
 };  };
   
   static  const enum mdocargt args_An[] = {
           MDOC_Split,
           MDOC_Nosplit,
           MDOC_ARG_MAX
   };
   
   static  const enum mdocargt args_Bd[] = {
           MDOC_Ragged,
           MDOC_Unfilled,
           MDOC_Filled,
           MDOC_Literal,
           MDOC_File,
           MDOC_Offset,
           MDOC_Compact,
           MDOC_Centred,
           MDOC_ARG_MAX
   };
   
   static  const enum mdocargt args_Bf[] = {
           MDOC_Emphasis,
           MDOC_Literal,
           MDOC_Symbolic,
           MDOC_ARG_MAX
   };
   
   static  const enum mdocargt args_Bk[] = {
           MDOC_Words,
           MDOC_ARG_MAX
   };
   
   static  const enum mdocargt args_Bl[] = {
           MDOC_Bullet,
           MDOC_Dash,
           MDOC_Hyphen,
           MDOC_Item,
           MDOC_Enum,
           MDOC_Tag,
           MDOC_Diag,
           MDOC_Hang,
           MDOC_Ohang,
           MDOC_Inset,
           MDOC_Column,
           MDOC_Width,
           MDOC_Offset,
           MDOC_Compact,
           MDOC_Nested,
           MDOC_ARG_MAX
   };
   
   static  const struct mdocarg mdocargs[MDOC_MAX] = {
           { ARGSFL_DELIM, NULL }, /* Ap */
           { ARGSFL_NONE, NULL }, /* Dd */
           { ARGSFL_NONE, NULL }, /* Dt */
           { ARGSFL_NONE, NULL }, /* Os */
           { ARGSFL_NONE, NULL }, /* Sh */
           { ARGSFL_NONE, NULL }, /* Ss */
           { ARGSFL_NONE, NULL }, /* Pp */
           { ARGSFL_DELIM, NULL }, /* D1 */
           { ARGSFL_DELIM, NULL }, /* Dl */
           { ARGSFL_NONE, args_Bd }, /* Bd */
           { ARGSFL_NONE, NULL }, /* Ed */
           { ARGSFL_NONE, args_Bl }, /* Bl */
           { ARGSFL_NONE, NULL }, /* El */
           { ARGSFL_NONE, NULL }, /* It */
           { ARGSFL_DELIM, NULL }, /* Ad */
           { ARGSFL_DELIM, args_An }, /* An */
           { ARGSFL_DELIM, NULL }, /* Ar */
           { ARGSFL_DELIM, NULL }, /* Cd */
           { ARGSFL_DELIM, NULL }, /* Cm */
           { ARGSFL_DELIM, NULL }, /* Dv */
           { ARGSFL_DELIM, NULL }, /* Er */
           { ARGSFL_DELIM, NULL }, /* Ev */
           { ARGSFL_NONE, args_Ex }, /* Ex */
           { ARGSFL_DELIM, NULL }, /* Fa */
           { ARGSFL_NONE, NULL }, /* Fd */
           { ARGSFL_DELIM, NULL }, /* Fl */
           { ARGSFL_DELIM, NULL }, /* Fn */
           { ARGSFL_DELIM, NULL }, /* Ft */
           { ARGSFL_DELIM, NULL }, /* Ic */
           { ARGSFL_DELIM, NULL }, /* In */
           { ARGSFL_DELIM, NULL }, /* Li */
           { ARGSFL_NONE, NULL }, /* Nd */
           { ARGSFL_DELIM, NULL }, /* Nm */
           { ARGSFL_DELIM, NULL }, /* Op */
           { ARGSFL_DELIM, NULL }, /* Ot */
           { ARGSFL_DELIM, NULL }, /* Pa */
           { ARGSFL_NONE, args_Ex }, /* Rv */
           { ARGSFL_DELIM, NULL }, /* St */
           { ARGSFL_DELIM, NULL }, /* Va */
           { ARGSFL_DELIM, NULL }, /* Vt */
           { ARGSFL_DELIM, NULL }, /* Xr */
           { ARGSFL_NONE, NULL }, /* %A */
           { ARGSFL_NONE, NULL }, /* %B */
           { ARGSFL_NONE, NULL }, /* %D */
           { ARGSFL_NONE, NULL }, /* %I */
           { ARGSFL_NONE, NULL }, /* %J */
           { ARGSFL_NONE, NULL }, /* %N */
           { ARGSFL_NONE, NULL }, /* %O */
           { ARGSFL_NONE, NULL }, /* %P */
           { ARGSFL_NONE, NULL }, /* %R */
           { ARGSFL_NONE, NULL }, /* %T */
           { ARGSFL_NONE, NULL }, /* %V */
           { ARGSFL_DELIM, NULL }, /* Ac */
           { ARGSFL_NONE, NULL }, /* Ao */
           { ARGSFL_DELIM, NULL }, /* Aq */
           { ARGSFL_DELIM, NULL }, /* At */
           { ARGSFL_DELIM, NULL }, /* Bc */
           { ARGSFL_NONE, args_Bf }, /* Bf */
           { ARGSFL_NONE, NULL }, /* Bo */
           { ARGSFL_DELIM, NULL }, /* Bq */
           { ARGSFL_DELIM, NULL }, /* Bsx */
           { ARGSFL_DELIM, NULL }, /* Bx */
           { ARGSFL_NONE, NULL }, /* Db */
           { ARGSFL_DELIM, NULL }, /* Dc */
           { ARGSFL_NONE, NULL }, /* Do */
           { ARGSFL_DELIM, NULL }, /* Dq */
           { ARGSFL_DELIM, NULL }, /* Ec */
           { ARGSFL_NONE, NULL }, /* Ef */
           { ARGSFL_DELIM, NULL }, /* Em */
           { ARGSFL_NONE, NULL }, /* Eo */
           { ARGSFL_DELIM, NULL }, /* Fx */
           { ARGSFL_DELIM, NULL }, /* Ms */
           { ARGSFL_DELIM, NULL }, /* No */
           { ARGSFL_DELIM, NULL }, /* Ns */
           { ARGSFL_DELIM, NULL }, /* Nx */
           { ARGSFL_DELIM, NULL }, /* Ox */
           { ARGSFL_DELIM, NULL }, /* Pc */
           { ARGSFL_DELIM, NULL }, /* Pf */
           { ARGSFL_NONE, NULL }, /* Po */
           { ARGSFL_DELIM, NULL }, /* Pq */
           { ARGSFL_DELIM, NULL }, /* Qc */
           { ARGSFL_DELIM, NULL }, /* Ql */
           { ARGSFL_NONE, NULL }, /* Qo */
           { ARGSFL_DELIM, NULL }, /* Qq */
           { ARGSFL_NONE, NULL }, /* Re */
           { ARGSFL_NONE, NULL }, /* Rs */
           { ARGSFL_DELIM, NULL }, /* Sc */
           { ARGSFL_NONE, NULL }, /* So */
           { ARGSFL_DELIM, NULL }, /* Sq */
           { ARGSFL_NONE, NULL }, /* Sm */
           { ARGSFL_DELIM, NULL }, /* Sx */
           { ARGSFL_DELIM, NULL }, /* Sy */
           { ARGSFL_DELIM, NULL }, /* Tn */
           { ARGSFL_DELIM, NULL }, /* Ux */
           { ARGSFL_DELIM, NULL }, /* Xc */
           { ARGSFL_NONE, NULL }, /* Xo */
           { ARGSFL_NONE, NULL }, /* Fo */
           { ARGSFL_DELIM, NULL }, /* Fc */
           { ARGSFL_NONE, NULL }, /* Oo */
           { ARGSFL_DELIM, NULL }, /* Oc */
           { ARGSFL_NONE, args_Bk }, /* Bk */
           { ARGSFL_NONE, NULL }, /* Ek */
           { ARGSFL_NONE, NULL }, /* Bt */
           { ARGSFL_NONE, NULL }, /* Hf */
           { ARGSFL_DELIM, NULL }, /* Fr */
           { ARGSFL_NONE, NULL }, /* Ud */
           { ARGSFL_DELIM, NULL }, /* Lb */
           { ARGSFL_NONE, NULL }, /* Lp */
           { ARGSFL_DELIM, NULL }, /* Lk */
           { ARGSFL_DELIM, NULL }, /* Mt */
           { ARGSFL_DELIM, NULL }, /* Brq */
           { ARGSFL_NONE, NULL }, /* Bro */
           { ARGSFL_DELIM, NULL }, /* Brc */
           { ARGSFL_NONE, NULL }, /* %C */
           { ARGSFL_NONE, NULL }, /* Es */
           { ARGSFL_DELIM, NULL }, /* En */
           { ARGSFL_DELIM, NULL }, /* Dx */
           { ARGSFL_NONE, NULL }, /* %Q */
           { ARGSFL_NONE, NULL }, /* br */
           { ARGSFL_NONE, NULL }, /* sp */
           { ARGSFL_NONE, NULL }, /* %U */
           { ARGSFL_NONE, NULL }, /* Ta */
           { ARGSFL_NONE, NULL }, /* ll */
   };
   
   
 /*  /*
  * Parse an argument from line text.  This comes in the form of -key   * Parse flags and their arguments from the input line.
  * [value0...], which may either have a single mandatory value, at least   * These come in the form -flag [argument ...].
  * one mandatory value, an optional single value, or no value.   * Some flags take no argument, some one, some multiple.
  */   */
 int  void
 mdoc_argv(struct mdoc *m, int line, int tok,  mdoc_argv(struct roff_man *mdoc, int line, int tok,
                 struct mdoc_arg **v, int *pos, char *buf)          struct mdoc_arg **reta, int *pos, char *buf)
 {  {
         char             *p, sv;          struct mdoc_argv          tmpv;
         struct mdoc_argv tmp;          struct mdoc_argv        **retv;
         struct mdoc_arg  *arg;          const enum mdocargt      *argtable;
           char                     *argname;
           int                       ipos, retc;
           char                      savechar;
   
         if (0 == buf[*pos])          *reta = NULL;
                 return(ARGV_EOLN);  
   
         assert(' ' != buf[*pos]);          /* Which flags does this macro support? */
   
         /* Parse through to the first unescaped space. */          argtable = mdocargs[tok].argvs;
           if (argtable == NULL)
                   return;
   
         p = &buf[++(*pos)];          /* Loop over the flags on the input line. */
   
         assert(*pos > 0);          ipos = *pos;
           while (buf[ipos] == '-') {
   
         /* LINTED */                  /* Seek to the first unescaped space. */
         while (buf[*pos]) {  
                 if (' ' == buf[*pos])                  for (argname = buf + ++ipos; buf[ipos] != '\0'; ipos++)
                         if ('\\' != buf[*pos - 1])                          if (buf[ipos] == ' ' && buf[ipos - 1] != '\\')
                                 break;                                  break;
                 (*pos)++;  
         }  
   
         /* XXX - save zeroed byte, if not an argument. */                  /*
                    * We want to nil-terminate the word to look it up.
                    * But we may not have a flag, in which case we need
                    * to restore the line as-is.  So keep around the
                    * stray byte, which we'll reset upon exiting.
                    */
   
         sv = 0;                  if ((savechar = buf[ipos]) != '\0')
         if (buf[*pos]) {                          buf[ipos++] = '\0';
                 sv = buf[*pos];  
                 buf[(*pos)++] = 0;  
         }  
   
         (void)memset(&tmp, 0, sizeof(struct mdoc_argv));                  /*
         tmp.line = line;                   * Now look up the word as a flag.  Use temporary
         tmp.pos = *pos;                   * storage that we'll copy into the node's flags.
                    */
   
         /* See if our token accepts the argument. */                  while ((tmpv.arg = *argtable++) != MDOC_ARG_MAX)
                           if ( ! strcmp(argname, mdoc_argnames[tmpv.arg]))
                                   break;
   
         if (MDOC_ARG_MAX == (tmp.arg = argv_a2arg(tok, p))) {                  /* If it isn't a flag, restore the saved byte. */
                 /* XXX - restore saved zeroed byte. */  
                 if (sv)  
                         buf[*pos - 1] = sv;  
                 return(ARGV_WORD);  
         }  
   
         while (buf[*pos] && ' ' == buf[*pos])                  if (tmpv.arg == MDOC_ARG_MAX) {
                 (*pos)++;                          if (savechar != '\0')
                                   buf[ipos - 1] = savechar;
                           break;
                   }
   
         if ( ! argv(m, line, &tmp, pos, buf))                  /* Read to the next word (the first argument). */
                 return(ARGV_ERROR);  
   
         if (NULL == (arg = *v))                  while (buf[ipos] == ' ')
                 arg = *v = mandoc_calloc(1, sizeof(struct mdoc_arg));                          ipos++;
   
         arg->argc++;                  /* Parse the arguments of the flag. */
         arg->argv = mandoc_realloc  
                 (arg->argv, arg->argc * sizeof(struct mdoc_argv));  
   
         (void)memcpy(&arg->argv[(int)arg->argc - 1],                  tmpv.line  = line;
                         &tmp, sizeof(struct mdoc_argv));                  tmpv.pos   = *pos;
                   tmpv.sz    = 0;
                   tmpv.value = NULL;
   
         return(ARGV_ARG);                  switch (argvflags[tmpv.arg]) {
 }                  case ARGV_SINGLE:
                           argv_single(mdoc, line, &tmpv, &ipos, buf);
                           break;
                   case ARGV_MULTI:
                           argv_multi(mdoc, line, &tmpv, &ipos, buf);
                           break;
                   case ARGV_NONE:
                           break;
                   }
   
                   /* Append to the return values. */
   
                   if (*reta == NULL)
                           *reta = mandoc_calloc(1, sizeof(**reta));
   
                   retc = ++(*reta)->argc;
                   retv = &(*reta)->argv;
                   *retv = mandoc_reallocarray(*retv, retc, sizeof(**retv));
                   memcpy(*retv + retc - 1, &tmpv, sizeof(**retv));
   
                   /* Prepare for parsing the next flag. */
   
                   *pos = ipos;
                   argtable = mdocargs[tok].argvs;
           }
   }
   
 void  void
 mdoc_argv_free(struct mdoc_arg *p)  mdoc_argv_free(struct mdoc_arg *p)
 {  {
         int              i, j;          int              i;
   
         if (NULL == p)          if (NULL == p)
                 return;                  return;
Line 300  mdoc_argv_free(struct mdoc_arg *p)
Line 387  mdoc_argv_free(struct mdoc_arg *p)
         }          }
         assert(p->argc);          assert(p->argc);
   
         /* LINTED */          for (i = (int)p->argc - 1; i >= 0; i--)
         for (i = 0; i < (int)p->argc; i++) {                  argn_free(p, i);
                 if (0 == p->argv[i].sz)  
                         continue;  
                 if (NULL == p->argv[i].value)  
                         continue;  
   
                 /* LINTED */  
                 for (j = 0; j < (int)p->argv[i].sz; j++)  
                         if (p->argv[i].value[j])  
                                 free(p->argv[i].value[j]);  
   
                 free(p->argv[i].value);  
         }  
   
         free(p->argv);          free(p->argv);
         free(p);          free(p);
 }  }
   
   static void
 int  argn_free(struct mdoc_arg *p, int iarg)
 mdoc_zargs(struct mdoc *m, int line, int *pos,  
                 char *buf, int flags, char **v)  
 {  {
           struct mdoc_argv *arg;
           int               j;
   
         return(args(m, line, pos, buf, flags, v));          arg = &p->argv[iarg];
 }  
   
           if (arg->sz && arg->value) {
 int                  for (j = (int)arg->sz - 1; j >= 0; j--)
 mdoc_args(struct mdoc *m, int line,                          free(arg->value[j]);
                 int *pos, char *buf, int tok, char **v)                  free(arg->value);
 {  
         int               fl, c, i;  
         struct mdoc_node *n;  
   
         fl = (0 == tok) ? 0 : mdoc_argflags[tok];  
   
         if (MDOC_It != tok)  
                 return(args(m, line, pos, buf, fl, v));  
   
         /*  
          * The `It' macro is a special case, as it acquires parameters from its  
          * parent `Bl' context, specifically, we're concerned with -column.  
          */  
   
         for (n = m->last; n; n = n->parent)  
                 if (MDOC_BLOCK == n->type && MDOC_Bl == n->tok)  
                         break;  
   
         assert(n);  
         c = (int)(n->args ? n->args->argc : 0);  
         assert(c > 0);  
   
         /* LINTED */  
         for (i = 0; i < c; i++) {  
                 if (MDOC_Column != n->args->argv[i].arg)  
                         continue;  
                 fl |= ARGS_TABSEP;  
                 fl &= ~ARGS_DELIM;  
                 break;  
         }          }
   
         return(args(m, line, pos, buf, fl, v));          for (--p->argc; iarg < (int)p->argc; iarg++)
                   p->argv[iarg] = p->argv[iarg+1];
 }  }
   
   enum margserr
 static int  mdoc_args(struct roff_man *mdoc, int line, int *pos,
 args(struct mdoc *m, int line, int *pos,          char *buf, int tok, char **v)
                 char *buf, int fl, char **v)  
 {  {
         int               i;          struct roff_node *n;
         char             *p, *pp;          char             *v_local;
           enum argsflag     fl;
   
           if (v == NULL)
                   v = &v_local;
           fl = tok == TOKEN_NONE ? ARGSFL_NONE : mdocargs[tok].flags;
           if (tok != MDOC_It)
                   return(args(mdoc, line, pos, buf, fl, v));
   
         /*          /*
          * Parse out the terms (like `val' in `.Xx -arg val' or simply           * We know that we're in an `It', so it's reasonable to expect
          * `.Xx val'), which can have all sorts of properties:           * us to be sitting in a `Bl'.  Someday this may not be the case
          *           * (if we allow random `It's sitting out there), so provide a
          *   ARGS_DELIM: use special handling if encountering trailing           * safe fall-back into the default behaviour.
          *   delimiters in the form of [[::delim::][ ]+]+.  
          *  
          *   ARGS_NOWARN: don't post warnings.  This is only used when  
          *   re-parsing delimiters, as the warnings have already been  
          *   posted.  
          *  
          *   ARGS_TABSEP: use special handling for tab/`Ta' separated  
          *   phrases like in `Bl -column'.  
          */           */
   
         assert(*pos);          for (n = mdoc->last; n; n = n->parent)
         assert(' ' != buf[*pos]);                  if (MDOC_Bl == n->tok)
                           if (LIST_column == n->norm->Bl.type) {
                                   fl = ARGSFL_TABSEP;
                                   break;
                           }
   
         if (0 == buf[*pos])          return(args(mdoc, line, pos, buf, fl, v));
                 return(ARGS_EOLN);  }
   
         /*  static enum margserr
          * If the first character is a delimiter and we're to look for  args(struct roff_man *mdoc, int line, int *pos,
          * delimited strings, then pass down the buffer seeing if it                  char *buf, enum argsflag fl, char **v)
          * follows the pattern of [[::delim::][ ]+]+.  {
          */          char            *p, *pp;
           int              pairs;
           enum margserr    rc;
   
         if ((fl & ARGS_DELIM) && mdoc_iscdelim(buf[*pos]) > 1) {          if ('\0' == buf[*pos]) {
                 for (i = *pos; buf[i]; ) {                  if (MDOC_PPHRASE & mdoc->flags)
                         if ( mdoc_iscdelim(buf[i]) < 2)                          return(ARGS_EOLN);
                                 break;                  /*
                         i++;                   * If we're not in a partial phrase and the flag for
                         if (0 == buf[i] || ' ' != buf[i])                   * being a phrase literal is still set, the punctuation
                                 break;                   * is unterminated.
                         i++;                   */
                         while (buf[i] && ' ' == buf[i])                  if (MDOC_PHRASELIT & mdoc->flags)
                                 i++;                          mandoc_msg(MANDOCERR_ARG_QUOTE,
                 }                              mdoc->parse, line, *pos, NULL);
   
                 if (0 == buf[i]) {                  mdoc->flags &= ~MDOC_PHRASELIT;
                         *v = &buf[*pos];                  return(ARGS_EOLN);
                         if (' ' != buf[i - 1])  
                                 return(ARGS_PUNCT);  
                         if (ARGS_NOWARN & fl)  
                                 return(ARGS_PUNCT);  
                         if ( ! mdoc_pwarn(m, line, *pos, ETAILWS))  
                                 return(ARGS_ERROR);  
                         return(ARGS_PUNCT);  
                 }  
         }          }
   
         *v = &buf[*pos];          *v = &buf[*pos];
   
           if (ARGSFL_DELIM == fl)
                   if (args_checkpunct(buf, *pos))
                           return(ARGS_PUNCT);
   
         /*          /*
          * First handle TABSEP items, restricted to `Bl -column'.  This           * First handle TABSEP items, restricted to `Bl -column'.  This
          * ignores conventional token parsing and instead uses tabs or           * ignores conventional token parsing and instead uses tabs or
Line 434  args(struct mdoc *m, int line, int *pos, 
Line 480  args(struct mdoc *m, int line, int *pos, 
          * for arguments at a later phase.           * for arguments at a later phase.
          */           */
   
         if (ARGS_TABSEP & fl) {          if (ARGSFL_TABSEP == fl) {
                 /* Scan ahead to tab (can't be escaped). */                  /* Scan ahead to tab (can't be escaped). */
                 p = strchr(*v, '\t');                  p = strchr(*v, '\t');
                   pp = NULL;
   
                 /* Scan ahead to unescaped `Ta'. */                  /* Scan ahead to unescaped `Ta'. */
                 for (pp = *v; ; pp++) {                  if ( ! (MDOC_PHRASELIT & mdoc->flags))
                         if (NULL == (pp = strstr(pp, "Ta")))                          for (pp = *v; ; pp++) {
                                 break;                                  if (NULL == (pp = strstr(pp, "Ta")))
                         if (pp > *v && ' ' != *(pp - 1))                                          break;
                                 continue;                                  if (pp > *v && ' ' != *(pp - 1))
                         if (' ' == *(pp + 2) || 0 == *(pp + 2))                                          continue;
                                 break;                                  if (' ' == *(pp + 2) || '\0' == *(pp + 2))
                 }                                          break;
                           }
   
                 /*                  /* By default, assume a phrase. */
                   rc = ARGS_PHRASE;
   
                   /*
                  * Adjust new-buffer position to be beyond delimiter                   * Adjust new-buffer position to be beyond delimiter
                  * mark (e.g., Ta -> end + 2).                   * mark (e.g., Ta -> end + 2).
                  */                   */
                 if (p && pp) {                  if (p && pp) {
                         *pos += pp < p ? 2 : 1;                          *pos += pp < p ? 2 : 1;
                           rc = pp < p ? ARGS_PHRASE : ARGS_PPHRASE;
                         p = pp < p ? pp : p;                          p = pp < p ? pp : p;
                 } else if (p && ! pp) {                  } else if (p && ! pp) {
                           rc = ARGS_PPHRASE;
                         *pos += 1;                          *pos += 1;
                 } else if (pp && ! p) {                  } else if (pp && ! p) {
                         p = pp;                          p = pp;
                         *pos += 2;                          *pos += 2;
                 } else                  } else {
                           rc = ARGS_PEND;
                         p = strchr(*v, 0);                          p = strchr(*v, 0);
                   }
   
                 /* Whitespace check for eoln case... */                  /* Whitespace check for eoln case... */
                 if (0 == *p && ' ' == *(p - 1) && ! (ARGS_NOWARN & fl))                  if ('\0' == *p && ' ' == *(p - 1))
                         if ( ! mdoc_pwarn(m, line, *pos, ETAILWS))                          mandoc_msg(MANDOCERR_SPACE_EOL, mdoc->parse,
                                 return(ARGS_ERROR);                              line, *pos, NULL);
   
                 *pos += (int)(p - *v);                  *pos += (int)(p - *v);
   
Line 483  args(struct mdoc *m, int line, int *pos, 
Line 538  args(struct mdoc *m, int line, int *pos, 
                 for (pp = &buf[*pos]; ' ' == *pp; pp++, (*pos)++)                  for (pp = &buf[*pos]; ' ' == *pp; pp++, (*pos)++)
                         /* Skip ahead. */ ;                          /* Skip ahead. */ ;
   
                 return(ARGS_PHRASE);                  return(rc);
         }          }
   
         /*          /*
          * Process a quoted literal.  A quote begins with a double-quote           * Process a quoted literal.  A quote begins with a double-quote
          * and ends with a double-quote NOT preceded by a double-quote.           * and ends with a double-quote NOT preceded by a double-quote.
            * NUL-terminate the literal in place.
            * Collapse pairs of quotes inside quoted literals.
          * Whitespace is NOT involved in literal termination.           * Whitespace is NOT involved in literal termination.
          */           */
   
         if ('\"' == buf[*pos]) {          if (MDOC_PHRASELIT & mdoc->flags || '\"' == buf[*pos]) {
                 *v = &buf[++(*pos)];                  if ( ! (MDOC_PHRASELIT & mdoc->flags))
                           *v = &buf[++(*pos)];
   
                   if (MDOC_PPHRASE & mdoc->flags)
                           mdoc->flags |= MDOC_PHRASELIT;
   
                   pairs = 0;
                 for ( ; buf[*pos]; (*pos)++) {                  for ( ; buf[*pos]; (*pos)++) {
                           /* Move following text left after quoted quotes. */
                           if (pairs)
                                   buf[*pos - pairs] = buf[*pos];
                         if ('\"' != buf[*pos])                          if ('\"' != buf[*pos])
                                 continue;                                  continue;
                           /* Unquoted quotes end quoted args. */
                         if ('\"' != buf[*pos + 1])                          if ('\"' != buf[*pos + 1])
                                 break;                                  break;
                           /* Quoted quotes collapse. */
                           pairs++;
                         (*pos)++;                          (*pos)++;
                 }                  }
                   if (pairs)
                           buf[*pos - pairs] = '\0';
   
                 if (0 == buf[*pos]) {                  if ('\0' == buf[*pos]) {
                         if (ARGS_NOWARN & fl)                          if (MDOC_PPHRASE & mdoc->flags)
                                 return(ARGS_QWORD);                                  return(ARGS_QWORD);
                         if ( ! mdoc_pwarn(m, line, *pos, EQUOTTERM))                          mandoc_msg(MANDOCERR_ARG_QUOTE,
                                 return(ARGS_ERROR);                              mdoc->parse, line, *pos, NULL);
                         return(ARGS_QWORD);                          return(ARGS_QWORD);
                 }                  }
   
                 buf[(*pos)++] = 0;                  mdoc->flags &= ~MDOC_PHRASELIT;
                   buf[(*pos)++] = '\0';
   
                 if (0 == buf[*pos])                  if ('\0' == buf[*pos])
                         return(ARGS_QWORD);                          return(ARGS_QWORD);
   
                 while (' ' == buf[*pos])                  while (' ' == buf[*pos])
                         (*pos)++;                          (*pos)++;
   
                 if (0 == buf[*pos] && ! (ARGS_NOWARN & fl))                  if ('\0' == buf[*pos])
                         if ( ! mdoc_pwarn(m, line, *pos, ETAILWS))                          mandoc_msg(MANDOCERR_SPACE_EOL, mdoc->parse,
                                 return(ARGS_ERROR);                              line, *pos, NULL);
   
                 return(ARGS_QWORD);                  return(ARGS_QWORD);
         }          }
   
         /*          p = &buf[*pos];
          * A non-quoted term progresses until either the end of line or          *v = mandoc_getarg(mdoc->parse, &p, line, pos);
          * a non-escaped whitespace.  
          */  
   
         for ( ; buf[*pos]; (*pos)++)  
                 if (' ' == buf[*pos] && '\\' != buf[*pos - 1])  
                         break;  
   
         if (0 == buf[*pos])  
                 return(ARGS_WORD);  
   
         buf[(*pos)++] = 0;  
   
         while (' ' == buf[*pos])  
                 (*pos)++;  
   
         if (0 == buf[*pos] && ! (ARGS_NOWARN & fl))  
                 if ( ! mdoc_pwarn(m, line, *pos, ETAILWS))  
                         return(ARGS_ERROR);  
   
         return(ARGS_WORD);          return(ARGS_WORD);
 }  }
   
   /*
    * Check if the string consists only of space-separated closing
    * delimiters.  This is a bit of a dance: the first must be a close
    * delimiter, but it may be followed by middle delimiters.  Arbitrary
    * whitespace may separate these tokens.
    */
 static int  static int
 argv_a2arg(int tok, const char *p)  args_checkpunct(const char *buf, int i)
 {  {
           int              j;
           char             dbuf[DELIMSZ];
           enum mdelim      d;
   
         /*          /* First token must be a close-delimiter. */
          * Parse an argument identifier from its text.  XXX - this  
          * should really be table-driven to clarify the code.  
          *  
          * If you add an argument to the list, make sure that you  
          * register it here with its one or more macros!  
          */  
   
         switch (tok) {          for (j = 0; buf[i] && ' ' != buf[i] && j < DELIMSZ; j++, i++)
         case (MDOC_An):                  dbuf[j] = buf[i];
                 if (0 == strcmp(p, "split"))  
                         return(MDOC_Split);  
                 else if (0 == strcmp(p, "nosplit"))  
                         return(MDOC_Nosplit);  
                 break;  
   
         case (MDOC_Bd):          if (DELIMSZ == j)
                 if (0 == strcmp(p, "ragged"))                  return(0);
                         return(MDOC_Ragged);  
                 else if (0 == strcmp(p, "unfilled"))  
                         return(MDOC_Unfilled);  
                 else if (0 == strcmp(p, "filled"))  
                         return(MDOC_Filled);  
                 else if (0 == strcmp(p, "literal"))  
                         return(MDOC_Literal);  
                 else if (0 == strcmp(p, "file"))  
                         return(MDOC_File);  
                 else if (0 == strcmp(p, "offset"))  
                         return(MDOC_Offset);  
                 else if (0 == strcmp(p, "compact"))  
                         return(MDOC_Compact);  
                 else if (0 == strcmp(p, "centered"))  
                         return(MDOC_Centred);  
                 break;  
   
         case (MDOC_Bf):          dbuf[j] = '\0';
                 if (0 == strcmp(p, "emphasis"))          if (DELIM_CLOSE != mdoc_isdelim(dbuf))
                         return(MDOC_Emphasis);                  return(0);
                 else if (0 == strcmp(p, "literal"))  
                         return(MDOC_Literal);  
                 else if (0 == strcmp(p, "symbolic"))  
                         return(MDOC_Symbolic);  
                 break;  
   
         case (MDOC_Bk):          while (' ' == buf[i])
                 if (0 == strcmp(p, "words"))                  i++;
                         return(MDOC_Words);  
                 break;  
   
         case (MDOC_Bl):          /* Remaining must NOT be open/none. */
                 if (0 == strcmp(p, "bullet"))  
                         return(MDOC_Bullet);          while (buf[i]) {
                 else if (0 == strcmp(p, "dash"))                  j = 0;
                         return(MDOC_Dash);                  while (buf[i] && ' ' != buf[i] && j < DELIMSZ)
                 else if (0 == strcmp(p, "hyphen"))                          dbuf[j++] = buf[i++];
                         return(MDOC_Hyphen);  
                 else if (0 == strcmp(p, "item"))                  if (DELIMSZ == j)
                         return(MDOC_Item);                          return(0);
                 else if (0 == strcmp(p, "enum"))  
                         return(MDOC_Enum);                  dbuf[j] = '\0';
                 else if (0 == strcmp(p, "tag"))                  d = mdoc_isdelim(dbuf);
                         return(MDOC_Tag);                  if (DELIM_NONE == d || DELIM_OPEN == d)
                 else if (0 == strcmp(p, "diag"))                          return(0);
                         return(MDOC_Diag);  
                 else if (0 == strcmp(p, "hang"))                  while (' ' == buf[i])
                         return(MDOC_Hang);                          i++;
                 else if (0 == strcmp(p, "ohang"))  
                         return(MDOC_Ohang);  
                 else if (0 == strcmp(p, "inset"))  
                         return(MDOC_Inset);  
                 else if (0 == strcmp(p, "column"))  
                         return(MDOC_Column);  
                 else if (0 == strcmp(p, "width"))  
                         return(MDOC_Width);  
                 else if (0 == strcmp(p, "offset"))  
                         return(MDOC_Offset);  
                 else if (0 == strcmp(p, "compact"))  
                         return(MDOC_Compact);  
                 else if (0 == strcmp(p, "nested"))  
                         return(MDOC_Nested);  
                 break;  
   
         case (MDOC_Rv):  
                 /* FALLTHROUGH */  
         case (MDOC_Ex):  
                 if (0 == strcmp(p, "std"))  
                         return(MDOC_Std);  
                 break;  
         default:  
                 break;  
         }          }
   
         return(MDOC_ARG_MAX);          return('\0' == buf[i]);
 }  }
   
   static void
 static int  argv_multi(struct roff_man *mdoc, int line,
 argv_multi(struct mdoc *m, int line,  
                 struct mdoc_argv *v, int *pos, char *buf)                  struct mdoc_argv *v, int *pos, char *buf)
 {  {
         int              c;          enum margserr    ac;
         char            *p;          char            *p;
   
         for (v->sz = 0; ; v->sz++) {          for (v->sz = 0; ; v->sz++) {
                 if ('-' == buf[*pos])                  if (buf[*pos] == '-')
                         break;                          break;
                 c = args(m, line, pos, buf, 0, &p);                  ac = args(mdoc, line, pos, buf, ARGSFL_NONE, &p);
                 if (ARGS_ERROR == c)                  if (ac == ARGS_EOLN)
                         return(0);  
                 else if (ARGS_EOLN == c)  
                         break;                          break;
   
                 if (0 == v->sz % MULTI_STEP)                  if (v->sz % MULTI_STEP == 0)
                         v->value = mandoc_realloc(v->value,                          v->value = mandoc_reallocarray(v->value,
                                 (v->sz + MULTI_STEP) * sizeof(char *));                              v->sz + MULTI_STEP, sizeof(char *));
   
                 v->value[(int)v->sz] = mandoc_strdup(p);                  v->value[(int)v->sz] = mandoc_strdup(p);
         }          }
   
         return(1);  
 }  }
   
   static void
 static int  argv_single(struct roff_man *mdoc, int line,
 argv_opt_single(struct mdoc *m, int line,  
                 struct mdoc_argv *v, int *pos, char *buf)                  struct mdoc_argv *v, int *pos, char *buf)
 {  {
         int              c;          enum margserr    ac;
         char            *p;          char            *p;
   
         if ('-' == buf[*pos])          ac = args(mdoc, line, pos, buf, ARGSFL_NONE, &p);
                 return(1);          if (ac == ARGS_EOLN)
                   return;
   
         c = args(m, line, pos, buf, 0, &p);  
         if (ARGS_ERROR == c)  
                 return(0);  
         if (ARGS_EOLN == c)  
                 return(1);  
   
         v->sz = 1;          v->sz = 1;
         v->value = mandoc_malloc(sizeof(char *));          v->value = mandoc_malloc(sizeof(char *));
         v->value[0] = mandoc_strdup(p);          v->value[0] = mandoc_strdup(p);
   
         return(1);  
 }  
   
   
 /*  
  * Parse a single, mandatory value from the stream.  
  */  
 static int  
 argv_single(struct mdoc *m, int line,  
                 struct mdoc_argv *v, int *pos, char *buf)  
 {  
         int              c, ppos;  
         char            *p;  
   
         ppos = *pos;  
   
         c = args(m, line, pos, buf, 0, &p);  
         if (ARGS_ERROR == c)  
                 return(0);  
         if (ARGS_EOLN == c)  
                 return(mdoc_perr(m, line, ppos, EARGVAL));  
   
         v->sz = 1;  
         v->value = mandoc_malloc(sizeof(char *));  
         v->value[0] = mandoc_strdup(p);  
   
         return(1);  
 }  
   
   
 /*  
  * Determine rules for parsing arguments.  Arguments can either accept  
  * no parameters, an optional single parameter, one parameter, or  
  * multiple parameters.  
  */  
 static int  
 argv(struct mdoc *mdoc, int line,  
                 struct mdoc_argv *v, int *pos, char *buf)  
 {  
   
         v->sz = 0;  
         v->value = NULL;  
   
         switch (mdoc_argvflags[v->arg]) {  
         case (ARGV_SINGLE):  
                 return(argv_single(mdoc, line, v, pos, buf));  
         case (ARGV_MULTI):  
                 return(argv_multi(mdoc, line, v, pos, buf));  
         case (ARGV_OPT_SINGLE):  
                 return(argv_opt_single(mdoc, line, v, pos, buf));  
         default:  
                 /* ARGV_NONE */  
                 break;  
         }  
   
         return(1);  
 }  }
Legend:
Removed from v.1.34  
changed lines
  Added in v.1.104
CVSweb