aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPeter Odding <peter@peterodding.com>2011-02-24 21:31:21 +0100
committerPeter Odding <peter@peterodding.com>2011-02-24 21:31:21 +0100
commit2a2cba0eb258b284d448e20e94d7e0bc6156a5bd (patch)
treee0e21edb4e3f086e09250e3642464de84a39d12c
parentea6efd67beffd43251f155cf948f400e0333e714 (diff)
downloadvim-easytags-2a2cba0eb258b284d448e20e94d7e0bc6156a5bd.tar.gz
Document the highlighting groups used by the plug-in
-rw-r--r--README.md16
1 files changed, 15 insertions, 1 deletions
diff --git a/README.md b/README.md
index 863b362..944bde7 100644
--- a/README.md
+++ b/README.md
@@ -84,7 +84,7 @@ Exuberant Ctags knows how to generate tags for struct/class members in C++ and J
:let g:easytags_include_members = 1
-Exuberant Ctags will be instructed to include struct/class members using the `--extra=+q` command line argument and the `easytags.vim` plug-in will highlight them using the `cMember` highlighting group. Because most color schemes don't distinguish the [Identifier and Type](http://vimdoc.sourceforge.net/htmldoc/syntax.html#group-name) highlighting groups all members will now probably look like type definitions. You can change that by executing any of the following Vim commands (from your vimrc script, a file type plug-in, etc.):
+Exuberant Ctags will be instructed to include struct/class members using the `--extra=+q` command line argument and the `easytags.vim` plug-in will highlight them using the `cMember` highlighting group. Because most color schemes don't distinguish the [Identifier and Type](http://vimdoc.sourceforge.net/htmldoc/syntax.html#group-name) highlighting groups all members will now probably look like type definitions. You can change that by executing either of the following Vim commands (from your vimrc script, a file type plug-in, etc.):
" If you like one of the existing styles you can link them:
highlight link cMember Special
@@ -98,6 +98,20 @@ UNIX has [symbolic links](http://en.wikipedia.org/wiki/Symbolic_link) and [hard
:let g:easytags_resolve_links = 1
+### How to customize the highlighting colors?
+
+The easytags plug-in defines new highlighting groups for dynamically highlighted tags. These groups are linked to Vim's default groups so that they're colored out of the box, but if you want you can change the styles. To do so use a `highlight` command such as the ones given a few paragraphs back. Of course you'll need to change the group name. Here are the group names used by the easytags plug-in:
+
+ * **Lua:** `luaFuncTag`
+ * **C:** `cTypeTag`, `cEnumTag`, `cPreProcTag`, `cFunctionTag`, `cMemberTag`
+ * **PHP:** `phpFunctionsTag`, `phpClassesTag`
+ * **Vim:** `vimAutoGroupTag`, `vimCommandTag`, `vimFuncNameTag`, `vimScriptFuncNameTag`
+ * **Python:** `pythonFunctionTag`, `pythonMethodTag`, `pythonClassTag`
+ * **Java:** `javaClassTag`, `javaMethodTag`
+ * **C#:** `csClassOrStructTag`, `csMethodTag`
+
+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).
+
## Troubleshooting
### `:HighlightTags` only works for the tags file created by `:UpdateTags`