ctags ファイルを生成すると、コメント内のコンテンツも解析されているようです。たとえば、Vim のプラグイン Tagbar を使用すると、次のような存在しない関数が関数のリストに表示されます。
- は
- の
- ただ
ここで何が起こっているかというと、ctags がコメントに入って、次のようなものを見つけているということです。
「この関数は...」と、「is」が関数だと思って、タグファイルにエントリを追加しています。
コメント内のコンテンツを解析しないように ctags に指示する簡単な方法があるかどうか疑問に思っています。
どうやら 5.8.0 の後にリリースされる修正があったようですが、これがすでにリリースされているかどうかはわかりません。私の ctags バージョンは 5.8.0 です。
これはPHPプロジェクトに関連していますが、答えがどのプログラミング言語でも機能するソリューションをカバーできればいいと思います(そのようなことが可能であれば).
例:
次の関数へのコメントは、タグ「is」を生成し、それを関数としてリストします。
/**
* This function is run to set certain preferences
*/