builtins now return success if supplied --help; use groff to build HTML man pages; reset mbstate if $'...' strings read an invalid multibyte sequence; read -t 0 now looks at other options (-n/-N/-d) and sets the terminal state appropriately

doc/bashref.info

@@ -2,9 +2,9 @@ This is bashref.info, produced by makeinfo version 7.2 from
 bashref.texi.
 
 This text is a brief description of the features that are present in the
-Bash shell (version 5.3, 6 September 2025).
+Bash shell (version 5.3, 19 September 2025).
 
-   This is Edition 5.3, last updated 6 September 2025, of ‘The GNU Bash
+   This is Edition 5.3, last updated 19 September 2025, of ‘The GNU Bash
 Reference Manual’, for ‘Bash’, Version 5.3.
 
    Copyright © 1988-2025 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, 6 September 2025).  The Bash home page is
+Bash shell (version 5.3, 19 September 2025).  The Bash home page is
 <http://www.gnu.org/software/bash/>.
 
-   This is Edition 5.3, last updated 6 September 2025, of ‘The GNU Bash
+   This is Edition 5.3, last updated 19 September 2025, of ‘The GNU Bash
 Reference Manual’, for ‘Bash’, Version 5.3.
 
    Bash contains features that appear in other popular shells, and some
@@ -3453,6 +3453,10 @@ that accept arguments but are not specified as accepting options
 interpret arguments beginning with ‘-’ as invalid options and require
 ‘--’ to prevent this interpretation.
 
+   All builtins except ‘:’, ‘true’, ‘false’, ‘echo’, and ‘test’/‘[’
+accept ‘--help’ as a special option.  If ‘--help’ is supplied, these
+builtins output a help message and exit with a status of 0.
+
 
 File: bashref.info,  Node: Bourne Shell Builtins,  Next: Bash Builtins,  Up: Shell Builtin Commands
 
@@ -8436,7 +8440,9 @@ File: bashref.info,  Node: Job Control Builtins,  Next: Job Control Variables,
 
      Supplying the ‘-f’ option, when job control is enabled, forces
      ‘wait’ to wait for each ID to terminate before returning its
-     status, instead of returning when it changes status.
+     status, instead of returning when it changes status.  If there are
+     no ID arguments, ‘wait’ waits until all background processes have
+     terminated.
 
      If none of the IDs specify one of the shell's an active child
      processes, the return status is 127.  If ‘wait’ is interrupted by a
@@ -12903,7 +12909,7 @@ D.1 Index of Shell Builtin Commands
 * dirs:                                  Directory Stack Builtins.
                                                               (line   7)
 * disown:                                Job Control Builtins.
-                                                              (line 120)
+                                                              (line 122)
 * echo:                                  Bash Builtins.       (line 284)
 * enable:                                Bash Builtins.       (line 337)
 * eval:                                  Bourne Shell Builtins.
@@ -12954,7 +12960,7 @@ D.1 Index of Shell Builtin Commands
 * shopt:                                 The Shopt Builtin.   (line   9)
 * source:                                Bash Builtins.       (line 678)
 * suspend:                               Job Control Builtins.
-                                                              (line 139)
+                                                              (line 141)
 * test:                                  Bourne Shell Builtins.
                                                               (line 340)
 * times:                                 Bourne Shell Builtins.
@@ -13652,138 +13658,138 @@ D.5 Concept Index
 
 
 Tag Table:
-Node: Top904
-Node: Introduction2848
-Node: What is Bash?3064
-Node: What is a shell?4200
-Node: Definitions6813
-Node: Basic Shell Features10143
-Node: Shell Syntax11370
-Node: Shell Operation12400
-Node: Quoting13694
-Node: Escape Character15035
-Node: Single Quotes15573
-Node: Double Quotes15925
-Node: ANSI-C Quoting17273
-Node: Locale Translation18670
-Node: Creating Internationalized Scripts20076
-Node: Comments24277
-Node: Shell Commands25047
-Node: Reserved Words25989
-Node: Simple Commands27135
-Node: Pipelines27800
-Node: Lists31059
-Node: Compound Commands32982
-Node: Looping Constructs33994
-Node: Conditional Constructs36546
-Node: Command Grouping51686
-Node: Coprocesses53181
-Node: GNU Parallel55870
-Node: Shell Functions56791
-Node: Shell Parameters65242
-Node: Positional Parameters70146
-Node: Special Parameters71239
-Node: Shell Expansions74703
-Node: Brace Expansion76895
-Node: Tilde Expansion80234
-Node: Shell Parameter Expansion83192
-Node: Command Substitution103838
-Node: Arithmetic Expansion107370
-Node: Process Substitution108549
-Node: Word Splitting109660
-Node: Filename Expansion112107
-Node: Pattern Matching115334
-Node: Quote Removal121060
-Node: Redirections121367
-Node: Executing Commands131626
-Node: Simple Command Expansion132296
-Node: Command Search and Execution134407
-Node: Command Execution Environment136854
-Node: Environment140305
-Node: Exit Status142211
-Node: Signals144273
-Node: Shell Scripts149206
-Node: Shell Builtin Commands152507
-Node: Bourne Shell Builtins154621
-Node: Bash Builtins181343
-Node: Modifying Shell Behavior218270
-Node: The Set Builtin218615
-Node: The Shopt Builtin230612
-Node: Special Builtins247668
-Node: Shell Variables248660
-Node: Bourne Shell Variables249097
-Node: Bash Variables251608
-Node: Bash Features290736
-Node: Invoking Bash291753
-Node: Bash Startup Files298340
-Node: Interactive Shells303585
-Node: What is an Interactive Shell?303996
-Node: Is this Shell Interactive?304661
-Node: Interactive Shell Behavior305488
-Node: Bash Conditional Expressions309252
-Node: Shell Arithmetic314672
-Node: Aliases318002
-Node: Arrays321139
-Node: The Directory Stack328730
-Node: Directory Stack Builtins329530
-Node: Controlling the Prompt333978
-Node: The Restricted Shell336866
-Node: Bash POSIX Mode339751
-Node: Shell Compatibility Mode358701
-Node: Job Control367711
-Node: Job Control Basics368171
-Node: Job Control Builtins374542
-Node: Job Control Variables381227
-Node: Command Line Editing382461
-Node: Introduction and Notation384167
-Node: Readline Interaction386522
-Node: Readline Bare Essentials387713
-Node: Readline Movement Commands389524
-Node: Readline Killing Commands390523
-Node: Readline Arguments392549
-Node: Searching393642
-Node: Readline Init File395888
-Node: Readline Init File Syntax397194
-Node: Conditional Init Constructs424148
-Node: Sample Init File428536
-Node: Bindable Readline Commands431659
-Node: Commands For Moving433200
-Node: Commands For History435667
-Node: Commands For Text441061
-Node: Commands For Killing445189
-Node: Numeric Arguments447980
-Node: Commands For Completion449135
-Node: Keyboard Macros454834
-Node: Miscellaneous Commands455538
-Node: Readline vi Mode462108
-Node: Programmable Completion463088
-Node: Programmable Completion Builtins472827
-Node: A Programmable Completion Example484567
-Node: Using History Interactively489915
-Node: Bash History Facilities490599
-Node: Bash History Builtins494337
-Node: History Interaction500811
-Node: Event Designators505764
-Node: Word Designators507345
-Node: Modifiers509740
-Node: Installing Bash511680
-Node: Basic Installation512799
-Node: Compilers and Options516678
-Node: Compiling For Multiple Architectures517431
-Node: Installation Names519187
-Node: Specifying the System Type521424
-Node: Sharing Defaults522173
-Node: Operation Controls522890
-Node: Optional Features523912
-Node: Reporting Bugs536638
-Node: Major Differences From The Bourne Shell537998
-Node: GNU Free Documentation License559428
-Node: Indexes584608
-Node: Builtin Index585062
-Node: Reserved Word Index592163
-Node: Variable Index594611
-Node: Function Index612027
-Node: Concept Index626025
+Node: Top906
+Node: Introduction2852
+Node: What is Bash?3068
+Node: What is a shell?4204
+Node: Definitions6817
+Node: Basic Shell Features10147
+Node: Shell Syntax11374
+Node: Shell Operation12404
+Node: Quoting13698
+Node: Escape Character15039
+Node: Single Quotes15577
+Node: Double Quotes15929
+Node: ANSI-C Quoting17277
+Node: Locale Translation18674
+Node: Creating Internationalized Scripts20080
+Node: Comments24281
+Node: Shell Commands25051
+Node: Reserved Words25993
+Node: Simple Commands27139
+Node: Pipelines27804
+Node: Lists31063
+Node: Compound Commands32986
+Node: Looping Constructs33998
+Node: Conditional Constructs36550
+Node: Command Grouping51690
+Node: Coprocesses53185
+Node: GNU Parallel55874
+Node: Shell Functions56795
+Node: Shell Parameters65246
+Node: Positional Parameters70150
+Node: Special Parameters71243
+Node: Shell Expansions74707
+Node: Brace Expansion76899
+Node: Tilde Expansion80238
+Node: Shell Parameter Expansion83196
+Node: Command Substitution103842
+Node: Arithmetic Expansion107374
+Node: Process Substitution108553
+Node: Word Splitting109664
+Node: Filename Expansion112111
+Node: Pattern Matching115338
+Node: Quote Removal121064
+Node: Redirections121371
+Node: Executing Commands131630
+Node: Simple Command Expansion132300
+Node: Command Search and Execution134411
+Node: Command Execution Environment136858
+Node: Environment140309
+Node: Exit Status142215
+Node: Signals144277
+Node: Shell Scripts149210
+Node: Shell Builtin Commands152511
+Node: Bourne Shell Builtins154855
+Node: Bash Builtins181577
+Node: Modifying Shell Behavior218504
+Node: The Set Builtin218849
+Node: The Shopt Builtin230846
+Node: Special Builtins247902
+Node: Shell Variables248894
+Node: Bourne Shell Variables249331
+Node: Bash Variables251842
+Node: Bash Features290970
+Node: Invoking Bash291987
+Node: Bash Startup Files298574
+Node: Interactive Shells303819
+Node: What is an Interactive Shell?304230
+Node: Is this Shell Interactive?304895
+Node: Interactive Shell Behavior305722
+Node: Bash Conditional Expressions309486
+Node: Shell Arithmetic314906
+Node: Aliases318236
+Node: Arrays321373
+Node: The Directory Stack328964
+Node: Directory Stack Builtins329764
+Node: Controlling the Prompt334212
+Node: The Restricted Shell337100
+Node: Bash POSIX Mode339985
+Node: Shell Compatibility Mode358935
+Node: Job Control367945
+Node: Job Control Basics368405
+Node: Job Control Builtins374776
+Node: Job Control Variables381567
+Node: Command Line Editing382801
+Node: Introduction and Notation384507
+Node: Readline Interaction386862
+Node: Readline Bare Essentials388053
+Node: Readline Movement Commands389864
+Node: Readline Killing Commands390863
+Node: Readline Arguments392889
+Node: Searching393982
+Node: Readline Init File396228
+Node: Readline Init File Syntax397534
+Node: Conditional Init Constructs424488
+Node: Sample Init File428876
+Node: Bindable Readline Commands431999
+Node: Commands For Moving433540
+Node: Commands For History436007
+Node: Commands For Text441401
+Node: Commands For Killing445529
+Node: Numeric Arguments448320
+Node: Commands For Completion449475
+Node: Keyboard Macros455174
+Node: Miscellaneous Commands455878
+Node: Readline vi Mode462448
+Node: Programmable Completion463428
+Node: Programmable Completion Builtins473167
+Node: A Programmable Completion Example484907
+Node: Using History Interactively490255
+Node: Bash History Facilities490939
+Node: Bash History Builtins494677
+Node: History Interaction501151
+Node: Event Designators506104
+Node: Word Designators507685
+Node: Modifiers510080
+Node: Installing Bash512020
+Node: Basic Installation513139
+Node: Compilers and Options517018
+Node: Compiling For Multiple Architectures517771
+Node: Installation Names519527
+Node: Specifying the System Type521764
+Node: Sharing Defaults522513
+Node: Operation Controls523230
+Node: Optional Features524252
+Node: Reporting Bugs536978
+Node: Major Differences From The Bourne Shell538338
+Node: GNU Free Documentation License559768
+Node: Indexes584948
+Node: Builtin Index585402
+Node: Reserved Word Index592503
+Node: Variable Index594951
+Node: Function Index612367
+Node: Concept Index626365
 
 End Tag Table