Skip to content

Commit 46d87b3

Browse files
committed
Explain how to setup custom ctags command line options
1 parent ba99f5f commit 46d87b3

2 files changed

Lines changed: 24 additions & 6 deletions

File tree

README.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -179,6 +179,10 @@ The easytags plug-in defines new highlighting groups for dynamically highlighted
179179

180180
As you can see each of these names ends in `Tag` to avoid conflicts with the syntax modes shipped with Vim. And about the singular/plural confusion: I've tried to match the existing highlighting groups defined by popular syntax modes (except of course for the `Tag` suffix).
181181

182+
## Passing custom command line arguments to Exuberant Ctags
183+
184+
You may want to run Exuberant Ctags with specific command line options, for example the [code_complete] [code_complete] plug-in requires the signature field to be present. To do this you can create a configuration file for Exuberant Ctags, e.g. `~/.ctags` on UNIX or `%USERPROFILE%\ctags.cnf` on Windows. The file should contain one command line option per line. See the [Exuberant Ctags manual] [ctags_cfg] for details.
185+
182186
## Troubleshooting
183187

184188
### `:HighlightTags` only works for the tags file created by `:UpdateTags`
@@ -246,7 +250,9 @@ This software is licensed under the [MIT license](http://en.wikipedia.org/wiki/M
246250

247251

248252
[canon]: http://en.wikipedia.org/wiki/Canonicalization
253+
[code_complete]: http://www.vim.org/scripts/script.php?script_id=1764
249254
[ctags]: http://en.wikipedia.org/wiki/Ctags
255+
[ctags_cfg]: http://ctags.sourceforge.net/ctags.html#FILES
250256
[ctags_fts]: http://ctags.sourceforge.net/languages.html
251257
[ctrl_c]: http://vimdoc.sourceforge.net/htmldoc/pattern.html#CTRL-C
252258
[ctrl_mapping]: http://vimdoc.sourceforge.net/htmldoc/tagsrch.html#CTRL-]

doc/easytags.txt

Lines changed: 18 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -352,6 +352,16 @@ syntax modes shipped with Vim. And about the singular/plural confusion: I've
352352
tried to match the existing highlighting groups defined by popular syntax
353353
modes (except of course for the 'Tag' suffix).
354354

355+
===============================================================================
356+
Passing custom command line arguments to Exuberant Ctags ~
357+
358+
You may want to run Exuberant Ctags with specific command line options, for
359+
example the code_complete [12] plug-in requires the signature field to be
360+
present. To do this you can create a configuration file for Exuberant Ctags,
361+
e.g. '~/.ctags' on UNIX or '%USERPROFILE%\ctags.cnf' on Windows. The file
362+
should contain one command line option per line. See the Exuberant Ctags
363+
manual [13] for details.
364+
355365
===============================================================================
356366
*easytags-troubleshooting*
357367
Troubleshooting ~
@@ -450,7 +460,7 @@ project directories.
450460
-------------------------------------------------------------------------------
451461
The plug-in doesn't seem to work in Cygwin ~
452462

453-
If you want to use the plug-in with Vim under Cygwin [12], you need to have
463+
If you want to use the plug-in with Vim under Cygwin [14], you need to have
454464
the Cygwin version of Ctags installed instead of the Windows version (thanks
455465
to Alex Zuroff for reporting this!).
456466

@@ -461,13 +471,13 @@ Contact ~
461471
If you have questions, bug reports, suggestions, etc. the author can be
462472
contacted at peter@peterodding.com. The latest version is available at
463473
http://peterodding.com/code/vim/easytags/ and http://github.com/xolox/vim-easytags.
464-
If you like this plug-in please vote for it on Vim Online [13].
474+
If you like this plug-in please vote for it on Vim Online [15].
465475

466476
===============================================================================
467477
*easytags-license*
468478
License ~
469479

470-
This software is licensed under the MIT license [14]. Copyright 2011 Peter
480+
This software is licensed under the MIT license [16]. Copyright 2011 Peter
471481
Odding <peter@peterodding.com>.
472482

473483
===============================================================================
@@ -485,8 +495,10 @@ References ~
485495
[9] http://en.wikipedia.org/wiki/Symbolic_link
486496
[10] http://en.wikipedia.org/wiki/Hard_link
487497
[11] http://en.wikipedia.org/wiki/Canonicalization
488-
[12] http://en.wikipedia.org/wiki/Cygwin
489-
[13] http://www.vim.org/scripts/script.php?script_id=3114
490-
[14] http://en.wikipedia.org/wiki/MIT_License
498+
[12] http://www.vim.org/scripts/script.php?script_id=1764
499+
[13] http://ctags.sourceforge.net/ctags.html#FILES
500+
[14] http://en.wikipedia.org/wiki/Cygwin
501+
[15] http://www.vim.org/scripts/script.php?script_id=3114
502+
[16] http://en.wikipedia.org/wiki/MIT_License
491503

492504
vim: ft=help

0 commit comments

Comments
 (0)