From 100bd8df876c589c956a08a76fa4fd9eac96af2d Mon Sep 17 00:00:00 2001 From: Peter Odding Date: Sat, 17 Sep 2011 17:47:01 +0200 Subject: =?UTF-8?q?New=20g:easytags=5Fupdatetime=5Fautodisable=20option=20?= =?UTF-8?q?(issue=20#17,=20reported=20by=20Strahinja=20Markovi=C4=87)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- doc/easytags.txt | 51 ++++++++++++++++++++++++++++++++++++--------------- 1 file changed, 36 insertions(+), 15 deletions(-) (limited to 'doc') diff --git a/doc/easytags.txt b/doc/easytags.txt index 0ffb508..1b9e78c 100644 --- a/doc/easytags.txt +++ b/doc/easytags.txt @@ -214,6 +214,26 @@ Note: Like the |g:easytags_always_enabled| option, if you change this option it won't apply until you restart Vim, so you'll have to set this option in your |vimrc| script. +------------------------------------------------------------------------------- +The *g:easytags_updatetime_min* option + +Vim has a setting which influences how often the plug-in is automatically +executed. When this setting is too low, the plug-in can break. For this reason +the plug-in warns you when |'updatetime'| is lower than 4000 milliseconds. If +you really want the plug-in to be executed more than once every 4 seconds +(without a warning) you can lower the minimum acceptable updatetime by setting +this option (number of milliseconds). + +------------------------------------------------------------------------------- +The *g:easytags_updatetime_autodisable* option + +Other plug-ins may lower the |'updatetime'| value in certain contexts, e.g. +insert mode in the case of the neocomplcache [9] plug-in. By setting this +option to 1 (true) you can configure the easytags plug-in so that it doesn't +give warnings about the updatetime option but instead skip updating and +highlighting while the updatetime is set too low. When the updatetime is +restored to a reasonable value the plug-in resumes. + ------------------------------------------------------------------------------- The *g:easytags_auto_update* option @@ -280,14 +300,14 @@ your vimrc script, a file type plug-in, etc.): ------------------------------------------------------------------------------- The *g:easytags_resolve_links* option -UNIX has symbolic links [9] and hard links [10], both of which conflict with +UNIX has symbolic links [10] and hard links [11], both of which conflict with the concept of having one unique location for every identifier. With regards to hard links there's not much anyone can do, but because I use symbolic links quite a lot I've added this option. It's disabled by default since it has a small performance impact and might not do what unknowing users expect it to: When you enable this option the plug-in will resolve symbolic links in pathnames, which means your tags file will only contain entries with canonical -pathnames [11]. To enable this option (which I strongly suggest doing when you +pathnames [12]. To enable this option (which I strongly suggest doing when you run UNIX and use symbolic links) execute the following Vim command: > :let g:easytags_resolve_links = 1 @@ -358,11 +378,11 @@ modes (except of course for the 'Tag' suffix). Passing custom command line arguments to Exuberant Ctags ~ You may want to run Exuberant Ctags with specific command line options, for -example the code_complete [12] plug-in requires the signature field to be +example the code_complete [13] 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 [13] for details. +manual [14] for details. =============================================================================== *easytags-troubleshooting* @@ -462,7 +482,7 @@ project directories. ------------------------------------------------------------------------------- The plug-in doesn't seem to work in Cygwin ~ -If you want to use the plug-in with Vim under Cygwin [14], you need to have +If you want to use the plug-in with Vim under Cygwin [15], you need to have the Cygwin version of Ctags installed instead of the Windows version (thanks to Alex Zuroff for reporting this!). @@ -473,13 +493,13 @@ Contact ~ If you have questions, bug reports, suggestions, etc. the author can be contacted at peter@peterodding.com. The latest version is available at http://peterodding.com/code/vim/easytags/ and http://github.com/xolox/vim-easytags. -If you like this plug-in please vote for it on Vim Online [15]. +If you like this plug-in please vote for it on Vim Online [16]. =============================================================================== *easytags-license* License ~ -This software is licensed under the MIT license [16]. Copyright 2011 Peter +This software is licensed under the MIT license [17]. Copyright 2011 Peter Odding . =============================================================================== @@ -494,13 +514,14 @@ References ~ [6] http://peterodding.com/code/vim/downloads/easytags.zip [7] http://peterodding.com/code/vim/shell/ [8] http://en.wikipedia.org/wiki/Dynamic-link_library -[9] http://en.wikipedia.org/wiki/Symbolic_link -[10] http://en.wikipedia.org/wiki/Hard_link -[11] http://en.wikipedia.org/wiki/Canonicalization -[12] http://www.vim.org/scripts/script.php?script_id=1764 -[13] http://ctags.sourceforge.net/ctags.html#FILES -[14] http://en.wikipedia.org/wiki/Cygwin -[15] http://www.vim.org/scripts/script.php?script_id=3114 -[16] http://en.wikipedia.org/wiki/MIT_License +[9] http://www.vim.org/scripts/script.php?script_id=2620 +[10] http://en.wikipedia.org/wiki/Symbolic_link +[11] http://en.wikipedia.org/wiki/Hard_link +[12] http://en.wikipedia.org/wiki/Canonicalization +[13] http://www.vim.org/scripts/script.php?script_id=1764 +[14] http://ctags.sourceforge.net/ctags.html#FILES +[15] http://en.wikipedia.org/wiki/Cygwin +[16] http://www.vim.org/scripts/script.php?script_id=3114 +[17] http://en.wikipedia.org/wiki/MIT_License vim: ft=help -- cgit v1.2.3