diff runtime/doc/options.txt @ 3359:20ca2e05ae20 v7.3.446

updated for version 7.3.446 Problem: Win32: External commands with special characters don't work. Solution: Add the 'shellxescape' option.
author Bram Moolenaar <bram@vim.org>
date Mon, 20 Feb 2012 22:18:30 +0100
parents b37888de599c
children 8dcf3ea92b63
line wrap: on
line diff
--- a/runtime/doc/options.txt
+++ b/runtime/doc/options.txt
@@ -6043,8 +6043,9 @@ A jump table for the options with a shor
 
 						*'shellxquote'* *'sxq'*
 'shellxquote' 'sxq'	string	(default: "";
-					for Win32, when 'shell' is cmd.exe or
-					contains "sh" somewhere: "\""
+					for Win32, when 'shell' is cmd.exe: "("
+					for Win32, when 'shell' contains "sh"
+					somewhere: "\""
 					for Unix, when using system(): "\"")
 			global
 			{not in Vi}
@@ -6052,6 +6053,9 @@ A jump table for the options with a shor
 	the "!" and ":!" commands.  Includes the redirection.  See
 	'shellquote' to exclude the redirection.  It's probably not useful
 	to set both options.
+	When the value is '(' then ')' is appended. When the value is '"('
+	then ')"' is appended.
+	When the value is '(' then also see 'shellxescape'.
 	This is an empty string by default on most systems, but is known to be
 	useful for on Win32 version, either for cmd.exe which automatically
 	strips off the first and last quote on a command, or 3rd-party shells
@@ -6061,6 +6065,16 @@ A jump table for the options with a shor
 	This option cannot be set from a |modeline| or in the |sandbox|, for
 	security reasons.
 
+						*'shellxescape'* *'sxe'*
+'shellxescape' 'sxe'	string	(default: "";
+				 for MS-DOS and MS-Windows: "\"&|<>()@^")
+			global
+			{not in Vi}
+	When 'shellxquote' is set to "(" then the characters listed in this
+	option will be escaped with a '^' character.  This makes it possible
+	to execute most external commands with cmd.exe.
+
+
 			*'shiftround'* *'sr'* *'noshiftround'* *'nosr'*
 'shiftround' 'sr'	boolean	(default off)
 			global