contrib/global/FAQ

   1
   2 Frequentry Asked Questions about GLOBAL.
   3
   4 ----------------------------------------------------------------------------
   5 Q1. Htags(1) aborts by short of memory. Why? Any workaround?
   6
   7         % htags
   8         Out of memory!
   9         % _
  10
  11 A1. It seems that Perl4 leaks memory. If you use that version of perl,
  12     then you had better to use Perl5. This works well.
  13
  14 ----------------------------------------------------------------------------
  15 Q2. Global(1) and btreeop(1) sometimes core dumps when using a large tag file.
  16     Any workaround?
  17
  18 A2. Btree(3) core dumps with a certain data set.
  19     Please apply the patches in this package. See ./dbpatches/README.
  20
  21 ----------------------------------------------------------------------------
  22 Q3. GLOBAL skip some functions.
  23     For example, GLOBAL skip the function 'func' in this example.
  24
  25         #define M(a)    static char *string = a;
  26
  27         M(a)
  28
  29         func() {                <= GLOBAL skip func().
  30                 ...
  31         }
  32
  33 A3. GLOBAL cannot recognize that pattern, because M(a) seems to be
  34     a function definition.
  35
  36     It should be follows.
  37
  38         #define M(a)    static char *string = a
  39
  40         M(a);                   <= end with ';'
  41
  42         func() {
  43                 ...
  44         }
  45
  46     Otherwise, you can tell gtags(1) that by listing the macros in
  47     '.notfunction' file in current directory.
  48
  49         [.notfunction]
  50         +---------------
  51         |M
  52         |...
  53
  54 ----------------------------------------------------------------------------
  55 Q4. I have set up 'global.conf' to use emacs's ctags command with GLOBAL
  56     but I cannot use htags.
  57
  58         % gtags
  59         % htags
  60         htags: GTAGS and GRTAGS not found. Please make them.
  61         % ls G*
  62         GPATH   GTAGS
  63
  64 A4. Emacs's ctags cannot locate function referencies. So, gtags cannot make
  65     GRTAGS tag file with it. With the result that you cannot use htags and
  66     global's -r option.
  67 ----------------------------------------------------------------------------