Bash-5.2-rc3 releasebash-5.2-rc3

1 files changed, 192 insertions, 172 deletions

diff --git a/doc/bashref.info b/doc/bashref.info
index cb1cf57b..9cd508b1 100644
--- a/doc/bashref.info
+++ b/doc/bashref.info
@@ -2,9 +2,9 @@ This is bashref.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.
@@ -27,10 +27,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
@@ -2490,6 +2490,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 '.'
@@ -7255,7 +7261,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.
@@ -7431,6 +7437,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: bashref.info,  Node: Job Control,  Next: Command Line Editing,  Prev: Bash Features,  Up: Top
@@ -7637,7 +7651,7 @@ File: bashref.info,  Node: Job Control Builtins,  Next: Job Control Variables,
      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
@@ -8145,7 +8159,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.
@@ -8240,7 +8256,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
@@ -8305,7 +8323,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
@@ -8402,7 +8422,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
@@ -10631,7 +10651,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
@@ -11987,27 +12007,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)
@@ -12021,15 +12041,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)
@@ -12037,13 +12057,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)
@@ -12065,15 +12085,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)
@@ -12082,9 +12102,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)
@@ -12107,19 +12127,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)
@@ -12130,11 +12150,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: bashref.info,  Node: Function Index,  Next: Concept Index,  Prev: Variable Index,  Up: Indexes
@@ -12513,138 +12533,138 @@ D.5 Concept Index
 
 
 Tag Table:
-Node: Top887
-Node: Introduction2797
-Node: What is Bash?3013
-Node: What is a shell?4127
-Node: Definitions6665
-Node: Basic Shell Features9616
-Node: Shell Syntax10835
-Node: Shell Operation11861
-Node: Quoting13154
-Node: Escape Character14458
-Node: Single Quotes14943
-Node: Double Quotes15291
-Node: ANSI-C Quoting16569
-Node: Locale Translation17879
-Node: Creating Internationalized Scripts19190
-Node: Comments23307
-Node: Shell Commands23925
-Node: Reserved Words24863
-Node: Simple Commands25619
-Node: Pipelines26273
-Node: Lists29272
-Node: Compound Commands31067
-Node: Looping Constructs32079
-Node: Conditional Constructs34574
-Node: Command Grouping49062
-Node: Coprocesses50540
-Node: GNU Parallel53203
-Node: Shell Functions54120
-Node: Shell Parameters62005
-Node: Positional Parameters66393
-Node: Special Parameters67295
-Node: Shell Expansions70509
-Node: Brace Expansion72636
-Node: Tilde Expansion75370
-Node: Shell Parameter Expansion77991
-Node: Command Substitution96342
-Node: Arithmetic Expansion97697
-Node: Process Substitution98665
-Node: Word Splitting99785
-Node: Filename Expansion101729
-Node: Pattern Matching104478
-Node: Quote Removal109135
-Node: Redirections109430
-Node: Executing Commands119090
-Node: Simple Command Expansion119760
-Node: Command Search and Execution121870
-Node: Command Execution Environment124248
-Node: Environment127283
-Node: Exit Status128946
-Node: Signals130730
-Node: Shell Scripts134179
-Node: Shell Builtin Commands137206
-Node: Bourne Shell Builtins139244
-Node: Bash Builtins160705
-Node: Modifying Shell Behavior191561
-Node: The Set Builtin191906
-Node: The Shopt Builtin202507
-Node: Special Builtins218419
-Node: Shell Variables219398
-Node: Bourne Shell Variables219835
-Node: Bash Variables221939
-Node: Bash Features254755
-Node: Invoking Bash255768
-Node: Bash Startup Files261781
-Node: Interactive Shells266912
-Node: What is an Interactive Shell?267322
-Node: Is this Shell Interactive?267971
-Node: Interactive Shell Behavior268786
-Node: Bash Conditional Expressions272415
-Node: Shell Arithmetic277057
-Node: Aliases280001
-Node: Arrays282614
-Node: The Directory Stack289005
-Node: Directory Stack Builtins289789
-Node: Controlling the Prompt294049
-Node: The Restricted Shell297014
-Node: Bash POSIX Mode299624
-Node: Shell Compatibility Mode311548
-Node: Job Control319591
-Node: Job Control Basics320051
-Node: Job Control Builtins325053
-Node: Job Control Variables330847
-Node: Command Line Editing332003
-Node: Introduction and Notation333674
-Node: Readline Interaction335297
-Node: Readline Bare Essentials336488
-Node: Readline Movement Commands338271
-Node: Readline Killing Commands339231
-Node: Readline Arguments341149
-Node: Searching342193
-Node: Readline Init File344379
-Node: Readline Init File Syntax345640
-Node: Conditional Init Constructs368839
-Node: Sample Init File373035
-Node: Bindable Readline Commands376159
-Node: Commands For Moving377363
-Node: Commands For History379414
-Node: Commands For Text384408
-Node: Commands For Killing388057
-Node: Numeric Arguments391090
-Node: Commands For Completion392229
-Node: Keyboard Macros396420
-Node: Miscellaneous Commands397107
-Node: Readline vi Mode403046
-Node: Programmable Completion403953
-Node: Programmable Completion Builtins411733
-Node: A Programmable Completion Example422485
-Node: Using History Interactively427732
-Node: Bash History Facilities428416
-Node: Bash History Builtins431421
-Node: History Interaction436429
-Node: Event Designators440049
-Node: Word Designators441403
-Node: Modifiers443163
-Node: Installing Bash444974
-Node: Basic Installation446111
-Node: Compilers and Options449833
-Node: Compiling For Multiple Architectures450574
-Node: Installation Names452267
-Node: Specifying the System Type454376
-Node: Sharing Defaults455092
-Node: Operation Controls455765
-Node: Optional Features456723
-Node: Reporting Bugs467941
-Node: Major Differences From The Bourne Shell469216
-Node: GNU Free Documentation License486066
-Node: Indexes511243
-Node: Builtin Index511697
-Node: Reserved Word Index518524
-Node: Variable Index520972
-Node: Function Index537746
-Node: Concept Index551530
+Node: Top889
+Node: Introduction2801
+Node: What is Bash?3017
+Node: What is a shell?4131
+Node: Definitions6669
+Node: Basic Shell Features9620
+Node: Shell Syntax10839
+Node: Shell Operation11865
+Node: Quoting13158
+Node: Escape Character14462
+Node: Single Quotes14947
+Node: Double Quotes15295
+Node: ANSI-C Quoting16573
+Node: Locale Translation17883
+Node: Creating Internationalized Scripts19194
+Node: Comments23311
+Node: Shell Commands23929
+Node: Reserved Words24867
+Node: Simple Commands25623
+Node: Pipelines26277
+Node: Lists29276
+Node: Compound Commands31071
+Node: Looping Constructs32083
+Node: Conditional Constructs34578
+Node: Command Grouping49066
+Node: Coprocesses50544
+Node: GNU Parallel53207
+Node: Shell Functions54124
+Node: Shell Parameters62009
+Node: Positional Parameters66397
+Node: Special Parameters67299
+Node: Shell Expansions70513
+Node: Brace Expansion72640
+Node: Tilde Expansion75374
+Node: Shell Parameter Expansion77995
+Node: Command Substitution96346
+Node: Arithmetic Expansion97701
+Node: Process Substitution98669
+Node: Word Splitting99789
+Node: Filename Expansion101733
+Node: Pattern Matching104482
+Node: Quote Removal109484
+Node: Redirections109779
+Node: Executing Commands119439
+Node: Simple Command Expansion120109
+Node: Command Search and Execution122219
+Node: Command Execution Environment124597
+Node: Environment127632
+Node: Exit Status129295
+Node: Signals131079
+Node: Shell Scripts134528
+Node: Shell Builtin Commands137555
+Node: Bourne Shell Builtins139593
+Node: Bash Builtins161054
+Node: Modifying Shell Behavior191910
+Node: The Set Builtin192255
+Node: The Shopt Builtin202856
+Node: Special Builtins218768
+Node: Shell Variables219747
+Node: Bourne Shell Variables220184
+Node: Bash Variables222288
+Node: Bash Features255104
+Node: Invoking Bash256117
+Node: Bash Startup Files262130
+Node: Interactive Shells267261
+Node: What is an Interactive Shell?267671
+Node: Is this Shell Interactive?268320
+Node: Interactive Shell Behavior269135
+Node: Bash Conditional Expressions272764
+Node: Shell Arithmetic277406
+Node: Aliases280350
+Node: Arrays282963
+Node: The Directory Stack289354
+Node: Directory Stack Builtins290138
+Node: Controlling the Prompt294398
+Node: The Restricted Shell297363
+Node: Bash POSIX Mode299973
+Node: Shell Compatibility Mode311896
+Node: Job Control320457
+Node: Job Control Basics320917
+Node: Job Control Builtins325919
+Node: Job Control Variables331714
+Node: Command Line Editing332870
+Node: Introduction and Notation334541
+Node: Readline Interaction336164
+Node: Readline Bare Essentials337355
+Node: Readline Movement Commands339138
+Node: Readline Killing Commands340098
+Node: Readline Arguments342016
+Node: Searching343060
+Node: Readline Init File345246
+Node: Readline Init File Syntax346507
+Node: Conditional Init Constructs370081
+Node: Sample Init File374277
+Node: Bindable Readline Commands377401
+Node: Commands For Moving378605
+Node: Commands For History380656
+Node: Commands For Text385650
+Node: Commands For Killing389299
+Node: Numeric Arguments392332
+Node: Commands For Completion393471
+Node: Keyboard Macros397662
+Node: Miscellaneous Commands398349
+Node: Readline vi Mode404288
+Node: Programmable Completion405195
+Node: Programmable Completion Builtins412975
+Node: A Programmable Completion Example423727
+Node: Using History Interactively428974
+Node: Bash History Facilities429658
+Node: Bash History Builtins432663
+Node: History Interaction437671
+Node: Event Designators441291
+Node: Word Designators442645
+Node: Modifiers444405
+Node: Installing Bash446216
+Node: Basic Installation447353
+Node: Compilers and Options451075
+Node: Compiling For Multiple Architectures451816
+Node: Installation Names453509
+Node: Specifying the System Type455618
+Node: Sharing Defaults456334
+Node: Operation Controls457007
+Node: Optional Features457965
+Node: Reporting Bugs469184
+Node: Major Differences From The Bourne Shell470459
+Node: GNU Free Documentation License487309
+Node: Indexes512486
+Node: Builtin Index512940
+Node: Reserved Word Index519767
+Node: Variable Index522215
+Node: Function Index538989
+Node: Concept Index552773
 
 End Tag Table