doc changes for --rcfile; fix isearch undo list incompatibility with bash-5.2; non-inc search preserves undo lists in history entries

2026-08-10 20:20:38 +02:00 · 2024-07-06 12:54:57 -04:00
parent dbff8b786e
commit a91b8b0773
20 changed files with 1048 additions and 1029 deletions
@@ -1,9 +1,9 @@
 This is bash.info, produced by makeinfo version 7.1 from bashref.texi.

 This text is a brief description of the features that are present in the
-Bash shell (version 5.3, 12 June 2024).
+Bash shell (version 5.3, 2 July 2024).

-   This is Edition 5.3, last updated 12 June 2024, of ‘The GNU Bash
+   This is Edition 5.3, last updated 2 July 2024, of ‘The GNU Bash
 Reference Manual’, for ‘Bash’, Version 5.3.

   Copyright © 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, 12 June 2024).  The Bash home page is
+Bash shell (version 5.3, 2 July 2024).  The Bash home page is
 <http://www.gnu.org/software/bash/>.

-   This is Edition 5.3, last updated 12 June 2024, of ‘The GNU Bash
+   This is Edition 5.3, last updated 2 July 2024, of ‘The GNU Bash
 Reference Manual’, for ‘Bash’, Version 5.3.

   Bash contains features that appear in other popular shells, and some
@@ -4274,7 +4274,8 @@ standard.
     Arguments to non-string format specifiers are treated as C language
     constants, except that a leading plus or minus sign is allowed, and
     if the leading character is a single or double quote, the value is
-     the ASCII value of the following character.
+     the numeric value of the following character, using the current
+     locale.

     The FORMAT is reused as necessary to consume all of the ARGUMENTS.
     If the FORMAT requires more ARGUMENTS than are supplied, the extra
@@ -6341,8 +6342,7 @@ Invoked as an interactive non-login shell
 When an interactive shell that is not a login shell is started, Bash
 reads and executes commands from ‘~/.bashrc’, if that file exists.  This
 may be inhibited by using the ‘--norc’ option.  The ‘--rcfile FILE’
-option will force Bash to read and execute commands from FILE instead of
-‘~/.bashrc’.
+option will cause Bash to use FILE instead of ‘~/.bashrc’.

   So, typically, your ‘~/.bash_profile’ contains the line
     if [ -f ~/.bashrc ]; then . ~/.bashrc; fi
@@ -6404,10 +6404,10 @@ 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.
+may be used to inhibit this behavior, and the ‘--rcfile’ option will
+make Bash use a different file instead of ‘~/.bashrc’, 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
 ................................................
@@ -7722,10 +7722,6 @@ required for bash-5.1 and later versions.
          double-quoted word expansions

 ‘compat43’
-        • the shell does not print a warning message if an attempt is
-          made to use a quoted compound assignment as an argument to
-          declare (e.g., declare -a foo='(1 2)').  Later versions warn
-          that this usage is deprecated
        • word expansion errors are considered non-fatal errors that
          cause the current command to fail, even in posix mode (the
          default behavior is to make them fatal errors that cause the
@@ -12294,8 +12290,8 @@ D.1 Index of Shell Builtin Commands
                                                              (line  69)
 * pwd:                                   Bourne Shell Builtins.
                                                              (line 226)
-* read:                                  Bash Builtins.       (line 523)
-* readarray:                             Bash Builtins.       (line 629)
+* read:                                  Bash Builtins.       (line 524)
+* readarray:                             Bash Builtins.       (line 630)
 * readonly:                              Bourne Shell Builtins.
                                                              (line 236)
 * return:                                Bourne Shell Builtins.
@@ -12304,7 +12300,7 @@ D.1 Index of Shell Builtin Commands
 * shift:                                 Bourne Shell Builtins.
                                                              (line 276)
 * shopt:                                 The Shopt Builtin.   (line   9)
-* source:                                Bash Builtins.       (line 638)
+* source:                                Bash Builtins.       (line 639)
 * suspend:                               Job Control Builtins.
                                                              (line 116)
 * test:                                  Bourne Shell Builtins.
@@ -12315,12 +12311,12 @@ D.1 Index of Shell Builtin Commands
                                                              (line 397)
 * true:                                  Bourne Shell Builtins.
                                                              (line 459)
-* type:                                  Bash Builtins.       (line 643)
-* typeset:                               Bash Builtins.       (line 681)
-* ulimit:                                Bash Builtins.       (line 687)
+* type:                                  Bash Builtins.       (line 644)
+* typeset:                               Bash Builtins.       (line 682)
+* ulimit:                                Bash Builtins.       (line 688)
 * umask:                                 Bourne Shell Builtins.
                                                              (line 464)
-* unalias:                               Bash Builtins.       (line 793)
+* unalias:                               Bash Builtins.       (line 794)
 * unset:                                 Bourne Shell Builtins.
                                                              (line 482)
 * wait:                                  Job Control Builtins.
@@ -12998,138 +12994,138 @@ D.5 Concept Index


 Tag Table:
-Node: Top893
-Node: Introduction2826
-Node: What is Bash?3039
-Node: What is a shell?4180
-Node: Definitions6759
-Node: Basic Shell Features9935
-Node: Shell Syntax11155
-Node: Shell Operation12182
-Node: Quoting13480
-Node: Escape Character14793
-Node: Single Quotes15291
-Node: Double Quotes15640
-Node: ANSI-C Quoting16983
-Node: Locale Translation18368
-Node: Creating Internationalized Scripts19712
-Node: Comments23910
-Node: Shell Commands24545
-Node: Reserved Words25484
-Node: Simple Commands26349
-Node: Pipelines27008
-Node: Lists30071
-Node: Compound Commands31943
-Node: Looping Constructs32952
-Node: Conditional Constructs35496
-Node: Command Grouping50317
-Node: Coprocesses51804
-Node: GNU Parallel54500
-Node: Shell Functions55418
-Node: Shell Parameters63524
-Node: Positional Parameters68057
-Node: Special Parameters68992
-Node: Shell Expansions72298
-Node: Brace Expansion74487
-Node: Tilde Expansion77150
-Node: Shell Parameter Expansion79916
-Node: Command Substitution99023
-Node: Arithmetic Expansion102556
-Node: Process Substitution103521
-Node: Word Splitting104658
-Node: Filename Expansion106799
-Node: Pattern Matching109895
-Node: Quote Removal115128
-Node: Redirections115432
-Node: Executing Commands125241
-Node: Simple Command Expansion125908
-Node: Command Search and Execution128019
-Node: Command Execution Environment130427
-Node: Environment133736
-Node: Exit Status135440
-Node: Signals137225
-Node: Shell Scripts140839
-Node: Shell Builtin Commands143931
-Node: Bourne Shell Builtins146042
-Node: Bash Builtins170812
-Node: Modifying Shell Behavior205793
-Node: The Set Builtin206135
-Node: The Shopt Builtin217650
-Node: Special Builtins234437
-Node: Shell Variables235426
-Node: Bourne Shell Variables235860
-Node: Bash Variables238053
-Node: Bash Features275218
-Node: Invoking Bash276232
-Node: Bash Startup Files282631
-Node: Interactive Shells287943
-Node: What is an Interactive Shell?288351
-Node: Is this Shell Interactive?289017
-Node: Interactive Shell Behavior289841
-Node: Bash Conditional Expressions293595
-Node: Shell Arithmetic298769
-Node: Aliases301851
-Node: Arrays304806
-Node: The Directory Stack311605
-Node: Directory Stack Builtins312402
-Node: Controlling the Prompt316851
-Node: The Restricted Shell319989
-Node: Bash POSIX Mode322776
-Node: Shell Compatibility Mode340287
-Node: Job Control349306
-Node: Job Control Basics349763
-Node: Job Control Builtins354937
-Node: Job Control Variables360897
-Node: Command Line Editing362074
-Node: Introduction and Notation363778
-Node: Readline Interaction365422
-Node: Readline Bare Essentials366610
-Node: Readline Movement Commands368428
-Node: Readline Killing Commands369425
-Node: Readline Arguments371403
-Node: Searching372460
-Node: Readline Init File374689
-Node: Readline Init File Syntax375971
-Node: Conditional Init Constructs400909
-Node: Sample Init File405274
-Node: Bindable Readline Commands408395
-Node: Commands For Moving409620
-Node: Commands For History411847
-Node: Commands For Text417052
-Node: Commands For Killing421186
-Node: Numeric Arguments423987
-Node: Commands For Completion425139
-Node: Keyboard Macros429455
-Node: Miscellaneous Commands430156
-Node: Readline vi Mode436810
-Node: Programmable Completion437762
-Node: Programmable Completion Builtins445719
-Node: A Programmable Completion Example457285
-Node: Using History Interactively462630
-Node: Bash History Facilities463311
-Node: Bash History Builtins466423
-Node: History Interaction471666
-Node: Event Designators475991
-Node: Word Designators477574
-Node: Modifiers479560
-Node: Installing Bash481469
-Node: Basic Installation482603
-Node: Compilers and Options486482
-Node: Compiling For Multiple Architectures487232
-Node: Installation Names488981
-Node: Specifying the System Type491215
-Node: Sharing Defaults491961
-Node: Operation Controls492675
-Node: Optional Features493694
-Node: Reporting Bugs505496
-Node: Major Differences From The Bourne Shell506845
-Node: GNU Free Documentation License526580
-Node: Indexes551757
-Node: Builtin Index552208
-Node: Reserved Word Index559306
-Node: Variable Index561751
-Node: Function Index578882
-Node: Concept Index592738
+Node: Top891
+Node: Introduction2822
+Node: What is Bash?3035
+Node: What is a shell?4176
+Node: Definitions6755
+Node: Basic Shell Features9931
+Node: Shell Syntax11151
+Node: Shell Operation12178
+Node: Quoting13476
+Node: Escape Character14789
+Node: Single Quotes15287
+Node: Double Quotes15636
+Node: ANSI-C Quoting16979
+Node: Locale Translation18364
+Node: Creating Internationalized Scripts19708
+Node: Comments23906
+Node: Shell Commands24541
+Node: Reserved Words25480
+Node: Simple Commands26345
+Node: Pipelines27004
+Node: Lists30067
+Node: Compound Commands31939
+Node: Looping Constructs32948
+Node: Conditional Constructs35492
+Node: Command Grouping50313
+Node: Coprocesses51800
+Node: GNU Parallel54496
+Node: Shell Functions55414
+Node: Shell Parameters63520
+Node: Positional Parameters68053
+Node: Special Parameters68988
+Node: Shell Expansions72294
+Node: Brace Expansion74483
+Node: Tilde Expansion77146
+Node: Shell Parameter Expansion79912
+Node: Command Substitution99019
+Node: Arithmetic Expansion102552
+Node: Process Substitution103517
+Node: Word Splitting104654
+Node: Filename Expansion106795
+Node: Pattern Matching109891
+Node: Quote Removal115124
+Node: Redirections115428
+Node: Executing Commands125237
+Node: Simple Command Expansion125904
+Node: Command Search and Execution128015
+Node: Command Execution Environment130423
+Node: Environment133732
+Node: Exit Status135436
+Node: Signals137221
+Node: Shell Scripts140835
+Node: Shell Builtin Commands143927
+Node: Bourne Shell Builtins146038
+Node: Bash Builtins170808
+Node: Modifying Shell Behavior205822
+Node: The Set Builtin206164
+Node: The Shopt Builtin217679
+Node: Special Builtins234466
+Node: Shell Variables235455
+Node: Bourne Shell Variables235889
+Node: Bash Variables238082
+Node: Bash Features275247
+Node: Invoking Bash276261
+Node: Bash Startup Files282660
+Node: Interactive Shells287963
+Node: What is an Interactive Shell?288371
+Node: Is this Shell Interactive?289037
+Node: Interactive Shell Behavior289861
+Node: Bash Conditional Expressions293615
+Node: Shell Arithmetic298789
+Node: Aliases301871
+Node: Arrays304826
+Node: The Directory Stack311625
+Node: Directory Stack Builtins312422
+Node: Controlling the Prompt316871
+Node: The Restricted Shell320009
+Node: Bash POSIX Mode322796
+Node: Shell Compatibility Mode340307
+Node: Job Control349074
+Node: Job Control Basics349531
+Node: Job Control Builtins354705
+Node: Job Control Variables360665
+Node: Command Line Editing361842
+Node: Introduction and Notation363546
+Node: Readline Interaction365190
+Node: Readline Bare Essentials366378
+Node: Readline Movement Commands368196
+Node: Readline Killing Commands369193
+Node: Readline Arguments371171
+Node: Searching372228
+Node: Readline Init File374457
+Node: Readline Init File Syntax375739
+Node: Conditional Init Constructs400677
+Node: Sample Init File405042
+Node: Bindable Readline Commands408163
+Node: Commands For Moving409388
+Node: Commands For History411615
+Node: Commands For Text416820
+Node: Commands For Killing420954
+Node: Numeric Arguments423755
+Node: Commands For Completion424907
+Node: Keyboard Macros429223
+Node: Miscellaneous Commands429924
+Node: Readline vi Mode436578
+Node: Programmable Completion437530
+Node: Programmable Completion Builtins445487
+Node: A Programmable Completion Example457053
+Node: Using History Interactively462398
+Node: Bash History Facilities463079
+Node: Bash History Builtins466191
+Node: History Interaction471434
+Node: Event Designators475759
+Node: Word Designators477342
+Node: Modifiers479328
+Node: Installing Bash481237
+Node: Basic Installation482371
+Node: Compilers and Options486250
+Node: Compiling For Multiple Architectures487000
+Node: Installation Names488749
+Node: Specifying the System Type490983
+Node: Sharing Defaults491729
+Node: Operation Controls492443
+Node: Optional Features493462
+Node: Reporting Bugs505264
+Node: Major Differences From The Bourne Shell506613
+Node: GNU Free Documentation License526348
+Node: Indexes551525
+Node: Builtin Index551976
+Node: Reserved Word Index559074
+Node: Variable Index561519
+Node: Function Index578650
+Node: Concept Index592506

 End Tag Table