runtime(doc): Tweak documentation style
Commit:
https://github.com/vim/vim/commit/bb807ebc8a7a6ad3f3d330cf19ce775cb40a2811
Author: Hirohito Higashi <[email protected]>
Date: Mon May 4 19:17:52 2026 +0000
runtime(doc): Tweak documentation style
closes: https://github.com/vim/vim/issues/20134
Signed-off-by: Hirohito Higashi <[email protected]>
Signed-off-by: Christian Brabandt <[email protected]>
diff --git a/runtime/doc/builtin.txt b/runtime/doc/builtin.txt
index b294b6388..e9036c18f 100644
--- a/runtime/doc/builtin.txt
+++ b/runtime/doc/builtin.txt
@@ -1,4 +1,4 @@
-*builtin.txt* For Vim version 9.2. Last change: 2026 Apr 28
+*builtin.txt* For Vim version 9.2. Last change: 2026 May 04
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -11904,16 +11904,16 @@ tabpanel_getinfo()
*tabpanel_getinfo()*
tabpanel_scroll({n} [, {opts}])
*tabpanel_scroll()*
Scroll the tabpanel by {n} rows. Positive values scroll down
- (later tabs become visible), negative values scroll up. The
- new offset is clamped to the valid range.
+ (later tab pages become visible), negative values scroll up.
+ The new offset is clamped to the valid range.
When {opts} is a |Dictionary| and its "absolute" entry is
- |TRUE|, {n} is used as the new absolute scroll offset
- instead of a delta.
+ |TRUE|, {n} is used as the new absolute scroll offset instead
+ of a delta.
- Returns |TRUE| if the scroll offset changed, |FALSE|
- otherwise (for example when the tabpanel is not shown, or
- the offset is already at the requested value).
+ Returns |TRUE| if the scroll offset changed, |FALSE| otherwise
+ (for example when the tabpanel is not shown, or the offset is
+ already at the requested value).
Return type: |vim9-boolean|
diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt
index 4628a1624..c4b2df144 100644
--- a/runtime/doc/options.txt
+++ b/runtime/doc/options.txt
@@ -1,4 +1,4 @@
-*options.txt* For Vim version 9.2. Last change: 2026 May 03
+*options.txt* For Vim version 9.2. Last change: 2026 May 04
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -10418,9 +10418,9 @@ A jump table for the options with a short description
can be found at |Q_op|.
"noselect" If 'wildmenu' is enabled, show the menu but do not
preselect the first item.
"noinsert" If 'wildmenu' is enabled, show the menu and preselect
- the first match, but do not insert it in the
- command line. If both "noinsert" and "noselect" are
- present, "noselect" takes precedence.
+ the first match, but do not insert it in the command
+ line. If both "noinsert" and "noselect" are present,
+ "noselect" takes precedence.
If only one match exists, it is completed fully, unless "noselect" or
"noinsert" is specified.
diff --git a/runtime/doc/syntax.txt b/runtime/doc/syntax.txt
index efebe5667..677e7cc3e 100644
--- a/runtime/doc/syntax.txt
+++ b/runtime/doc/syntax.txt
@@ -1,4 +1,4 @@
-*syntax.txt* For Vim version 9.2. Last change: 2026 Apr 30
+*syntax.txt* For Vim version 9.2. Last change: 2026 May 04
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -6135,15 +6135,16 @@ StatusLine Status line of current window.
current window's status line. see |hl-VertSplit|.
*hl-StatusLineNC*
StatusLineNC status lines of not-current windows.
- Also used for the vertical separator cell adjacent to a
+ Also used for the vertical separator cell adjacent to the
non-current window's status line. see |hl-VertSplitNC|.
Note: If this is equal to "StatusLine", Vim will use "^^^" in
the status line of the current window.
*hl-StatusLineTerm*
StatusLineTerm Status line of current window, if it is a |terminal| window.
*hl-StatusLineTermNC*
-StatusLineTermNC Status lines of not-current windows that is a
- |terminal| window.
+StatusLineTermNC
+ Status lines of not-current windows that is a |terminal|
+ window.
*hl-TabLine*
TabLine Tab pages line, not active tab page label.
*hl-TabLineFill*
@@ -6163,19 +6164,19 @@ Title Titles for output from ":set all",
":autocmd" etc.
*hl-TitleBar*
TitleBar Title bar for the active Gui's window.
This feature is supported only in the MS-Windows GUI.
- See |gui-w32-title-bar| for details
+ See |gui-w32-title-bar| for details.
Only the `guibg` and `guifg` highlight arguments are effective.
*hl-TitleBarNC*
TitleBarNC Title bar for inactive Gui's window.
This feature is supported only in the MS-Windows GUI.
- See |gui-w32-title-bar| for details
+ See |gui-w32-title-bar| for details.
Only the `guibg` and `guifg` highlight arguments are effective.
*hl-Visual*
Visual Visual mode selection.
*hl-VisualNOS*
VisualNOS Visual mode selection when vim is "Not Owning the Selection".
- Only X11 Gui's |gui-x11|, |xterm-clipboard| and
|wayland-selections|
- supports this.
+ Only X11 Gui's |gui-x11|, |xterm-clipboard| and
+ |wayland-selections| supports this.
*hl-WarningMsg*
WarningMsg Warning messages.
*hl-WildMenu*
@@ -6195,10 +6196,9 @@ Menu Current font, background and foreground
colors of the menus.
Also used for the toolbar.
Applicable highlight arguments: font, guibg, guifg.
- NOTE: For Motif the font argument actually
- specifies a fontset at all times, no matter if 'guifontset' is
- empty, and as such it is tied to the current |:language| when
- set.
+ NOTE: For Motif the font argument actually specifies a fontset
+ at all times, no matter if 'guifontset' is empty, and as such
+ it is tied to the current |:language| when set.
*hl-Scrollbar*
Scrollbar Current background and foreground of the main window's
@@ -6209,10 +6209,9 @@ Scrollbar Current background and foreground of
the main window's
Tooltip Current font, background and foreground of the tooltips.
Applicable highlight arguments: font, guibg, guifg.
- NOTE: For Motif the font argument actually
- specifies a fontset at all times, no matter if 'guifontset' is
- empty, and as such it is tied to the current |:language| when
- set.
+ NOTE: For Motif the font argument actually specifies a fontset
+ at all times, no matter if 'guifontset' is empty, and as such
+ it is tied to the current |:language| when set.
==============================================================================
15. Linking groups *:hi-link* *:highlight-link* *E412* *E413*
diff --git a/runtime/doc/tabpage.txt b/runtime/doc/tabpage.txt
index d6db4e8d0..1b6f78127 100644
--- a/runtime/doc/tabpage.txt
+++ b/runtime/doc/tabpage.txt
@@ -1,4 +1,4 @@
-*tabpage.txt* For Vim version 9.2. Last change: 2026 Apr 28
+*tabpage.txt* For Vim version 9.2. Last change: 2026 May 04
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -516,7 +516,7 @@ a new, empty tab page; it is treated the same as a single
click.
For finer-grained control, the 'tabpanel' value may contain |stl-%[FuncName]|
click regions. Clicks on those regions are dispatched to the callback
-function instead of falling through to tab selection.
+function instead of falling through to tab page selection.
==============================================================================
6. Setting 'guitablabel' *setting-guitablabel*
diff --git a/runtime/doc/vim9.txt b/runtime/doc/vim9.txt
index b107d62c7..5d6b71b5c 100644
--- a/runtime/doc/vim9.txt
+++ b/runtime/doc/vim9.txt
@@ -1,4 +1,4 @@
-*vim9.txt* For Vim version 9.2. Last change: 2026 Feb 14
+*vim9.txt* For Vim version 9.2. Last change: 2026 May 04
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -2355,11 +2355,6 @@ in Vim9 script.
let &laststatus=v:true
vim9cmd &laststatus = true
-<
- - Not using a string where an argument requires a string (|E1174|) >vim
-
- echo substitute('Hallo', 'a', 'e', v:true)
- vim9cmd echo substitute('Hallo', 'a', 'e', true) # E1174: String...
<
One consequence is that the item type of a list or dict given to |map()| must
not change when its type is either declared or inferred. For example, this
--
--
You received this message from the "vim_dev" maillist.
Do not top-post! Type your reply below the text you are replying to.
For more information, visit http://www.vim.org/maillist.php
---
You received this message because you are subscribed to the Google Groups
"vim_dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To view this discussion visit
https://groups.google.com/d/msgid/vim_dev/E1wJyzV-005q67-La%40256bit.org.