On Wed, Aug 16, 2006 at 03:33:42PM -0400, Gabriel Farrell wrote:
>
> Aha. Benji's explanation is correct. My $VIM points at
> /usr/share/vim/addons/ which contains doc/matchit.txt, doc/tags, and
> plugin/matchit.vim. This is the default for the Debian installation.
> The screwy thing is that unless I copy matchit.vim into
> $HOME/.vim/plugin/, matchit isn't installed, and I can't see any help
> for it because, as you surmised, :helptags hasn't been run on
> /usr/share/vim/addons/doc/ -- the tags file in that directory is
> empty.
>
> I'm not sure if this is a bug in vim or the debian package; I think
> mostly the package.
>
> gabe
I think you are right that the package only partially installs the
plugin. Just to be clear, there are three related things; I will use
<rtp> to denote a path that is in the 'runtimepath' option.
(1) A line appears under :help local-additions if <rtp>/doc/matchit.txt
exists.
(2) A tags file for <dir>/matchit.txt is created if you run
:helptags <dir>
and :help will find those tags if <dir> is in 'runtimepath'.
(3) The plugin will be effective if <rtp>/plugin/matchit.vim exists.
This particular plugin also relies on <rtp>/ftplugin/*.vim to set
buffer-local variables that control its behavior.
HTH --Benji Fisher
