mirrors/neovim
1
0
Fork 0
mirror of https://github.com/neovim/neovim.git synced 2025-09-06 03:18:16 +00:00
Code Issues Packages Projects Releases Wiki Activity

vim-patch:fb08192: runtime(doc): clarify the use of 'tagfunc', update a comment in tags.c

Browse Source 
related: vim/vim#17228

fb08192ca7

Co-authored-by: Christian Brabandt <cb@256bit.org>
This commit is contained in:
zeertzjq
2025-05-01 07:43:24 +08:00
parent ad48cccaa8
commit b38525f65c
5 changed files with 19 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
runtime/doc/options.txt
View File

@@ -6531,7 +6531,8 @@ A jump table for the options with a short description can be found at |Q_op|.
*'tagfunc'* *'tfu'* *'tagfunc'* *'tfu'*
'tagfunc' 'tfu' string (default "") 'tagfunc' 'tfu' string (default "")
local to buffer local to buffer
This option specifies a function to be used to perform tag searches. This option specifies a function to be used to perform tag searches
(including |taglist()|).
The function gets the tag pattern and should return a List of matching The function gets the tag pattern and should return a List of matching
tags. See |tag-function| for an explanation of how to write the tags. See |tag-function| for an explanation of how to write the
function and an example. The value can be the name of a function, a function and an example. The value can be the name of a function, a

21
runtime/doc/tagsrch.txt
View File

@@ -888,8 +888,8 @@ Common arguments for the commands above:
7. Using 'tagfunc' *tag-function* 7. Using 'tagfunc' *tag-function*
It is possible to provide Vim with a function which will generate a list of It is possible to provide Vim with a function which will generate a list of
tags used for commands like |:tag|, |:tselect| and Normal mode tag commands tags used for commands like |:tag|, |:tselect|, Normal mode tag commands like
like |CTRL-]|. |CTRL-]| and for the |taglist()| function.
The function used for generating the taglist is specified by setting the The function used for generating the taglist is specified by setting the
'tagfunc' option. The function will be called with three arguments: 'tagfunc' option. The function will be called with three arguments:
@@ -943,15 +943,14 @@ It is not allowed to close a window or change window from inside 'tagfunc'.
The following is a hypothetical example of a function used for 'tagfunc'. It The following is a hypothetical example of a function used for 'tagfunc'. It
uses the output of |taglist()| to generate the result: a list of tags in the uses the output of |taglist()| to generate the result: a list of tags in the
inverse order of file names. inverse order of file names.
> >vim
function TagFunc(pattern, flags, info) function CompareFilenames(item1, item2)
function CompareFilenames(item1, item2) let f1 = a:item1['filename']
let f1 = a:item1['filename'] let f2 = a:item2['filename']
let f2 = a:item2['filename'] return f1 >=# f2 ? -1 : f1 <=# f2 ? 1 : 0
return f1 >=# f2 ? endfunction
\ -1 : f1 <=# f2 ? 1 : 0
endfunction
function TagFunc(pattern, flags, info)
let result = taglist(a:pattern) let result = taglist(a:pattern)
call sort(result, "CompareFilenames") call sort(result, "CompareFilenames")
@@ -959,5 +958,7 @@ inverse order of file names.
endfunc endfunc
set tagfunc=TagFunc set tagfunc=TagFunc
< <
Note: When executing |taglist()| the 'tagfunc' function won't be called
recursively.
vim:tw=78:ts=8:noet:ft=help:norl: vim:tw=78:ts=8:noet:ft=help:norl:

3
runtime/lua/vim/_meta/options.lua generated
View File

@@ -7037,7 +7037,8 @@ vim.bo.tc = vim.bo.tagcase
vim.go.tagcase = vim.o.tagcase vim.go.tagcase = vim.o.tagcase
vim.go.tc = vim.go.tagcase vim.go.tc = vim.go.tagcase
--- This option specifies a function to be used to perform tag searches. --- This option specifies a function to be used to perform tag searches
--- (including `taglist()`).
--- The function gets the tag pattern and should return a List of matching --- The function gets the tag pattern and should return a List of matching
--- tags. See `tag-function` for an explanation of how to write the --- tags. See `tag-function` for an explanation of how to write the
--- function and an example. The value can be the name of a function, a --- function and an example. The value can be the name of a function, a

3
src/nvim/options.lua
View File

@@ -9182,7 +9182,8 @@ local options = {
cb = 'did_set_tagfunc', cb = 'did_set_tagfunc',
defaults = '', defaults = '',
desc = [=[ desc = [=[
This option specifies a function to be used to perform tag searches. This option specifies a function to be used to perform tag searches
(including |taglist()|).
The function gets the tag pattern and should return a List of matching The function gets the tag pattern and should return a List of matching
tags. See |tag-function| for an explanation of how to write the tags. See |tag-function| for an explanation of how to write the
function and an example. The value can be the name of a function, a function and an example. The value can be the name of a function, a

3
src/nvim/tag.c
View File

@@ -1502,7 +1502,8 @@ static bool findtags_in_help_init(findtags_state_T *st)
/// Use the function set in 'tagfunc' (if configured and enabled) to get the /// Use the function set in 'tagfunc' (if configured and enabled) to get the
/// tags. /// tags.
/// Return OK if at least 1 tag has been successfully found, NOTDONE if the /// Return OK if at least 1 tag has been successfully found, NOTDONE if the
/// 'tagfunc' is not used or the 'tagfunc' returns v:null and FAIL otherwise. /// 'tagfunc' is not used, still executing or the 'tagfunc' returned v:null and
/// FAIL otherwise.
static int findtags_apply_tfu(findtags_state_T *st, char *pat, char *buf_ffname) static int findtags_apply_tfu(findtags_state_T *st, char *pat, char *buf_ffname)
{ {
const bool use_tfu = ((st->flags & TAG_NO_TAGFUNC) == 0); const bool use_tfu = ((st->flags & TAG_NO_TAGFUNC) == 0);