Write about kind collisions to ctags-faq(7)

[masatake]

@masatake - it seems that the c tag was already used for classes in Python. Can you update the merge to use capitalized C for code cells instead?

See https://github.com/universal-ctags/ctags/issues/2978#issuecomment-829451352 . See also https://docs.ctags.io/en/latest/man/ctags-client-tools.7.html#multiple-languages-for-an-input-file.

Use the language field to distinguish whether a tag having c as its kind means class in the Python or cell in the IPythonCell. --fields=+l or `--fields=+{language}'.

I will not update. Even if I will update as you wrote, your issue will occur again when C kind is introduced to the Python parser.

I recommend you to enable --fields=+Kzl.

The rest of the work is up to the developers of your client tool.

I must add this to ctags-faq(7).

Originally posted by @masatake in https://github.com/universal-ctags/ctags/issues/3000#issuecomment-833126017