On Thu, Aug 17, 2006 at 08:33:23AM -0400, Benji Fisher wrote: > 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.
Yes. Maybe it should only appear once :helptags has been run? Is that possible? > (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'. Yes. > (3) The plugin will be effective if <rtp>/plugin/matchit.vim exists. I wasn't sure about this one, but after some tests I see it's also true. > This particular plugin also relies on <rtp>/ftplugin/*.vim to set > buffer-local variables that control its behavior. Yes. Thank you for the clarification. gabe