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

This commit is contained in:
Chet Ramey
2024-07-06 12:54:57 -04:00
parent dbff8b786e
commit a91b8b0773
20 changed files with 1048 additions and 1029 deletions
+150 -154
View File
@@ -2,9 +2,9 @@ This is bashref.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.
@@ -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, 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
@@ -4275,7 +4275,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
@@ -6342,8 +6343,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
@@ -6405,10 +6405,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
................................................
@@ -7723,10 +7723,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
@@ -12295,8 +12291,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.
@@ -12305,7 +12301,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.
@@ -12316,12 +12312,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.
@@ -12999,138 +12995,138 @@ D.5 Concept Index

Tag Table:
Node: Top896
Node: Introduction2832
Node: What is Bash?3048
Node: What is a shell?4192
Node: Definitions6774
Node: Basic Shell Features9953
Node: Shell Syntax11176
Node: Shell Operation12206
Node: Quoting13507
Node: Escape Character14823
Node: Single Quotes15324
Node: Double Quotes15676
Node: ANSI-C Quoting17022
Node: Locale Translation18410
Node: Creating Internationalized Scripts19757
Node: Comments23958
Node: Shell Commands24596
Node: Reserved Words25538
Node: Simple Commands26406
Node: Pipelines27068
Node: Lists30134
Node: Compound Commands32009
Node: Looping Constructs33021
Node: Conditional Constructs35568
Node: Command Grouping50392
Node: Coprocesses51882
Node: GNU Parallel54581
Node: Shell Functions55502
Node: Shell Parameters63611
Node: Positional Parameters68147
Node: Special Parameters69085
Node: Shell Expansions72394
Node: Brace Expansion74586
Node: Tilde Expansion77252
Node: Shell Parameter Expansion80021
Node: Command Substitution99131
Node: Arithmetic Expansion102667
Node: Process Substitution103635
Node: Word Splitting104775
Node: Filename Expansion106919
Node: Pattern Matching110018
Node: Quote Removal115254
Node: Redirections115561
Node: Executing Commands125373
Node: Simple Command Expansion126043
Node: Command Search and Execution128157
Node: Command Execution Environment130568
Node: Environment133880
Node: Exit Status135587
Node: Signals137375
Node: Shell Scripts140992
Node: Shell Builtin Commands144087
Node: Bourne Shell Builtins146201
Node: Bash Builtins170974
Node: Modifying Shell Behavior205958
Node: The Set Builtin206303
Node: The Shopt Builtin217821
Node: Special Builtins234611
Node: Shell Variables235603
Node: Bourne Shell Variables236040
Node: Bash Variables238236
Node: Bash Features275404
Node: Invoking Bash276421
Node: Bash Startup Files282823
Node: Interactive Shells288138
Node: What is an Interactive Shell?288549
Node: Is this Shell Interactive?289218
Node: Interactive Shell Behavior290045
Node: Bash Conditional Expressions293802
Node: Shell Arithmetic298979
Node: Aliases302064
Node: Arrays305022
Node: The Directory Stack311824
Node: Directory Stack Builtins312624
Node: Controlling the Prompt317076
Node: The Restricted Shell320217
Node: Bash POSIX Mode323007
Node: Shell Compatibility Mode340521
Node: Job Control349543
Node: Job Control Basics350003
Node: Job Control Builtins355180
Node: Job Control Variables361143
Node: Command Line Editing362323
Node: Introduction and Notation364030
Node: Readline Interaction365677
Node: Readline Bare Essentials366868
Node: Readline Movement Commands368689
Node: Readline Killing Commands369689
Node: Readline Arguments371670
Node: Searching372730
Node: Readline Init File374962
Node: Readline Init File Syntax376247
Node: Conditional Init Constructs401188
Node: Sample Init File405556
Node: Bindable Readline Commands408680
Node: Commands For Moving409908
Node: Commands For History412138
Node: Commands For Text417346
Node: Commands For Killing421483
Node: Numeric Arguments424287
Node: Commands For Completion425442
Node: Keyboard Macros429761
Node: Miscellaneous Commands430465
Node: Readline vi Mode437122
Node: Programmable Completion438077
Node: Programmable Completion Builtins446037
Node: A Programmable Completion Example457606
Node: Using History Interactively462954
Node: Bash History Facilities463638
Node: Bash History Builtins466753
Node: History Interaction471999
Node: Event Designators476327
Node: Word Designators477913
Node: Modifiers479902
Node: Installing Bash481814
Node: Basic Installation482951
Node: Compilers and Options486833
Node: Compiling For Multiple Architectures487586
Node: Installation Names489338
Node: Specifying the System Type491575
Node: Sharing Defaults492324
Node: Operation Controls493041
Node: Optional Features494063
Node: Reporting Bugs505868
Node: Major Differences From The Bourne Shell507220
Node: GNU Free Documentation License526958
Node: Indexes552138
Node: Builtin Index552592
Node: Reserved Word Index559693
Node: Variable Index562141
Node: Function Index579275
Node: Concept Index593134
Node: Top894
Node: Introduction2828
Node: What is Bash?3044
Node: What is a shell?4188
Node: Definitions6770
Node: Basic Shell Features9949
Node: Shell Syntax11172
Node: Shell Operation12202
Node: Quoting13503
Node: Escape Character14819
Node: Single Quotes15320
Node: Double Quotes15672
Node: ANSI-C Quoting17018
Node: Locale Translation18406
Node: Creating Internationalized Scripts19753
Node: Comments23954
Node: Shell Commands24592
Node: Reserved Words25534
Node: Simple Commands26402
Node: Pipelines27064
Node: Lists30130
Node: Compound Commands32005
Node: Looping Constructs33017
Node: Conditional Constructs35564
Node: Command Grouping50388
Node: Coprocesses51878
Node: GNU Parallel54577
Node: Shell Functions55498
Node: Shell Parameters63607
Node: Positional Parameters68143
Node: Special Parameters69081
Node: Shell Expansions72390
Node: Brace Expansion74582
Node: Tilde Expansion77248
Node: Shell Parameter Expansion80017
Node: Command Substitution99127
Node: Arithmetic Expansion102663
Node: Process Substitution103631
Node: Word Splitting104771
Node: Filename Expansion106915
Node: Pattern Matching110014
Node: Quote Removal115250
Node: Redirections115557
Node: Executing Commands125369
Node: Simple Command Expansion126039
Node: Command Search and Execution128153
Node: Command Execution Environment130564
Node: Environment133876
Node: Exit Status135583
Node: Signals137371
Node: Shell Scripts140988
Node: Shell Builtin Commands144083
Node: Bourne Shell Builtins146197
Node: Bash Builtins170970
Node: Modifying Shell Behavior205987
Node: The Set Builtin206332
Node: The Shopt Builtin217850
Node: Special Builtins234640
Node: Shell Variables235632
Node: Bourne Shell Variables236069
Node: Bash Variables238265
Node: Bash Features275433
Node: Invoking Bash276450
Node: Bash Startup Files282852
Node: Interactive Shells288158
Node: What is an Interactive Shell?288569
Node: Is this Shell Interactive?289238
Node: Interactive Shell Behavior290065
Node: Bash Conditional Expressions293822
Node: Shell Arithmetic298999
Node: Aliases302084
Node: Arrays305042
Node: The Directory Stack311844
Node: Directory Stack Builtins312644
Node: Controlling the Prompt317096
Node: The Restricted Shell320237
Node: Bash POSIX Mode323027
Node: Shell Compatibility Mode340541
Node: Job Control349311
Node: Job Control Basics349771
Node: Job Control Builtins354948
Node: Job Control Variables360911
Node: Command Line Editing362091
Node: Introduction and Notation363798
Node: Readline Interaction365445
Node: Readline Bare Essentials366636
Node: Readline Movement Commands368457
Node: Readline Killing Commands369457
Node: Readline Arguments371438
Node: Searching372498
Node: Readline Init File374730
Node: Readline Init File Syntax376015
Node: Conditional Init Constructs400956
Node: Sample Init File405324
Node: Bindable Readline Commands408448
Node: Commands For Moving409676
Node: Commands For History411906
Node: Commands For Text417114
Node: Commands For Killing421251
Node: Numeric Arguments424055
Node: Commands For Completion425210
Node: Keyboard Macros429529
Node: Miscellaneous Commands430233
Node: Readline vi Mode436890
Node: Programmable Completion437845
Node: Programmable Completion Builtins445805
Node: A Programmable Completion Example457374
Node: Using History Interactively462722
Node: Bash History Facilities463406
Node: Bash History Builtins466521
Node: History Interaction471767
Node: Event Designators476095
Node: Word Designators477681
Node: Modifiers479670
Node: Installing Bash481582
Node: Basic Installation482719
Node: Compilers and Options486601
Node: Compiling For Multiple Architectures487354
Node: Installation Names489106
Node: Specifying the System Type491343
Node: Sharing Defaults492092
Node: Operation Controls492809
Node: Optional Features493831
Node: Reporting Bugs505636
Node: Major Differences From The Bourne Shell506988
Node: GNU Free Documentation License526726
Node: Indexes551906
Node: Builtin Index552360
Node: Reserved Word Index559461
Node: Variable Index561909
Node: Function Index579043
Node: Concept Index592902

End Tag Table