adam/vim
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

runtime(doc): Tweak documentation style

Browse Source 
closes: #18155

Signed-off-by: Hirohito Higashi <h.east.727@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
This commit is contained in:
Hirohito Higashi
2025-08-29 18:17:40 +02:00
committed by Christian Brabandt
parent 4fec4bb7a5
commit e0196f3e27
3 changed files with 50 additions and 42 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
runtime/doc/autocmd.txt
View File

@ -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

78
runtime/doc/eval.txt
View File

@ -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
<amatch> set to "version". You can use |terminalprops()| to see
what Vim figured out about the terminal.
<amatch> set to "version". You can use |terminalprops()| to
see what Vim figured out about the terminal.
The response from a new xterm is: "<Esc>[> 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 <amatch> 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 <amatch> set to "cursorshape".
variable is set, the TermResponseAll autocommand event is
fired, with <amatch> 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 <amatch> 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 <amatch> 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 <amatch>
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 "<filetype>_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 ~

8
runtime/doc/tags
View File

@ -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*