diff --git a/runtime/doc/autocmd.txt b/runtime/doc/autocmd.txt index 37b3e3509c..d5b8c6a627 100644 --- a/runtime/doc/autocmd.txt +++ b/runtime/doc/autocmd.txt @@ -1,4 +1,4 @@ -*autocmd.txt* For Vim version 9.1. Last change: 2025 Aug 27 +*autocmd.txt* For Vim version 9.1. Last change: 2025 Aug 29 VIM REFERENCE MANUAL by Bram Moolenaar @@ -1315,7 +1315,7 @@ TermResponseAll After the response to |t_RV|, |t_RC|, |t_RS|, "version", "cursorblink", "cursorshape", - "ambiguouswidth" + "ambiguouswidth", "osc" Note that this event may be triggered halfway executing another event, especially if file I/O, @@ -1330,8 +1330,6 @@ TermResponseAll After the response to |t_RV|, |t_RC|, |t_RS|, TermResponseAll autocommand events when it encounters "foreground" and "background" values. - - *TextChanged* TextChanged After a change was made to the text in the current buffer in Normal mode. That is after diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt index edc9bf33ae..efd6218d49 100644 --- a/runtime/doc/eval.txt +++ b/runtime/doc/eval.txt @@ -1,4 +1,4 @@ -*eval.txt* For Vim version 9.1. Last change: 2025 Aug 27 +*eval.txt* For Vim version 9.1. Last change: 2025 Aug 29 VIM REFERENCE MANUAL by Bram Moolenaar @@ -972,8 +972,8 @@ is not available it returns -1 or the default value you specify: > Blob iteration ~ -The |:for| loop executes commands for each byte of a Blob. The loop variable is -set to each byte in the Blob. Example: > +The |:for| loop executes commands for each byte of a Blob. The loop variable +is set to each byte in the Blob. Example: > :for byte in 0z112233 : call Doit(byte) :endfor @@ -1547,9 +1547,9 @@ String. A negative index always results in an empty string (reason: backward compatibility). Use [-1:] to get the last byte or character. In Vim9 script a negative index is used like with a list: count from the end. -If expr10 is a |List| then it results the item at index expr1. See |list-index| -for possible index values. If the index is out of range this results in an -error. Example: > +If expr10 is a |List| then it results the item at index expr1. See +|list-index| for possible index values. If the index is out of range this +results in an error. Example: > :let item = mylist[-1] " get last item 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 unavailable. See 'clipmethod' for more details. - *v:cmdarg* *cmdarg-variable* v:cmdarg This variable is used for two purposes: 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 It is possible to remove entries from this dictionary but doing so is NOT recommended, because it is disruptive to other scripts. It is also unlikely to achieve the desired - result because the |:colorscheme| and |:highlight| commands will - both automatically load all `colors/lists/default.vim` color - scripts. + result because the |:colorscheme| and |:highlight| commands + will both automatically load all `colors/lists/default.vim` + color scripts. You can make changes to that file, but make sure to add new keys instead of updating existing ones, otherwise Vim will skip @@ -2721,9 +2720,10 @@ v:python3_version should exactly match the Python library up to the minor version (e.g. 3.10.2 and 3.10.3 are compatible as the minor version is "10", whereas 3.9.4 and 3.10.3 are not compatible). - When |python-stable-abi| is used, this will be the minimum Python - version that you can use instead. (e.g. if v:python3_version - indicates 3.9, you can use 3.9, 3.10, or anything above). + When |python-stable-abi| is used, this will be the minimum + Python version that you can use instead. (e.g. if + v:python3_version indicates 3.9, you can use 3.9, 3.10, or + anything above). This number is encoded as a hex number following Python ABI versioning conventions. Do the following to have a @@ -2861,16 +2861,16 @@ v:t_enumvalue Value of |enumvalue| type. Read-only. See: |type()| *v:t_tuple* *t_tuple-variable* v:t_tuple Value of |Tuple| type. Read-only. See: |type()| - *v:termresponse* *termresponse-variable* + *v:termresponse* *termresponse-variable* v:termresponse The escape sequence returned by the terminal for the |t_RV| termcap entry. It is set when Vim receives an escape sequence that starts with ESC [ or CSI, then '>' or '?' and ends in a 'c', with only digits and ';' in between. - When this option is set, the TermResponse autocommand event is - fired, so that you can react to the response from the + When this variable is set, the TermResponse autocommand event + is fired, so that you can react to the response from the terminal. The TermResponseAll event is also fired, with - set to "version". You can use |terminalprops()| to see - what Vim figured out about the terminal. + set to "version". You can use |terminalprops()| to + see what Vim figured out about the terminal. The response from a new xterm is: "[> Pp ; Pv ; Pc c". Pp is the terminal type: 0 for vt100 and 1 for vt220. Pv is the patch level (since this was introduced in patch 95, it's @@ -2879,21 +2879,21 @@ v:termresponse The escape sequence returned by the terminal for the |t_RV| codes. This only works with xterm |xterm-codes|. {only when compiled with |+termresponse| feature} - *v:termblinkresp* + *v:termblinkresp* *termblinkresp-variable* v:termblinkresp The escape sequence returned by the terminal for the |t_RC| termcap entry. This is used to find out whether the terminal cursor is blinking. This is used by |term_getcursor()|. When - this option is set, the TermResponseAll autocommand event is + this variable is set, the TermResponseAll autocommand event is fired, with set to "cursorblink". - *v:termstyleresp* + *v:termstyleresp* *termstyleresp-variable* v:termstyleresp The escape sequence returned by the terminal for the |t_RS| termcap entry. This is used to find out what the shape of the cursor is. This is used by |term_getcursor()|. When this - option is set, the TermResponseAll autocommand event is fired, - with set to "cursorshape". + variable is set, the TermResponseAll autocommand event is + fired, with set to "cursorshape". - *v:termrbgresp* + *v:termrbgresp* *termrbgresp-variable* v:termrbgresp The escape sequence returned by the terminal for the |t_RB| termcap entry. This is used to find out what the terminal background color is; see 'background'. This is set by the @@ -2901,27 +2901,27 @@ v:termrbgresp The escape sequence returned by the terminal for the |t_RB| Vim, but can be set manually if you know what you are doing. Note that changing this will not do anything. - *v:termrfgresp* + *v:termrfgresp* *termrfgresp-variable* v:termrfgresp The escape sequence returned by the terminal for the |t_RF| termcap entry. This is used to find out what the terminal foreground color is. Behaves the same as |v:termrbgresp| - *v:termu7resp* + *v:termu7resp* *termu7resp-variable* v:termu7resp The escape sequence returned by the terminal for the |t_u7| termcap entry. This is used to find out what the terminal does with ambiguous width characters, see 'ambiwidth'. When - this option is set, the TermResponseAll autocommand event is + this variable is set, the TermResponseAll autocommand event is fired, with set to "ambiguouswidth". - *v:termda1* + *v:termda1* *termda1-variable* v:termda1 The escape sequence returned by a primary device attributes - (DA1) query from the terminal. When this option is set, the + (DA1) query from the terminal. When this variable is set, the TermResponseAll autocommand event is fired, with set to "da1". Can be used to detect OSC 52 support in a terminal. - *v:termosc* + *v:termosc* *termosc-variable* v:termosc The escape sequence of the most recent OSC response received - from the terminal. When this option is set, the + from the terminal. When this variable is set, the |TermResponseAll| autocommand event is fired, with set to "osc". Also used to set the |v:termrbgresp| and |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 *v:warningmsg* *warningmsg-variable* v:warningmsg Last given warning message. It's allowed to set this variable. - *v:wayland_display* + *v:wayland_display* *wayland_display-variable* v:wayland_display The name of the Wayland display that Vim is connected to. Equivalent to the $WAYLAND_DISPLAY environment variable. @@ -3356,7 +3356,8 @@ text... One or more items from a |List| can be removed: > :unlet list[3] " remove fourth item :unlet list[3:] " remove fourth item to last -< One item from a |Dictionary| can be removed at a time: > +< One item from a |Dictionary| can be removed at a time: +> :unlet dict['two'] :unlet dict.two < This is especially useful to clean up used global @@ -3487,7 +3488,7 @@ text... - In |Vim9| script an error is given. - In legacy script this is silently ignored. -:if {expr1} *:if* *:end* *:endif* *:en* *E171* *E579* *E580* +:if {expr1} *:if* *:end* *:endif* *:en* *E171* *E579* *E580* :en[dif] Execute the commands until the next matching `:else` or `:endif` if {expr1} evaluates to non-zero. Although the short forms work, it is recommended to @@ -3825,8 +3826,9 @@ text... message in the |message-history|. When used in a script or function the line number will be added. Spaces are placed between the arguments as with the - `:echomsg` command. When used inside a try conditional, - the message is raised as an error exception instead + `:echomsg` command. When used inside a try + conditional, the message is raised as an error + exception instead (see |try-echoerr|). Example: > :echoerr "This script just failed!" @@ -5172,8 +5174,8 @@ to execute the given executable. For security reasons users may not want to have Vim execute random executables or may have forbidden to do so for specific filetypes by setting the "_exec" variable (|plugin_exec|). -It returns |true| or |false| to indicate whether the plugin should run the given -executable. It takes the following arguments: +It returns |true| or |false| to indicate whether the plugin should run the +given executable. It takes the following arguments: argument type ~ diff --git a/runtime/doc/tags b/runtime/doc/tags index 3a4a07bf02..37484a1d17 100644 --- a/runtime/doc/tags +++ b/runtime/doc/tags @@ -10893,6 +10893,7 @@ term_setrestore() terminal.txt /*term_setrestore()* term_setsize() terminal.txt /*term_setsize()* term_start() terminal.txt /*term_start()* term_wait() terminal.txt /*term_wait()* +termblinkresp-variable eval.txt /*termblinkresp-variable* termcap term.txt /*termcap* termcap-changed version4.txt /*termcap-changed* termcap-colors term.txt /*termcap-colors* @@ -10900,6 +10901,7 @@ termcap-cursor-color term.txt /*termcap-cursor-color* termcap-cursor-shape term.txt /*termcap-cursor-shape* termcap-options term.txt /*termcap-options* termcap-title term.txt /*termcap-title* +termda1-variable eval.txt /*termda1-variable* termdebug-commands terminal.txt /*termdebug-commands* termdebug-communication terminal.txt /*termdebug-communication* termdebug-customizing terminal.txt /*termdebug-customizing* @@ -10963,7 +10965,12 @@ terminal-window terminal.txt /*terminal-window* terminal.txt terminal.txt /*terminal.txt* terminalprops() builtin.txt /*terminalprops()* terminfo term.txt /*terminfo* +termosc-variable eval.txt /*termosc-variable* +termrbgresp-variable eval.txt /*termrbgresp-variable* termresponse-variable eval.txt /*termresponse-variable* +termrfgresp-variable eval.txt /*termrfgresp-variable* +termstyleresp-variable eval.txt /*termstyleresp-variable* +termu7resp-variable eval.txt /*termu7resp-variable* ternary eval.txt /*ternary* test-functions usr_41.txt /*test-functions* test-functions-details testing.txt /*test-functions-details* @@ -11669,6 +11676,7 @@ wayland-seat wayland.txt /*wayland-seat* wayland-selections wayland.txt /*wayland-selections* wayland-useful wayland.txt /*wayland-useful* wayland.txt wayland.txt /*wayland.txt* +wayland_display-variable eval.txt /*wayland_display-variable* wdl-syntax syntax.txt /*wdl-syntax* wdl.vim syntax.txt /*wdl.vim* white-space pattern.txt /*white-space*