diff options
Diffstat (limited to 'doc/bash.info')
| -rw-r--r-- | doc/bash.info | 364 |
1 files changed, 192 insertions, 172 deletions
diff --git a/doc/bash.info b/doc/bash.info index b5f05d1c..51fe7c1d 100644 --- a/doc/bash.info +++ b/doc/bash.info @@ -1,9 +1,9 @@ This is bash.info, produced by makeinfo version 6.8 from bashref.texi. This text is a brief description of the features that are present in the -Bash shell (version 5.2, 3 June 2022). +Bash shell (version 5.2, 29 July 2022). - This is Edition 5.2, last updated 3 June 2022, of 'The GNU Bash + This is Edition 5.2, last updated 29 July 2022, of 'The GNU Bash Reference Manual', for 'Bash', Version 5.2. Copyright (C) 1988-2022 Free Software Foundation, Inc. @@ -26,10 +26,10 @@ Bash Features ************* This text is a brief description of the features that are present in the -Bash shell (version 5.2, 3 June 2022). The Bash home page is +Bash shell (version 5.2, 29 July 2022). The Bash home page is <http://www.gnu.org/software/bash/>. - This is Edition 5.2, last updated 3 June 2022, of 'The GNU Bash + This is Edition 5.2, last updated 29 July 2022, of 'The GNU Bash Reference Manual', for 'Bash', Version 5.2. Bash contains features that appear in other popular shells, and some @@ -2489,6 +2489,12 @@ the following sub-patterns: '!(PATTERN-LIST)' Matches anything except one of the given patterns. + The 'extglob' option changes the behavior of the parser, since the +parentheses are normally treated as operators with syntactic meaning. +To ensure that extended matching patterns are parsed correctly, make +sure that 'extglob' is enabled before parsing constructs containing the +patterns, including shell functions and command substitutions. + When matching filenames, the 'dotglob' shell option determines the set of filenames that are tested: when 'dotglob' is enabled, the set of filenames includes all files beginning with '.', but the filenames '.' @@ -7254,7 +7260,7 @@ startup files. 'read', the trap handler executes and 'read' returns an exit status greater than 128. - 60. The 'printf' builting uses 'double' (via 'strtod') to convert + 60. The 'printf' builtin uses 'double' (via 'strtod') to convert arguments corresponding to floating point conversion specifiers, instead of 'long double' if it's available. The 'L' length modifier forces 'printf' to use 'long double' if it's available. @@ -7430,6 +7436,14 @@ required for bash-5.1 and later versions. before any variable-specific transformations have been performed (e.g., converting to lowercase). Bash-5.2 will return the final value assigned to the variable. + * Parsing command substitutions will behave as if extended glob + (*note The Shopt Builtin::) is enabled, so that parsing a + command substitution containing an extglob pattern (say, as + part of a shell function) will not fail. This assumes the + intent is to enable extglob before the command is executed and + word expansions are performed. It will fail at word expansion + time if extglob hasn't been enabled by the time the command is + executed. File: bash.info, Node: Job Control, Next: Command Line Editing, Prev: Bash Features, Up: Top @@ -7636,7 +7650,7 @@ File: bash.info, Node: Job Control Builtins, Next: Job Control Variables, Pre assignment. This is useful only when the '-n' option is supplied. Supplying the '-f' option, when job control is enabled, forces 'wait' to wait for each PID or JOBSPEC to terminate before - returning its status, intead of returning when it changes status. + returning its status, instead of returning when it changes status. If neither JOBSPEC nor PID specifies an active child process of the shell, the return status is 127. If 'wait' is interrupted by a signal, the return status will be greater than 128, as described @@ -8144,7 +8158,9 @@ Variable Settings eighth bit and prefixing an <ESC> character, converting them to a meta-prefixed key sequence. The default value is 'on', but will be set to 'off' if the locale is one that contains - eight-bit characters. + eight-bit characters. This variable is dependent on the + 'LC_CTYPE' locale category, and may change if the locale is + changed. 'disable-completion' If set to 'On', Readline will inhibit word completion. @@ -8239,7 +8255,9 @@ Variable Settings regardless of what the terminal claims it can support. The default value is 'off', but Readline will set it to 'on' if the locale contains eight-bit characters. The name - 'meta-flag' is a synonym for this variable. + 'meta-flag' is a synonym for this variable. This variable is + dependent on the 'LC_CTYPE' locale category, and may change if + the locale is changed. 'isearch-terminators' The string of characters that should terminate an incremental @@ -8304,7 +8322,9 @@ Variable Settings If set to 'on', Readline will display characters with the eighth bit set directly rather than as a meta-prefixed escape sequence. The default is 'off', but Readline will set it to - 'on' if the locale contains eight-bit characters. + 'on' if the locale contains eight-bit characters. This + variable is dependent on the 'LC_CTYPE' locale category, and + may change if the locale is changed. 'page-completions' If set to 'on', Readline uses an internal 'more'-like pager to @@ -8401,7 +8421,7 @@ Key Bindings string that is inserted when the key is pressed (a MACRO). The 'bind -p' command displays Readline function names and bindings - in a format that can put directly into an initialization file. + in a format that can be put directly into an initialization file. *Note Bash Builtins::. KEYNAME: FUNCTION-NAME or MACRO @@ -10630,7 +10650,7 @@ the Bash 'configure' recognizes. '--with-libintl-prefix[=PREFIX]' Define this to make Bash link with a locally-installed version of - the libintl library instead ofthe version in 'lib/intl'. + the libintl library instead of the version in 'lib/intl'. '--with-libiconv-prefix[=PREFIX]' Define this to make Bash look for libiconv in PREFIX instead of the @@ -11986,27 +12006,27 @@ D.3 Parameter and Variable Index * COPROC: Bash Variables. (line 260) * DIRSTACK: Bash Variables. (line 264) * disable-completion: Readline Init File Syntax. - (line 146) + (line 148) * echo-control-characters: Readline Init File Syntax. - (line 151) + (line 153) * editing-mode: Readline Init File Syntax. - (line 156) + (line 158) * EMACS: Bash Variables. (line 274) * emacs-mode-string: Readline Init File Syntax. - (line 162) + (line 164) * enable-active-region: Readline Init File Syntax. - (line 172) + (line 174) * enable-bracketed-paste: Readline Init File Syntax. - (line 185) + (line 187) * enable-keypad: Readline Init File Syntax. - (line 194) + (line 196) * ENV: Bash Variables. (line 279) * EPOCHREALTIME: Bash Variables. (line 284) * EPOCHSECONDS: Bash Variables. (line 292) * EUID: Bash Variables. (line 299) * EXECIGNORE: Bash Variables. (line 303) * expand-tilde: Readline Init File Syntax. - (line 205) + (line 207) * FCEDIT: Bash Variables. (line 316) * FIGNORE: Bash Variables. (line 320) * FUNCNAME: Bash Variables. (line 326) @@ -12020,15 +12040,15 @@ D.3 Parameter and Variable Index * HISTFILESIZE: Bash Variables. (line 402) * HISTIGNORE: Bash Variables. (line 413) * history-preserve-point: Readline Init File Syntax. - (line 209) + (line 211) * history-size: Readline Init File Syntax. - (line 215) + (line 217) * HISTSIZE: Bash Variables. (line 433) * HISTTIMEFORMAT: Bash Variables. (line 440) * HOME: Bourne Shell Variables. (line 13) * horizontal-scroll-mode: Readline Init File Syntax. - (line 224) + (line 226) * HOSTFILE: Bash Variables. (line 448) * HOSTNAME: Bash Variables. (line 459) * HOSTTYPE: Bash Variables. (line 462) @@ -12036,13 +12056,13 @@ D.3 Parameter and Variable Index (line 18) * IGNOREEOF: Bash Variables. (line 465) * input-meta: Readline Init File Syntax. - (line 233) + (line 235) * INPUTRC: Bash Variables. (line 475) * INSIDE_EMACS: Bash Variables. (line 479) * isearch-terminators: Readline Init File Syntax. - (line 241) + (line 245) * keymap: Readline Init File Syntax. - (line 248) + (line 252) * LANG: Creating Internationalized Scripts. (line 51) * LANG <1>: Bash Variables. (line 485) @@ -12064,15 +12084,15 @@ D.3 Parameter and Variable Index (line 27) * MAPFILE: Bash Variables. (line 540) * mark-modified-lines: Readline Init File Syntax. - (line 278) + (line 282) * mark-symlinked-directories: Readline Init File Syntax. - (line 283) + (line 287) * match-hidden-files: Readline Init File Syntax. - (line 288) + (line 292) * menu-complete-display-prefix: Readline Init File Syntax. - (line 295) + (line 299) * meta-flag: Readline Init File Syntax. - (line 233) + (line 235) * OLDPWD: Bash Variables. (line 544) * OPTARG: Bourne Shell Variables. (line 34) @@ -12081,9 +12101,9 @@ D.3 Parameter and Variable Index (line 38) * OSTYPE: Bash Variables. (line 551) * output-meta: Readline Init File Syntax. - (line 300) + (line 304) * page-completions: Readline Init File Syntax. - (line 306) + (line 312) * PATH: Bourne Shell Variables. (line 42) * PIPESTATUS: Bash Variables. (line 554) @@ -12106,19 +12126,19 @@ D.3 Parameter and Variable Index * READLINE_POINT: Bash Variables. (line 626) * REPLY: Bash Variables. (line 630) * revert-all-at-newline: Readline Init File Syntax. - (line 316) + (line 322) * SECONDS: Bash Variables. (line 633) * SHELL: Bash Variables. (line 642) * SHELLOPTS: Bash Variables. (line 647) * SHLVL: Bash Variables. (line 656) * show-all-if-ambiguous: Readline Init File Syntax. - (line 322) -* show-all-if-unmodified: Readline Init File Syntax. (line 328) +* show-all-if-unmodified: Readline Init File Syntax. + (line 334) * show-mode-in-prompt: Readline Init File Syntax. - (line 337) -* skip-completed-text: Readline Init File Syntax. (line 343) +* skip-completed-text: Readline Init File Syntax. + (line 349) * SRANDOM: Bash Variables. (line 661) * TEXTDOMAIN: Creating Internationalized Scripts. (line 51) @@ -12129,11 +12149,11 @@ D.3 Parameter and Variable Index * TMPDIR: Bash Variables. (line 720) * UID: Bash Variables. (line 724) * vi-cmd-mode-string: Readline Init File Syntax. - (line 356) + (line 362) * vi-ins-mode-string: Readline Init File Syntax. - (line 367) + (line 373) * visible-stats: Readline Init File Syntax. - (line 378) + (line 384) File: bash.info, Node: Function Index, Next: Concept Index, Prev: Variable Index, Up: Indexes @@ -12512,138 +12532,138 @@ D.5 Concept Index Tag Table: -Node: Top884 -Node: Introduction2791 -Node: What is Bash?3004 -Node: What is a shell?4115 -Node: Definitions6650 -Node: Basic Shell Features9598 -Node: Shell Syntax10814 -Node: Shell Operation11837 -Node: Quoting13127 -Node: Escape Character14428 -Node: Single Quotes14910 -Node: Double Quotes15255 -Node: ANSI-C Quoting16530 -Node: Locale Translation17837 -Node: Creating Internationalized Scripts19145 -Node: Comments23259 -Node: Shell Commands23874 -Node: Reserved Words24809 -Node: Simple Commands25562 -Node: Pipelines26213 -Node: Lists29209 -Node: Compound Commands31001 -Node: Looping Constructs32010 -Node: Conditional Constructs34502 -Node: Command Grouping48987 -Node: Coprocesses50462 -Node: GNU Parallel53122 -Node: Shell Functions54036 -Node: Shell Parameters61918 -Node: Positional Parameters66303 -Node: Special Parameters67202 -Node: Shell Expansions70413 -Node: Brace Expansion72537 -Node: Tilde Expansion75268 -Node: Shell Parameter Expansion77886 -Node: Command Substitution96234 -Node: Arithmetic Expansion97586 -Node: Process Substitution98551 -Node: Word Splitting99668 -Node: Filename Expansion101609 -Node: Pattern Matching104355 -Node: Quote Removal109009 -Node: Redirections109301 -Node: Executing Commands118958 -Node: Simple Command Expansion119625 -Node: Command Search and Execution121732 -Node: Command Execution Environment124107 -Node: Environment127139 -Node: Exit Status128799 -Node: Signals130580 -Node: Shell Scripts134026 -Node: Shell Builtin Commands137050 -Node: Bourne Shell Builtins139085 -Node: Bash Builtins160543 -Node: Modifying Shell Behavior191396 -Node: The Set Builtin191738 -Node: The Shopt Builtin202336 -Node: Special Builtins218245 -Node: Shell Variables219221 -Node: Bourne Shell Variables219655 -Node: Bash Variables221756 -Node: Bash Features254569 -Node: Invoking Bash255579 -Node: Bash Startup Files261589 -Node: Interactive Shells266717 -Node: What is an Interactive Shell?267124 -Node: Is this Shell Interactive?267770 -Node: Interactive Shell Behavior268582 -Node: Bash Conditional Expressions272208 -Node: Shell Arithmetic276847 -Node: Aliases279788 -Node: Arrays282398 -Node: The Directory Stack288786 -Node: Directory Stack Builtins289567 -Node: Controlling the Prompt293824 -Node: The Restricted Shell296786 -Node: Bash POSIX Mode299393 -Node: Shell Compatibility Mode311314 -Node: Job Control319354 -Node: Job Control Basics319811 -Node: Job Control Builtins324810 -Node: Job Control Variables330601 -Node: Command Line Editing331754 -Node: Introduction and Notation333422 -Node: Readline Interaction335042 -Node: Readline Bare Essentials336230 -Node: Readline Movement Commands338010 -Node: Readline Killing Commands338967 -Node: Readline Arguments340882 -Node: Searching341923 -Node: Readline Init File344106 -Node: Readline Init File Syntax345364 -Node: Conditional Init Constructs368560 -Node: Sample Init File372753 -Node: Bindable Readline Commands375874 -Node: Commands For Moving377075 -Node: Commands For History379123 -Node: Commands For Text384114 -Node: Commands For Killing387760 -Node: Numeric Arguments390790 -Node: Commands For Completion391926 -Node: Keyboard Macros396114 -Node: Miscellaneous Commands396798 -Node: Readline vi Mode402734 -Node: Programmable Completion403638 -Node: Programmable Completion Builtins411415 -Node: A Programmable Completion Example422164 -Node: Using History Interactively427408 -Node: Bash History Facilities428089 -Node: Bash History Builtins431091 -Node: History Interaction436096 -Node: Event Designators439713 -Node: Word Designators441064 -Node: Modifiers442821 -Node: Installing Bash444629 -Node: Basic Installation445763 -Node: Compilers and Options449482 -Node: Compiling For Multiple Architectures450220 -Node: Installation Names451910 -Node: Specifying the System Type454016 -Node: Sharing Defaults454729 -Node: Operation Controls455399 -Node: Optional Features456354 -Node: Reporting Bugs467569 -Node: Major Differences From The Bourne Shell468841 -Node: GNU Free Documentation License485688 -Node: Indexes510862 -Node: Builtin Index511313 -Node: Reserved Word Index518137 -Node: Variable Index520582 -Node: Function Index537353 -Node: Concept Index551134 +Node: Top886 +Node: Introduction2795 +Node: What is Bash?3008 +Node: What is a shell?4119 +Node: Definitions6654 +Node: Basic Shell Features9602 +Node: Shell Syntax10818 +Node: Shell Operation11841 +Node: Quoting13131 +Node: Escape Character14432 +Node: Single Quotes14914 +Node: Double Quotes15259 +Node: ANSI-C Quoting16534 +Node: Locale Translation17841 +Node: Creating Internationalized Scripts19149 +Node: Comments23263 +Node: Shell Commands23878 +Node: Reserved Words24813 +Node: Simple Commands25566 +Node: Pipelines26217 +Node: Lists29213 +Node: Compound Commands31005 +Node: Looping Constructs32014 +Node: Conditional Constructs34506 +Node: Command Grouping48991 +Node: Coprocesses50466 +Node: GNU Parallel53126 +Node: Shell Functions54040 +Node: Shell Parameters61922 +Node: Positional Parameters66307 +Node: Special Parameters67206 +Node: Shell Expansions70417 +Node: Brace Expansion72541 +Node: Tilde Expansion75272 +Node: Shell Parameter Expansion77890 +Node: Command Substitution96238 +Node: Arithmetic Expansion97590 +Node: Process Substitution98555 +Node: Word Splitting99672 +Node: Filename Expansion101613 +Node: Pattern Matching104359 +Node: Quote Removal109358 +Node: Redirections109650 +Node: Executing Commands119307 +Node: Simple Command Expansion119974 +Node: Command Search and Execution122081 +Node: Command Execution Environment124456 +Node: Environment127488 +Node: Exit Status129148 +Node: Signals130929 +Node: Shell Scripts134375 +Node: Shell Builtin Commands137399 +Node: Bourne Shell Builtins139434 +Node: Bash Builtins160892 +Node: Modifying Shell Behavior191745 +Node: The Set Builtin192087 +Node: The Shopt Builtin202685 +Node: Special Builtins218594 +Node: Shell Variables219570 +Node: Bourne Shell Variables220004 +Node: Bash Variables222105 +Node: Bash Features254918 +Node: Invoking Bash255928 +Node: Bash Startup Files261938 +Node: Interactive Shells267066 +Node: What is an Interactive Shell?267473 +Node: Is this Shell Interactive?268119 +Node: Interactive Shell Behavior268931 +Node: Bash Conditional Expressions272557 +Node: Shell Arithmetic277196 +Node: Aliases280137 +Node: Arrays282747 +Node: The Directory Stack289135 +Node: Directory Stack Builtins289916 +Node: Controlling the Prompt294173 +Node: The Restricted Shell297135 +Node: Bash POSIX Mode299742 +Node: Shell Compatibility Mode311662 +Node: Job Control320220 +Node: Job Control Basics320677 +Node: Job Control Builtins325676 +Node: Job Control Variables331468 +Node: Command Line Editing332621 +Node: Introduction and Notation334289 +Node: Readline Interaction335909 +Node: Readline Bare Essentials337097 +Node: Readline Movement Commands338877 +Node: Readline Killing Commands339834 +Node: Readline Arguments341749 +Node: Searching342790 +Node: Readline Init File344973 +Node: Readline Init File Syntax346231 +Node: Conditional Init Constructs369802 +Node: Sample Init File373995 +Node: Bindable Readline Commands377116 +Node: Commands For Moving378317 +Node: Commands For History380365 +Node: Commands For Text385356 +Node: Commands For Killing389002 +Node: Numeric Arguments392032 +Node: Commands For Completion393168 +Node: Keyboard Macros397356 +Node: Miscellaneous Commands398040 +Node: Readline vi Mode403976 +Node: Programmable Completion404880 +Node: Programmable Completion Builtins412657 +Node: A Programmable Completion Example423406 +Node: Using History Interactively428650 +Node: Bash History Facilities429331 +Node: Bash History Builtins432333 +Node: History Interaction437338 +Node: Event Designators440955 +Node: Word Designators442306 +Node: Modifiers444063 +Node: Installing Bash445871 +Node: Basic Installation447005 +Node: Compilers and Options450724 +Node: Compiling For Multiple Architectures451462 +Node: Installation Names453152 +Node: Specifying the System Type455258 +Node: Sharing Defaults455971 +Node: Operation Controls456641 +Node: Optional Features457596 +Node: Reporting Bugs468812 +Node: Major Differences From The Bourne Shell470084 +Node: GNU Free Documentation License486931 +Node: Indexes512105 +Node: Builtin Index512556 +Node: Reserved Word Index519380 +Node: Variable Index521825 +Node: Function Index538596 +Node: Concept Index552377 End Tag Table |