From 2a2cba0eb258b284d448e20e94d7e0bc6156a5bd Mon Sep 17 00:00:00 2001 From: Peter Odding Date: Thu, 24 Feb 2011 21:31:21 +0100 Subject: Document the highlighting groups used by the plug-in --- README.md | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) (limited to 'README.md') 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` -- cgit v1.2.3