Mercurial > vim

comparison runtime/doc/options.txt @ 25084:beff72446e2e v8.2.3079

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
patch 8.2.3079: Powershell core not supported by default Commit: https://github.com/vim/vim/commit/a3d1b29bd36487167c98b3cefa30f06c529e412d Author: Mike Williams <mikew@globalgraphics.com> Date: Wed Jun 30 20:56:00 2021 +0200 patch 8.2.3079: Powershell core not supported by default Problem: Powershell core not supported by default. Solution: Set option defaults for "pwsh". (Mike Williams, closes https://github.com/vim/vim/issues/8481)
author Bram Moolenaar <Bram@vim.org>
date Wed, 30 Jun 2021 21:00:05 +0200
parents 0ce24f734615
children cf0774d010b7
comparison
equal deleted inserted replaced
25083:05c4686c56d2 25084:beff72446e2e
6631 "tcsh" after initializations, the default becomes "|& tee". If the 6631 "tcsh" after initializations, the default becomes "|& tee". If the
6632 'shell' option is "sh", "ksh", "mksh", "pdksh", "zsh", "zsh-beta", 6632 'shell' option is "sh", "ksh", "mksh", "pdksh", "zsh", "zsh-beta",
6633 "bash", "fish", "ash" or "dash" the default becomes "2>&1| tee". This 6633 "bash", "fish", "ash" or "dash" the default becomes "2>&1| tee". This
6634 means that stderr is also included. Before using the 'shell' option a 6634 means that stderr is also included. Before using the 'shell' option a
6635 path is removed, thus "/bin/sh" uses "sh". 6635 path is removed, thus "/bin/sh" uses "sh".
6636 For Unix and MS-Windows, when the 'shell' option is "pwsh" the default
6637 becomes ">%s 2>&1" and the output is not echoed to the screen.
6636 The initialization of this option is done after reading the ".vimrc" 6638 The initialization of this option is done after reading the ".vimrc"
6637 and the other initializations, so that when the 'shell' option is set 6639 and the other initializations, so that when the 'shell' option is set
6638 there, the 'shellpipe' option changes automatically, unless it was 6640 there, the 'shellpipe' option changes automatically, unless it was
6639 explicitly set before. 6641 explicitly set before.
6640 When 'shellpipe' is set to an empty string, no redirection of the 6642 When 'shellpipe' is set to an empty string, no redirection of the
6646 become obsolete (at least for Unix). 6648 become obsolete (at least for Unix).
6647 This option cannot be set from a |modeline| or in the |sandbox|, for 6649 This option cannot be set from a |modeline| or in the |sandbox|, for
6648 security reasons. 6650 security reasons.
6649 6651
6650 *'shellquote'* *'shq'* 6652 *'shellquote'* *'shq'*
6651 'shellquote' 'shq' string (default: ""; Win32, when 'shell' does not 6653 'shellquote' 'shq' string (default: "")
6652 contain powershell but contains "sh"
6653 somewhere: "\"")
6654 global 6654 global
6655 Quoting character(s), put around the command passed to the shell, for 6655 Quoting character(s), put around the command passed to the shell, for
6656 the "!" and ":!" commands. The redirection is kept outside of the 6656 the "!" and ":!" commands. The redirection is kept outside of the
6657 quoting. See 'shellxquote' to include the redirection. It's 6657 quoting. See 'shellxquote' to include the redirection. It's
6658 probably not useful to set both options. 6658 probably not useful to set both options.
6659 This is an empty string by default. Only known to be useful for 6659 This is an empty string by default. Only known to be useful for
6660 third-party shells on MS-Windows-like systems, such as the MKS Korn 6660 third-party shells on MS-Windows-like systems, such as the MKS Korn
6661 Shell or bash, where it should be "\"". The default is adjusted 6661 Shell or bash, where it should be "\"". See |dos-shell|.
6662 according the value of 'shell', to reduce the need to set this option
6663 by the user. See |dos-shell|.
6664 This option cannot be set from a |modeline| or in the |sandbox|, for 6662 This option cannot be set from a |modeline| or in the |sandbox|, for
6665 security reasons. 6663 security reasons.
6666 6664
6667 *'shellredir'* *'srr'* 6665 *'shellredir'* *'srr'*
6668 'shellredir' 'srr' string (default ">", ">&", ">%s 2>&1", or 6666 'shellredir' 'srr' string (default ">", ">&", ">%s 2>&1", or
6675 (the file name is appended automatically if no %s appears in the value 6673 (the file name is appended automatically if no %s appears in the value
6676 of this option). 6674 of this option).
6677 The default is ">". For Unix, if the 'shell' option is "csh" or 6675 The default is ">". For Unix, if the 'shell' option is "csh" or
6678 "tcsh" during initializations, the default becomes ">&". If the 6676 "tcsh" during initializations, the default becomes ">&". If the
6679 'shell' option is "sh", "ksh", "mksh", "pdksh", "zsh", "zsh-beta", 6677 'shell' option is "sh", "ksh", "mksh", "pdksh", "zsh", "zsh-beta",
6680 "bash" or "fish", the default becomes ">%s 2>&1". This means that 6678 "bash", "fish", or "pwsh", the default becomes ">%s 2>&1". This means
6681 stderr is also included. For Win32, the Unix checks are done and 6679 that stderr is also included. For Win32, the Unix checks are done and
6682 additionally "cmd" is checked for, which makes the default ">%s 2>&1", 6680 additionally "cmd" is checked for, which makes the default ">%s 2>&1",
6683 and "powershell" is checked for which makes the default 6681 and "powershell" is checked for which makes the default
6684 "2>&1 | Out-File -Encoding default". Also, the same names with ".exe" 6682 "2>&1 | Out-File -Encoding default" (see |dos-powershell|). Also, the
6685 appended are checked for. 6683 same names with ".exe" appended are checked for.
6686 The initialization of this option is done after reading the ".vimrc" 6684 The initialization of this option is done after reading the ".vimrc"
6687 and the other initializations, so that when the 'shell' option is set 6685 and the other initializations, so that when the 'shell' option is set
6688 there, the 'shellredir' option changes automatically unless it was 6686 there, the 'shellredir' option changes automatically unless it was
6689 explicitly set before. 6687 explicitly set before.
6690 In the future pipes may be used for filtering and this option will 6688 In the future pipes may be used for filtering and this option will
6695 *'shellslash'* *'ssl'* *'noshellslash'* *'nossl'* 6693 *'shellslash'* *'ssl'* *'noshellslash'* *'nossl'*
6696 'shellslash' 'ssl' boolean (default off) 6694 'shellslash' 'ssl' boolean (default off)
6697 global 6695 global
6698 {only for MS-Windows} 6696 {only for MS-Windows}
6699 When set, a forward slash is used when expanding file names. This is 6697 When set, a forward slash is used when expanding file names. This is
6700 useful when a Unix-like shell is used instead of cmd.exe or 6698 useful when a Unix-like shell is used instead of cmd.exe, pwsh.exe, or
6701 powershell.exe. Backward slashes can still be typed, but they are 6699 powershell.exe. Backward slashes can still be typed, but they are
6702 changed to forward slashes by Vim. 6700 changed to forward slashes by Vim.
6703 Note that setting or resetting this option has no effect for some 6701 Note that setting or resetting this option has no effect for some
6704 existing file names, thus this option needs to be set before opening 6702 existing file names, thus this option needs to be set before opening
6705 any file for best results. This might change in the future. 6703 any file for best results. This might change in the future.
6765 to set both options. 6763 to set both options.
6766 When the value is '(' then ')' is appended. When the value is '"(' 6764 When the value is '(' then ')' is appended. When the value is '"('
6767 then ')"' is appended. 6765 then ')"' is appended.
6768 When the value is '(' then also see 'shellxescape'. 6766 When the value is '(' then also see 'shellxescape'.
6769 This is an empty string by default on most systems, but is known to be 6767 This is an empty string by default on most systems, but is known to be
6770 useful for on Win32 version, either for cmd.exe and powershell.exe 6768 useful for on Win32 version, either for cmd.exe, powershell.exe, or
6771 which automatically strips off the first and last quote on a command, 6769 pwsh.exe which automatically strips off the first and last quote on a
6772 or 3rd-party shells such as the MKS Korn Shell or bash, where it 6770 command, or 3rd-party shells such as the MKS Korn Shell or bash, where
6773 should be "\"". The default is adjusted according the value of 6771 it should be "\"". The default is adjusted according the value of
6774 'shell', to reduce the need to set this option by the user. See 6772 'shell', to reduce the need to set this option by the user. See
6775 |dos-shell|. 6773 |dos-shell|.
6776 This option cannot be set from a |modeline| or in the |sandbox|, for 6774 This option cannot be set from a |modeline| or in the |sandbox|, for
6777 security reasons. 6775 security reasons.
6778 6776