aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--README.md4
-rw-r--r--autoload/xolox/easytags.vim101
-rw-r--r--doc/easytags.txt2
3 files changed, 64 insertions, 43 deletions
diff --git a/README.md b/README.md
index 225940c..b386449 100644
--- a/README.md
+++ b/README.md
@@ -351,8 +351,8 @@ If you have questions, bug reports, suggestions, etc. the author can be contacte
## License
-This software is licensed under the [MIT license](http://en.wikipedia.org/wiki/MIT_License).
-© 2014 Peter Odding &lt;<peter@peterodding.com>&gt; and Ingo Karkat.
+This software is licensed under the [MIT license](http://en.wikipedia.org/wiki/MIT_License).
+© 2015 Peter Odding &lt;<peter@peterodding.com>&gt; and Ingo Karkat.
Thanks go out to everyone who has helped to improve the vim-easytags plug-in (whether through pull requests, bug reports or personal e-mails).
diff --git a/autoload/xolox/easytags.vim b/autoload/xolox/easytags.vim
index 0fc91ba..b328e19 100644
--- a/autoload/xolox/easytags.vim
+++ b/autoload/xolox/easytags.vim
@@ -1,9 +1,9 @@
" Vim script
" Author: Peter Odding <peter@peterodding.com>
-" Last Change: November 21, 2014
+" Last Change: March 15, 2015
" URL: http://peterodding.com/code/vim/easytags/
-let g:xolox#easytags#version = '3.9.1'
+let g:xolox#easytags#version = '3.10'
let g:xolox#easytags#default_pattern_prefix = '\C\<'
let g:xolox#easytags#default_pattern_suffix = '\>'
@@ -104,7 +104,7 @@ function! xolox#easytags#register(global) " {{{2
let tagfiles = xolox#misc#option#split_tags(&tags)
let expanded = map(copy(tagfiles), 'resolve(expand(v:val))')
" Add the filename to the &tags option when the user hasn't done so already.
- let tagsfile = a:global ? g:easytags_file : xolox#easytags#get_tagsfile()
+ let tagsfile = a:global ? g:easytags_file : xolox#easytags#get_file_type_specific_tagsfile()
if index(expanded, xolox#misc#path#absolute(tagsfile)) == -1
" This is a real mess because of bugs in Vim?! :let &tags = '...' doesn't
" work on UNIX and Windows, :set tags=... doesn't work on Windows. What I
@@ -254,7 +254,7 @@ function! s:prep_cmdline(cfile, arguments) " {{{3
let program = get(language, 'cmd', xolox#easytags#ctags_command())
if empty(program)
call xolox#misc#msg#warn("easytags.vim %s: No 'cmd' defined for language '%s', and also no global default!", g:xolox#easytags#version, vim_file_type)
- return
+ return ''
endif
let cmdline = [program] + get(language, 'args', [])
call add(cmdline, xolox#misc#escape#shell(get(language, 'stdout_opt', '-f-')))
@@ -449,7 +449,37 @@ function! xolox#easytags#ctags_command() " {{{2
return ''
endfunction
-function xolox#easytags#get_dynamic_tagsfile() " {{{2
+function! xolox#easytags#get_tagsfile() " {{{2
+ " Get the absolute pathname of the tags file to use. This function
+ " automatically selects the best choice from the following options (in
+ " descending order of preference):
+ "
+ " 1. Dynamic tags files (see `xolox#easytags#get_dynamic_tagsfile()`).
+ " 2. File type specific tags files (see `xolox#easytags#get_file_type_specific_tagsfile()`).
+ " 3. The global tags file (see `xolox#easytags#get_global_tagsfile()`).
+ "
+ " Returns the absolute pathname of the selected tags file.
+ "
+ " This function is no longer used by the vim-easytags plug-in itself because
+ " the vim-easytags plug-in needs to differentiate between the different
+ " types of tags files in every place where it deals with tags files. Because
+ " this is an externally callable function it is unclear to me if other code
+ " depends on it, this is the reason why I haven't removed it yet.
+ let tagsfile = xolox#easytags#get_dynamic_tagsfile()
+ if empty(tagsfile)
+ let tagsfile = xolox#easytags#get_file_type_specific_tagsfile()
+ endif
+ if empty(tagsfile)
+ let tagsfile = xolox#easytags#get_global_tagsfile()
+ endif
+ return tagsfile
+endfunction
+
+function! xolox#easytags#get_dynamic_tagsfile() " {{{2
+ " Get the pathname of the dynamic tags file to use. If the user configured
+ " dynamic tags files this function returns the pathname of the applicable
+ " dynamic tags file (which may not exist yet), otherwise it returns an empty
+ " string.
let tagsfile = ''
" Look for a suitable project specific tags file?
let dynamic_files = xolox#misc#option#get('easytags_dynamic_files', 0)
@@ -460,60 +490,51 @@ function xolox#easytags#get_dynamic_tagsfile() " {{{2
let directory = fnamemodify(tagsfile, ':h')
if filewritable(directory) != 2
" If the directory of the dynamic tags file is not writable, we fall
- " back to a file type specific tags file or the global tags file.
+ " back to another type of tags file.
call xolox#misc#msg#warn("easytags.vim %s: Dynamic tags files enabled but %s not writable so falling back.", g:xolox#easytags#version, directory)
let tagsfile = ''
endif
endif
- " If the tags file exists, make sure it is writable!
- if filereadable(tagsfile) && filewritable(tagsfile) != 1
- let message = "The dynamic tags file %s isn't writable!"
- throw printf(message, fnamemodify(tagsfile, ':~'))
- endif
if !empty(tagsfile)
- call xolox#misc#msg#debug("easytags.vim %s: Selected dynamic tags file %s.", g:xolox#easytags#version, tagsfile)
- return xolox#misc#path#absolute(tagsfile)
- end
+ return s:select_tags_file(tagsfile, 'dynamic')
+ endif
return ''
endfunction
-function xolox#easytags#get_global_tagsfile() " {{{2
- let tagsfile = ''
- " Check if a file type specific tags file is useful?
+function! xolox#easytags#get_file_type_specific_tagsfile() " {{{2
+ " Get the pathname of the file type specific tags file to use. If the user
+ " configured file type specific tags files this function returns the
+ " pathname of the applicable file type specific tags file (which may not
+ " exist yet), otherwise it returns an empty string.
let vim_file_type = xolox#easytags#filetypes#canonicalize(&filetype)
if !empty(g:easytags_by_filetype) && !empty(vim_file_type)
let directory = xolox#misc#path#absolute(g:easytags_by_filetype)
let tagsfile = xolox#misc#path#merge(directory, vim_file_type)
if !empty(tagsfile)
- call xolox#misc#msg#debug("easytags.vim %s: Selected file type specific tags file %s.", g:xolox#easytags#version, tagsfile)
- endif
- endif
- " Default to the global tags file?
- if empty(tagsfile)
- let tagsfile = expand(xolox#misc#option#get('easytags_file'))
- if !empty(tagsfile)
- call xolox#misc#msg#debug("easytags.vim %s: Selected global tags file %s.", g:xolox#easytags#version, tagsfile)
+ return s:select_tags_file(tagsfile, 'file type specific')
endif
endif
- " If the tags file exists, make sure it is writable!
- if filereadable(tagsfile) && filewritable(tagsfile) != 1
- let message = "The global tags file %s isn't writable!"
- throw printf(message, fnamemodify(tagsfile, ':~'))
- endif
- if !empty(tagsfile)
- return xolox#misc#path#absolute(tagsfile)
- endif
return ''
endfunction
-function! xolox#easytags#get_tagsfile() " {{{2
- " Try to get a dynamic tags file
- let tagsfile = xolox#easytags#get_dynamic_tagsfile()
- " Otherwise get a global tags file
- if empty(tagsfile)
- let tagsfile = xolox#easytags#get_global_tagsfile()
+function! xolox#easytags#get_global_tagsfile() " {{{2
+ " Get the pathname of the global tags file. Returns the absolute pathname of
+ " the global tags file.
+ let tagsfile = xolox#misc#option#get('easytags_file')
+ return s:select_tags_file(expand(tagsfile), 'global')
+endfunction
+
+function! s:select_tags_file(tagsfile, kind) " {{{2
+ " If the selected tags file exists, make sure its writable. Also provide the
+ " user with feedback about the tags file selection process.
+ if filereadable(a:tagsfile) && filewritable(a:tagsfile) != 1
+ let message = "The %s tags file %s isn't writable!"
+ throw printf(message, a:kind, fnamemodify(a:tagsfile, ':~'))
endif
- return tagsfile
+ " Provide the user with feedback about the tags file selection process.
+ call xolox#misc#msg#debug("easytags.vim %s: Selected %s tags file %s.", g:xolox#easytags#version, a:kind, a:tagsfile)
+ " Canonicalize the tags file's pathname.
+ return xolox#misc#path#absolute(a:tagsfile)
endfunction
function! xolox#easytags#syntax_groups_to_ignore() " {{{2
diff --git a/doc/easytags.txt b/doc/easytags.txt
index cc2c84e..8c23aea 100644
--- a/doc/easytags.txt
+++ b/doc/easytags.txt
@@ -717,7 +717,7 @@ easytags. If you like this plug-in please vote for it on Vim Online [22].
*easytags-license*
License ~
-This software is licensed under the MIT license [23]. Š 2014 Peter Odding
+This software is licensed under the MIT license [23]. © 2015 Peter Odding
<peter@peterodding.com> and Ingo Karkat.
Thanks go out to everyone who has helped to improve the vim-easytags plug-in