vimdoc-ja-working icon indicating copy to clipboard operation
vimdoc-ja-working copied to clipboard

doc/tags-jaに無効なタグが混じっている

Open machakann opened this issue 3 years ago • 5 comments

vimdoc-ja/doc/tags-ja に以下の無効なタグ混じっているようです。これらは文章中で * に囲まれていますがヘルプタグとなることを意図されていないもののように思います。

実害というほどではないのですが、手元で :helptags してしまうと差分が発生してしまいます。

machakann avatar Dec 09 '22 15:12 machakann

そもそもで言うと

  • 他のも含めたhelptagを、ユーザーは環境が作れたら生成するべき(じゃないと正しく引けない)
  • 配布物として常に最新のhelptagを生成して含めるべき(じゃないと齟齬がある)

のどっちかやらんといかんのかな なのでしょうけど、どうしたもんかな...というはありそう。

tsuyoshicho avatar Dec 10 '22 00:12 tsuyoshicho

タグファイルを含めるかに関する議論は #268 のとおりで私としては(それが難しくないかぎり)含めることに異論ありません。ただ、疑問なのは deploy されている tags-ja も Vim が生成したものと思われるのですが、私の手元で生成されるものと差分が出るのは不思議におもっています。Vimのバージョンの問題でしょうか。

私としてもそこまで重大な問題だと思っているわけではなくて、一応無効なタグなので報告しておこうと思った次第です。

machakann avatar Dec 10 '22 02:12 machakann

あ、そっちで論議があったか...なんででしょうね?

tsuyoshicho avatar Dec 10 '22 05:12 tsuyoshicho

@machakann 9.0.0110 からhelpの例の中のタグを除外するようになりました。

vimdoc-ja-working で使用しているVimは v8.2.0020 ですので、上記バージョン以降のVimの:helptagsと差分が出ちゃいますね。

h-east avatar Dec 10 '22 13:12 h-east

ありがとうございます。なるほど、たしかに書いていませんでしたが手元の Vim は 9.0.1044 でした。

machakann avatar Dec 10 '22 14:12 machakann