Mercurial > vim

comparison runtime/doc/builtin.txt @ 35184:0a80fe1a9125

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
runtime(doc): clarify {special} argument for shellescape() Commit: https://github.com/vim/vim/commit/5faeb60480c6efba5c0468c01275120b6ace5a09 Author: Enno <Konfekt@users.noreply.github.com> Date: Wed May 15 21:54:19 2024 +0200 runtime(doc): clarify {special} argument for shellescape() closes: https://github.com/vim/vim/issues/14770 Signed-off-by: Enno <Konfekt@users.noreply.github.com> Signed-off-by: Christian Brabandt <cb@256bit.org>
author Christian Brabandt <cb@256bit.org>
date Wed, 15 May 2024 22:00:04 +0200
parents 9322493ebe58
children 3a4fd6867abf
comparison
equal deleted inserted replaced
35183:9a1ac66c788d 35184:0a80fe1a9125
1 *builtin.txt* For Vim version 9.1. Last change: 2024 May 07 1 *builtin.txt* For Vim version 9.1. Last change: 2024 May 15
2 2
3 3
4 VIM REFERENCE MANUAL by Bram Moolenaar 4 VIM REFERENCE MANUAL by Bram Moolenaar
5 5
6 6
8989 {string} in double quotes and double all double quotes within 8989 {string} in double quotes and double all double quotes within
8990 {string}. 8990 {string}.
8991 Otherwise it will enclose {string} in single quotes and 8991 Otherwise it will enclose {string} in single quotes and
8992 replace all "'" with "'\''". 8992 replace all "'" with "'\''".
8993 8993
8994 When the {special} argument is present and it's a non-zero 8994 The {special} argument adds additional escaping of keywords
8995 Number or a non-empty String (|non-zero-arg|), then special 8995 used in Vim commands. When it is not omitted and a non-zero
8996 items such as "!", "%", "#" and "<cword>" will be preceded by 8996 number or a non-empty String (|non-zero-arg|), then special
8997 a backslash. This backslash will be removed again by the |:!| 8997 items such as "!", "%", "#" and "<cword>" (as listed in
8998 command. 8998 |expand()|) will be preceded by a backslash.
8999 This backslash will be removed again by the |:!| command.
8999 9000
9000 The "!" character will be escaped (again with a |non-zero-arg| 9001 The "!" character will be escaped (again with a |non-zero-arg|
9001 {special}) when 'shell' contains "csh" in the tail. That is 9002 {special}) when 'shell' contains "csh" in the tail. That is
9002 because for csh and tcsh "!" is used for history replacement 9003 because for csh and tcsh "!" is used for history replacement
9003 even when inside single quotes. 9004 even when inside single quotes.