Home Explore Blog CI



neovim

13th chunk of `runtime/doc/tagsrch.txt`
79ad31fcbd760f53251ecdb42f055c56413be170f3ab2b1400000001000009c1
			*CTRL-W_d-default*
			Mapped to |vim.diagnostic.open_float()| by default.
			|default-mappings|

							*:dsp* *:dsplit*
:[range]dsp[lit][!] [count] [/]string[/]
			Like "CTRL-W d", but search in [range] lines
			(default: whole file).
			See |:search-args| for [/] and [!].

							*:checkp* *:checkpath*
:checkp[ath]		List all the included files that could not be found.

:checkp[ath]!		List all the included files.

								*:search-args*
Common arguments for the commands above:
[!]	When included, find matches in lines that are recognized as comments.
	When excluded, a match is ignored when the line is recognized as a
	comment (according to 'comments'), or the match is in a C comment
	(after "//" or inside `/* */`).  Note that a match may be missed if a
	line is recognized as a comment, but the comment ends halfway the line.
	And if the line is a comment, but it is not recognized (according to
	'comments') a match may be found in it anyway.  Example: >
		/* comment
		   foobar */
<	A match for "foobar" is found, because this line is not recognized as
	a comment (even though syntax highlighting does recognize it).
	Note: Since a macro definition mostly doesn't look like a comment, the
	[!] makes no difference for ":dlist", ":dsearch" and ":djump".
[/]	A pattern can be surrounded by "/".  Without "/" only whole words are
	matched, using the pattern "\<pattern\>".  Only after the second "/" a
	next command can be appended with "|".  Example: >
	:isearch /string/ | echo "the last one"
<	For a ":djump", ":dsplit", ":dlist" and ":dsearch" command the pattern
	is used as a literal string, not as a search pattern.

==============================================================================
7. Using 'tagfunc'						*tag-function*

It is possible to provide Vim with a function which will generate a list of
tags used for commands like |:tag|, |:tselect|, Normal mode tag commands like
|CTRL-]| and for the |taglist()| function.

The function used for generating the taglist is specified by setting the
'tagfunc' option.  The function will be called with three arguments:
   pattern	The tag identifier or pattern used during the tag search.
   flags	String containing flags to control the function behavior.
   info		Dict containing the following entries:
		    buf_ffname	  Full filename which can be used for priority.
		    user_data	  Custom data String, if stored in the tag
				  stack previously by tagfunc.

Note that "a:" needs to be prepended to the argument name

Title: Macro Search Options, Tag Function
Summary
This section covers additional macro search options, including searching within comments and the use of patterns with '/'. It also introduces the 'tagfunc' option, which allows you to specify a function that generates a list of tags for various tag-related commands.