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

2026-07-10 13:40:55 +02:00 · 2023-09-07 17:09:24 -04:00
parent f4683835d8
commit aab2c1fb1d
17 changed files with 2751 additions and 2650 deletions
@@ -2,9 +2,9 @@ This is bashref.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.
@@ -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, 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
@@ -4228,6 +4228,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
@@ -6630,7 +6631,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.
@@ -6896,23 +6900,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
@@ -12163,8 +12168,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.
@@ -12173,7 +12178,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.
@@ -12184,12 +12189,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.
@@ -12919,84 +12924,84 @@ Node: Shell Scripts137167
 Node: Shell Builtin Commands140194
 Node: Bourne Shell Builtins142232
 Node: Bash Builtins165368
-Node: Modifying Shell Behavior198306
-Node: The Set Builtin198651
-Node: The Shopt Builtin209625
-Node: Special Builtins225763
-Node: Shell Variables226742
-Node: Bourne Shell Variables227179
-Node: Bash Variables229283
-Node: Bash Features264342
-Node: Invoking Bash265355
-Node: Bash Startup Files271394
-Node: Interactive Shells276525
-Node: What is an Interactive Shell?276936
-Node: Is this Shell Interactive?277585
-Node: Interactive Shell Behavior278400
-Node: Bash Conditional Expressions282029
-Node: Shell Arithmetic286671
-Node: Aliases289632
-Node: Arrays292526
-Node: The Directory Stack299087
-Node: Directory Stack Builtins299871
-Node: Controlling the Prompt304131
-Node: The Restricted Shell307096
-Node: Bash POSIX Mode309706
-Node: Shell Compatibility Mode325867
-Node: Job Control334111
-Node: Job Control Basics334571
-Node: Job Control Builtins339573
-Node: Job Control Variables345368
-Node: Command Line Editing346524
-Node: Introduction and Notation348195
-Node: Readline Interaction349818
-Node: Readline Bare Essentials351009
-Node: Readline Movement Commands352798
-Node: Readline Killing Commands353758
-Node: Readline Arguments355679
-Node: Searching356723
-Node: Readline Init File358909
-Node: Readline Init File Syntax360170
-Node: Conditional Init Constructs384195
-Node: Sample Init File388391
-Node: Bindable Readline Commands391515
-Node: Commands For Moving392719
-Node: Commands For History394770
-Node: Commands For Text399764
-Node: Commands For Killing403742
-Node: Numeric Arguments406446
-Node: Commands For Completion407585
-Node: Keyboard Macros411776
-Node: Miscellaneous Commands412464
-Node: Readline vi Mode418502
-Node: Programmable Completion419409
-Node: Programmable Completion Builtins427189
-Node: A Programmable Completion Example438309
-Node: Using History Interactively443557
-Node: Bash History Facilities444241
-Node: Bash History Builtins447252
-Node: History Interaction452343
-Node: Event Designators456156
-Node: Word Designators457694
-Node: Modifiers459559
-Node: Installing Bash461367
-Node: Basic Installation462504
-Node: Compilers and Options466226
-Node: Compiling For Multiple Architectures466967
-Node: Installation Names468659
-Node: Specifying the System Type470768
-Node: Sharing Defaults471485
-Node: Operation Controls472158
-Node: Optional Features473116
-Node: Reporting Bugs484335
-Node: Major Differences From The Bourne Shell485669
-Node: GNU Free Documentation License502527
-Node: Indexes527704
-Node: Builtin Index528158
-Node: Reserved Word Index535259
-Node: Variable Index537707
-Node: Function Index554841
-Node: Concept Index568562
+Node: Modifying Shell Behavior198307
+Node: The Set Builtin198652
+Node: The Shopt Builtin209626
+Node: Special Builtins225764
+Node: Shell Variables226743
+Node: Bourne Shell Variables227180
+Node: Bash Variables229284
+Node: Bash Features264343
+Node: Invoking Bash265356
+Node: Bash Startup Files271395
+Node: Interactive Shells276526
+Node: What is an Interactive Shell?276937
+Node: Is this Shell Interactive?277586
+Node: Interactive Shell Behavior278401
+Node: Bash Conditional Expressions282030
+Node: Shell Arithmetic286943
+Node: Aliases289904
+Node: Arrays292798
+Node: The Directory Stack299432
+Node: Directory Stack Builtins300216
+Node: Controlling the Prompt304476
+Node: The Restricted Shell307441
+Node: Bash POSIX Mode310051
+Node: Shell Compatibility Mode326212
+Node: Job Control334456
+Node: Job Control Basics334916
+Node: Job Control Builtins339918
+Node: Job Control Variables345713
+Node: Command Line Editing346869
+Node: Introduction and Notation348540
+Node: Readline Interaction350163
+Node: Readline Bare Essentials351354
+Node: Readline Movement Commands353143
+Node: Readline Killing Commands354103
+Node: Readline Arguments356024
+Node: Searching357068
+Node: Readline Init File359254
+Node: Readline Init File Syntax360515
+Node: Conditional Init Constructs384540
+Node: Sample Init File388736
+Node: Bindable Readline Commands391860
+Node: Commands For Moving393064
+Node: Commands For History395115
+Node: Commands For Text400109
+Node: Commands For Killing404087
+Node: Numeric Arguments406791
+Node: Commands For Completion407930
+Node: Keyboard Macros412121
+Node: Miscellaneous Commands412809
+Node: Readline vi Mode418847
+Node: Programmable Completion419754
+Node: Programmable Completion Builtins427534
+Node: A Programmable Completion Example438654
+Node: Using History Interactively443902
+Node: Bash History Facilities444586
+Node: Bash History Builtins447597
+Node: History Interaction452688
+Node: Event Designators456501
+Node: Word Designators458039
+Node: Modifiers459904
+Node: Installing Bash461712
+Node: Basic Installation462849
+Node: Compilers and Options466571
+Node: Compiling For Multiple Architectures467312
+Node: Installation Names469004
+Node: Specifying the System Type471113
+Node: Sharing Defaults471830
+Node: Operation Controls472503
+Node: Optional Features473461
+Node: Reporting Bugs484680
+Node: Major Differences From The Bourne Shell486014
+Node: GNU Free Documentation License502872
+Node: Indexes528049
+Node: Builtin Index528503
+Node: Reserved Word Index535604
+Node: Variable Index538052
+Node: Function Index555186
+Node: Concept Index568907

 End Tag Table