neovim

commit d9b08c58c34ba6c8083f533d5f7a0fd21e262d00
parent 46d124a9339f24eb5e5dc1ed7e6fdad99599cec8
Author: zeertzjq <zeertzjq@outlook.com>
Date:   Sun, 24 Nov 2024 06:54:39 +0800

vim-patch:partial:a01148d: runtime(doc): Expand docs on :! vs. :term (#31321)

fixes: vim/vim#16071
closes: vim/vim#16089

https://github.com/vim/vim/commit/a01148d2cb2f8d2820a5b95474d11db0d1802360

Co-authored-by: matveyt <matthewtarasov@yandex.ru>
Diffstat:
M
runtime/doc/various.txt
 | 
10
++++++++++

1 file changed, 10 insertions(+), 0 deletions(-)
diff --git a/runtime/doc/various.txt b/runtime/doc/various.txt
@@ -282,6 +282,16 @@ gx			Opens the current filepath or URL (decided by
 			requires using the call operator (&). >
 				:!Write-Output "1`n2" | & "C:\Windows\System32\sort.exe" /r
 <
+			Vim builds command line using options 'shell', 'shcf',
+			'sxq' and 'shq' in the following order:
+			`&sh &shcf &sxq &shq {cmd} &shq &sxq`
+			So setting both 'sxq' and 'shq' is possible but rarely
+			useful.  Additional escaping inside `{cmd}` may also
+			be due to 'sxe' option.
+
+			Also, all |cmdline-special| characters in {cmd} are
+			replaced by Vim before passing them to shell.
+
 							*E34*
 			Any "!" in {cmd} is replaced with the previous
 			external command (see also 'cpoptions'), unless