From ec9c32637f566f38d097c566209d85d697182153 Mon Sep 17 00:00:00 2001 From: Christian Brabandt Date: Wed, 21 Feb 2024 20:40:05 +0100 Subject: [PATCH] runtime(doc): clarify expand() for :terminal windows While adding to the documentation, also mention the rolled-back key-translation strategy in version9.txt closes: #14069 Signed-off-by: Christian Brabandt --- runtime/doc/builtin.txt | 3 +++ runtime/doc/tags | 1 + runtime/doc/terminal.txt | 3 ++- runtime/doc/version9.txt | 5 ++++- 4 files changed, 10 insertions(+), 2 deletions(-) diff --git a/runtime/doc/builtin.txt b/runtime/doc/builtin.txt index 2dc8f615f..f1256b027 100644 --- a/runtime/doc/builtin.txt +++ b/runtime/doc/builtin.txt @@ -2540,6 +2540,9 @@ expand({string} [, {nosuf} [, {list}]]) *expand()* for a non-existing file is not included, unless {string} does not start with '%', '#' or '<', see below. + For a |:terminal| window '%' expands to a '!' followed by + the command or shell that is run |terminal-bufname| + When {string} starts with '%', '#' or '<', the expansion is done like for the |cmdline-special| variables with their associated modifiers. Here is a short overview: diff --git a/runtime/doc/tags b/runtime/doc/tags index b7e26ee49..5c2eee33e 100644 --- a/runtime/doc/tags +++ b/runtime/doc/tags @@ -10531,6 +10531,7 @@ termdebug_winbar terminal.txt /*termdebug_winbar* terminal terminal.txt /*terminal* terminal-api terminal.txt /*terminal-api* terminal-autoshelldir terminal.txt /*terminal-autoshelldir* +terminal-bufname terminal.txt /*terminal-bufname* terminal-client-server terminal.txt /*terminal-client-server* terminal-close terminal.txt /*terminal-close* terminal-colors os_unix.txt /*terminal-colors* diff --git a/runtime/doc/terminal.txt b/runtime/doc/terminal.txt index c5331fa85..3720603ff 100644 --- a/runtime/doc/terminal.txt +++ b/runtime/doc/terminal.txt @@ -1,4 +1,4 @@ -*terminal.txt* For Vim version 9.1. Last change: 2023 Nov 08 +*terminal.txt* For Vim version 9.1. Last change: 2024 Feb 21 VIM REFERENCE MANUAL by Bram Moolenaar @@ -208,6 +208,7 @@ Command syntax ~ [command]. Use `:execute` if you must have a Vim command following in the same line. + *terminal-bufname* A new buffer will be created, using [command] or 'shell' as the name, prefixed with a "!". If a buffer by this name already exists a number is added in diff --git a/runtime/doc/version9.txt b/runtime/doc/version9.txt index 29dbfb8c5..7b9a3664a 100644 --- a/runtime/doc/version9.txt +++ b/runtime/doc/version9.txt @@ -1,4 +1,4 @@ -*version9.txt* For Vim version 9.1. Last change: 2024 Jan 05 +*version9.txt* For Vim version 9.1. Last change: 2024 Feb 21 VIM REFERENCE MANUAL by Bram Moolenaar @@ -41578,6 +41578,9 @@ Options: ~ ============================================================================== INCOMPATIBLE CHANGES *incompatible-9.2* +Improved/Different MS-Windows mapping support +|w32-experimental-keycode-trans-strategy| + ============================================================================== IMPROVEMENTS *improvements-9.2*