runtime(doc): text-objects: document how escaped delimiters are handled

Signed-off-by: Christian Brabandt <cb@256bit.org>
This commit is contained in:
Christian Brabandt
2023-09-29 00:09:28 +02:00
parent b90e3bc491
commit 02902b547b

View File

@ -1,4 +1,4 @@
*motion.txt* For Vim version 9.0. Last change: 2023 Sep 18 *motion.txt* For Vim version 9.0. Last change: 2023 Sep 28
VIM REFERENCE MANUAL by Bram Moolenaar VIM REFERENCE MANUAL by Bram Moolenaar
@ -592,14 +592,16 @@ a] *v_a]* *v_a[* *a]* *a[*
a[ "a [] block", select [count] '[' ']' blocks. This a[ "a [] block", select [count] '[' ']' blocks. This
goes backwards to the [count] unclosed '[', and finds goes backwards to the [count] unclosed '[', and finds
the matching ']'. The enclosed text is selected, the matching ']'. The enclosed text is selected,
including the '[' and ']'. including the '[' and ']'. The |cpo-M| option flag
is used to handle escaped brackets.
When used in Visual mode it is made characterwise. When used in Visual mode it is made characterwise.
i] *v_i]* *v_i[* *i]* *i[* i] *v_i]* *v_i[* *i]* *i[*
i[ "inner [] block", select [count] '[' ']' blocks. This i[ "inner [] block", select [count] '[' ']' blocks. This
goes backwards to the [count] unclosed '[', and finds goes backwards to the [count] unclosed '[', and finds
the matching ']'. The enclosed text is selected, the matching ']'. The enclosed text is selected,
excluding the '[' and ']'. excluding the '[' and ']'. The |cpo-M| option flag
is used to handle escaped brackets.
When used in Visual mode it is made characterwise. When used in Visual mode it is made characterwise.
a) *v_a)* *a)* *a(* a) *v_a)* *a)* *a(*
@ -607,7 +609,8 @@ a( *vab* *v_ab* *v_a(* *ab*
ab "a block", select [count] blocks, from "[count] [(" to ab "a block", select [count] blocks, from "[count] [(" to
the matching ')', including the '(' and ')' (see the matching ')', including the '(' and ')' (see
|[(|). Does not include white space outside of the |[(|). Does not include white space outside of the
parenthesis. parenthesis. The |cpo-M| option flag is used to
handle escaped parenthesis.
When used in Visual mode it is made characterwise. When used in Visual mode it is made characterwise.
i) *v_i)* *i)* *i(* i) *v_i)* *i)* *i(*
@ -615,19 +618,22 @@ i( *vib* *v_ib* *v_i(* *ib*
ib "inner block", select [count] blocks, from "[count] [(" ib "inner block", select [count] blocks, from "[count] [("
to the matching ')', excluding the '(' and ')' (see to the matching ')', excluding the '(' and ')' (see
|[(|). If the cursor is not inside a () block, then |[(|). If the cursor is not inside a () block, then
find the next "(". find the next "(". The |cpo-M| option flag
is used to handle escaped parenthesis.
When used in Visual mode it is made characterwise. When used in Visual mode it is made characterwise.
a> *v_a>* *v_a<* *a>* *a<* a> *v_a>* *v_a<* *a>* *a<*
a< "a <> block", select [count] <> blocks, from the a< "a <> block", select [count] <> blocks, from the
[count]'th unmatched '<' backwards to the matching [count]'th unmatched '<' backwards to the matching
'>', including the '<' and '>'. '>', including the '<' and '>'. The |cpo-M| option flag
is used to handle escaped '<' and '>'.
When used in Visual mode it is made characterwise. When used in Visual mode it is made characterwise.
i> *v_i>* *v_i<* *i>* *i<* i> *v_i>* *v_i<* *i>* *i<*
i< "inner <> block", select [count] <> blocks, from i< "inner <> block", select [count] <> blocks, from
the [count]'th unmatched '<' backwards to the matching the [count]'th unmatched '<' backwards to the matching
'>', excluding the '<' and '>'. '>', excluding the '<' and '>'. The |cpo-M| option flag
is used to handle escaped '<' and '>'.
When used in Visual mode it is made characterwise. When used in Visual mode it is made characterwise.
*v_at* *at* *v_at* *at*
@ -649,14 +655,16 @@ a} *v_a}* *a}* *a{*
a{ *v_aB* *v_a{* *aB* a{ *v_aB* *v_a{* *aB*
aB "a Block", select [count] Blocks, from "[count] [{" to aB "a Block", select [count] Blocks, from "[count] [{" to
the matching '}', including the '{' and '}' (see the matching '}', including the '{' and '}' (see
|[{|). |[{|). The |cpo-M| option flag is used to handle
escaped braces.
When used in Visual mode it is made characterwise. When used in Visual mode it is made characterwise.
i} *v_i}* *i}* *i{* i} *v_i}* *i}* *i{*
i{ *v_iB* *v_i{* *iB* i{ *v_iB* *v_i{* *iB*
iB "inner Block", select [count] Blocks, from "[count] [{" iB "inner Block", select [count] Blocks, from "[count] [{"
to the matching '}', excluding the '{' and '}' (see to the matching '}', excluding the '{' and '}' (see
|[{|). |[{|). The |cpo-M| option flag is used to handle
escaped braces.
When used in Visual mode it is made characterwise. When used in Visual mode it is made characterwise.
a" *v_aquote* *aquote* a" *v_aquote* *aquote*