runtime(doc): clarify term_cols allowed range in terminal.txt
Commit:
https://github.com/vim/vim/commit/f73bd2546ed9cdc9966d0831d05c1109830dcddc
Author: Kalin KOZHUHAROV <[email protected]>
Date: Fri Feb 6 14:55:12 2026 +0000
runtime(doc): clarify term_cols allowed range in terminal.txt
Patch 9.0.1527 (related issue:
vim/vimhttps://github.com/vim/vim/issues/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 <[email protected]>
Signed-off-by: Christian Brabandt <[email protected]>
diff --git a/runtime/doc/terminal.txt b/runtime/doc/terminal.txt
index 083f013cc..c4f227d09 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|.
--
--
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/E1voNJT-00GATK-01%40256bit.org.
