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/bash.info

@@ -1,9 +1,9 @@
 This is bash.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.
@@ -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, 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
@@ -3452,6 +3452,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: bash.info,  Node: Bourne Shell Builtins,  Next: Bash Builtins,  Up: Shell Builtin Commands
 
@@ -8435,7 +8439,9 @@ File: bash.info,  Node: Job Control Builtins,  Next: Job Control Variables,  Pre
 
      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
@@ -12902,7 +12908,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.
@@ -12953,7 +12959,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.
@@ -13651,138 +13657,138 @@ D.5 Concept Index
 
 
 Tag Table:
-Node: Top901
-Node: Introduction2842
-Node: What is Bash?3055
-Node: What is a shell?4188
-Node: Definitions6798
-Node: Basic Shell Features10125
-Node: Shell Syntax11349
-Node: Shell Operation12376
-Node: Quoting13667
-Node: Escape Character15005
-Node: Single Quotes15540
-Node: Double Quotes15889
-Node: ANSI-C Quoting17234
-Node: Locale Translation18628
-Node: Creating Internationalized Scripts20031
-Node: Comments24229
-Node: Shell Commands24996
-Node: Reserved Words25935
-Node: Simple Commands27078
-Node: Pipelines27740
-Node: Lists30996
-Node: Compound Commands32916
-Node: Looping Constructs33925
-Node: Conditional Constructs36474
-Node: Command Grouping51611
-Node: Coprocesses53103
-Node: GNU Parallel55789
-Node: Shell Functions56707
-Node: Shell Parameters65155
-Node: Positional Parameters70056
-Node: Special Parameters71146
-Node: Shell Expansions74607
-Node: Brace Expansion76796
-Node: Tilde Expansion80132
-Node: Shell Parameter Expansion83087
-Node: Command Substitution103730
-Node: Arithmetic Expansion107259
-Node: Process Substitution108435
-Node: Word Splitting109543
-Node: Filename Expansion111987
-Node: Pattern Matching115211
-Node: Quote Removal120934
-Node: Redirections121238
-Node: Executing Commands131494
-Node: Simple Command Expansion132161
-Node: Command Search and Execution134269
-Node: Command Execution Environment136713
-Node: Environment140161
-Node: Exit Status142064
-Node: Signals144123
-Node: Shell Scripts149053
-Node: Shell Builtin Commands152351
-Node: Bourne Shell Builtins154462
-Node: Bash Builtins181181
-Node: Modifying Shell Behavior218105
-Node: The Set Builtin218447
-Node: The Shopt Builtin230441
-Node: Special Builtins247494
-Node: Shell Variables248483
-Node: Bourne Shell Variables248917
-Node: Bash Variables251425
-Node: Bash Features290550
-Node: Invoking Bash291564
-Node: Bash Startup Files298148
-Node: Interactive Shells303390
-Node: What is an Interactive Shell?303798
-Node: Is this Shell Interactive?304460
-Node: Interactive Shell Behavior305284
-Node: Bash Conditional Expressions309045
-Node: Shell Arithmetic314462
-Node: Aliases317789
-Node: Arrays320923
-Node: The Directory Stack328511
-Node: Directory Stack Builtins329308
-Node: Controlling the Prompt333753
-Node: The Restricted Shell336638
-Node: Bash POSIX Mode339520
-Node: Shell Compatibility Mode358467
-Node: Job Control367474
-Node: Job Control Basics367931
-Node: Job Control Builtins374299
-Node: Job Control Variables380981
-Node: Command Line Editing382212
-Node: Introduction and Notation383915
-Node: Readline Interaction386267
-Node: Readline Bare Essentials387455
-Node: Readline Movement Commands389263
-Node: Readline Killing Commands390259
-Node: Readline Arguments392282
-Node: Searching393372
-Node: Readline Init File395615
-Node: Readline Init File Syntax396918
-Node: Conditional Init Constructs423869
-Node: Sample Init File428254
-Node: Bindable Readline Commands431374
-Node: Commands For Moving432912
-Node: Commands For History435376
-Node: Commands For Text440767
-Node: Commands For Killing444892
-Node: Numeric Arguments447680
-Node: Commands For Completion448832
-Node: Keyboard Macros454528
-Node: Miscellaneous Commands455229
-Node: Readline vi Mode461796
-Node: Programmable Completion462773
-Node: Programmable Completion Builtins472509
-Node: A Programmable Completion Example484246
-Node: Using History Interactively489591
-Node: Bash History Facilities490272
-Node: Bash History Builtins494007
-Node: History Interaction500478
-Node: Event Designators505428
-Node: Word Designators507006
-Node: Modifiers509398
-Node: Installing Bash511335
-Node: Basic Installation512451
-Node: Compilers and Options516327
-Node: Compiling For Multiple Architectures517077
-Node: Installation Names518830
-Node: Specifying the System Type521064
-Node: Sharing Defaults521810
-Node: Operation Controls522524
-Node: Optional Features523543
-Node: Reporting Bugs536266
-Node: Major Differences From The Bourne Shell537623
-Node: GNU Free Documentation License559050
-Node: Indexes584227
-Node: Builtin Index584678
-Node: Reserved Word Index591776
-Node: Variable Index594221
-Node: Function Index611634
-Node: Concept Index625629
+Node: Top903
+Node: Introduction2846
+Node: What is Bash?3059
+Node: What is a shell?4192
+Node: Definitions6802
+Node: Basic Shell Features10129
+Node: Shell Syntax11353
+Node: Shell Operation12380
+Node: Quoting13671
+Node: Escape Character15009
+Node: Single Quotes15544
+Node: Double Quotes15893
+Node: ANSI-C Quoting17238
+Node: Locale Translation18632
+Node: Creating Internationalized Scripts20035
+Node: Comments24233
+Node: Shell Commands25000
+Node: Reserved Words25939
+Node: Simple Commands27082
+Node: Pipelines27744
+Node: Lists31000
+Node: Compound Commands32920
+Node: Looping Constructs33929
+Node: Conditional Constructs36478
+Node: Command Grouping51615
+Node: Coprocesses53107
+Node: GNU Parallel55793
+Node: Shell Functions56711
+Node: Shell Parameters65159
+Node: Positional Parameters70060
+Node: Special Parameters71150
+Node: Shell Expansions74611
+Node: Brace Expansion76800
+Node: Tilde Expansion80136
+Node: Shell Parameter Expansion83091
+Node: Command Substitution103734
+Node: Arithmetic Expansion107263
+Node: Process Substitution108439
+Node: Word Splitting109547
+Node: Filename Expansion111991
+Node: Pattern Matching115215
+Node: Quote Removal120938
+Node: Redirections121242
+Node: Executing Commands131498
+Node: Simple Command Expansion132165
+Node: Command Search and Execution134273
+Node: Command Execution Environment136717
+Node: Environment140165
+Node: Exit Status142068
+Node: Signals144127
+Node: Shell Scripts149057
+Node: Shell Builtin Commands152355
+Node: Bourne Shell Builtins154696
+Node: Bash Builtins181415
+Node: Modifying Shell Behavior218339
+Node: The Set Builtin218681
+Node: The Shopt Builtin230675
+Node: Special Builtins247728
+Node: Shell Variables248717
+Node: Bourne Shell Variables249151
+Node: Bash Variables251659
+Node: Bash Features290784
+Node: Invoking Bash291798
+Node: Bash Startup Files298382
+Node: Interactive Shells303624
+Node: What is an Interactive Shell?304032
+Node: Is this Shell Interactive?304694
+Node: Interactive Shell Behavior305518
+Node: Bash Conditional Expressions309279
+Node: Shell Arithmetic314696
+Node: Aliases318023
+Node: Arrays321157
+Node: The Directory Stack328745
+Node: Directory Stack Builtins329542
+Node: Controlling the Prompt333987
+Node: The Restricted Shell336872
+Node: Bash POSIX Mode339754
+Node: Shell Compatibility Mode358701
+Node: Job Control367708
+Node: Job Control Basics368165
+Node: Job Control Builtins374533
+Node: Job Control Variables381321
+Node: Command Line Editing382552
+Node: Introduction and Notation384255
+Node: Readline Interaction386607
+Node: Readline Bare Essentials387795
+Node: Readline Movement Commands389603
+Node: Readline Killing Commands390599
+Node: Readline Arguments392622
+Node: Searching393712
+Node: Readline Init File395955
+Node: Readline Init File Syntax397258
+Node: Conditional Init Constructs424209
+Node: Sample Init File428594
+Node: Bindable Readline Commands431714
+Node: Commands For Moving433252
+Node: Commands For History435716
+Node: Commands For Text441107
+Node: Commands For Killing445232
+Node: Numeric Arguments448020
+Node: Commands For Completion449172
+Node: Keyboard Macros454868
+Node: Miscellaneous Commands455569
+Node: Readline vi Mode462136
+Node: Programmable Completion463113
+Node: Programmable Completion Builtins472849
+Node: A Programmable Completion Example484586
+Node: Using History Interactively489931
+Node: Bash History Facilities490612
+Node: Bash History Builtins494347
+Node: History Interaction500818
+Node: Event Designators505768
+Node: Word Designators507346
+Node: Modifiers509738
+Node: Installing Bash511675
+Node: Basic Installation512791
+Node: Compilers and Options516667
+Node: Compiling For Multiple Architectures517417
+Node: Installation Names519170
+Node: Specifying the System Type521404
+Node: Sharing Defaults522150
+Node: Operation Controls522864
+Node: Optional Features523883
+Node: Reporting Bugs536606
+Node: Major Differences From The Bourne Shell537963
+Node: GNU Free Documentation License559390
+Node: Indexes584567
+Node: Builtin Index585018
+Node: Reserved Word Index592116
+Node: Variable Index594561
+Node: Function Index611974
+Node: Concept Index625969
 
 End Tag Table