new readline application hook to print macro key sequences and values; change bind -X default output format; bind -x accepts more input formats; quoting changes for pathname expansion patterns

2026-07-10 05:30:49 +02:00 · 2023-08-01 09:59:09 -04:00
parent f6a78e24d8
commit ab99fdbca6
19 changed files with 2386 additions and 2209 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, 26 July 2023).
+Bash shell (version 5.3, 31 July 2023).

-   This is Edition 5.3, last updated 26 July 2023, of 'The GNU Bash
+   This is Edition 5.3, last updated 31 July 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, 26 July 2023).  The Bash home page is
+Bash shell (version 5.3, 31 July 2023).  The Bash home page is
 <http://www.gnu.org/software/bash/>.

-   This is Edition 5.3, last updated 26 July 2023, of 'The GNU Bash
+   This is Edition 5.3, last updated 31 July 2023, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 5.3.

   Bash contains features that appear in other popular shells, and some
@@ -3775,7 +3775,7 @@ standard.
          bind [-m KEYMAP] [-lpsvPSVX]
          bind [-m KEYMAP] [-q FUNCTION] [-u FUNCTION] [-r KEYSEQ]
          bind [-m KEYMAP] -f FILENAME
-          bind [-m KEYMAP] -x KEYSEQ:SHELL-COMMAND
+          bind [-m KEYMAP] -x KEYSEQ[: ]SHELL-COMMAND
          bind [-m KEYMAP] KEYSEQ:FUNCTION-NAME
          bind [-m KEYMAP] KEYSEQ:READLINE-COMMAND
          bind READLINE-COMMAND-LINE
@@ -3839,6 +3839,15 @@ standard.

     '-x KEYSEQ:SHELL-COMMAND'
          Cause SHELL-COMMAND to be executed whenever KEYSEQ is entered.
+          The separator between KEYSEQ and SHELL-COMMAND is either
+          whitespace or a colon optionally followed by whitespace.  If
+          the separator is whitespace, SHELL-COMMAND must be enclosed in
+          double quotes and Readline expands any of its special
+          backslash-escapes in SHELL-COMMAND before saving it.  If the
+          separator is a colon, any enclosing double quotes are
+          optional, and Readline does not expand the command string
+          before saving it.  Since the entire key binding expression
+          must be a single argument, it should be enclosed in quotes.
          When SHELL-COMMAND is executed, the shell sets the
          'READLINE_LINE' variable to the contents of the Readline line
          buffer and the 'READLINE_POINT' and 'READLINE_MARK' variables
@@ -12078,11 +12087,11 @@ D.1 Index of Shell Builtin Commands
 * bind:                                  Bash Builtins.       (line  21)
 * break:                                 Bourne Shell Builtins.
                                                              (line  37)
-* builtin:                               Bash Builtins.       (line 108)
-* caller:                                Bash Builtins.       (line 117)
+* builtin:                               Bash Builtins.       (line 117)
+* caller:                                Bash Builtins.       (line 126)
 * cd:                                    Bourne Shell Builtins.
                                                              (line  45)
-* command:                               Bash Builtins.       (line 134)
+* command:                               Bash Builtins.       (line 143)
 * compgen:                               Programmable Completion Builtins.
                                                              (line  12)
 * complete:                              Programmable Completion Builtins.
@@ -12091,13 +12100,13 @@ D.1 Index of Shell Builtin Commands
                                                              (line 248)
 * continue:                              Bourne Shell Builtins.
                                                              (line  90)
-* declare:                               Bash Builtins.       (line 154)
+* declare:                               Bash Builtins.       (line 163)
 * dirs:                                  Directory Stack Builtins.
                                                              (line   7)
 * disown:                                Job Control Builtins.
                                                              (line 104)
-* echo:                                  Bash Builtins.       (line 257)
-* enable:                                Bash Builtins.       (line 306)
+* echo:                                  Bash Builtins.       (line 266)
+* enable:                                Bash Builtins.       (line 315)
 * eval:                                  Bourne Shell Builtins.
                                                              (line  99)
 * exec:                                  Bourne Shell Builtins.
@@ -12116,26 +12125,26 @@ D.1 Index of Shell Builtin Commands
                                                              (line 153)
 * hash:                                  Bourne Shell Builtins.
                                                              (line 197)
-* help:                                  Bash Builtins.       (line 342)
+* help:                                  Bash Builtins.       (line 351)
 * history:                               Bash History Builtins.
                                                              (line  46)
 * jobs:                                  Job Control Builtins.
                                                              (line  27)
 * kill:                                  Job Control Builtins.
                                                              (line  58)
-* let:                                   Bash Builtins.       (line 361)
-* local:                                 Bash Builtins.       (line 369)
-* logout:                                Bash Builtins.       (line 386)
-* mapfile:                               Bash Builtins.       (line 391)
+* let:                                   Bash Builtins.       (line 370)
+* local:                                 Bash Builtins.       (line 378)
+* logout:                                Bash Builtins.       (line 395)
+* mapfile:                               Bash Builtins.       (line 400)
 * popd:                                  Directory Stack Builtins.
                                                              (line  35)
-* printf:                                Bash Builtins.       (line 437)
+* printf:                                Bash Builtins.       (line 446)
 * pushd:                                 Directory Stack Builtins.
                                                              (line  69)
 * pwd:                                   Bourne Shell Builtins.
                                                              (line 218)
-* read:                                  Bash Builtins.       (line 504)
-* readarray:                             Bash Builtins.       (line 601)
+* read:                                  Bash Builtins.       (line 513)
+* readarray:                             Bash Builtins.       (line 610)
 * readonly:                              Bourne Shell Builtins.
                                                              (line 228)
 * return:                                Bourne Shell Builtins.
@@ -12144,7 +12153,7 @@ D.1 Index of Shell Builtin Commands
 * shift:                                 Bourne Shell Builtins.
                                                              (line 268)
 * shopt:                                 The Shopt Builtin.   (line   9)
-* source:                                Bash Builtins.       (line 610)
+* source:                                Bash Builtins.       (line 619)
 * suspend:                               Job Control Builtins.
                                                              (line 116)
 * test:                                  Bourne Shell Builtins.
@@ -12155,12 +12164,12 @@ D.1 Index of Shell Builtin Commands
                                                              (line 389)
 * true:                                  Bourne Shell Builtins.
                                                              (line 451)
-* type:                                  Bash Builtins.       (line 615)
-* typeset:                               Bash Builtins.       (line 653)
-* ulimit:                                Bash Builtins.       (line 659)
+* type:                                  Bash Builtins.       (line 624)
+* typeset:                               Bash Builtins.       (line 662)
+* ulimit:                                Bash Builtins.       (line 668)
 * umask:                                 Bourne Shell Builtins.
                                                              (line 456)
-* unalias:                               Bash Builtins.       (line 765)
+* unalias:                               Bash Builtins.       (line 774)
 * unset:                                 Bourne Shell Builtins.
                                                              (line 474)
 * wait:                                  Job Control Builtins.
@@ -12890,84 +12899,84 @@ Node: Shell Scripts137159
 Node: Shell Builtin Commands140186
 Node: Bourne Shell Builtins142224
 Node: Bash Builtins165360
-Node: Modifying Shell Behavior197386
-Node: The Set Builtin197731
-Node: The Shopt Builtin208675
-Node: Special Builtins224813
-Node: Shell Variables225792
-Node: Bourne Shell Variables226229
-Node: Bash Variables228333
-Node: Bash Features263290
-Node: Invoking Bash264303
-Node: Bash Startup Files270316
-Node: Interactive Shells275447
-Node: What is an Interactive Shell?275858
-Node: Is this Shell Interactive?276507
-Node: Interactive Shell Behavior277322
-Node: Bash Conditional Expressions280951
-Node: Shell Arithmetic285593
-Node: Aliases288554
-Node: Arrays291448
-Node: The Directory Stack298011
-Node: Directory Stack Builtins298795
-Node: Controlling the Prompt303055
-Node: The Restricted Shell306020
-Node: Bash POSIX Mode308630
-Node: Shell Compatibility Mode324773
-Node: Job Control333017
-Node: Job Control Basics333477
-Node: Job Control Builtins338479
-Node: Job Control Variables344274
-Node: Command Line Editing345430
-Node: Introduction and Notation347101
-Node: Readline Interaction348724
-Node: Readline Bare Essentials349915
-Node: Readline Movement Commands351704
-Node: Readline Killing Commands352664
-Node: Readline Arguments354585
-Node: Searching355629
-Node: Readline Init File357815
-Node: Readline Init File Syntax359076
-Node: Conditional Init Constructs383101
-Node: Sample Init File387297
-Node: Bindable Readline Commands390421
-Node: Commands For Moving391625
-Node: Commands For History393676
-Node: Commands For Text398670
-Node: Commands For Killing402648
-Node: Numeric Arguments405352
-Node: Commands For Completion406491
-Node: Keyboard Macros410682
-Node: Miscellaneous Commands411370
-Node: Readline vi Mode417408
-Node: Programmable Completion418315
-Node: Programmable Completion Builtins426095
-Node: A Programmable Completion Example437215
-Node: Using History Interactively442463
-Node: Bash History Facilities443147
-Node: Bash History Builtins446152
-Node: History Interaction451176
-Node: Event Designators454796
-Node: Word Designators456150
-Node: Modifiers457910
-Node: Installing Bash459718
-Node: Basic Installation460855
-Node: Compilers and Options464577
-Node: Compiling For Multiple Architectures465318
-Node: Installation Names467010
-Node: Specifying the System Type469119
-Node: Sharing Defaults469836
-Node: Operation Controls470509
-Node: Optional Features471467
-Node: Reporting Bugs482686
-Node: Major Differences From The Bourne Shell484020
-Node: GNU Free Documentation License500869
-Node: Indexes526046
-Node: Builtin Index526500
-Node: Reserved Word Index533601
-Node: Variable Index536049
-Node: Function Index553183
-Node: Concept Index566904
+Node: Modifying Shell Behavior198006
+Node: The Set Builtin198351
+Node: The Shopt Builtin209295
+Node: Special Builtins225433
+Node: Shell Variables226412
+Node: Bourne Shell Variables226849
+Node: Bash Variables228953
+Node: Bash Features263910
+Node: Invoking Bash264923
+Node: Bash Startup Files270936
+Node: Interactive Shells276067
+Node: What is an Interactive Shell?276478
+Node: Is this Shell Interactive?277127
+Node: Interactive Shell Behavior277942
+Node: Bash Conditional Expressions281571
+Node: Shell Arithmetic286213
+Node: Aliases289174
+Node: Arrays292068
+Node: The Directory Stack298631
+Node: Directory Stack Builtins299415
+Node: Controlling the Prompt303675
+Node: The Restricted Shell306640
+Node: Bash POSIX Mode309250
+Node: Shell Compatibility Mode325393
+Node: Job Control333637
+Node: Job Control Basics334097
+Node: Job Control Builtins339099
+Node: Job Control Variables344894
+Node: Command Line Editing346050
+Node: Introduction and Notation347721
+Node: Readline Interaction349344
+Node: Readline Bare Essentials350535
+Node: Readline Movement Commands352324
+Node: Readline Killing Commands353284
+Node: Readline Arguments355205
+Node: Searching356249
+Node: Readline Init File358435
+Node: Readline Init File Syntax359696
+Node: Conditional Init Constructs383721
+Node: Sample Init File387917
+Node: Bindable Readline Commands391041
+Node: Commands For Moving392245
+Node: Commands For History394296
+Node: Commands For Text399290
+Node: Commands For Killing403268
+Node: Numeric Arguments405972
+Node: Commands For Completion407111
+Node: Keyboard Macros411302
+Node: Miscellaneous Commands411990
+Node: Readline vi Mode418028
+Node: Programmable Completion418935
+Node: Programmable Completion Builtins426715
+Node: A Programmable Completion Example437835
+Node: Using History Interactively443083
+Node: Bash History Facilities443767
+Node: Bash History Builtins446772
+Node: History Interaction451796
+Node: Event Designators455416
+Node: Word Designators456770
+Node: Modifiers458530
+Node: Installing Bash460338
+Node: Basic Installation461475
+Node: Compilers and Options465197
+Node: Compiling For Multiple Architectures465938
+Node: Installation Names467630
+Node: Specifying the System Type469739
+Node: Sharing Defaults470456
+Node: Operation Controls471129
+Node: Optional Features472087
+Node: Reporting Bugs483306
+Node: Major Differences From The Bourne Shell484640
+Node: GNU Free Documentation License501489
+Node: Indexes526666
+Node: Builtin Index527120
+Node: Reserved Word Index534221
+Node: Variable Index536669
+Node: Function Index553803
+Node: Concept Index567524

 End Tag Table