docs/TROUBLESHOOTING

   1 Okie, you're trying desperately to install htag and it's all going wrong.
   2 If after reading this you really can't solve it or you now have a patch then
   3 please mail me huggie@earth.li
   4
   5 Here are some hints:
   6
   7 1.      Turn on all the debugging options.
   8         $cfgdebug in htag.pl (copy locally if it's installed sitewide)
   9         $cfg{'nicedie'} = 1; as the first thing in your .htrc
  10
  11 2.      If perl says something like:
  12         HtagPlugin version 0.5 required--this is only version 0.4 at
  13         ./htag.pl line 40.
  14         BEGIN failed--compilation aborted at ./htag.pl line 40.
  15         Then your HtagPlugin.pm is too old and isn't the one required by
  16         htag.pl.  I distribute them all together in the htag tarball but you
  17         might be hitting a problem with multiple copies of HtagPlugin.pm.
  18
  19         Fix: put use lib '/path/to/HtagPlugin/'; at the top of htag.pl (copy
  20         it locally if it's installed sitewide).
  21
  22 3.      You use htag in a script which replaces your editor but nicedie
  23         isn't working or for some unknown reason it's not stopping.
  24
  25         You can log the whole output of htag to a file if nicedie isn't
  26         working for some reason (please report this to me if it isn't),
  27         using tee something like:
  28         htag.pl -m $1 |tee htaglog
  29         $EDITOR $1
  30
  31 4.      If you're having problems with the merge plugin then you can define
  32         anal_merge_debug in that file (copy the plugins locally if it's
  33         sitewide and change your plugin dir).
  34         Beware that it really *is* anal debugging though and is very
  35         verbose.
  36