vim-patch:a35235e824bb (#27598)

runtime(doc) Update help text for matchbufline() and matchstrlist()

closes: vim/vim#14080

a35235e824

Co-authored-by: Yegappan Lakshmanan <yegappan@yahoo.com>
This commit is contained in:
zeertzjq 2024-02-24 17:55:32 +08:00 committed by GitHub
parent acb13c7ac7
commit 9418381ccc
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
3 changed files with 21 additions and 0 deletions

View File

@ -4437,6 +4437,7 @@ match({expr}, {pat} [, {start} [, {count}]]) *match()*
Note that when {count} is added the way {start} works changes,
see above.
*match-pattern*
See |pattern| for the patterns that are accepted.
The 'ignorecase' option is used to set the ignore-caseness of
the pattern. 'smartcase' is NOT used. The matching is always
@ -4573,6 +4574,9 @@ matchbufline({buf}, {pat}, {lnum}, {end}, [, {dict}]) *matchbufline()*
This function works only for loaded buffers. First call
|bufload()| if needed.
See |match-pattern| for information about the effect of some
option settings on the pattern.
When {buf} is not a valid buffer, the buffer is not loaded or
{lnum} or {end} is not valid then an error is given and an
empty |List| is returned.
@ -4747,6 +4751,9 @@ matchstrlist({list}, {pat} [, {dict}]) *matchstrlist()*
submatches a List of submatches. Present only if
"submatches" is set to v:true in {dict}.
See |match-pattern| for information about the effect of some
option settings on the pattern.
Example: >vim
:echo matchstrlist(['tik tok'], '\<\k\+\>')
[{'idx': 0, 'byteidx': 0, 'text': 'tik'}, {'idx': 0, 'byteidx': 4, 'text': 'tok'}]

View File

@ -5356,6 +5356,7 @@ function vim.fn.mapset(dict) end
--- Note that when {count} is added the way {start} works changes,
--- see above.
---
--- *match-pattern*
--- See |pattern| for the patterns that are accepted.
--- The 'ignorecase' option is used to set the ignore-caseness of
--- the pattern. 'smartcase' is NOT used. The matching is always
@ -5514,6 +5515,9 @@ function vim.fn.matcharg(nr) end
--- This function works only for loaded buffers. First call
--- |bufload()| if needed.
---
--- See |match-pattern| for information about the effect of some
--- option settings on the pattern.
---
--- When {buf} is not a valid buffer, the buffer is not loaded or
--- {lnum} or {end} is not valid then an error is given and an
--- empty |List| is returned.
@ -5727,6 +5731,9 @@ function vim.fn.matchstr(expr, pat, start, count) end
--- submatches a List of submatches. Present only if
--- "submatches" is set to v:true in {dict}.
---
--- See |match-pattern| for information about the effect of some
--- option settings on the pattern.
---
--- Example: >vim
--- :echo matchstrlist(['tik tok'], '\<\k\+\>')
--- [{'idx': 0, 'byteidx': 0, 'text': 'tik'}, {'idx': 0, 'byteidx': 4, 'text': 'tok'}]

View File

@ -6546,6 +6546,7 @@ M.funcs = {
Note that when {count} is added the way {start} works changes,
see above.
*match-pattern*
See |pattern| for the patterns that are accepted.
The 'ignorecase' option is used to set the ignore-caseness of
the pattern. 'smartcase' is NOT used. The matching is always
@ -6726,6 +6727,9 @@ M.funcs = {
This function works only for loaded buffers. First call
|bufload()| if needed.
See |match-pattern| for information about the effect of some
option settings on the pattern.
When {buf} is not a valid buffer, the buffer is not loaded or
{lnum} or {end} is not valid then an error is given and an
empty |List| is returned.
@ -6960,6 +6964,9 @@ M.funcs = {
submatches a List of submatches. Present only if
"submatches" is set to v:true in {dict}.
See |match-pattern| for information about the effect of some
option settings on the pattern.
Example: >vim
:echo matchstrlist(['tik tok'], '\<\k\+\>')
[{'idx': 0, 'byteidx': 0, 'text': 'tik'}, {'idx': 0, 'byteidx': 4, 'text': 'tok'}]