On Wed, Aug 16, 2006 at 08:55:26AM -0400, Benji Fisher wrote: > On Wed, Aug 16, 2006 at 02:18:55AM +0200, A.J.Mechelynck wrote: > > Gabriel Farrell wrote: > > >Hi, > > > > > >Regarding a thread [1] back in February on this list about local > > >additions, I'm not seeing some of the errors remarked upon at that > > >time, but I do see 'matchit.txt' under the LOCAL ADDITIONS heading > > >even when it's not installed. If I do copy it into the doc directory > > >and run helptags, it's listed twice. A minor annoyance, to be sure. > > > > > >gabe > > > > > >[1] http://marc.theaimsgroup.com/?t=113952672100003
First off, I forgot to mention that I'm on Debian unstable, Vim 7.0.35, just so it's known. > > What you see there may depend on how you update your Vim runtime files, > > and when you last did. I do it by downloading the contents of > > ftp://ftp.vim.org/pub/vim/runtime/ except its dos/ subdirectory, my > > help.txt is dated: > > > > *help.txt* For Vim version 7.0. Last change: 2006 Jun 16 > > > > I have matchit.txt (and two more files) in $VIM/vimfiles/doc, and I see > > > > LOCAL ADDITIONS: *local-additions* > > |matchit.txt| Extended "%" matching > > |pi_netrw.txt| For Vim version 7.0. Last change: 2006 Jun 08 > > |pi_vimball.txt| For Vim version 7.0. Last change: 2006 Jun 19 > > > > ------------------------------------------------------------------------------ > > > > > > Running "less" on the same file shows that the LOCAL ADDITIONS section > > is actually empty in the file as it resides on disk. You might want to > > open it with a text editor other than Vim, and remove all non-blank > > lines between LOCAL ADDITIONS and the horizontal line. This is interesting. When I run less on /usr/share/vim/vim70/doc/help.txt the LOCAL ADDITIONS section is blank, like yours. > > Best regards, > > Tony. > > If there are any non-blank lines there, I would consider the file > corrupted. > > The documentation on this feature is a little terse. Using > > :helpgrep local-add > > leads to > > :help write-local-help > > which explains where those lines come from. The surprising thing (for > me) is that these lines are added whether or not :helptags has been run > on the directory containing the doc files. I did not figure this out > until I looked at the source: > > vim70/src $ grep local-add *.c > vim70/src $ vim ex_cmds.c > /local-add > > According to the comments there, vim builds the "LOCAL ADDITIONS" > section by looking for doc/*.txt in every 'runtimepath' directory other > than $VIMRUNTIME and extracting the first line. > > Conclusion: if you have a line for matchit.txt under LOCAL > ADDITIONS, then you probably have doc/matchit.txt somewhere in your > runtime path; if you have duplicate entries, then you have duplicate > files. It does not matter whether you have installed the help files > with :helptags . Does this explain what you see? > > HTH --Benji Fisher > 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
