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-19 01:42:51 +02:00 · 2023-08-01 09:59:09 -04:00
parent f6a78e24d8
commit ab99fdbca6
19 changed files with 2386 additions and 2209 deletions
@@ -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, 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.
@@ -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, 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
@@ -3774,7 +3774,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
@@ -3838,6 +3838,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
@@ -12077,11 +12086,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.
@@ -12090,13 +12099,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.
@@ -12115,26 +12124,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.
@@ -12143,7 +12152,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.
@@ -12154,12 +12163,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.
@@ -12889,84 +12898,84 @@ Node: Shell Scripts137006
 Node: Shell Builtin Commands140030
 Node: Bourne Shell Builtins142065
 Node: Bash Builtins165198
-Node: Modifying Shell Behavior197221
-Node: The Set Builtin197563
-Node: The Shopt Builtin208504
-Node: Special Builtins224639
-Node: Shell Variables225615
-Node: Bourne Shell Variables226049
-Node: Bash Variables228150
-Node: Bash Features263104
-Node: Invoking Bash264114
-Node: Bash Startup Files270124
-Node: Interactive Shells275252
-Node: What is an Interactive Shell?275660
-Node: Is this Shell Interactive?276306
-Node: Interactive Shell Behavior277118
-Node: Bash Conditional Expressions280744
-Node: Shell Arithmetic285383
-Node: Aliases288341
-Node: Arrays291232
-Node: The Directory Stack297792
-Node: Directory Stack Builtins298573
-Node: Controlling the Prompt302830
-Node: The Restricted Shell305792
-Node: Bash POSIX Mode308399
-Node: Shell Compatibility Mode324539
-Node: Job Control332780
-Node: Job Control Basics333237
-Node: Job Control Builtins338236
-Node: Job Control Variables344028
-Node: Command Line Editing345181
-Node: Introduction and Notation346849
-Node: Readline Interaction348469
-Node: Readline Bare Essentials349657
-Node: Readline Movement Commands351443
-Node: Readline Killing Commands352400
-Node: Readline Arguments354318
-Node: Searching355359
-Node: Readline Init File357542
-Node: Readline Init File Syntax358800
-Node: Conditional Init Constructs382822
-Node: Sample Init File387015
-Node: Bindable Readline Commands390136
-Node: Commands For Moving391337
-Node: Commands For History393385
-Node: Commands For Text398376
-Node: Commands For Killing402351
-Node: Numeric Arguments405052
-Node: Commands For Completion406188
-Node: Keyboard Macros410376
-Node: Miscellaneous Commands411061
-Node: Readline vi Mode417096
-Node: Programmable Completion418000
-Node: Programmable Completion Builtins425777
-Node: A Programmable Completion Example436894
-Node: Using History Interactively442139
-Node: Bash History Facilities442820
-Node: Bash History Builtins445822
-Node: History Interaction450843
-Node: Event Designators454460
-Node: Word Designators455811
-Node: Modifiers457568
-Node: Installing Bash459373
-Node: Basic Installation460507
-Node: Compilers and Options464226
-Node: Compiling For Multiple Architectures464964
-Node: Installation Names466653
-Node: Specifying the System Type468759
-Node: Sharing Defaults469473
-Node: Operation Controls470143
-Node: Optional Features471098
-Node: Reporting Bugs482314
-Node: Major Differences From The Bourne Shell483645
-Node: GNU Free Documentation License500491
-Node: Indexes525665
-Node: Builtin Index526116
-Node: Reserved Word Index533214
-Node: Variable Index535659
-Node: Function Index552790
-Node: Concept Index566508
+Node: Modifying Shell Behavior197841
+Node: The Set Builtin198183
+Node: The Shopt Builtin209124
+Node: Special Builtins225259
+Node: Shell Variables226235
+Node: Bourne Shell Variables226669
+Node: Bash Variables228770
+Node: Bash Features263724
+Node: Invoking Bash264734
+Node: Bash Startup Files270744
+Node: Interactive Shells275872
+Node: What is an Interactive Shell?276280
+Node: Is this Shell Interactive?276926
+Node: Interactive Shell Behavior277738
+Node: Bash Conditional Expressions281364
+Node: Shell Arithmetic286003
+Node: Aliases288961
+Node: Arrays291852
+Node: The Directory Stack298412
+Node: Directory Stack Builtins299193
+Node: Controlling the Prompt303450
+Node: The Restricted Shell306412
+Node: Bash POSIX Mode309019
+Node: Shell Compatibility Mode325159
+Node: Job Control333400
+Node: Job Control Basics333857
+Node: Job Control Builtins338856
+Node: Job Control Variables344648
+Node: Command Line Editing345801
+Node: Introduction and Notation347469
+Node: Readline Interaction349089
+Node: Readline Bare Essentials350277
+Node: Readline Movement Commands352063
+Node: Readline Killing Commands353020
+Node: Readline Arguments354938
+Node: Searching355979
+Node: Readline Init File358162
+Node: Readline Init File Syntax359420
+Node: Conditional Init Constructs383442
+Node: Sample Init File387635
+Node: Bindable Readline Commands390756
+Node: Commands For Moving391957
+Node: Commands For History394005
+Node: Commands For Text398996
+Node: Commands For Killing402971
+Node: Numeric Arguments405672
+Node: Commands For Completion406808
+Node: Keyboard Macros410996
+Node: Miscellaneous Commands411681
+Node: Readline vi Mode417716
+Node: Programmable Completion418620
+Node: Programmable Completion Builtins426397
+Node: A Programmable Completion Example437514
+Node: Using History Interactively442759
+Node: Bash History Facilities443440
+Node: Bash History Builtins446442
+Node: History Interaction451463
+Node: Event Designators455080
+Node: Word Designators456431
+Node: Modifiers458188
+Node: Installing Bash459993
+Node: Basic Installation461127
+Node: Compilers and Options464846
+Node: Compiling For Multiple Architectures465584
+Node: Installation Names467273
+Node: Specifying the System Type469379
+Node: Sharing Defaults470093
+Node: Operation Controls470763
+Node: Optional Features471718
+Node: Reporting Bugs482934
+Node: Major Differences From The Bourne Shell484265
+Node: GNU Free Documentation License501111
+Node: Indexes526285
+Node: Builtin Index526736
+Node: Reserved Word Index533834
+Node: Variable Index536279
+Node: Function Index553410
+Node: Concept Index567128

 End Tag Table