diff options
Diffstat (limited to 'Doc/help/disable')
-rw-r--r-- | Doc/help/disable | 85 |
1 files changed, 85 insertions, 0 deletions
diff --git a/Doc/help/disable b/Doc/help/disable new file mode 100644 index 000000000..3d2e4a4f7 --- /dev/null +++ b/Doc/help/disable @@ -0,0 +1,85 @@ +disable [ -afmprs ] name ... + Temporarily disable the named hash table elements or patterns. + The default is to disable builtin commands. This allows you to + use an external command with the same name as a builtin command. + The -a option causes disable to act on regular or global + aliases. The -s option causes disable to act on suffix aliases. + The -f option causes disable to act on shell functions. The -r + options causes disable to act on reserved words. Without argu- + ments all disabled hash table elements from the corresponding + hash table are printed. With the -m flag the arguments are + taken as patterns (which should be quoted to prevent them from + undergoing filename expansion), and all hash table elements from + the corresponding hash table matching these patterns are dis- + abled. Disabled objects can be enabled with the enable command. + + With the option -p, name ... refer to elements of the shell's + pattern syntax as described in the section `Filename Genera- + tion'. Certain elements can be disabled separately, as given + below. + + Note that patterns not allowed by the current settings for the + options EXTENDED_GLOB, KSH_GLOB and SH_GLOB are never enabled, + regardless of the setting here. For example, if EXTENDED_GLOB + is not active, the pattern ^ is ineffective even if `disable -p + "^"' has not been issued. The list below indicates any option + settings that restrict the use of the pattern. It should be + noted that setting SH_GLOB has a wider effect than merely dis- + abling patterns as certain expressions, in particular those in- + volving parentheses, are parsed differently. + + The following patterns may be disabled; all the strings need + quoting on the command line to prevent them from being inter- + preted immediately as patterns and the patterns are shown below + in single quotes as a reminder. + + '?' The pattern character ? wherever it occurs, including + when preceding a parenthesis with KSH_GLOB. + + '*' The pattern character * wherever it occurs, including re- + cursive globbing and when preceding a parenthesis with + KSH_GLOB. + + '[' Character classes. + + '<' (NO_SH_GLOB) + Numeric ranges. + + '|' (NO_SH_GLOB) + Alternation in grouped patterns, case statements, or + KSH_GLOB parenthesised expressions. + + '(' (NO_SH_GLOB) + Grouping using single parentheses. Disabling this does + not disable the use of parentheses for KSH_GLOB where + they are introduced by a special character, nor for glob + qualifiers (use `setopt NO_BARE_GLOB_QUAL' to disable + glob qualifiers that use parentheses only). + + '~' (EXTENDED_GLOB) + Exclusion in the form A~B. + + '^' (EXTENDED_GLOB) + Exclusion in the form A^B. + + '#' (EXTENDED_GLOB) + The pattern character # wherever it occurs, both for rep- + etition of a previous pattern and for indicating globbing + flags. + + '?(' (KSH_GLOB) + The grouping form ?(...). Note this is also disabled if + '?' is disabled. + + '*(' (KSH_GLOB) + The grouping form *(...). Note this is also disabled if + '*' is disabled. + + '+(' (KSH_GLOB) + The grouping form +(...). + + '!(' (KSH_GLOB) + The grouping form !(...). + + '@(' (KSH_GLOB) + The grouping form @(...). |