From: Hirohito Higashi Date: Mon, 4 May 2026 19:17:52 +0000 (+0000) Subject: runtime(doc): Tweak documentation style X-Git-Tag: v9.2.0438~1 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=bb807ebc8a7a6ad3f3d330cf19ce775cb40a2811;p=thirdparty%2Fvim.git runtime(doc): Tweak documentation style closes: #20134 Signed-off-by: Hirohito Higashi Signed-off-by: Christian Brabandt --- diff --git a/runtime/doc/builtin.txt b/runtime/doc/builtin.txt index b294b63884..e9036c18f1 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 4628a1624c..c4b2df144b 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 efebe56674..677e7cc3eb 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 d6db4e8d04..1b6f781272 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 b107d62c7a..5d6b71b5c2 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