fix cd when user assigns a value to OLDPWD; fix android issue with blocked system calls; fix historical use of test -t; fix issue with foreground-TSTP async jobs

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.3, 29 June 2023).
+Bash shell (version 5.3, 7 July 2023).
 
-   This is Edition 5.3, last updated 29 June 2023, of 'The GNU Bash
+   This is Edition 5.3, last updated 7 July 2023, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 5.3.
 
    Copyright (C) 1988-2023 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.3, 29 June 2023).  The Bash home page is
+Bash shell (version 5.3, 7 July 2023).  The Bash home page is
 <http://www.gnu.org/software/bash/>.
 
-   This is Edition 5.3, last updated 29 June 2023, of 'The GNU Bash
+   This is Edition 5.3, last updated 7 July 2023, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 5.3.
 
    Bash contains features that appear in other popular shells, and some
@@ -3613,8 +3613,25 @@ standard.
           The expression is parsed and evaluated according to precedence
           using the rules listed above.
 
-     When used with 'test' or '[', the '<' and '>' operators sort
-     lexicographically using ASCII ordering.
+     If the shell is not in POSIX mode, when used with 'test' or '[',
+     the '<' and '>' operators sort lexicographically using ASCII
+     ordering.  If the shell is in POSIX mode, these operators use the
+     current locale.
+
+     The historical operator-precedence parsing with 4 or more arguments
+     can lead to ambiguities when it encounters strings that look like
+     primaries.  The POSIX standard has deprecated the '-a' and '-o'
+     primaries and enclosing expressions within parentheses.  Scripts
+     should no longer use them.  It's much more reliable to restrict
+     test invocations to a single primary, and to replace uses of '-a'
+     and '-o' with the shell's '&&' and '||' list operators.  For
+     example, use
+
+          test -n string1 && test -n string2
+
+     instead of
+
+          test -n string1 -a -n string2
 
 'times'
           times
@@ -7493,7 +7510,12 @@ startup files.
   66. The 'test' builtin compares strings using the current locale when
      processing the '<' and '>' binary operators.
 
-  67. Command substitutions don't set the '?' special parameter.  The
+  67. The 'test' builtin's '-t' unary primary requires an argument.
+     Historical versions of 'test' made the argument optional in certain
+     cases, and bash attempts to accommodate those for backwards
+     compatibility.
+
+  68. Command substitutions don't set the '?' special parameter.  The
      exit status of a simple command without a command word is still the
      exit status of the last command substitution that occurred while
      evaluating the variable assignments and redirections in that
@@ -12107,19 +12129,19 @@ D.1 Index of Shell Builtin Commands
 * test:                                  Bourne Shell Builtins.
                                                               (line 281)
 * times:                                 Bourne Shell Builtins.
-                                                              (line 366)
+                                                              (line 383)
 * trap:                                  Bourne Shell Builtins.
-                                                              (line 372)
+                                                              (line 389)
 * true:                                  Bourne Shell Builtins.
-                                                              (line 434)
+                                                              (line 451)
 * type:                                  Bash Builtins.       (line 615)
 * typeset:                               Bash Builtins.       (line 653)
 * ulimit:                                Bash Builtins.       (line 659)
 * umask:                                 Bourne Shell Builtins.
-                                                              (line 439)
+                                                              (line 456)
 * unalias:                               Bash Builtins.       (line 765)
 * unset:                                 Bourne Shell Builtins.
-                                                              (line 457)
+                                                              (line 474)
 * wait:                                  Job Control Builtins.
                                                               (line  76)
 
@@ -12794,138 +12816,138 @@ D.5 Concept Index
 
 
 Tag Table:
-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 Translation17843
-Node: Creating Internationalized Scripts19151
-Node: Comments23265
-Node: Shell Commands23880
-Node: Reserved Words24815
-Node: Simple Commands25568
-Node: Pipelines26219
-Node: Lists29202
-Node: Compound Commands30994
-Node: Looping Constructs32003
-Node: Conditional Constructs34495
-Node: Command Grouping48980
-Node: Coprocesses50455
-Node: GNU Parallel53115
-Node: Shell Functions54029
-Node: Shell Parameters61911
-Node: Positional Parameters66296
-Node: Special Parameters67195
-Node: Shell Expansions70406
-Node: Brace Expansion72491
-Node: Tilde Expansion75222
-Node: Shell Parameter Expansion77840
-Node: Command Substitution96239
-Node: Arithmetic Expansion99700
-Node: Process Substitution100665
-Node: Word Splitting101782
-Node: Filename Expansion103827
-Node: Pattern Matching106757
-Node: Quote Removal111756
-Node: Redirections112048
-Node: Executing Commands121738
-Node: Simple Command Expansion122405
-Node: Command Search and Execution124512
-Node: Command Execution Environment126896
-Node: Environment129928
-Node: Exit Status131588
-Node: Signals133369
-Node: Shell Scripts136815
-Node: Shell Builtin Commands139839
-Node: Bourne Shell Builtins141874
-Node: Bash Builtins164278
-Node: Modifying Shell Behavior196274
-Node: The Set Builtin196616
-Node: The Shopt Builtin207211
-Node: Special Builtins223215
-Node: Shell Variables224191
-Node: Bourne Shell Variables224625
-Node: Bash Variables226726
-Node: Bash Features261680
-Node: Invoking Bash262690
-Node: Bash Startup Files268700
-Node: Interactive Shells273828
-Node: What is an Interactive Shell?274236
-Node: Is this Shell Interactive?274882
-Node: Interactive Shell Behavior275694
-Node: Bash Conditional Expressions279320
-Node: Shell Arithmetic283959
-Node: Aliases286917
-Node: Arrays289808
-Node: The Directory Stack296368
-Node: Directory Stack Builtins297149
-Node: Controlling the Prompt301406
-Node: The Restricted Shell304368
-Node: Bash POSIX Mode306975
-Node: Shell Compatibility Mode322888
-Node: Job Control331129
-Node: Job Control Basics331586
-Node: Job Control Builtins336585
-Node: Job Control Variables342377
-Node: Command Line Editing343530
-Node: Introduction and Notation345198
-Node: Readline Interaction346818
-Node: Readline Bare Essentials348006
-Node: Readline Movement Commands349792
-Node: Readline Killing Commands350749
-Node: Readline Arguments352667
-Node: Searching353708
-Node: Readline Init File355891
-Node: Readline Init File Syntax357149
-Node: Conditional Init Constructs380937
-Node: Sample Init File385130
-Node: Bindable Readline Commands388251
-Node: Commands For Moving389452
-Node: Commands For History391500
-Node: Commands For Text396491
-Node: Commands For Killing400137
-Node: Numeric Arguments403167
-Node: Commands For Completion404303
-Node: Keyboard Macros408491
-Node: Miscellaneous Commands409176
-Node: Readline vi Mode415211
-Node: Programmable Completion416115
-Node: Programmable Completion Builtins423892
-Node: A Programmable Completion Example435009
-Node: Using History Interactively440254
-Node: Bash History Facilities440935
-Node: Bash History Builtins443937
-Node: History Interaction448958
-Node: Event Designators452575
-Node: Word Designators453926
-Node: Modifiers455683
-Node: Installing Bash457488
-Node: Basic Installation458622
-Node: Compilers and Options462341
-Node: Compiling For Multiple Architectures463079
-Node: Installation Names464768
-Node: Specifying the System Type466874
-Node: Sharing Defaults467588
-Node: Operation Controls468258
-Node: Optional Features469213
-Node: Reporting Bugs480429
-Node: Major Differences From The Bourne Shell481760
-Node: GNU Free Documentation License498606
-Node: Indexes523780
-Node: Builtin Index524231
-Node: Reserved Word Index531329
-Node: Variable Index533774
-Node: Function Index550905
-Node: Concept Index564686
+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 Translation17839
+Node: Creating Internationalized Scripts19147
+Node: Comments23261
+Node: Shell Commands23876
+Node: Reserved Words24811
+Node: Simple Commands25564
+Node: Pipelines26215
+Node: Lists29198
+Node: Compound Commands30990
+Node: Looping Constructs31999
+Node: Conditional Constructs34491
+Node: Command Grouping48976
+Node: Coprocesses50451
+Node: GNU Parallel53111
+Node: Shell Functions54025
+Node: Shell Parameters61907
+Node: Positional Parameters66292
+Node: Special Parameters67191
+Node: Shell Expansions70402
+Node: Brace Expansion72487
+Node: Tilde Expansion75218
+Node: Shell Parameter Expansion77836
+Node: Command Substitution96235
+Node: Arithmetic Expansion99696
+Node: Process Substitution100661
+Node: Word Splitting101778
+Node: Filename Expansion103823
+Node: Pattern Matching106753
+Node: Quote Removal111752
+Node: Redirections112044
+Node: Executing Commands121734
+Node: Simple Command Expansion122401
+Node: Command Search and Execution124508
+Node: Command Execution Environment126892
+Node: Environment129924
+Node: Exit Status131584
+Node: Signals133365
+Node: Shell Scripts136811
+Node: Shell Builtin Commands139835
+Node: Bourne Shell Builtins141870
+Node: Bash Builtins165003
+Node: Modifying Shell Behavior196999
+Node: The Set Builtin197341
+Node: The Shopt Builtin207936
+Node: Special Builtins223940
+Node: Shell Variables224916
+Node: Bourne Shell Variables225350
+Node: Bash Variables227451
+Node: Bash Features262405
+Node: Invoking Bash263415
+Node: Bash Startup Files269425
+Node: Interactive Shells274553
+Node: What is an Interactive Shell?274961
+Node: Is this Shell Interactive?275607
+Node: Interactive Shell Behavior276419
+Node: Bash Conditional Expressions280045
+Node: Shell Arithmetic284684
+Node: Aliases287642
+Node: Arrays290533
+Node: The Directory Stack297093
+Node: Directory Stack Builtins297874
+Node: Controlling the Prompt302131
+Node: The Restricted Shell305093
+Node: Bash POSIX Mode307700
+Node: Shell Compatibility Mode323840
+Node: Job Control332081
+Node: Job Control Basics332538
+Node: Job Control Builtins337537
+Node: Job Control Variables343329
+Node: Command Line Editing344482
+Node: Introduction and Notation346150
+Node: Readline Interaction347770
+Node: Readline Bare Essentials348958
+Node: Readline Movement Commands350744
+Node: Readline Killing Commands351701
+Node: Readline Arguments353619
+Node: Searching354660
+Node: Readline Init File356843
+Node: Readline Init File Syntax358101
+Node: Conditional Init Constructs381889
+Node: Sample Init File386082
+Node: Bindable Readline Commands389203
+Node: Commands For Moving390404
+Node: Commands For History392452
+Node: Commands For Text397443
+Node: Commands For Killing401089
+Node: Numeric Arguments404119
+Node: Commands For Completion405255
+Node: Keyboard Macros409443
+Node: Miscellaneous Commands410128
+Node: Readline vi Mode416163
+Node: Programmable Completion417067
+Node: Programmable Completion Builtins424844
+Node: A Programmable Completion Example435961
+Node: Using History Interactively441206
+Node: Bash History Facilities441887
+Node: Bash History Builtins444889
+Node: History Interaction449910
+Node: Event Designators453527
+Node: Word Designators454878
+Node: Modifiers456635
+Node: Installing Bash458440
+Node: Basic Installation459574
+Node: Compilers and Options463293
+Node: Compiling For Multiple Architectures464031
+Node: Installation Names465720
+Node: Specifying the System Type467826
+Node: Sharing Defaults468540
+Node: Operation Controls469210
+Node: Optional Features470165
+Node: Reporting Bugs481381
+Node: Major Differences From The Bourne Shell482712
+Node: GNU Free Documentation License499558
+Node: Indexes524732
+Node: Builtin Index525183
+Node: Reserved Word Index532281
+Node: Variable Index534726
+Node: Function Index551857
+Node: Concept Index565638
 
 End Tag Table