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/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.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.
@@ -27,10 +27,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
@@ -3614,8 +3614,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
@@ -7494,7 +7511,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
@@ -12108,19 +12130,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)
 
@@ -12795,138 +12817,138 @@ D.5 Concept Index
 
 
 Tag Table:
-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 Translation17885
-Node: Creating Internationalized Scripts19196
-Node: Comments23313
-Node: Shell Commands23931
-Node: Reserved Words24869
-Node: Simple Commands25625
-Node: Pipelines26279
-Node: Lists29265
-Node: Compound Commands31060
-Node: Looping Constructs32072
-Node: Conditional Constructs34567
-Node: Command Grouping49055
-Node: Coprocesses50533
-Node: GNU Parallel53196
-Node: Shell Functions54113
-Node: Shell Parameters61998
-Node: Positional Parameters66386
-Node: Special Parameters67288
-Node: Shell Expansions70502
-Node: Brace Expansion72590
-Node: Tilde Expansion75324
-Node: Shell Parameter Expansion77945
-Node: Command Substitution96347
-Node: Arithmetic Expansion99811
-Node: Process Substitution100779
-Node: Word Splitting101899
-Node: Filename Expansion103947
-Node: Pattern Matching106880
-Node: Quote Removal111882
-Node: Redirections112177
-Node: Executing Commands121870
-Node: Simple Command Expansion122540
-Node: Command Search and Execution124650
-Node: Command Execution Environment127037
-Node: Environment130072
-Node: Exit Status131735
-Node: Signals133519
-Node: Shell Scripts136968
-Node: Shell Builtin Commands139995
-Node: Bourne Shell Builtins142033
-Node: Bash Builtins164440
-Node: Modifying Shell Behavior196439
-Node: The Set Builtin196784
-Node: The Shopt Builtin207382
-Node: Special Builtins223389
-Node: Shell Variables224368
-Node: Bourne Shell Variables224805
-Node: Bash Variables226909
-Node: Bash Features261866
-Node: Invoking Bash262879
-Node: Bash Startup Files268892
-Node: Interactive Shells274023
-Node: What is an Interactive Shell?274434
-Node: Is this Shell Interactive?275083
-Node: Interactive Shell Behavior275898
-Node: Bash Conditional Expressions279527
-Node: Shell Arithmetic284169
-Node: Aliases287130
-Node: Arrays290024
-Node: The Directory Stack296587
-Node: Directory Stack Builtins297371
-Node: Controlling the Prompt301631
-Node: The Restricted Shell304596
-Node: Bash POSIX Mode307206
-Node: Shell Compatibility Mode323122
-Node: Job Control331366
-Node: Job Control Basics331826
-Node: Job Control Builtins336828
-Node: Job Control Variables342623
-Node: Command Line Editing343779
-Node: Introduction and Notation345450
-Node: Readline Interaction347073
-Node: Readline Bare Essentials348264
-Node: Readline Movement Commands350053
-Node: Readline Killing Commands351013
-Node: Readline Arguments352934
-Node: Searching353978
-Node: Readline Init File356164
-Node: Readline Init File Syntax357425
-Node: Conditional Init Constructs381216
-Node: Sample Init File385412
-Node: Bindable Readline Commands388536
-Node: Commands For Moving389740
-Node: Commands For History391791
-Node: Commands For Text396785
-Node: Commands For Killing400434
-Node: Numeric Arguments403467
-Node: Commands For Completion404606
-Node: Keyboard Macros408797
-Node: Miscellaneous Commands409485
-Node: Readline vi Mode415523
-Node: Programmable Completion416430
-Node: Programmable Completion Builtins424210
-Node: A Programmable Completion Example435330
-Node: Using History Interactively440578
-Node: Bash History Facilities441262
-Node: Bash History Builtins444267
-Node: History Interaction449291
-Node: Event Designators452911
-Node: Word Designators454265
-Node: Modifiers456025
-Node: Installing Bash457833
-Node: Basic Installation458970
-Node: Compilers and Options462692
-Node: Compiling For Multiple Architectures463433
-Node: Installation Names465125
-Node: Specifying the System Type467234
-Node: Sharing Defaults467951
-Node: Operation Controls468624
-Node: Optional Features469582
-Node: Reporting Bugs480801
-Node: Major Differences From The Bourne Shell482135
-Node: GNU Free Documentation License498984
-Node: Indexes524161
-Node: Builtin Index524615
-Node: Reserved Word Index531716
-Node: Variable Index534164
-Node: Function Index551298
-Node: Concept Index565082
+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 Translation17881
+Node: Creating Internationalized Scripts19192
+Node: Comments23309
+Node: Shell Commands23927
+Node: Reserved Words24865
+Node: Simple Commands25621
+Node: Pipelines26275
+Node: Lists29261
+Node: Compound Commands31056
+Node: Looping Constructs32068
+Node: Conditional Constructs34563
+Node: Command Grouping49051
+Node: Coprocesses50529
+Node: GNU Parallel53192
+Node: Shell Functions54109
+Node: Shell Parameters61994
+Node: Positional Parameters66382
+Node: Special Parameters67284
+Node: Shell Expansions70498
+Node: Brace Expansion72586
+Node: Tilde Expansion75320
+Node: Shell Parameter Expansion77941
+Node: Command Substitution96343
+Node: Arithmetic Expansion99807
+Node: Process Substitution100775
+Node: Word Splitting101895
+Node: Filename Expansion103943
+Node: Pattern Matching106876
+Node: Quote Removal111878
+Node: Redirections112173
+Node: Executing Commands121866
+Node: Simple Command Expansion122536
+Node: Command Search and Execution124646
+Node: Command Execution Environment127033
+Node: Environment130068
+Node: Exit Status131731
+Node: Signals133515
+Node: Shell Scripts136964
+Node: Shell Builtin Commands139991
+Node: Bourne Shell Builtins142029
+Node: Bash Builtins165165
+Node: Modifying Shell Behavior197164
+Node: The Set Builtin197509
+Node: The Shopt Builtin208107
+Node: Special Builtins224114
+Node: Shell Variables225093
+Node: Bourne Shell Variables225530
+Node: Bash Variables227634
+Node: Bash Features262591
+Node: Invoking Bash263604
+Node: Bash Startup Files269617
+Node: Interactive Shells274748
+Node: What is an Interactive Shell?275159
+Node: Is this Shell Interactive?275808
+Node: Interactive Shell Behavior276623
+Node: Bash Conditional Expressions280252
+Node: Shell Arithmetic284894
+Node: Aliases287855
+Node: Arrays290749
+Node: The Directory Stack297312
+Node: Directory Stack Builtins298096
+Node: Controlling the Prompt302356
+Node: The Restricted Shell305321
+Node: Bash POSIX Mode307931
+Node: Shell Compatibility Mode324074
+Node: Job Control332318
+Node: Job Control Basics332778
+Node: Job Control Builtins337780
+Node: Job Control Variables343575
+Node: Command Line Editing344731
+Node: Introduction and Notation346402
+Node: Readline Interaction348025
+Node: Readline Bare Essentials349216
+Node: Readline Movement Commands351005
+Node: Readline Killing Commands351965
+Node: Readline Arguments353886
+Node: Searching354930
+Node: Readline Init File357116
+Node: Readline Init File Syntax358377
+Node: Conditional Init Constructs382168
+Node: Sample Init File386364
+Node: Bindable Readline Commands389488
+Node: Commands For Moving390692
+Node: Commands For History392743
+Node: Commands For Text397737
+Node: Commands For Killing401386
+Node: Numeric Arguments404419
+Node: Commands For Completion405558
+Node: Keyboard Macros409749
+Node: Miscellaneous Commands410437
+Node: Readline vi Mode416475
+Node: Programmable Completion417382
+Node: Programmable Completion Builtins425162
+Node: A Programmable Completion Example436282
+Node: Using History Interactively441530
+Node: Bash History Facilities442214
+Node: Bash History Builtins445219
+Node: History Interaction450243
+Node: Event Designators453863
+Node: Word Designators455217
+Node: Modifiers456977
+Node: Installing Bash458785
+Node: Basic Installation459922
+Node: Compilers and Options463644
+Node: Compiling For Multiple Architectures464385
+Node: Installation Names466077
+Node: Specifying the System Type468186
+Node: Sharing Defaults468903
+Node: Operation Controls469576
+Node: Optional Features470534
+Node: Reporting Bugs481753
+Node: Major Differences From The Bourne Shell483087
+Node: GNU Free Documentation License499936
+Node: Indexes525113
+Node: Builtin Index525567
+Node: Reserved Word Index532668
+Node: Variable Index535116
+Node: Function Index552250
+Node: Concept Index566034
 
 End Tag Table