Bash-5.2-rc1 release

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, 24 February 2022).
+Bash shell (version 5.2, 3 June 2022).
 
-   This is Edition 5.2, last updated 24 February 2022, of 'The GNU Bash
+   This is Edition 5.2, last updated 3 June 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, 24 February 2022).  The Bash home page is
+Bash shell (version 5.2, 3 June 2022).  The Bash home page is
 <http://www.gnu.org/software/bash/>.
 
-   This is Edition 5.2, last updated 24 February 2022, of 'The GNU Bash
+   This is Edition 5.2, last updated 3 June 2022, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 5.2.
 
    Bash contains features that appear in other popular shells, and some
@@ -705,11 +705,12 @@ information.
    If the pipeline is not executed asynchronously (*note Lists::), the
 shell waits for all commands in the pipeline to complete.
 
-   Each command in a pipeline is executed in its own "subshell", which
-is a separate process (*note Command Execution Environment::).  If the
-'lastpipe' option is enabled using the 'shopt' builtin (*note The Shopt
-Builtin::), the last element of a pipeline may be run by the shell
-process when job control is not active.
+   Each command in a multi-command pipeline, where pipes are created, is
+executed in its own "subshell", which is a separate process (*note
+Command Execution Environment::).  If the 'lastpipe' option is enabled
+using the 'shopt' builtin (*note The Shopt Builtin::), the last element
+of a pipeline may be run by the shell process when job control is not
+active.
 
    The exit status of a pipeline is the exit status of the last command
 in the pipeline, unless the 'pipefail' option is enabled (*note The Set
@@ -1144,6 +1145,9 @@ File: bashref.info,  Node: Conditional Constructs,  Next: Command Grouping,  Pre
      is the portion of the string matching the Nth parenthesized
      subexpression.
 
+     Bash sets 'BASH_REMATCH' in the global scope; declaring it as a
+     local variable will lead to unexpected results.
+
      Expressions may be combined using the following operators, listed
      in decreasing order of precedence:
 
@@ -2432,9 +2436,10 @@ characters must be quoted if they are to be matched literally.
      character not enclosed is matched.  A '-' may be matched by
      including it as the first or last character in the set.  A ']' may
      be matched by including it as the first character in the set.  The
-     sorting order of characters in range expressions is determined by
-     the current locale and the values of the 'LC_COLLATE' and 'LC_ALL'
-     shell variables, if set.
+     sorting order of characters in range expressions, and the
+     characters included in the range, are determined by the current
+     locale and the values of the 'LC_COLLATE' and 'LC_ALL' shell
+     variables, if set.
 
      For example, in the default C locale, '[a-dx-z]' is equivalent to
      '[abcdxyz]'.  Many locales sort characters in dictionary order, and
@@ -6147,14 +6152,15 @@ Invoked by remote shell daemon
 ..............................
 
 Bash attempts to determine when it is being run with its standard input
-connected to a network connection, as when executed by the remote shell
-daemon, usually 'rshd', or the secure shell daemon 'sshd'.  If Bash
-determines it is being run in this fashion, it reads and executes
-commands from '~/.bashrc', if that file exists and is readable.  It will
-not do this if invoked as 'sh'.  The '--norc' option may be used to
-inhibit this behavior, and the '--rcfile' option may be used to force
-another file to be read, but neither 'rshd' nor 'sshd' generally invoke
-the shell with those options or allow them to be specified.
+connected to a network connection, as when executed by the historical
+remote shell daemon, usually 'rshd', or the secure shell daemon 'sshd'.
+If Bash determines it is being run non-interactively in this fashion, it
+reads and executes commands from '~/.bashrc', if that file exists and is
+readable.  It will not do this if invoked as 'sh'.  The '--norc' option
+may be used to inhibit this behavior, and the '--rcfile' option may be
+used to force another file to be read, but neither 'rshd' nor 'sshd'
+generally invoke the shell with those options or allow them to be
+specified.
 
 Invoked with unequal effective and real UID/GIDs
 ................................................
@@ -7249,7 +7255,12 @@ startup files.
      'read', the trap handler executes and 'read' returns an exit status
      greater than 128.
 
-  60. Bash removes an exited background process's status from the list
+  60. The 'printf' builting 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.
+
+  61. Bash removes an exited background process's status from the list
      of such statuses after the 'wait' builtin is used to obtain it.
 
    There is other POSIX behavior that Bash does not implement by default
@@ -7646,8 +7657,11 @@ File: bashref.info,  Node: Job Control Builtins,  Next: Job Control Variables,
           suspend [-f]
 
      Suspend the execution of this shell until it receives a 'SIGCONT'
-     signal.  A login shell cannot be suspended; the '-f' option can be
-     used to override this and force the suspension.
+     signal.  A login shell, or a shell without job control enabled,
+     cannot be suspended; the '-f' option can be used to override this
+     and force the suspension.  The return status is 0 unless the shell
+     is a login shell or job control is not enabled and '-f' is not
+     supplied.
 
    When job control is not active, the 'kill' and 'wait' builtins do not
 accept JOBSPEC arguments.  They must be supplied process IDs.
@@ -12495,138 +12509,138 @@ D.5 Concept Index
 
 
 Tag Table:
-Node: Top897
-Node: Introduction2817
-Node: What is Bash?3033
-Node: What is a shell?4147
-Node: Definitions6685
-Node: Basic Shell Features9636
-Node: Shell Syntax10855
-Node: Shell Operation11881
-Node: Quoting13174
-Node: Escape Character14478
-Node: Single Quotes14963
-Node: Double Quotes15311
-Node: ANSI-C Quoting16589
-Node: Locale Translation17899
-Node: Creating Internationalized Scripts19210
-Node: Comments23327
-Node: Shell Commands23945
-Node: Reserved Words24883
-Node: Simple Commands25639
-Node: Pipelines26293
-Node: Lists29252
-Node: Compound Commands31047
-Node: Looping Constructs32059
-Node: Conditional Constructs34554
-Node: Command Grouping48898
-Node: Coprocesses50376
-Node: GNU Parallel53039
-Node: Shell Functions53956
-Node: Shell Parameters61841
-Node: Positional Parameters66229
-Node: Special Parameters67131
-Node: Shell Expansions70345
-Node: Brace Expansion72472
-Node: Tilde Expansion75206
-Node: Shell Parameter Expansion77827
-Node: Command Substitution96178
-Node: Arithmetic Expansion97533
-Node: Process Substitution98501
-Node: Word Splitting99621
-Node: Filename Expansion101565
-Node: Pattern Matching104314
-Node: Quote Removal108922
-Node: Redirections109217
-Node: Executing Commands118877
-Node: Simple Command Expansion119547
-Node: Command Search and Execution121657
-Node: Command Execution Environment124035
-Node: Environment127070
-Node: Exit Status128733
-Node: Signals130517
-Node: Shell Scripts133966
-Node: Shell Builtin Commands136993
-Node: Bourne Shell Builtins139031
-Node: Bash Builtins160492
-Node: Modifying Shell Behavior191348
-Node: The Set Builtin191693
-Node: The Shopt Builtin202294
-Node: Special Builtins218206
-Node: Shell Variables219185
-Node: Bourne Shell Variables219622
-Node: Bash Variables221726
-Node: Bash Features254542
-Node: Invoking Bash255555
-Node: Bash Startup Files261568
-Node: Interactive Shells266671
-Node: What is an Interactive Shell?267081
-Node: Is this Shell Interactive?267730
-Node: Interactive Shell Behavior268545
-Node: Bash Conditional Expressions272174
-Node: Shell Arithmetic276816
-Node: Aliases279760
-Node: Arrays282373
-Node: The Directory Stack288764
-Node: Directory Stack Builtins289548
-Node: Controlling the Prompt293808
-Node: The Restricted Shell296773
-Node: Bash POSIX Mode299383
-Node: Shell Compatibility Mode311033
-Node: Job Control319062
-Node: Job Control Basics319522
-Node: Job Control Builtins324524
-Node: Job Control Variables329924
-Node: Command Line Editing331080
-Node: Introduction and Notation332751
-Node: Readline Interaction334374
-Node: Readline Bare Essentials335565
-Node: Readline Movement Commands337348
-Node: Readline Killing Commands338308
-Node: Readline Arguments340226
-Node: Searching341270
-Node: Readline Init File343456
-Node: Readline Init File Syntax344717
-Node: Conditional Init Constructs367916
-Node: Sample Init File372112
-Node: Bindable Readline Commands375236
-Node: Commands For Moving376440
-Node: Commands For History378491
-Node: Commands For Text383485
-Node: Commands For Killing387134
-Node: Numeric Arguments390167
-Node: Commands For Completion391306
-Node: Keyboard Macros395497
-Node: Miscellaneous Commands396184
-Node: Readline vi Mode402123
-Node: Programmable Completion403030
-Node: Programmable Completion Builtins410810
-Node: A Programmable Completion Example421505
-Node: Using History Interactively426752
-Node: Bash History Facilities427436
-Node: Bash History Builtins430441
-Node: History Interaction435449
-Node: Event Designators439069
-Node: Word Designators440423
-Node: Modifiers442183
-Node: Installing Bash443994
-Node: Basic Installation445131
-Node: Compilers and Options448853
-Node: Compiling For Multiple Architectures449594
-Node: Installation Names451287
-Node: Specifying the System Type453396
-Node: Sharing Defaults454112
-Node: Operation Controls454785
-Node: Optional Features455743
-Node: Reporting Bugs466961
-Node: Major Differences From The Bourne Shell468236
-Node: GNU Free Documentation License485086
-Node: Indexes510263
-Node: Builtin Index510717
-Node: Reserved Word Index517544
-Node: Variable Index519992
-Node: Function Index536766
-Node: Concept Index550550
+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 Grouping49041
+Node: Coprocesses50519
+Node: GNU Parallel53182
+Node: Shell Functions54099
+Node: Shell Parameters61984
+Node: Positional Parameters66372
+Node: Special Parameters67274
+Node: Shell Expansions70488
+Node: Brace Expansion72615
+Node: Tilde Expansion75349
+Node: Shell Parameter Expansion77970
+Node: Command Substitution96321
+Node: Arithmetic Expansion97676
+Node: Process Substitution98644
+Node: Word Splitting99764
+Node: Filename Expansion101708
+Node: Pattern Matching104457
+Node: Quote Removal109114
+Node: Redirections109409
+Node: Executing Commands119069
+Node: Simple Command Expansion119739
+Node: Command Search and Execution121849
+Node: Command Execution Environment124227
+Node: Environment127262
+Node: Exit Status128925
+Node: Signals130709
+Node: Shell Scripts134158
+Node: Shell Builtin Commands137185
+Node: Bourne Shell Builtins139223
+Node: Bash Builtins160684
+Node: Modifying Shell Behavior191540
+Node: The Set Builtin191885
+Node: The Shopt Builtin202486
+Node: Special Builtins218398
+Node: Shell Variables219377
+Node: Bourne Shell Variables219814
+Node: Bash Variables221918
+Node: Bash Features254734
+Node: Invoking Bash255747
+Node: Bash Startup Files261760
+Node: Interactive Shells266891
+Node: What is an Interactive Shell?267301
+Node: Is this Shell Interactive?267950
+Node: Interactive Shell Behavior268765
+Node: Bash Conditional Expressions272394
+Node: Shell Arithmetic277036
+Node: Aliases279980
+Node: Arrays282593
+Node: The Directory Stack288984
+Node: Directory Stack Builtins289768
+Node: Controlling the Prompt294028
+Node: The Restricted Shell296993
+Node: Bash POSIX Mode299603
+Node: Shell Compatibility Mode311527
+Node: Job Control319556
+Node: Job Control Basics320016
+Node: Job Control Builtins325018
+Node: Job Control Variables330588
+Node: Command Line Editing331744
+Node: Introduction and Notation333415
+Node: Readline Interaction335038
+Node: Readline Bare Essentials336229
+Node: Readline Movement Commands338012
+Node: Readline Killing Commands338972
+Node: Readline Arguments340890
+Node: Searching341934
+Node: Readline Init File344120
+Node: Readline Init File Syntax345381
+Node: Conditional Init Constructs368580
+Node: Sample Init File372776
+Node: Bindable Readline Commands375900
+Node: Commands For Moving377104
+Node: Commands For History379155
+Node: Commands For Text384149
+Node: Commands For Killing387798
+Node: Numeric Arguments390831
+Node: Commands For Completion391970
+Node: Keyboard Macros396161
+Node: Miscellaneous Commands396848
+Node: Readline vi Mode402787
+Node: Programmable Completion403694
+Node: Programmable Completion Builtins411474
+Node: A Programmable Completion Example422169
+Node: Using History Interactively427416
+Node: Bash History Facilities428100
+Node: Bash History Builtins431105
+Node: History Interaction436113
+Node: Event Designators439733
+Node: Word Designators441087
+Node: Modifiers442847
+Node: Installing Bash444658
+Node: Basic Installation445795
+Node: Compilers and Options449517
+Node: Compiling For Multiple Architectures450258
+Node: Installation Names451951
+Node: Specifying the System Type454060
+Node: Sharing Defaults454776
+Node: Operation Controls455449
+Node: Optional Features456407
+Node: Reporting Bugs467625
+Node: Major Differences From The Bourne Shell468900
+Node: GNU Free Documentation License485750
+Node: Indexes510927
+Node: Builtin Index511381
+Node: Reserved Word Index518208
+Node: Variable Index520656
+Node: Function Index537430
+Node: Concept Index551214
 
 End Tag Table