fix typo in readline custom LS_COLORS extension; fix so `time' is recognized as a reserved word after $( and ${; don't run traps while parsing a command substitution

This commit is contained in:
Chet Ramey
2023-09-07 17:09:24 -04:00
parent f4683835d8
commit aab2c1fb1d
17 changed files with 2751 additions and 2650 deletions
+112 -107
View File
@@ -1,9 +1,9 @@
This is bash.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, 15 August 2023).
Bash shell (version 5.3, 31 August 2023).
This is Edition 5.3, last updated 15 August 2023, of 'The GNU Bash
This is Edition 5.3, last updated 31 August 2023, of 'The GNU Bash
Reference Manual', for 'Bash', Version 5.3.
Copyright (C) 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, 15 August 2023). The Bash home page is
Bash shell (version 5.3, 31 August 2023). The Bash home page is
<http://www.gnu.org/software/bash/>.
This is Edition 5.3, last updated 15 August 2023, of 'The GNU Bash
This is Edition 5.3, last updated 31 August 2023, of 'The GNU Bash
Reference Manual', for 'Bash', Version 5.3.
Bash contains features that appear in other popular shells, and some
@@ -4227,6 +4227,7 @@ standard.
'%Q'
like '%q', but applies any supplied precision to the ARGUMENT
before quoting it.
'%(DATEFMT)T'
Causes 'printf' to output the date-time string resulting from
using DATEFMT as a format string for 'strftime'(3). The
@@ -6629,7 +6630,10 @@ link itself.
'-v VARNAME'
True if the shell variable VARNAME is set (has been assigned a
value).
value). If VARNAME is an indexed array variable name subscripted
by '@' or '*', this returns true if the array has any set elements.
If VARNAME is an associative array variable name subscripted by '@'
or '*', this returns true if an element with that key is set.
'-R VARNAME'
True if the shell variable VARNAME is set and is a name reference.
@@ -6895,23 +6899,24 @@ above.
Any element of an array may be referenced using '${NAME[SUBSCRIPT]}'.
The braces are required to avoid conflicts with the shell's filename
expansion operators. If the SUBSCRIPT is '@' or '*', the word expands
to all members of the array NAME. These subscripts differ only when the
word appears within double quotes. If the word is double-quoted,
'${NAME[*]}' expands to a single word with the value of each array
member separated by the first character of the 'IFS' variable, and
'${NAME[@]}' expands each element of NAME to a separate word. When
there are no array members, '${NAME[@]}' expands to nothing. If the
double-quoted expansion occurs within a word, the expansion of the first
parameter is joined with the beginning part of the original word, and
the expansion of the last parameter is joined with the last part of the
original word. This is analogous to the expansion of the special
parameters '@' and '*'. '${#NAME[SUBSCRIPT]}' expands to the length of
'${NAME[SUBSCRIPT]}'. If SUBSCRIPT is '@' or '*', the expansion is the
number of elements in the array. If the SUBSCRIPT used to reference an
element of an indexed array evaluates to a number less than zero, it is
interpreted as relative to one greater than the maximum index of the
array, so negative indices count back from the end of the array, and an
index of -1 refers to the last element.
to all members of the array NAME, unless otherwise noted in the
description of a builtin or word expansion. These subscripts differ
only when the word appears within double quotes. If the word is
double-quoted, '${NAME[*]}' expands to a single word with the value of
each array member separated by the first character of the 'IFS'
variable, and '${NAME[@]}' expands each element of NAME to a separate
word. When there are no array members, '${NAME[@]}' expands to nothing.
If the double-quoted expansion occurs within a word, the expansion of
the first parameter is joined with the beginning part of the original
word, and the expansion of the last parameter is joined with the last
part of the original word. This is analogous to the expansion of the
special parameters '@' and '*'. '${#NAME[SUBSCRIPT]}' expands to the
length of '${NAME[SUBSCRIPT]}'. If SUBSCRIPT is '@' or '*', the
expansion is the number of elements in the array. If the SUBSCRIPT used
to reference an element of an indexed array evaluates to a number less
than zero, it is interpreted as relative to one greater than the maximum
index of the array, so negative indices count back from the end of the
array, and an index of -1 refers to the last element.
Referencing an array variable without a subscript is equivalent to
referencing with a subscript of 0. Any reference to a variable using a
@@ -12162,8 +12167,8 @@ D.1 Index of Shell Builtin Commands
(line 69)
* pwd: Bourne Shell Builtins.
(line 218)
* read: Bash Builtins. (line 513)
* readarray: Bash Builtins. (line 616)
* read: Bash Builtins. (line 514)
* readarray: Bash Builtins. (line 617)
* readonly: Bourne Shell Builtins.
(line 228)
* return: Bourne Shell Builtins.
@@ -12172,7 +12177,7 @@ D.1 Index of Shell Builtin Commands
* shift: Bourne Shell Builtins.
(line 268)
* shopt: The Shopt Builtin. (line 9)
* source: Bash Builtins. (line 625)
* source: Bash Builtins. (line 626)
* suspend: Job Control Builtins.
(line 116)
* test: Bourne Shell Builtins.
@@ -12183,12 +12188,12 @@ D.1 Index of Shell Builtin Commands
(line 389)
* true: Bourne Shell Builtins.
(line 451)
* type: Bash Builtins. (line 630)
* typeset: Bash Builtins. (line 668)
* ulimit: Bash Builtins. (line 674)
* type: Bash Builtins. (line 631)
* typeset: Bash Builtins. (line 669)
* ulimit: Bash Builtins. (line 675)
* umask: Bourne Shell Builtins.
(line 456)
* unalias: Bash Builtins. (line 780)
* unalias: Bash Builtins. (line 781)
* unset: Bourne Shell Builtins.
(line 474)
* wait: Job Control Builtins.
@@ -12918,84 +12923,84 @@ Node: Shell Scripts137014
Node: Shell Builtin Commands140038
Node: Bourne Shell Builtins142073
Node: Bash Builtins165206
Node: Modifying Shell Behavior198141
Node: The Set Builtin198483
Node: The Shopt Builtin209454
Node: Special Builtins225589
Node: Shell Variables226565
Node: Bourne Shell Variables226999
Node: Bash Variables229100
Node: Bash Features264156
Node: Invoking Bash265166
Node: Bash Startup Files271202
Node: Interactive Shells276330
Node: What is an Interactive Shell?276738
Node: Is this Shell Interactive?277384
Node: Interactive Shell Behavior278196
Node: Bash Conditional Expressions281822
Node: Shell Arithmetic286461
Node: Aliases289419
Node: Arrays292310
Node: The Directory Stack298868
Node: Directory Stack Builtins299649
Node: Controlling the Prompt303906
Node: The Restricted Shell306868
Node: Bash POSIX Mode309475
Node: Shell Compatibility Mode325633
Node: Job Control333874
Node: Job Control Basics334331
Node: Job Control Builtins339330
Node: Job Control Variables345122
Node: Command Line Editing346275
Node: Introduction and Notation347943
Node: Readline Interaction349563
Node: Readline Bare Essentials350751
Node: Readline Movement Commands352537
Node: Readline Killing Commands353494
Node: Readline Arguments355412
Node: Searching356453
Node: Readline Init File358636
Node: Readline Init File Syntax359894
Node: Conditional Init Constructs383916
Node: Sample Init File388109
Node: Bindable Readline Commands391230
Node: Commands For Moving392431
Node: Commands For History394479
Node: Commands For Text399470
Node: Commands For Killing403445
Node: Numeric Arguments406146
Node: Commands For Completion407282
Node: Keyboard Macros411470
Node: Miscellaneous Commands412155
Node: Readline vi Mode418190
Node: Programmable Completion419094
Node: Programmable Completion Builtins426871
Node: A Programmable Completion Example437988
Node: Using History Interactively443233
Node: Bash History Facilities443914
Node: Bash History Builtins446922
Node: History Interaction452010
Node: Event Designators455820
Node: Word Designators457355
Node: Modifiers459217
Node: Installing Bash461022
Node: Basic Installation462156
Node: Compilers and Options465875
Node: Compiling For Multiple Architectures466613
Node: Installation Names468302
Node: Specifying the System Type470408
Node: Sharing Defaults471122
Node: Operation Controls471792
Node: Optional Features472747
Node: Reporting Bugs483963
Node: Major Differences From The Bourne Shell485294
Node: GNU Free Documentation License502149
Node: Indexes527323
Node: Builtin Index527774
Node: Reserved Word Index534872
Node: Variable Index537317
Node: Function Index554448
Node: Concept Index568166
Node: Modifying Shell Behavior198142
Node: The Set Builtin198484
Node: The Shopt Builtin209455
Node: Special Builtins225590
Node: Shell Variables226566
Node: Bourne Shell Variables227000
Node: Bash Variables229101
Node: Bash Features264157
Node: Invoking Bash265167
Node: Bash Startup Files271203
Node: Interactive Shells276331
Node: What is an Interactive Shell?276739
Node: Is this Shell Interactive?277385
Node: Interactive Shell Behavior278197
Node: Bash Conditional Expressions281823
Node: Shell Arithmetic286733
Node: Aliases289691
Node: Arrays292582
Node: The Directory Stack299213
Node: Directory Stack Builtins299994
Node: Controlling the Prompt304251
Node: The Restricted Shell307213
Node: Bash POSIX Mode309820
Node: Shell Compatibility Mode325978
Node: Job Control334219
Node: Job Control Basics334676
Node: Job Control Builtins339675
Node: Job Control Variables345467
Node: Command Line Editing346620
Node: Introduction and Notation348288
Node: Readline Interaction349908
Node: Readline Bare Essentials351096
Node: Readline Movement Commands352882
Node: Readline Killing Commands353839
Node: Readline Arguments355757
Node: Searching356798
Node: Readline Init File358981
Node: Readline Init File Syntax360239
Node: Conditional Init Constructs384261
Node: Sample Init File388454
Node: Bindable Readline Commands391575
Node: Commands For Moving392776
Node: Commands For History394824
Node: Commands For Text399815
Node: Commands For Killing403790
Node: Numeric Arguments406491
Node: Commands For Completion407627
Node: Keyboard Macros411815
Node: Miscellaneous Commands412500
Node: Readline vi Mode418535
Node: Programmable Completion419439
Node: Programmable Completion Builtins427216
Node: A Programmable Completion Example438333
Node: Using History Interactively443578
Node: Bash History Facilities444259
Node: Bash History Builtins447267
Node: History Interaction452355
Node: Event Designators456165
Node: Word Designators457700
Node: Modifiers459562
Node: Installing Bash461367
Node: Basic Installation462501
Node: Compilers and Options466220
Node: Compiling For Multiple Architectures466958
Node: Installation Names468647
Node: Specifying the System Type470753
Node: Sharing Defaults471467
Node: Operation Controls472137
Node: Optional Features473092
Node: Reporting Bugs484308
Node: Major Differences From The Bourne Shell485639
Node: GNU Free Documentation License502494
Node: Indexes527668
Node: Builtin Index528119
Node: Reserved Word Index535217
Node: Variable Index537662
Node: Function Index554793
Node: Concept Index568511

End Tag Table