From f73bd2546ed9cdc9966d0831d05c1109830dcddc Mon Sep 17 00:00:00 2001 From: Kalin KOZHUHAROV Date: Fri, 6 Feb 2026 14:55:12 +0000 Subject: [PATCH] runtime(doc): clarify term_cols allowed range in terminal.txt Patch 9.0.1527 (related issue: vim/vim#12362) introduced range checking for `term_cols` parameter of the various terminal related functions, but did not update the documentation. This is the fix, hopefully I found everything that mentions is. Also improve the style for `term_rows` to match. Code reference ( https://github.com/vim/vim/blob/master/src/job.c#L456 ): if (opt->jo_term_cols < 0 || opt->jo_term_cols > 1000) closes: #19346 Signed-off-by: Kalin Kozhuharov Signed-off-by: Christian Brabandt --- runtime/doc/terminal.txt | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/runtime/doc/terminal.txt b/runtime/doc/terminal.txt index 083f013cc1..c4f227d090 100644 --- a/runtime/doc/terminal.txt +++ b/runtime/doc/terminal.txt @@ -1,4 +1,4 @@ -*terminal.txt* For Vim version 9.1. Last change: 2026 Jan 18 +*terminal.txt* For Vim version 9.1. Last change: 2026 Feb 06 VIM REFERENCE MANUAL by Bram Moolenaar @@ -525,10 +525,12 @@ term_dumpdiff({filename}, {filename} [, {options}]) of the first file name. "term_rows" vertical size to use for the terminal, instead of using 'termwinsize', but - respecting the minimal size + respecting the minimal size; valid range + is from 0 to 1000 "term_cols" horizontal size to use for the terminal, instead of using 'termwinsize', but - respecting the minimal size + respecting the minimal size; valid range + is from 0 to 1000 "vertical" split the window vertically "curwin" use the current window, do not split the window; fails if the current buffer @@ -951,9 +953,10 @@ term_start({cmd} [, {options}]) *term_start()* of the command name. "term_rows" vertical size to use for the terminal, instead of using 'termwinsize'; valid - range is from zero to 1000 + range is from 0 to 1000 "term_cols" horizontal size to use for the terminal, - instead of using 'termwinsize' + instead of using 'termwinsize'; valid + range is from 0 to 1000 "vertical" split the window vertically; note that other window position can be defined with command modifiers, such as |:belowright|. -- 2.47.3