Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
internals:shell_options [2011/01/10 19:55]
thebonsai fixed internal link
internals:shell_options [2019/11/02 13:17] (current)
ersen edit shell mode of promptvars
Line 12: Line 12:
 ^Option: ​ |''​autocd'' ​ ^Since: ​ |4.0-alpha ​  | ^Option: ​ |''​autocd'' ​ ^Since: ​ |4.0-alpha ​  |
 ^Shell mode:  |interactive only  ^Default: |off  | ^Shell mode:  |interactive only  ^Default: |off  |
 +
 +If set, a command name that is the name of a directory is executed as if it were the argument to the cd command.
 +
 +==== assoc_expand_once ====
 +^Option: ​ |''​assoc_expand_once'' ​ ^Since: ​ |5.0-alpha ​  |
 +^Shell mode:  |all  ^Default: |off  |
 +
 +If set, Bash attempts to expand associative array options only once.
 +
  
 ==== cdable_vars ==== ==== cdable_vars ====
Line 38: Line 47:
  
 ==== checkwinsize ==== ==== checkwinsize ====
-^Option: ​ |''​checkwinsize'' ​ ^Since: ​ |unknown ​ | +^ Option: ​     | ''​checkwinsize'' ​ ^ Since: ​   | unknown ​ | 
-^Shell mode:  |all  ^Default: ​|off  |+^ Shell mode:  | all               ​^ Default:  ​| on       |
  
-If set, Bash checks the window size after each command and, if necessary, updates the values of the variables ​''​LINES'' ​and ''​COLUMNS''​.+If set, Bash checks the window size after each command and, if necessary, updates the values of the variables ​[[syntax:​shellvars#​LINES|LINES]] ​and [[syntax:​shellvars#​COLUMNS|COLUMNS]].
  
 ==== cmdhist ==== ==== cmdhist ====
Line 73: Line 82:
 Compatiblity mode for Bash 4.1 Compatiblity mode for Bash 4.1
  
 +==== compat42 ====
 +^Option: ​ |''​compat42'' ​ ^Since: ​ |4.3-alpha ​  |
 +^Shell mode:  |all  ^Default: |off  |
 +
 +Compatiblity mode for Bash 4.2
 +
 +==== compat43 ====
 +^Option: ​ |''​compat43'' ​ ^Since: ​ |4.4-alpha ​  |
 +^Shell mode:  |all  ^Default: |off  |
 +
 +Compatiblity mode for Bash 4.3
 +
 +==== compat44 ====
 +^Option: ​ |''​compat44'' ​ ^Since: ​ |5.0-alpha ​  |
 +^Shell mode:  |all  ^Default: |off  |
 +
 +Compatiblity mode for Bash 4.4
 +
 +==== direxpand ====
 +^Option: ​ |''​direxpand'' ​ ^Since: ​ |4.3-alpha ​  |
 +^Shell mode:  |all  ^Default: |off (unless changed on compile-time with ''​--enable-direxpand-default''​) ​ |
 +
 +If set, bash replaces directory names with the results of word expansion when performing filename completion. This changes the contents of the readline editing buffer. If not set, bash attempts to preserve what the user typed.
  
 ==== dirspell ==== ==== dirspell ====
Line 108: Line 140:
 ^Shell mode:  |all  ^Default: |off  | ^Shell mode:  |all  ^Default: |off  |
  
-If set, the extended [[syntax:​pattern | pattern matching]] features are enabled. See the important note below under [[internals:​shell_options#​parser_configurations | Parser configurations]].+If set, the extended [[syntax:​pattern | pattern matching]] features are enabled. See the important note below under [[#​parser_configurations | Parser configurations]].
  
 ==== extquote ==== ==== extquote ====
Line 124: Line 156:
 ==== force_fignore ==== ==== force_fignore ====
 ^Option: ​ |''​force_fignore'' ​ ^Since: ​ |3.0-alpha ​ | ^Option: ​ |''​force_fignore'' ​ ^Since: ​ |3.0-alpha ​ |
-^Shell mode:  |interactive ​(?)  ​^Default:​ |on  |+^Shell mode:  |interactive ​   ​^Default:​ |on  
 + 
 +If set, the suffixes specified by the [[syntax:​shellvars#​FIGNORE|FIGNORE]] shell variable cause words to be ignored when performing word completion even if the ignored words are the only possible completions. This option is enabled by default. 
 + 
 +==== globasciiranges ==== 
 +^Option: ​ |''​globasciiranges'' ​ ^Since: ​ |4.3-alpha ​ | 
 +^Shell mode:  | all             ^Default: |on (configurable at compile time)  |
  
-If set, the suffixes specified by the ''​FIGNORE''​ shell variable cause words to be ignored ​when performing ​word completion even if the ignored words are the only possible completions. This option ​is enabled by default.+If set, range expressions used in pattern matching ​ behave as if in the traditional C locale ​when performing ​comparisons. 
 +That is, the current locale'​s collating sequence ​is not taken into account, so b will not collate between A and B, and upper-case and lower-case ASCII 
 +characters will collate together.
  
 ==== globstar ==== ==== globstar ====
Line 144: Line 184:
 ^Shell mode:  |interactive (?)  ^Default: |off  | ^Shell mode:  |interactive (?)  ^Default: |off  |
  
-If set, the history list is appended to the file named by the value of the ''​HISTFILE'' ​variable when the shell exits, rather than overwriting the file.+If set, the history list is appended to the file named by the value of the [[syntax:​shellvars#​HISTFILE|HISTFILE]] ​variable when the shell exits, rather than overwriting the file.
  
 ==== histreedit ==== ==== histreedit ====
Line 187: Line 227:
  
 If set, and the [[#​cmdhist]] option is enabled, multi-line commands are saved to the history with embedded newlines rather than using semicolon separators where possible. If set, and the [[#​cmdhist]] option is enabled, multi-line commands are saved to the history with embedded newlines rather than using semicolon separators where possible.
 +
 +==== localvar_inherit ====
 +^Option: ​ |''​localvar_inherit'' ​ ^Since: ​ |5.0-alpha ​ |
 +^Shell mode:  |all  ^Default: |off  |
 +
 +If this option is set, a local variable inherits the value of a variable with the same name at the nearest preceding scope.
  
 ==== login_shell ==== ==== login_shell ====
Line 208: Line 254:
 ==== nocaseglob ==== ==== nocaseglob ====
 ^Option: ​ |''​nocaseglob'' ​ ^Since: ​ |2.02-alpha1 ​ | ^Option: ​ |''​nocaseglob'' ​ ^Since: ​ |2.02-alpha1 ​ |
-^Shell mode:  |interactive (?)  ​^Default:​ |off  |+^Shell mode:  |all  ​^Default:​ |off  |
  
 If set, Bash matches filenames in a case-insensitive fashion when performing pathname expansion. If set, Bash matches filenames in a case-insensitive fashion when performing pathname expansion.
Line 214: Line 260:
 ==== nocasematch ==== ==== nocasematch ====
 ^Option: ​ |''​nocasematch'' ​ ^Since: ​ |3.1-alpha1 ​ | ^Option: ​ |''​nocasematch'' ​ ^Since: ​ |3.1-alpha1 ​ |
-^Shell mode:  |interactive (?)  ​^Default:​ |off  |+^Shell mode:  |all  ​^Default:​ |off  |
  
 If set, Bash matches patterns in a case-insensitive fashion when performing matching while executing ''​case''​ or ''<​nowiki>​[[</​nowiki>''​ conditional commands. If set, Bash matches patterns in a case-insensitive fashion when performing matching while executing ''​case''​ or ''<​nowiki>​[[</​nowiki>''​ conditional commands.
Line 220: Line 266:
 ==== nullglob ==== ==== nullglob ====
 ^Option: ​ |''​nullglob'' ​ ^Since: ​ |unknown ​ | ^Option: ​ |''​nullglob'' ​ ^Since: ​ |unknown ​ |
-^Shell mode:  |interactive (?)  ​^Default:​ |off  |+^Shell mode:  |all  ​^Default:​ |off  |
  
 If set, Bash allows patterns which match no files to expand to a null string, rather than themselves. If set, Bash allows patterns which match no files to expand to a null string, rather than themselves.
Line 232: Line 278:
 ==== promptvars ==== ==== promptvars ====
 ^Option: ​ |''​promptvars'' ​ ^Since: ​ |unknown ​ | ^Option: ​ |''​promptvars'' ​ ^Since: ​ |unknown ​ |
-^Shell mode:  |interactive ​(?​)  ​^Default: |on  |+^Shell mode:  |interactive ​     ^Default: |on  |
  
 If set, prompt strings undergo parameter expansion, command substitution,​ arithmetic expansion, and quote  removal after being expanded using the prompt special sequences. This option is enabled by default. If set, prompt strings undergo parameter expansion, command substitution,​ arithmetic expansion, and quote  removal after being expanded using the prompt special sequences. This option is enabled by default.
Line 243: Line 289:
  
 ==== shift_verbose ==== ==== shift_verbose ====
-^Option: ​ |''​shift_verbose'' ​ ^Since: ​ |unknown ​ +^ Option: ​     | ''​shift_verbose'' ​ ^ Since: ​   | unknown ​               
-^Shell mode:  |interactive (?​)  ​^Default: |off  |+^ Shell mode:  |all    ​^ Default: ​ | off, on in POSIX mode  |
  
 If set, the shift builtin prints an error message when the shift count exceeds the number of positional parameters. If set, the shift builtin prints an error message when the shift count exceeds the number of positional parameters.
Line 250: Line 296:
 ==== sourcepath ==== ==== sourcepath ====
 ^Option: ​ |''​sourcepath'' ​ ^Since: ​ |unknown ​ | ^Option: ​ |''​sourcepath'' ​ ^Since: ​ |unknown ​ |
-^Shell mode:  |interactive (?)  ​^Default:​ |on  |+^Shell mode:  |all  ​^Default:​ |on  |
  
 If set, the source builtin command uses the value of PATH to find the directory containing the file supplied as an argument. ​ This option is enabled by default. If set, the source builtin command uses the value of PATH to find the directory containing the file supplied as an argument. ​ This option is enabled by default.
 +
 +==== syslog_history ====
 +^Option: ​ |''​syslog_history'' ​ ^Since: ​ |5.0-alpha ​ |
 +^Shell mode:  |unknown ​ ^Default: |off  |
 +
 +If set, the shell history is sent to syslog.
 +
 +This option is undocumented and available only if the shell supports syslog.
 +
  
 ==== xpg_echo ==== ==== xpg_echo ====
 ^Option: ​ |''​xpg_echo'' ​ ^Since: ​ |2.04-beta1 ​ | ^Option: ​ |''​xpg_echo'' ​ ^Since: ​ |2.04-beta1 ​ |
-^Shell mode:  |interactive (?)  ​^Default:​ |off  |+^Shell mode:  |all  ​^Default:​ |off  |
  
 If set, the ''​echo''​-builtin command expands backslash-escape sequences by default (POSIX, SUS, XPG). If set, the ''​echo''​-builtin command expands backslash-escape sequences by default (POSIX, SUS, XPG).
  • internals/shell_options.1294689327.txt
  • Last modified: 2011/01/10 19:55
  • by thebonsai