1- *eval.txt* For Vim version 9.1. Last change: 2025 Aug 27
1+ *eval.txt* For Vim version 9.1. Last change: 2025 Aug 29
22
33
44 VIM REFERENCE MANUAL by Bram Moolenaar
@@ -972,8 +972,8 @@ is not available it returns -1 or the default value you specify: >
972972
973973Blob iteration ~
974974
975- The | :for | loop executes commands for each byte of a Blob. The loop variable is
976- set to each byte in the Blob. Example: >
975+ The | :for | loop executes commands for each byte of a Blob. The loop variable
976+ is set to each byte in the Blob. Example: >
977977 :for byte in 0z112233
978978 : call Doit(byte)
979979 :endfor
@@ -1547,9 +1547,9 @@ String. A negative index always results in an empty string (reason: backward
15471547compatibility). Use [-1:] to get the last byte or character.
15481548In Vim9 script a negative index is used like with a list: count from the end.
15491549
1550- If expr10 is a | List | then it results the item at index expr1. See | list-index |
1551- for possible index values. If the index is out of range this results in an
1552- error. Example: >
1550+ If expr10 is a | List | then it results the item at index expr1. See
1551+ | list-index | for possible index values. If the index is out of range this
1552+ results in an error. Example: >
15531553 :let item = mylist[-1] " get last item
15541554
15551555 Generally, if a | List | index is equal to or higher than the length of the
@@ -2251,7 +2251,6 @@ v:clipmethod The current method of accessing the clipboard that is being
22512251 unavailable.
22522252 See 'clipmethod' for more details.
22532253
2254-
22552254 *v:cmdarg* *cmdarg-variable*
22562255v:cmdarg This variable is used for two purposes:
22572256 1. The extra arguments given to a file read/write command.
@@ -2318,9 +2317,9 @@ v:colornames A dictionary that maps color names to hex color strings. These
23182317 It is possible to remove entries from this dictionary but
23192318 doing so is NOT recommended, because it is disruptive to
23202319 other scripts. It is also unlikely to achieve the desired
2321- result because the | :colorscheme | and | :highlight | commands will
2322- both automatically load all `colors/lists/ default.vim ` color
2323- scripts.
2320+ result because the | :colorscheme | and | :highlight | commands
2321+ will both automatically load all `colors/lists/ default.vim `
2322+ color scripts.
23242323
23252324 You can make changes to that file, but make sure to add new
23262325 keys instead of updating existing ones, otherwise Vim will skip
@@ -2721,9 +2720,10 @@ v:python3_version
27212720 should exactly match the Python library up to the minor
27222721 version (e.g. 3.10.2 and 3.10.3 are compatible as the minor
27232722 version is "10", whereas 3.9.4 and 3.10.3 are not compatible).
2724- When | python-stable-abi | is used, this will be the minimum Python
2725- version that you can use instead. (e.g. if v:python3_version
2726- indicates 3.9, you can use 3.9, 3.10, or anything above).
2723+ When | python-stable-abi | is used, this will be the minimum
2724+ Python version that you can use instead. (e.g. if
2725+ v:python3_version indicates 3.9, you can use 3.9, 3.10, or
2726+ anything above).
27272727
27282728 This number is encoded as a hex number following Python ABI
27292729 versioning conventions. Do the following to have a
@@ -2861,16 +2861,16 @@ v:t_enumvalue Value of |enumvalue| type. Read-only. See: |type()|
28612861 *v:t_tuple* *t_tuple-variable*
28622862v:t_tuple Value of | Tuple | type. Read-only. See: | type() |
28632863
2864- *v:termresponse* *termresponse-variable*
2864+ *v:termresponse* *termresponse-variable*
28652865v:termresponse The escape sequence returned by the terminal for the | t_RV |
28662866 termcap entry. It is set when Vim receives an escape sequence
28672867 that starts with ESC [ or CSI, then '>' or '?' and ends in a
28682868 'c', with only digits and ';' in between.
2869- When this option is set, the TermResponse autocommand event is
2870- fired, so that you can react to the response from the
2869+ When this variable is set, the TermResponse autocommand event
2870+ is fired, so that you can react to the response from the
28712871 terminal. The TermResponseAll event is also fired, with
2872- <amatch> set to "version". You can use | terminalprops() | to see
2873- what Vim figured out about the terminal.
2872+ <amatch> set to "version". You can use | terminalprops() | to
2873+ see what Vim figured out about the terminal.
28742874 The response from a new xterm is: "<Esc> [> Pp ; Pv ; Pc c". Pp
28752875 is the terminal type: 0 for vt100 and 1 for vt220. Pv is the
28762876 patch level (since this was introduced in patch 95, it's
@@ -2879,49 +2879,49 @@ v:termresponse The escape sequence returned by the terminal for the |t_RV|
28792879 codes. This only works with xterm | xterm-codes | .
28802880 {only when compiled with | +termresponse | feature}
28812881
2882- *v:termblinkresp*
2882+ *v:termblinkresp* *termblinkresp-variable *
28832883v:termblinkresp The escape sequence returned by the terminal for the | t_RC |
28842884 termcap entry. This is used to find out whether the terminal
28852885 cursor is blinking. This is used by | term_getcursor() | . When
2886- this option is set, the TermResponseAll autocommand event is
2886+ this variable is set, the TermResponseAll autocommand event is
28872887 fired, with <amatch> set to "cursorblink".
28882888
2889- *v:termstyleresp*
2889+ *v:termstyleresp* *termstyleresp-variable *
28902890v:termstyleresp The escape sequence returned by the terminal for the | t_RS |
28912891 termcap entry. This is used to find out what the shape of the
28922892 cursor is. This is used by | term_getcursor() | . When this
2893- option is set, the TermResponseAll autocommand event is fired,
2894- with <amatch> set to "cursorshape".
2893+ variable is set, the TermResponseAll autocommand event is
2894+ fired, with <amatch> set to "cursorshape".
28952895
2896- *v:termrbgresp*
2896+ *v:termrbgresp* *termrbgresp-variable *
28972897v:termrbgresp The escape sequence returned by the terminal for the | t_RB |
28982898 termcap entry. This is used to find out what the terminal
28992899 background color is; see 'background' . This is set by the
29002900 $VIMRUNTIME/plugin/colorresp.vim plugin normally included with
29012901 Vim, but can be set manually if you know what you are doing.
29022902 Note that changing this will not do anything.
29032903
2904- *v:termrfgresp*
2904+ *v:termrfgresp* *termrfgresp-variable *
29052905v:termrfgresp The escape sequence returned by the terminal for the | t_RF |
29062906 termcap entry. This is used to find out what the terminal
29072907 foreground color is. Behaves the same as | v:termrbgresp |
29082908
2909- *v:termu7resp*
2909+ *v:termu7resp* *termu7resp-variable *
29102910v:termu7resp The escape sequence returned by the terminal for the | t_u7 |
29112911 termcap entry. This is used to find out what the terminal
29122912 does with ambiguous width characters, see 'ambiwidth' . When
2913- this option is set, the TermResponseAll autocommand event is
2913+ this variable is set, the TermResponseAll autocommand event is
29142914 fired, with <amatch> set to "ambiguouswidth".
29152915
2916- *v:termda1*
2916+ *v:termda1* *termda1-variable *
29172917v:termda1 The escape sequence returned by a primary device attributes
2918- (DA1) query from the terminal. When this option is set, the
2918+ (DA1) query from the terminal. When this variable is set, the
29192919 TermResponseAll autocommand event is fired, with <amatch> set
29202920 to "da1". Can be used to detect OSC 52 support in a terminal.
29212921
2922- *v:termosc*
2922+ *v:termosc* *termosc-variable *
29232923v:termosc The escape sequence of the most recent OSC response received
2924- from the terminal. When this option is set, the
2924+ from the terminal. When this variable is set, the
29252925 | TermResponseAll | autocommand event is fired, with <amatch>
29262926 set to "osc". Also used to set the | v:termrbgresp | and
29272927 | v:termrfgresp | via the $VIMRUNTIME/plugin/colorresp.vim
@@ -2994,7 +2994,7 @@ v:vim_did_enter Zero until most of startup is done. It is set to one just
29942994 *v:warningmsg* *warningmsg-variable*
29952995v:warningmsg Last given warning message. It's allowed to set this variable.
29962996
2997- *v:wayland_display*
2997+ *v:wayland_display* *wayland_display-variable *
29982998v:wayland_display
29992999 The name of the Wayland display that Vim is connected to.
30003000 Equivalent to the $WAYLAND_DISPLAY environment variable.
@@ -3356,7 +3356,8 @@ text...
33563356 One or more items from a | List | can be removed: >
33573357 :unlet list[3] " remove fourth item
33583358 :unlet list[3:] " remove fourth item to last
3359- < One item from a | Dictionary | can be removed at a time: >
3359+ < One item from a | Dictionary | can be removed at a time:
3360+ >
33603361 :unlet dict['two']
33613362 :unlet dict.two
33623363< This is especially useful to clean up used global
@@ -3487,7 +3488,7 @@ text...
34873488 - In | Vim9 | script an error is given.
34883489 - In legacy script this is silently ignored.
34893490
3490- :if {expr1} *:if* *:end* *:endif* *:en* *E171* *E579* *E580*
3491+ :if {expr1} *:if* *:end* *:endif* *:en* *E171* *E579* *E580*
34913492:en[dif] Execute the commands until the next matching `:else `
34923493 or `:endif ` if {expr1} evaluates to non-zero.
34933494 Although the short forms work, it is recommended to
@@ -3825,8 +3826,9 @@ text...
38253826 message in the | message-history | . When used in a
38263827 script or function the line number will be added.
38273828 Spaces are placed between the arguments as with the
3828- `:echomsg ` command. When used inside a try conditional,
3829- the message is raised as an error exception instead
3829+ `:echomsg ` command. When used inside a try
3830+ conditional, the message is raised as an error
3831+ exception instead
38303832 (see | try-echoerr | ).
38313833 Example: >
38323834 :echoerr "This script just failed!"
@@ -5172,8 +5174,8 @@ to execute the given executable. For security reasons users may not want to
51725174have Vim execute random executables or may have forbidden to do so for
51735175specific filetypes by setting the "<filetype> _exec" variable (| plugin_exec | ).
51745176
5175- It returns | true | or | false | to indicate whether the plugin should run the given
5176- executable. It takes the following arguments:
5177+ It returns | true | or | false | to indicate whether the plugin should run the
5178+ given executable. It takes the following arguments:
51775179
51785180 argument type ~
51795181
0 commit comments