aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPeter Odding <peter@peterodding.com>2015-04-02 21:21:52 +0200
committerPeter Odding <peter@peterodding.com>2015-04-02 21:21:52 +0200
commitb05ac67b8bac71b47d6cae9d19fd12a69dd4ea92 (patch)
treedf3e91d79b159598be47ccd301d63fb0a2cb0e93
parent188b40b8de49d09735e55be00359e4c664b6ea74 (diff)
downloadvim-easytags-b05ac67b8bac71b47d6cae9d19fd12a69dd4ea92.tar.gz
Improve easytags_auto_{update,highlight} option documentation
Try to prevent confusion like in issue #92 on GitHub by @oryband: I had to comment out the auto_update/highlight lines in order for easytags to create the local .tags file. I thought that these options were meant only for on_cursorhold. The documentation regarding this is quite ambiguous: If on_cursorhold is off, why does auto_update/highlight also apply to events? Events aren't auto - I set them manually. For details: https://github.com/xolox/vim-easytags/issues/92
-rw-r--r--README.md4
-rw-r--r--doc/easytags.txt6
2 files changed, 10 insertions, 0 deletions
diff --git a/README.md b/README.md
index 8b8f56a..cad248e 100644
--- a/README.md
+++ b/README.md
@@ -179,12 +179,16 @@ By default the plug-in automatically updates and highlights your tags when you s
:let g:easytags_auto_update = 0
+This disables all _automatic_ tags file updates (regardless of how they were enabled) where automatic means _initiated by a Vim automatic command_.
+
### The `g:easytags_auto_highlight` option
By default the plug-in automatically updates and highlights your tags when you stop typing for a moment. If you want to disable automatic highlighting while keeping automatic updating enabled you can set this option to false:
:let g:easytags_auto_highlight = 0
+This disables all _automatic_ tags highlighting (regardless of how it was enabled) where automatic means _initiated by a Vim automatic command_.
+
### The `g:easytags_autorecurse` option
When the `:UpdateTags` command is executed automatically or without arguments, it defaults to updating just the tags for the current file. If you'd rather have it recursively scan everything below the directory of the current file then set this option to true (1):
diff --git a/doc/easytags.txt b/doc/easytags.txt
index afb0c59..b904e86 100644
--- a/doc/easytags.txt
+++ b/doc/easytags.txt
@@ -399,6 +399,9 @@ keeping automatic highlighting enabled you can set this option to false:
>
:let g:easytags_auto_update = 0
<
+This disables all _automatic_ tags file updates (regardless of how they were
+enabled) where automatic means _initiated by a Vim automatic command_.
+
-------------------------------------------------------------------------------
The *g:easytags_auto_highlight* option
@@ -408,6 +411,9 @@ keeping automatic updating enabled you can set this option to false:
>
:let g:easytags_auto_highlight = 0
<
+This disables all _automatic_ tags highlighting (regardless of how it was
+enabled) where automatic means _initiated by a Vim automatic command_.
+
-------------------------------------------------------------------------------
The *g:easytags_autorecurse* option