How to add comments to an Exuberant Ctags config file?

Question

What character can I use to put comments in an Exuberant Ctags .ctags file?

I would like to add comments with explanations, and perhaps to disable some rege

Answer 1

You can't! I looked through the source code (thanks to apt-get source). There are no checks for lines to ignore. The relevant code is in parseFileOptions() in options.c

But sometimes comments are a neccessity, so as a workaround I put a comment in as a regexp, in such as way that it is unlikely to ever match anything.

--regex-coffee=/^(COMMENT: Disable next line when using prop tag)/\1/X,XXX/

The ^ helps the match to fail quickly, whilst the ( ) wrapper is purely for visual effect.

Your comment should be a valid regexp, to avoid warnings on stderr. (That means unescaped /s must be avoided, and if you use any [ ] ( or )s they should be paired up.) See Tom's solution to avoid these restrictions.

Answer 2

As @joeytwiddle points out, comments are not supported by the parser, but there is a work-around.

Example .ctags file:

--regex-C=/$x/x/x/e/ The ctags parser currently doesn't support comments
--regex-C=/$x/x/x/e/ This is a work-around which works with '/' characters
--regex-C=/$x/x/x/e/ http://stackoverflow.com/questions/10973224/how-to-add-comments-to-an-exuberant-ctags-config-file
--regex-C=/$x/x/x/e/ 
--regex-C=/$x/x/x/e/ You can add whatever comment text you want here.

Answer 3

Given that comments don't work, what about a .ctags.readme file...

For most things you don't actually need a comment, e.g. you don't really need the comment below.

# Define tags for the Coffeescript language
--langdef=coffee
--langmap=coffee:.coffee

I can see however that you might want to add comments explaining some mind bending regex, so for each line that absolutely needs it you can copy paste it into the .ctags.readme file as a markdown file:

Forgive me father for I have regexed
It was purely because I wanted some lovely coffee properties
```
--regex-coffee=/^[ \t]*@?([a-zA-Z_$][0-9a-zA-Z_$]*):.*$/\1/p,property/
```

Keeping .ctags.readme and .ctags in sync

You could have a block at the bottom of the ctags file separated with a line break, then delete this final block.

If you only have the one line break in your .ctags file this sed will delete all the lines after the line break.

Then do some grepping for the --regex lines to append the lines from .ctags.readme into .ctags.

sed -i '/^\s*$/,$d' .ctags
grep "^--regex" .ctags.readme >> .ctags

Answer 4

You can use '#' as the start of comment if you are using Universal-ctag(https://ctags.io).