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

Diff for /mandoc/mandocdb.c between version 1.87 and 1.100

version 1.87, 2013/12/27 16:40:35 version 1.100, 2014/01/05 04:13:52
Line 1 
Line 1 
 /*      $Id$ */  /*      $Id$ */
 /*  /*
  * Copyright (c) 2011, 2012 Kristaps Dzonsons <kristaps@bsd.lv>   * Copyright (c) 2011, 2012 Kristaps Dzonsons <kristaps@bsd.lv>
  * Copyright (c) 2011, 2012, 2013 Ingo Schwarze <schwarze@openbsd.org>   * Copyright (c) 2011, 2012, 2013, 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 above   * purpose with or without fee is hereby granted, provided that the above
Line 82  enum form {
Line 82  enum form {
 };  };
   
 struct  str {  struct  str {
         char            *utf8; /* key in UTF-8 form */          char            *rendered; /* key in UTF-8 or ASCII form */
         const struct mpage *mpage; /* if set, the owning parse */          const struct mpage *mpage; /* if set, the owning parse */
         uint64_t         mask; /* bitmask in sequence */          uint64_t         mask; /* bitmask in sequence */
         char             key[]; /* the string itself */          char             key[]; /* may contain escape sequences */
 };  };
   
 struct  inodev {  struct  inodev {
Line 143  static void *hash_alloc(size_t, void *);
Line 143  static void *hash_alloc(size_t, void *);
 static  void     hash_free(void *, size_t, void *);  static  void     hash_free(void *, size_t, void *);
 static  void    *hash_halloc(size_t, void *);  static  void    *hash_halloc(size_t, void *);
 static  void     mlink_add(struct mlink *, const struct stat *);  static  void     mlink_add(struct mlink *, const struct stat *);
   static  int      mlink_check(struct mpage *, struct mlink *);
 static  void     mlink_free(struct mlink *);  static  void     mlink_free(struct mlink *);
   static  void     mlinks_undupe(struct mpage *);
 static  void     mpages_free(void);  static  void     mpages_free(void);
 static  void     mpages_merge(struct mchars *, struct mparse *, int);  static  void     mpages_merge(struct mchars *, struct mparse *, int);
 static  void     parse_cat(struct mpage *);  static  void     parse_cat(struct mpage *);
Line 153  static int  parse_mdoc_body(struct mpage *, const stru
Line 155  static int  parse_mdoc_body(struct mpage *, const stru
 static  int      parse_mdoc_head(struct mpage *, const struct mdoc_node *);  static  int      parse_mdoc_head(struct mpage *, const struct mdoc_node *);
 static  int      parse_mdoc_Fd(struct mpage *, const struct mdoc_node *);  static  int      parse_mdoc_Fd(struct mpage *, const struct mdoc_node *);
 static  int      parse_mdoc_Fn(struct mpage *, const struct mdoc_node *);  static  int      parse_mdoc_Fn(struct mpage *, const struct mdoc_node *);
 static  int      parse_mdoc_In(struct mpage *, const struct mdoc_node *);  
 static  int      parse_mdoc_Nd(struct mpage *, const struct mdoc_node *);  static  int      parse_mdoc_Nd(struct mpage *, const struct mdoc_node *);
 static  int      parse_mdoc_Nm(struct mpage *, const struct mdoc_node *);  static  int      parse_mdoc_Nm(struct mpage *, const struct mdoc_node *);
 static  int      parse_mdoc_Sh(struct mpage *, const struct mdoc_node *);  static  int      parse_mdoc_Sh(struct mpage *, const struct mdoc_node *);
 static  int      parse_mdoc_St(struct mpage *, const struct mdoc_node *);  
 static  int      parse_mdoc_Xr(struct mpage *, const struct mdoc_node *);  static  int      parse_mdoc_Xr(struct mpage *, const struct mdoc_node *);
 static  void     putkey(const struct mpage *,  static  void     putkey(const struct mpage *,
                         const char *, uint64_t);                          const char *, uint64_t);
Line 165  static void  putkeys(const struct mpage *,
Line 165  static void  putkeys(const struct mpage *,
                         const char *, size_t, uint64_t);                          const char *, size_t, uint64_t);
 static  void     putmdockey(const struct mpage *,  static  void     putmdockey(const struct mpage *,
                         const struct mdoc_node *, uint64_t);                          const struct mdoc_node *, uint64_t);
   static  void     render_key(struct mchars *, struct str *);
 static  void     say(const char *, const char *, ...);  static  void     say(const char *, const char *, ...);
 static  int      set_basedir(const char *);  static  int      set_basedir(const char *);
 static  int      treescan(void);  static  int      treescan(void);
 static  size_t   utf8(unsigned int, char [7]);  static  size_t   utf8(unsigned int, char [7]);
 static  void     utf8key(struct mchars *, struct str *);  
   
 static  char            *progname;  static  char            *progname;
 static  int              use_all; /* use all found files */  static  int              use_all; /* use all found files */
 static  int              nodb; /* no database changes */  static  int              nodb; /* no database changes */
 static  int              verb; /* print what we're doing */  static  int              verb; /* print what we're doing */
 static  int              warnings; /* warn about crap */  static  int              warnings; /* warn about crap */
   static  int              write_utf8; /* write UTF-8 output; else ASCII */
 static  int              exitcode; /* to be returned by main */  static  int              exitcode; /* to be returned by main */
 static  enum op          op; /* operational mode */  static  enum op          op; /* operational mode */
 static  char             basedir[PATH_MAX]; /* current base directory */  static  char             basedir[PATH_MAX]; /* current base directory */
Line 215  static const struct mdoc_handler mdocs[MDOC_MAX] = {
Line 216  static const struct mdoc_handler mdocs[MDOC_MAX] = {
         { parse_mdoc_Fn, 0 },  /* Fn */          { parse_mdoc_Fn, 0 },  /* Fn */
         { NULL, TYPE_Ft },  /* Ft */          { NULL, TYPE_Ft },  /* Ft */
         { NULL, TYPE_Ic },  /* Ic */          { NULL, TYPE_Ic },  /* Ic */
         { parse_mdoc_In, TYPE_In },  /* In */          { NULL, TYPE_In },  /* In */
         { NULL, TYPE_Li },  /* Li */          { NULL, TYPE_Li },  /* Li */
         { parse_mdoc_Nd, TYPE_Nd },  /* Nd */          { parse_mdoc_Nd, TYPE_Nd },  /* Nd */
         { parse_mdoc_Nm, TYPE_Nm },  /* Nm */          { parse_mdoc_Nm, TYPE_Nm },  /* Nm */
Line 223  static const struct mdoc_handler mdocs[MDOC_MAX] = {
Line 224  static const struct mdoc_handler mdocs[MDOC_MAX] = {
         { NULL, 0 },  /* Ot */          { NULL, 0 },  /* Ot */
         { NULL, TYPE_Pa },  /* Pa */          { NULL, TYPE_Pa },  /* Pa */
         { NULL, 0 },  /* Rv */          { NULL, 0 },  /* Rv */
         { parse_mdoc_St, 0 },  /* St */          { NULL, TYPE_St },  /* St */
         { NULL, TYPE_Va },  /* Va */          { NULL, TYPE_Va },  /* Va */
         { parse_mdoc_body, TYPE_Va },  /* Vt */          { parse_mdoc_body, TYPE_Va },  /* Vt */
         { parse_mdoc_Xr, 0 },  /* Xr */          { parse_mdoc_Xr, 0 },  /* Xr */
Line 351  main(int argc, char *argv[])
Line 352  main(int argc, char *argv[])
         path_arg = NULL;          path_arg = NULL;
         op = OP_DEFAULT;          op = OP_DEFAULT;
   
         while (-1 != (ch = getopt(argc, argv, "aC:d:ntu:vW")))          while (-1 != (ch = getopt(argc, argv, "aC:d:nT:tu:vW")))
                 switch (ch) {                  switch (ch) {
                 case ('a'):                  case ('a'):
                         use_all = 1;                          use_all = 1;
Line 369  main(int argc, char *argv[])
Line 370  main(int argc, char *argv[])
                 case ('n'):                  case ('n'):
                         nodb = 1;                          nodb = 1;
                         break;                          break;
                   case ('T'):
                           if (strcmp(optarg, "utf8")) {
                                   fprintf(stderr, "-T%s: Unsupported "
                                       "output format\n", optarg);
                                   goto usage;
                           }
                           write_utf8 = 1;
                           break;
                 case ('t'):                  case ('t'):
                         CHECKOP(op, ch);                          CHECKOP(op, ch);
                         dup2(STDOUT_FILENO, STDERR_FILENO);                          dup2(STDOUT_FILENO, STDERR_FILENO);
Line 490  out:
Line 499  out:
         ohash_delete(&mlinks);          ohash_delete(&mlinks);
         return(exitcode);          return(exitcode);
 usage:  usage:
         fprintf(stderr, "usage: %s [-anvW] [-C file]\n"          fprintf(stderr, "usage: %s [-anvW] [-C file] [-Tutf8]\n"
                         "       %s [-anvW] dir ...\n"                          "       %s [-anvW] [-Tutf8] dir ...\n"
                         "       %s [-nvW] -d dir [file ...]\n"                          "       %s [-nvW] [-Tutf8] -d dir [file ...]\n"
                         "       %s [-nvW] -u dir [file ...]\n"                          "       %s [-nvW] -u dir [file ...]\n"
                         "       %s -t file ...\n",                          "       %s -t file ...\n",
                        progname, progname, progname,                         progname, progname, progname,
Line 522  treescan(void)
Line 531  treescan(void)
         FTSENT          *ff;          FTSENT          *ff;
         struct mlink    *mlink;          struct mlink    *mlink;
         int              dform;          int              dform;
         char            *fsec;          char            *dsec, *arch, *fsec, *cp;
         const char      *dsec, *arch, *cp, *path;          const char      *path;
         const char      *argv[2];          const char      *argv[2];
   
         argv[0] = ".";          argv[0] = ".";
Line 548  treescan(void)
Line 557  treescan(void)
                 /*                  /*
                  * If we're a regular file, add an mlink by using the                   * If we're a regular file, add an mlink by using the
                  * stored directory data and handling the filename.                   * stored directory data and handling the filename.
                  * Disallow duplicate (hard-linked) files.  
                  */                   */
                 if (FTS_F == ff->fts_info) {                  if (FTS_F == ff->fts_info) {
                         if (0 == strcmp(path, MANDOC_DB))                          if (0 == strcmp(path, MANDOC_DB))
Line 589  treescan(void)
Line 597  treescan(void)
                                 continue;                                  continue;
                         } else                          } else
                                 fsec[-1] = '\0';                                  fsec[-1] = '\0';
   
                         mlink = mandoc_calloc(1, sizeof(struct mlink));                          mlink = mandoc_calloc(1, sizeof(struct mlink));
                         strlcpy(mlink->file, path, sizeof(mlink->file));                          strlcpy(mlink->file, path, sizeof(mlink->file));
                         mlink->dform = dform;                          mlink->dform = dform;
                         if (NULL != dsec)                          mlink->dsec = dsec;
                                 mlink->dsec = mandoc_strdup(dsec);                          mlink->arch = arch;
                         if (NULL != arch)                          mlink->name = ff->fts_name;
                                 mlink->arch = mandoc_strdup(arch);                          mlink->fsec = fsec;
                         mlink->name = mandoc_strdup(ff->fts_name);  
                         if (NULL != fsec)  
                                 mlink->fsec = mandoc_strdup(fsec);  
                         mlink_add(mlink, ff->fts_statp);                          mlink_add(mlink, ff->fts_statp);
                         continue;                          continue;
                 } else if (FTS_D != ff->fts_info &&                  } else if (FTS_D != ff->fts_info &&
Line 618  treescan(void)
Line 624  treescan(void)
                          * Try to infer this from the name.                           * Try to infer this from the name.
                          * If we're not in use_all, enforce it.                           * If we're not in use_all, enforce it.
                          */                           */
                         dsec = NULL;  
                         dform = FORM_NONE;  
                         cp = ff->fts_name;                          cp = ff->fts_name;
                         if (FTS_DP == ff->fts_info)                          if (FTS_DP == ff->fts_info)
                                 break;                                  break;
Line 630  treescan(void)
Line 634  treescan(void)
                         } else if (0 == strncmp(cp, "cat", 3)) {                          } else if (0 == strncmp(cp, "cat", 3)) {
                                 dform = FORM_CAT;                                  dform = FORM_CAT;
                                 dsec = cp + 3;                                  dsec = cp + 3;
                           } else {
                                   dform = FORM_NONE;
                                   dsec = NULL;
                         }                          }
   
                         if (NULL != dsec || use_all)                          if (NULL != dsec || use_all)
Line 644  treescan(void)
Line 651  treescan(void)
                          * Possibly our architecture.                           * Possibly our architecture.
                          * If we're descending, keep tabs on it.                           * If we're descending, keep tabs on it.
                          */                           */
                         arch = NULL;  
                         if (FTS_DP != ff->fts_info && NULL != dsec)                          if (FTS_DP != ff->fts_info && NULL != dsec)
                                 arch = ff->fts_name;                                  arch = ff->fts_name;
                           else
                                   arch = NULL;
                         break;                          break;
                 default:                  default:
                         if (FTS_DP == ff->fts_info || use_all)                          if (FTS_DP == ff->fts_info || use_all)
Line 663  treescan(void)
Line 671  treescan(void)
 }  }
   
 /*  /*
  * Add a file to the file vector.   * Add a file to the mlinks table.
  * Do not verify that it's a "valid" looking manpage (we'll do that   * Do not verify that it's a "valid" looking manpage (we'll do that
  * later).   * later).
  *   *
Line 674  treescan(void)
Line 682  treescan(void)
  *   or   *   or
  *   [./]cat<section>[/<arch>]/<name>.0   *   [./]cat<section>[/<arch>]/<name>.0
  *   *
  * Stuff this information directly into the mlink vector.  
  * See treescan() for the fts(3) version of this.   * See treescan() for the fts(3) version of this.
  */   */
 static void  static void
Line 721  filescan(const char *file)
Line 728  filescan(const char *file)
                 *p++ = '\0';                  *p++ = '\0';
                 if (0 == strncmp(start, "man", 3)) {                  if (0 == strncmp(start, "man", 3)) {
                         mlink->dform = FORM_SRC;                          mlink->dform = FORM_SRC;
                         mlink->dsec = mandoc_strdup(start + 3);                          mlink->dsec = start + 3;
                 } else if (0 == strncmp(start, "cat", 3)) {                  } else if (0 == strncmp(start, "cat", 3)) {
                         mlink->dform = FORM_CAT;                          mlink->dform = FORM_CAT;
                         mlink->dsec = mandoc_strdup(start + 3);                          mlink->dsec = start + 3;
                 }                  }
   
                 start = p;                  start = p;
                 if (NULL != mlink->dsec && NULL != (p = strchr(start, '/'))) {                  if (NULL != mlink->dsec && NULL != (p = strchr(start, '/'))) {
                         *p++ = '\0';                          *p++ = '\0';
                         mlink->arch = mandoc_strdup(start);                          mlink->arch = start;
                         start = p;                          start = p;
                 }                  }
         }          }
Line 745  filescan(const char *file)
Line 752  filescan(const char *file)
   
         if ('.' == *p) {          if ('.' == *p) {
                 *p++ = '\0';                  *p++ = '\0';
                 mlink->fsec = mandoc_strdup(p);                  mlink->fsec = p;
         }          }
   
         /*          /*
Line 757  filescan(const char *file)
Line 764  filescan(const char *file)
                 mlink->name = p + 1;                  mlink->name = p + 1;
                 *p = '\0';                  *p = '\0';
         }          }
         mlink->name = mandoc_strdup(mlink->name);  
   
         mlink_add(mlink, &st);          mlink_add(mlink, &st);
 }  }
   
Line 771  mlink_add(struct mlink *mlink, const struct stat *st)
Line 776  mlink_add(struct mlink *mlink, const struct stat *st)
   
         assert(NULL != mlink->file);          assert(NULL != mlink->file);
   
         if (NULL == mlink->dsec)          mlink->dsec = mandoc_strdup(mlink->dsec ? mlink->dsec : "");
                 mlink->dsec = mandoc_strdup("");          mlink->arch = mandoc_strdup(mlink->arch ? mlink->arch : "");
         if (NULL == mlink->arch)          mlink->name = mandoc_strdup(mlink->name ? mlink->name : "");
                 mlink->arch = mandoc_strdup("");          mlink->fsec = mandoc_strdup(mlink->fsec ? mlink->fsec : "");
         if (NULL == mlink->name)  
                 mlink->name = mandoc_strdup("");  
         if (NULL == mlink->fsec)  
                 mlink->fsec = mandoc_strdup("");  
   
         if ('0' == *mlink->fsec) {          if ('0' == *mlink->fsec) {
                 free(mlink->fsec);                  free(mlink->fsec);
Line 842  mpages_free(void)
Line 843  mpages_free(void)
 }  }
   
 /*  /*
    * For each mlink to the mpage, check whether the path looks like
    * it is formatted, and if it does, check whether a source manual
    * exists by the same name, ignoring the suffix.
    * If both conditions hold, drop the mlink.
    */
   static void
   mlinks_undupe(struct mpage *mpage)
   {
           char              buf[PATH_MAX];
           struct mlink    **prev;
           struct mlink     *mlink;
           char             *bufp;
   
           mpage->form = FORM_CAT;
           prev = &mpage->mlinks;
           while (NULL != (mlink = *prev)) {
                   if (FORM_CAT != mlink->dform) {
                           mpage->form = FORM_NONE;
                           goto nextlink;
                   }
                   if (strlcpy(buf, mlink->file, PATH_MAX) >= PATH_MAX) {
                           if (warnings)
                                   say(mlink->file, "Filename too long");
                           goto nextlink;
                   }
                   bufp = strstr(buf, "cat");
                   assert(NULL != bufp);
                   memcpy(bufp, "man", 3);
                   if (NULL != (bufp = strrchr(buf, '.')))
                           *++bufp = '\0';
                   strlcat(buf, mlink->dsec, PATH_MAX);
                   if (NULL == ohash_find(&mlinks,
                                   ohash_qlookup(&mlinks, buf)))
                           goto nextlink;
                   if (warnings)
                           say(mlink->file, "Man source exists: %s", buf);
                   if (use_all)
                           goto nextlink;
                   *prev = mlink->next;
                   mlink_free(mlink);
                   continue;
   nextlink:
                   prev = &(*prev)->next;
           }
   }
   
   static int
   mlink_check(struct mpage *mpage, struct mlink *mlink)
   {
           int      match;
   
           match = 1;
   
           /*
            * Check whether the manual section given in a file
            * agrees with the directory where the file is located.
            * Some manuals have suffixes like (3p) on their
            * section number either inside the file or in the
            * directory name, some are linked into more than one
            * section, like encrypt(1) = makekey(8).
            */
   
           if (FORM_SRC == mpage->form &&
               strcasecmp(mpage->sec, mlink->dsec)) {
                   match = 0;
                   say(mlink->file, "Section \"%s\" manual in %s directory",
                       mpage->sec, mlink->dsec);
           }
   
           /*
            * Manual page directories exist for each kernel
            * architecture as returned by machine(1).
            * However, many manuals only depend on the
            * application architecture as returned by arch(1).
            * For example, some (2/ARM) manuals are shared
            * across the "armish" and "zaurus" kernel
            * architectures.
            * A few manuals are even shared across completely
            * different architectures, for example fdformat(1)
            * on amd64, i386, sparc, and sparc64.
            */
   
           if (strcasecmp(mpage->arch, mlink->arch)) {
                   match = 0;
                   say(mlink->file, "Architecture \"%s\" manual in "
                       "\"%s\" directory", mpage->arch, mlink->arch);
           }
   
           if (strcasecmp(mpage->title, mlink->name))
                   match = 0;
   
           return(match);
   }
   
   /*
  * Run through the files in the global vector "mpages"   * Run through the files in the global vector "mpages"
  * and add them to the database specified in "basedir".   * and add them to the database specified in "basedir".
  *   *
Line 853  mpages_merge(struct mchars *mc, struct mparse *mp, int
Line 949  mpages_merge(struct mchars *mc, struct mparse *mp, int
 {  {
         struct ohash             title_table;          struct ohash             title_table;
         struct ohash_info        title_info, str_info;          struct ohash_info        title_info, str_info;
         char                     buf[PATH_MAX];  
         struct mpage            *mpage;          struct mpage            *mpage;
           struct mlink            *mlink;
         struct mdoc             *mdoc;          struct mdoc             *mdoc;
         struct man              *man;          struct man              *man;
         struct title            *title_entry;          struct title            *title_entry;
         char                    *bufp, *title_str;          char                    *title_str;
         const char              *cp;          const char              *cp;
         size_t                   sz;  
         int                      match;          int                      match;
         unsigned int             pslot, tslot;          unsigned int             pslot, tslot;
         enum mandoclevel         lvl;          enum mandoclevel         lvl;
Line 880  mpages_merge(struct mchars *mc, struct mparse *mp, int
Line 975  mpages_merge(struct mchars *mc, struct mparse *mp, int
   
         mpage = ohash_first(&mpages, &pslot);          mpage = ohash_first(&mpages, &pslot);
         while (NULL != mpage) {          while (NULL != mpage) {
                 /*                  mlinks_undupe(mpage);
                  * If we're a catpage (as defined by our path), then see                  if (NULL == mpage->mlinks) {
                  * if a manpage exists by the same name (ignoring the                          mpage = ohash_next(&mpages, &pslot);
                  * suffix).                          continue;
                  * If it does, then we want to use it instead of our  
                  * own.  
                  */  
                 if ( ! use_all && FORM_CAT == mpage->mlinks->dform) {  
                         sz = strlcpy(buf, mpage->mlinks->file, PATH_MAX);  
                         if (sz >= PATH_MAX) {  
                                 if (warnings)  
                                         say(mpage->mlinks->file,  
                                             "Filename too long");  
                                 mpage = ohash_next(&mpages, &pslot);  
                                 continue;  
                         }  
                         bufp = strstr(buf, "cat");  
                         assert(NULL != bufp);  
                         memcpy(bufp, "man", 3);  
                         if (NULL != (bufp = strrchr(buf, '.')))  
                                 *++bufp = '\0';  
                         strlcat(buf, mpage->mlinks->dsec, PATH_MAX);  
                         if (NULL != ohash_find(&mlinks,  
                                         ohash_qlookup(&mlinks, buf))) {  
                                 if (warnings)  
                                         say(mpage->mlinks->file, "Man "  
                                             "source exists: %s", buf);  
                                 mpage = ohash_next(&mpages, &pslot);  
                                 continue;  
                         }  
                 }                  }
   
                 ohash_init(&strings, 6, &str_info);                  ohash_init(&strings, 6, &str_info);
                 mparse_reset(mp);                  mparse_reset(mp);
                 mdoc = NULL;                  mdoc = NULL;
                 man = NULL;                  man = NULL;
                 match = 1;  
   
                 /*                  /*
                  * Try interpreting the file as mdoc(7) or man(7)                   * Try interpreting the file as mdoc(7) or man(7)
Line 956  mpages_merge(struct mchars *mc, struct mparse *mp, int
Line 1024  mpages_merge(struct mchars *mc, struct mparse *mp, int
                         mpage->title =                          mpage->title =
                             mandoc_strdup(mpage->mlinks->name);                              mandoc_strdup(mpage->mlinks->name);
                 }                  }
                   putkey(mpage, mpage->sec, TYPE_sec);
                   putkey(mpage, '\0' == *mpage->arch ?
                       "any" : mpage->arch, TYPE_arch);
   
                 /*                  for (mlink = mpage->mlinks; mlink; mlink = mlink->next) {
                  * Check whether the manual section given in a file                          if ('\0' != *mlink->dsec)
                  * agrees with the directory where the file is located.                                  putkey(mpage, mlink->dsec, TYPE_sec);
                  * Some manuals have suffixes like (3p) on their                          if ('\0' != *mlink->fsec)
                  * section number either inside the file or in the                                  putkey(mpage, mlink->fsec, TYPE_sec);
                  * directory name, some are linked into more than one                          putkey(mpage, '\0' == *mlink->arch ?
                  * section, like encrypt(1) = makekey(8).  Do not skip                              "any" : mlink->arch, TYPE_arch);
                  * manuals for such reasons.                          putkey(mpage, mlink->name, TYPE_Nm);
                  */  
                 if (warnings && !use_all && FORM_SRC == mpage->form &&  
                     strcasecmp(mpage->sec, mpage->mlinks->dsec)) {  
                         match = 0;  
                         say(mpage->mlinks->file, "Section \"%s\" "  
                                 "manual in %s directory",  
                                 mpage->sec, mpage->mlinks->dsec);  
                 }                  }
   
                 /*                  if (warnings && !use_all) {
                  * Manual page directories exist for each kernel  
                  * architecture as returned by machine(1).  
                  * However, many manuals only depend on the  
                  * application architecture as returned by arch(1).  
                  * For example, some (2/ARM) manuals are shared  
                  * across the "armish" and "zaurus" kernel  
                  * architectures.  
                  * A few manuals are even shared across completely  
                  * different architectures, for example fdformat(1)  
                  * on amd64, i386, sparc, and sparc64.  
                  * Thus, warn about architecture mismatches,  
                  * but don't skip manuals for this reason.  
                  */  
                 if (warnings && !use_all &&  
                     strcasecmp(mpage->arch, mpage->mlinks->arch)) {  
                         match = 0;                          match = 0;
                         say(mpage->mlinks->file, "Architecture \"%s\" "                          for (mlink = mpage->mlinks; mlink;
                                 "manual in \"%s\" directory",                               mlink = mlink->next)
                                 mpage->arch, mpage->mlinks->arch);                                  if (mlink_check(mpage, mlink))
                 }                                          match = 1;
                 if (warnings && !use_all &&                  } else
                     strcasecmp(mpage->title, mpage->mlinks->name))                          match = 1;
                         match = 0;  
   
                 putkey(mpage, mpage->mlinks->name, TYPE_Nm);  
   
                 if (NULL != mdoc) {                  if (NULL != mdoc) {
                         if (NULL != (cp = mdoc_meta(mdoc)->name))                          if (NULL != (cp = mdoc_meta(mdoc)->name))
                                 putkey(mpage, cp, TYPE_Nm);                                  putkey(mpage, cp, TYPE_Nm);
Line 1423  parse_mdoc_Fd(struct mpage *mpage, const struct mdoc_n
Line 1469  parse_mdoc_Fd(struct mpage *mpage, const struct mdoc_n
   
         if (end > start)          if (end > start)
                 putkeys(mpage, start, end - start + 1, TYPE_In);                  putkeys(mpage, start, end - start + 1, TYPE_In);
         return(1);          return(0);
 }  }
   
 static int  static int
 parse_mdoc_In(struct mpage *mpage, const struct mdoc_node *n)  
 {  
   
         if (NULL != n->child && MDOC_TEXT == n->child->type)  
                 return(0);  
   
         putkey(mpage, n->child->string, TYPE_In);  
         return(1);  
 }  
   
 static int  
 parse_mdoc_Fn(struct mpage *mpage, const struct mdoc_node *n)  parse_mdoc_Fn(struct mpage *mpage, const struct mdoc_node *n)
 {  {
         const char      *cp;          const char      *cp;
Line 1471  parse_mdoc_Fn(struct mpage *mpage, const struct mdoc_n
Line 1506  parse_mdoc_Fn(struct mpage *mpage, const struct mdoc_n
 }  }
   
 static int  static int
 parse_mdoc_St(struct mpage *mpage, const struct mdoc_node *n)  
 {  
   
         if (NULL == n->child || MDOC_TEXT != n->child->type)  
                 return(0);  
   
         putkey(mpage, n->child->string, TYPE_St);  
         return(1);  
 }  
   
 static int  
 parse_mdoc_Xr(struct mpage *mpage, const struct mdoc_node *n)  parse_mdoc_Xr(struct mpage *mpage, const struct mdoc_node *n)
 {  {
         char    *cp;          char    *cp;
Line 1538  static int
Line 1562  static int
 parse_mdoc_Nm(struct mpage *mpage, const struct mdoc_node *n)  parse_mdoc_Nm(struct mpage *mpage, const struct mdoc_node *n)
 {  {
   
         if (SEC_NAME == n->sec)          return(SEC_NAME == n->sec ||
                 return(1);              (SEC_SYNOPSIS == n->sec && MDOC_HEAD == n->type));
         else if (SEC_SYNOPSIS != n->sec || MDOC_HEAD != n->type)  
                 return(0);  
   
         return(1);  
 }  }
   
 static int  static int
Line 1652  utf8(unsigned int cp, char out[7])
Line 1672  utf8(unsigned int cp, char out[7])
 }  }
   
 /*  /*
  * Store the UTF-8 version of a key, or alias the pointer if the key has   * Store the rendered version of a key, or alias the pointer
  * no UTF-8 transcription marks in it.   * if the key contains no escape sequences.
  */   */
 static void  static void
 utf8key(struct mchars *mc, struct str *key)  render_key(struct mchars *mc, struct str *key)
 {  {
         size_t           sz, bsz, pos;          size_t           sz, bsz, pos;
         char             utfbuf[7], res[5];          char             utfbuf[7], res[5];
Line 1665  utf8key(struct mchars *mc, struct str *key)
Line 1685  utf8key(struct mchars *mc, struct str *key)
         int              len, u;          int              len, u;
         enum mandoc_esc  esc;          enum mandoc_esc  esc;
   
         assert(NULL == key->utf8);          assert(NULL == key->rendered);
   
         res[0] = '\\';          res[0] = '\\';
         res[1] = '\t';          res[1] = '\t';
Line 1681  utf8key(struct mchars *mc, struct str *key)
Line 1701  utf8key(struct mchars *mc, struct str *key)
          * pointer as ourselvse and get out of here.           * pointer as ourselvse and get out of here.
          */           */
         if (strcspn(val, res) == bsz) {          if (strcspn(val, res) == bsz) {
                 key->utf8 = key->key;                  key->rendered = key->key;
                 return;                  return;
         }          }
   
Line 1716  utf8key(struct mchars *mc, struct str *key)
Line 1736  utf8key(struct mchars *mc, struct str *key)
                 /* Read past the slash. */                  /* Read past the slash. */
   
                 val++;                  val++;
                 u = 0;  
   
                 /*                  /*
                  * Parse the escape sequence and see if it's a                   * Parse the escape sequence and see if it's a
                  * predefined character or special character.                   * predefined character or special character.
                  */                   */
   
                 esc = mandoc_escape                  esc = mandoc_escape
                         ((const char **)&val, &seq, &len);                          ((const char **)&val, &seq, &len);
                 if (ESCAPE_ERROR == esc)                  if (ESCAPE_ERROR == esc)
                         break;                          break;
   
                 if (ESCAPE_SPECIAL != esc)                  if (ESCAPE_SPECIAL != esc)
                         continue;                          continue;
                 if (0 == (u = mchars_spec2cp(mc, seq, len)))  
                         continue;  
   
                 /*                  /*
                  * If we have a Unicode codepoint, try to convert that                   * Render the special character
                  * to a UTF-8 byte string.                   * as either UTF-8 or ASCII.
                  */                   */
                 cpp = utfbuf;  
                 if (0 == (sz = utf8(u, utfbuf)))  
                         continue;  
   
                   if (write_utf8) {
                           if (0 == (u = mchars_spec2cp(mc, seq, len)))
                                   continue;
                           cpp = utfbuf;
                           if (0 == (sz = utf8(u, utfbuf)))
                                   continue;
                           sz = strlen(cpp);
                   } else {
                           cpp = mchars_spec2str(mc, seq, len, &sz);
                           if (NULL == cpp)
                                   continue;
                           if (ASCII_NBRSP == *cpp) {
                                   cpp = " ";
                                   sz = 1;
                           }
                   }
   
                 /* Copy the rendered glyph into the stream. */                  /* Copy the rendered glyph into the stream. */
   
                 sz = strlen(cpp);  
                 bsz += sz;                  bsz += sz;
   
                 buf = mandoc_realloc(buf, bsz);                  buf = mandoc_realloc(buf, bsz);
   
                 memcpy(&buf[pos], cpp, sz);                  memcpy(&buf[pos], cpp, sz);
                 pos += sz;                  pos += sz;
         }          }
   
         buf[pos] = '\0';          buf[pos] = '\0';
         key->utf8 = buf;          key->rendered = buf;
 }  }
   
 /*  /*
  * Flush the current page's terms (and their bits) into the database.   * Flush the current page's terms (and their bits) into the database.
  * Wrap the entire set of additions in a transaction to make sqlite be a   * Wrap the entire set of additions in a transaction to make sqlite be a
  * little faster.   * little faster.
  * Also, UTF-8-encode the description at the last possible moment.   * Also, handle escape sequences at the last possible moment.
  */   */
 static void  static void
 dbindex(const struct mpage *mpage, struct mchars *mc)  dbindex(const struct mpage *mpage, struct mchars *mc)
Line 1782  dbindex(const struct mpage *mpage, struct mchars *mc)
Line 1810  dbindex(const struct mpage *mpage, struct mchars *mc)
                 key = ohash_find(&strings,                  key = ohash_find(&strings,
                         ohash_qlookup(&strings, mpage->desc));                          ohash_qlookup(&strings, mpage->desc));
                 assert(NULL != key);                  assert(NULL != key);
                 if (NULL == key->utf8)                  if (NULL == key->rendered)
                         utf8key(mc, key);                          render_key(mc, key);
                 desc = key->utf8;                  desc = key->rendered;
         }          }
   
         SQL_EXEC("BEGIN TRANSACTION");          SQL_EXEC("BEGIN TRANSACTION");
   
         i = 1;          i = 1;
         /*  
          * XXX The following three lines are obsolete  
          * and only kept for backward compatibility  
          * until apropos(1) and friends have caught up.  
          */  
         SQL_BIND_TEXT(stmts[STMT_INSERT_PAGE], i, mpage->mlinks->file);  
         SQL_BIND_TEXT(stmts[STMT_INSERT_PAGE], i, mpage->mlinks->dsec);  
         SQL_BIND_TEXT(stmts[STMT_INSERT_PAGE], i, mpage->mlinks->arch);  
         SQL_BIND_TEXT(stmts[STMT_INSERT_PAGE], i, desc);          SQL_BIND_TEXT(stmts[STMT_INSERT_PAGE], i, desc);
         SQL_BIND_INT(stmts[STMT_INSERT_PAGE], i, FORM_SRC == mpage->form);          SQL_BIND_INT(stmts[STMT_INSERT_PAGE], i, FORM_SRC == mpage->form);
         SQL_STEP(stmts[STMT_INSERT_PAGE]);          SQL_STEP(stmts[STMT_INSERT_PAGE]);
Line 1806  dbindex(const struct mpage *mpage, struct mchars *mc)
Line 1826  dbindex(const struct mpage *mpage, struct mchars *mc)
   
         for (mlink = mpage->mlinks; mlink; mlink = mlink->next) {          for (mlink = mpage->mlinks; mlink; mlink = mlink->next) {
                 i = 1;                  i = 1;
                   SQL_BIND_TEXT(stmts[STMT_INSERT_LINK], i, mlink->file);
                 SQL_BIND_TEXT(stmts[STMT_INSERT_LINK], i, mlink->dsec);                  SQL_BIND_TEXT(stmts[STMT_INSERT_LINK], i, mlink->dsec);
                 SQL_BIND_TEXT(stmts[STMT_INSERT_LINK], i, mlink->arch);                  SQL_BIND_TEXT(stmts[STMT_INSERT_LINK], i, mlink->arch);
                 SQL_BIND_TEXT(stmts[STMT_INSERT_LINK], i, mlink->file);                  SQL_BIND_TEXT(stmts[STMT_INSERT_LINK], i, mlink->name);
                 SQL_BIND_INT64(stmts[STMT_INSERT_LINK], i, recno);                  SQL_BIND_INT64(stmts[STMT_INSERT_LINK], i, recno);
                 SQL_STEP(stmts[STMT_INSERT_LINK]);                  SQL_STEP(stmts[STMT_INSERT_LINK]);
                 sqlite3_reset(stmts[STMT_INSERT_LINK]);                  sqlite3_reset(stmts[STMT_INSERT_LINK]);
Line 1817  dbindex(const struct mpage *mpage, struct mchars *mc)
Line 1838  dbindex(const struct mpage *mpage, struct mchars *mc)
         for (key = ohash_first(&strings, &slot); NULL != key;          for (key = ohash_first(&strings, &slot); NULL != key;
              key = ohash_next(&strings, &slot)) {               key = ohash_next(&strings, &slot)) {
                 assert(key->mpage == mpage);                  assert(key->mpage == mpage);
                 if (NULL == key->utf8)                  if (NULL == key->rendered)
                         utf8key(mc, key);                          render_key(mc, key);
                 i = 1;                  i = 1;
                 SQL_BIND_INT64(stmts[STMT_INSERT_KEY], i, key->mask);                  SQL_BIND_INT64(stmts[STMT_INSERT_KEY], i, key->mask);
                 SQL_BIND_TEXT(stmts[STMT_INSERT_KEY], i, key->utf8);                  SQL_BIND_TEXT(stmts[STMT_INSERT_KEY], i, key->rendered);
                 SQL_BIND_INT64(stmts[STMT_INSERT_KEY], i, recno);                  SQL_BIND_INT64(stmts[STMT_INSERT_KEY], i, recno);
                 SQL_STEP(stmts[STMT_INSERT_KEY]);                  SQL_STEP(stmts[STMT_INSERT_KEY]);
                 sqlite3_reset(stmts[STMT_INSERT_KEY]);                  sqlite3_reset(stmts[STMT_INSERT_KEY]);
                 if (key->utf8 != key->key)                  if (key->rendered != key->key)
                         free(key->utf8);                          free(key->rendered);
                 free(key);                  free(key);
         }          }
   
Line 1933  dbopen(int real)
Line 1954  dbopen(int real)
                 return(0);                  return(0);
         }          }
   
         /*  
          * XXX The first three columns in table mpages are obsolete  
          * and only kept for backward compatibility  
          * until apropos(1) and friends have caught up.  
          */  
         sql = "CREATE TABLE \"mpages\" (\n"          sql = "CREATE TABLE \"mpages\" (\n"
               " \"file\" TEXT NOT NULL,\n"  
               " \"sec\" TEXT NOT NULL,\n"  
               " \"arch\" TEXT NOT NULL,\n"  
               " \"desc\" TEXT NOT NULL,\n"                " \"desc\" TEXT NOT NULL,\n"
               " \"form\" INTEGER NOT NULL,\n"                " \"form\" INTEGER NOT NULL,\n"
               " \"id\" INTEGER PRIMARY KEY AUTOINCREMENT NOT NULL\n"                " \"id\" INTEGER PRIMARY KEY AUTOINCREMENT NOT NULL\n"
               ");\n"                ");\n"
               "\n"                "\n"
               "CREATE TABLE \"mlinks\" (\n"                "CREATE TABLE \"mlinks\" (\n"
                 " \"file\" TEXT NOT NULL,\n"
               " \"sec\" TEXT NOT NULL,\n"                " \"sec\" TEXT NOT NULL,\n"
               " \"arch\" TEXT NOT NULL,\n"                " \"arch\" TEXT NOT NULL,\n"
               " \"name\" TEXT NOT NULL,\n"                " \"name\" TEXT NOT NULL,\n"
Line 1977  prepare_statements:
Line 1991  prepare_statements:
         sql = "DELETE FROM mpages where file=?";          sql = "DELETE FROM mpages where file=?";
         sqlite3_prepare_v2(db, sql, -1, &stmts[STMT_DELETE_PAGE], NULL);          sqlite3_prepare_v2(db, sql, -1, &stmts[STMT_DELETE_PAGE], NULL);
         sql = "INSERT INTO mpages "          sql = "INSERT INTO mpages "
                 "(file,sec,arch,desc,form) VALUES (?,?,?,?,?)";                  "(desc,form) VALUES (?,?)";
         sqlite3_prepare_v2(db, sql, -1, &stmts[STMT_INSERT_PAGE], NULL);          sqlite3_prepare_v2(db, sql, -1, &stmts[STMT_INSERT_PAGE], NULL);
         sql = "INSERT INTO mlinks "          sql = "INSERT INTO mlinks "
                 "(sec,arch,name,pageid) VALUES (?,?,?,?)";                  "(file,sec,arch,name,pageid) VALUES (?,?,?,?,?)";
         sqlite3_prepare_v2(db, sql, -1, &stmts[STMT_INSERT_LINK], NULL);          sqlite3_prepare_v2(db, sql, -1, &stmts[STMT_INSERT_LINK], NULL);
         sql = "INSERT INTO keys "          sql = "INSERT INTO keys "
                 "(bits,key,pageid) VALUES (?,?,?)";                  "(bits,key,pageid) VALUES (?,?,?)";

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

CVSweb