pmodules/bash
0
0
Fork 0
mirror of https://https.git.savannah.gnu.org/git/bash.git synced 2026-07-06 11:50:49 +02:00
Code Issues Packages Projects Releases Wiki Activity

change redisplay to handle some cases where the line consumes more than the number of physical screen lines; add regerror() error messages if regular expression compilation fails; make sure active region readline variables are displayed with bind -v; partial fix for bind -x and commands containing quoting characters

Browse Source
This commit is contained in:
Chet Ramey
2023-07-19 15:33:45 -04:00
parent 7f7ee0e9c6
commit ad39c5c3d7
23 changed files with 2269 additions and 1996 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/bashref.info
+210 -201
View File
@@ -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, 7 July 2023).
Bash shell (version 5.3, 19 July 2023).
This is Edition 5.3, last updated 7 July 2023, of 'The GNU Bash
This is Edition 5.3, last updated 19 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, 7 July 2023). The Bash home page is
Bash shell (version 5.3, 19 July 2023). The Bash home page is
<http://www.gnu.org/software/bash/>.
This is Edition 5.3, last updated 7 July 2023, of 'The GNU Bash
This is Edition 5.3, last updated 19 July 2023, of 'The GNU Bash
Reference Manual', for 'Bash', Version 5.3.
Bash contains features that appear in other popular shells, and some
@@ -4538,6 +4538,8 @@ parameters, or to display the names and values of shell variables.
'set'
set [-abefhkmnptuvxBCEHPT] [-o OPTION-NAME] [--] [-] [ARGUMENT ...]
set [+abefhkmnptuvxBCEHPT] [+o OPTION-NAME] [--] [-] [ARGUMENT ...]
set -o
set +o
If no options or arguments are supplied, 'set' displays the names
and values of all shell variables and functions, sorted according
@@ -4613,7 +4615,12 @@ parameters, or to display the names and values of shell variables.
'-o OPTION-NAME'
Set the option corresponding to OPTION-NAME:
Set the option corresponding to OPTION-NAME. If '-o' is
supplied with no OPTION-NAME, 'set' prints the current shell
options settings. If '+o' is supplied with no OPTION-NAME,
'set' prints a series of 'set' commands to recreate the
current option settings on the standard output. Valid option
names are:
'allexport'
Same as '-a'.
@@ -8339,8 +8346,11 @@ Variable Settings
'bind-tty-special-chars'
If set to 'on' (the default), Readline attempts to bind the
control characters treated specially by the kernel's terminal
driver to their Readline equivalents.
control characters that are treated specially by the kernel's
terminal driver to their Readline equivalents. These override
the default Readline bindings described here. Type 'stty -a'
at a Bash prompt to see your current terminal settings,
including the special control characters (usually 'cchars').
'blink-matching-paren'
If set to 'on', Readline attempts to briefly move the cursor
@@ -9220,6 +9230,13 @@ File: bashref.info, Node: Commands For Text, Next: Commands For Killing, Prev
past that word as well. If the insertion point is at the end of
the line, this transposes the last two words on the line.
'shell-transpose-words (M-C-t)'
Drag the word before point past the word after point, moving point
past that word as well. If the insertion point is at the end of
the line, this transposes the last two words on the line. Word
boundaries are the same as 'shell-forward-word' and
'shell-backward-word'.
'upcase-word (M-u)'
Uppercase the current (or following) word. With a negative
argument, uppercase the previous word, but do not move the cursor.
@@ -9287,13 +9304,6 @@ File: bashref.info, Node: Commands For Killing, Next: Numeric Arguments, Prev
Kill the word behind point. Word boundaries are the same as
'shell-backward-word'.
'shell-transpose-words (M-C-t)'
Drag the word before point past the word after point, moving point
past that word as well. If the insertion point is at the end of
the line, this transposes the last two words on the line. Word
boundaries are the same as 'shell-forward-word' and
'shell-backward-word'.
'unix-word-rubout (C-w)'
Kill the word behind point, using white space as a word boundary.
The killed text is saved on the kill-ring.
@@ -12248,27 +12258,27 @@ D.3 Parameter and Variable Index
* bind-tty-special-chars: Readline Init File Syntax.
(line 71)
* blink-matching-paren: Readline Init File Syntax.
(line 76)
(line 79)
* CDPATH: Bourne Shell Variables.
(line 9)
* CHILD_MAX: Bash Variables. (line 213)
* colored-completion-prefix: Readline Init File Syntax.
(line 81)
(line 84)
* colored-stats: Readline Init File Syntax.
(line 91)
(line 94)
* COLUMNS: Bash Variables. (line 220)
* comment-begin: Readline Init File Syntax.
(line 97)
(line 100)
* completion-display-width: Readline Init File Syntax.
(line 102)
(line 105)
* completion-ignore-case: Readline Init File Syntax.
(line 109)
(line 112)
* completion-map-case: Readline Init File Syntax.
(line 114)
(line 117)
* completion-prefix-display-length: Readline Init File Syntax.
(line 120)
(line 123)
* completion-query-items: Readline Init File Syntax.
(line 127)
(line 130)
* COMPREPLY: Bash Variables. (line 272)
* COMP_CWORD: Bash Variables. (line 226)
* COMP_KEY: Bash Variables. (line 255)
@@ -12278,31 +12288,31 @@ D.3 Parameter and Variable Index
* COMP_WORDBREAKS: Bash Variables. (line 259)
* COMP_WORDS: Bash Variables. (line 265)
* convert-meta: Readline Init File Syntax.
(line 138)
(line 141)
* COPROC: Bash Variables. (line 278)
* DIRSTACK: Bash Variables. (line 282)
* disable-completion: Readline Init File Syntax.
(line 148)
(line 151)
* echo-control-characters: Readline Init File Syntax.
(line 153)
(line 156)
* editing-mode: Readline Init File Syntax.
(line 158)
(line 161)
* EMACS: Bash Variables. (line 292)
* emacs-mode-string: Readline Init File Syntax.
(line 164)
(line 167)
* enable-active-region: Readline Init File Syntax.
(line 174)
(line 177)
* enable-bracketed-paste: Readline Init File Syntax.
(line 187)
(line 190)
* enable-keypad: Readline Init File Syntax.
(line 196)
(line 199)
* ENV: Bash Variables. (line 297)
* EPOCHREALTIME: Bash Variables. (line 302)
* EPOCHSECONDS: Bash Variables. (line 310)
* EUID: Bash Variables. (line 317)
* EXECIGNORE: Bash Variables. (line 321)
* expand-tilde: Readline Init File Syntax.
(line 207)
(line 210)
* FCEDIT: Bash Variables. (line 334)
* FIGNORE: Bash Variables. (line 338)
* FUNCNAME: Bash Variables. (line 344)
@@ -12317,15 +12327,15 @@ D.3 Parameter and Variable Index
* HISTFILESIZE: Bash Variables. (line 446)
* HISTIGNORE: Bash Variables. (line 457)
* history-preserve-point: Readline Init File Syntax.
(line 211)
(line 214)
* history-size: Readline Init File Syntax.
(line 217)
(line 220)
* HISTSIZE: Bash Variables. (line 477)
* HISTTIMEFORMAT: Bash Variables. (line 484)
* HOME: Bourne Shell Variables.
(line 13)
* horizontal-scroll-mode: Readline Init File Syntax.
(line 226)
(line 229)
* HOSTFILE: Bash Variables. (line 492)
* HOSTNAME: Bash Variables. (line 503)
* HOSTTYPE: Bash Variables. (line 506)
@@ -12333,13 +12343,13 @@ D.3 Parameter and Variable Index
(line 18)
* IGNOREEOF: Bash Variables. (line 509)
* input-meta: Readline Init File Syntax.
(line 235)
(line 238)
* INPUTRC: Bash Variables. (line 519)
* INSIDE_EMACS: Bash Variables. (line 523)
* isearch-terminators: Readline Init File Syntax.
(line 245)
(line 248)
* keymap: Readline Init File Syntax.
(line 252)
(line 255)
* LANG: Creating Internationalized Scripts.
(line 51)
* LANG <1>: Bash Variables. (line 529)
@@ -12361,15 +12371,15 @@ D.3 Parameter and Variable Index
(line 27)
* MAPFILE: Bash Variables. (line 584)
* mark-modified-lines: Readline Init File Syntax.
(line 282)
(line 285)
* mark-symlinked-directories: Readline Init File Syntax.
(line 287)
(line 290)
* match-hidden-files: Readline Init File Syntax.
(line 292)
(line 295)
* menu-complete-display-prefix: Readline Init File Syntax.
(line 299)
(line 302)
* meta-flag: Readline Init File Syntax.
(line 235)
(line 238)
* OLDPWD: Bash Variables. (line 588)
* OPTARG: Bourne Shell Variables.
(line 34)
@@ -12378,9 +12388,9 @@ D.3 Parameter and Variable Index
(line 38)
* OSTYPE: Bash Variables. (line 595)
* output-meta: Readline Init File Syntax.
(line 304)
(line 307)
* page-completions: Readline Init File Syntax.
(line 312)
(line 315)
* PATH: Bourne Shell Variables.
(line 42)
* PIPESTATUS: Bash Variables. (line 598)
@@ -12403,21 +12413,21 @@ D.3 Parameter and Variable Index
* READLINE_POINT: Bash Variables. (line 670)
* REPLY: Bash Variables. (line 674)
* revert-all-at-newline: Readline Init File Syntax.
(line 322)
(line 325)
* search-ignore-case: Readline Init File Syntax.
(line 329)
(line 332)
* SECONDS: Bash Variables. (line 677)
* SHELL: Bash Variables. (line 686)
* SHELLOPTS: Bash Variables. (line 691)
* SHLVL: Bash Variables. (line 700)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 334)
(line 337)
* show-all-if-unmodified: Readline Init File Syntax.
(line 340)
(line 343)
* show-mode-in-prompt: Readline Init File Syntax.
(line 349)
(line 352)
* skip-completed-text: Readline Init File Syntax.
(line 355)
(line 358)
* SRANDOM: Bash Variables. (line 705)
* TEXTDOMAIN: Creating Internationalized Scripts.
(line 51)
@@ -12428,11 +12438,11 @@ D.3 Parameter and Variable Index
* TMPDIR: Bash Variables. (line 764)
* UID: Bash Variables. (line 768)
* vi-cmd-mode-string: Readline Init File Syntax.
(line 368)
(line 371)
* vi-ins-mode-string: Readline Init File Syntax.
(line 379)
(line 382)
* visible-stats: Readline Init File Syntax.
(line 390)
(line 393)

File: bashref.info, Node: Function Index, Next: Concept Index, Prev: Variable Index, Up: Indexes
@@ -12461,7 +12471,7 @@ D.4 Function Index
* beginning-of-line (C-a): Commands For Moving. (line 6)
* bracketed-paste-begin (): Commands For Text. (line 33)
* call-last-kbd-macro (C-x e): Keyboard Macros. (line 13)
* capitalize-word (M-c): Commands For Text. (line 66)
* capitalize-word (M-c): Commands For Text. (line 73)
* character-search (C-]): Miscellaneous Commands.
(line 42)
* character-search-backward (M-C-]): Miscellaneous Commands.
@@ -12483,24 +12493,24 @@ D.4 Function Index
* complete-variable (M-$): Commands For Completion.
(line 64)
* copy-backward-word (): Commands For Killing.
(line 69)
(line 62)
* copy-forward-word (): Commands For Killing.
(line 74)
(line 67)
* copy-region-as-kill (): Commands For Killing.
(line 65)
(line 58)
* dabbrev-expand (): Commands For Completion.
(line 95)
* delete-char (C-d): Commands For Text. (line 12)
* delete-char-or-list (): Commands For Completion.
(line 43)
* delete-horizontal-space (): Commands For Killing.
(line 57)
(line 50)
* digit-argument (M-0, M-1, ... M--): Numeric Arguments. (line 6)
* display-shell-version (C-x C-v): Miscellaneous Commands.
(line 116)
* do-lowercase-version (M-A, M-B, M-X, ...): Miscellaneous Commands.
(line 14)
* downcase-word (M-l): Commands For Text. (line 62)
* downcase-word (M-l): Commands For Text. (line 69)
* dump-functions (): Miscellaneous Commands.
(line 74)
* dump-macros (): Miscellaneous Commands.
@@ -12552,7 +12562,7 @@ D.4 Function Index
* kill-line (C-k): Commands For Killing.
(line 6)
* kill-region (): Commands For Killing.
(line 61)
(line 54)
* kill-whole-line (): Commands For Killing.
(line 19)
* kill-word (M-d): Commands For Killing.
@@ -12572,7 +12582,7 @@ D.4 Function Index
(line 39)
* operate-and-get-next (C-o): Commands For History.
(line 96)
* overwrite-mode (): Commands For Text. (line 70)
* overwrite-mode (): Commands For Text. (line 77)
* possible-command-completions (C-x !): Commands For Completion.
(line 86)
* possible-completions (M-?): Commands For Completion.
@@ -12610,8 +12620,7 @@ D.4 Function Index
* shell-forward-word (M-C-f): Commands For Moving. (line 26)
* shell-kill-word (M-C-d): Commands For Killing.
(line 32)
* shell-transpose-words (M-C-t): Commands For Killing.
(line 41)
* shell-transpose-words (M-C-t): Commands For Text. (line 58)
* skip-csi-sequence (): Miscellaneous Commands.
(line 52)
* spell-correct-word (C-x s): Miscellaneous Commands.
@@ -12625,20 +12634,20 @@ D.4 Function Index
(line 23)
* universal-argument (): Numeric Arguments. (line 10)
* unix-filename-rubout (): Commands For Killing.
(line 52)
(line 45)
* unix-line-discard (C-u): Commands For Killing.
(line 16)
* unix-word-rubout (C-w): Commands For Killing.
(line 48)
* upcase-word (M-u): Commands For Text. (line 58)
(line 41)
* upcase-word (M-u): Commands For Text. (line 65)
* yank (C-y): Commands For Killing.
(line 79)
(line 72)
* yank-last-arg (M-. or M-_): Commands For History.
(line 84)
* yank-nth-arg (M-C-y): Commands For History.
(line 75)
* yank-pop (M-y): Commands For Killing.
(line 82)
(line 75)

File: bashref.info, Node: Concept Index, Prev: Function Index, Up: Indexes
@@ -12817,138 +12826,138 @@ D.5 Concept Index

Tag Table:
Node: Top887
Node: Introduction2797
Node: What is Bash?3013
Node: What is a shell?4127
Node: Definitions6665
Node: Basic Shell Features9616
Node: Shell Syntax10835
Node: Shell Operation11861
Node: Quoting13154
Node: Escape Character14458
Node: Single Quotes14943
Node: Double Quotes15291
Node: ANSI-C Quoting16569
Node: Locale Translation17881
Node: Creating Internationalized Scripts19192
Node: Comments23309
Node: Shell Commands23927
Node: Reserved Words24865
Node: Simple Commands25621
Node: Pipelines26275
Node: Lists29261
Node: Compound Commands31056
Node: Looping Constructs32068
Node: Conditional Constructs34563
Node: Command Grouping49051
Node: Coprocesses50529
Node: GNU Parallel53192
Node: Shell Functions54109
Node: Shell Parameters61994
Node: Positional Parameters66382
Node: Special Parameters67284
Node: Shell Expansions70498
Node: Brace Expansion72586
Node: Tilde Expansion75320
Node: Shell Parameter Expansion77941
Node: Command Substitution96343
Node: Arithmetic Expansion99807
Node: Process Substitution100775
Node: Word Splitting101895
Node: Filename Expansion103943
Node: Pattern Matching106876
Node: Quote Removal111878
Node: Redirections112173
Node: Executing Commands121866
Node: Simple Command Expansion122536
Node: Command Search and Execution124646
Node: Command Execution Environment127033
Node: Environment130068
Node: Exit Status131731
Node: Signals133515
Node: Shell Scripts136964
Node: Shell Builtin Commands139991
Node: Bourne Shell Builtins142029
Node: Bash Builtins165165
Node: Modifying Shell Behavior197164
Node: The Set Builtin197509
Node: The Shopt Builtin208107
Node: Special Builtins224114
Node: Shell Variables225093
Node: Bourne Shell Variables225530
Node: Bash Variables227634
Node: Bash Features262591
Node: Invoking Bash263604
Node: Bash Startup Files269617
Node: Interactive Shells274748
Node: What is an Interactive Shell?275159
Node: Is this Shell Interactive?275808
Node: Interactive Shell Behavior276623
Node: Bash Conditional Expressions280252
Node: Shell Arithmetic284894
Node: Aliases287855
Node: Arrays290749
Node: The Directory Stack297312
Node: Directory Stack Builtins298096
Node: Controlling the Prompt302356
Node: The Restricted Shell305321
Node: Bash POSIX Mode307931
Node: Shell Compatibility Mode324074
Node: Job Control332318
Node: Job Control Basics332778
Node: Job Control Builtins337780
Node: Job Control Variables343575
Node: Command Line Editing344731
Node: Introduction and Notation346402
Node: Readline Interaction348025
Node: Readline Bare Essentials349216
Node: Readline Movement Commands351005
Node: Readline Killing Commands351965
Node: Readline Arguments353886
Node: Searching354930
Node: Readline Init File357116
Node: Readline Init File Syntax358377
Node: Conditional Init Constructs382168
Node: Sample Init File386364
Node: Bindable Readline Commands389488
Node: Commands For Moving390692
Node: Commands For History392743
Node: Commands For Text397737
Node: Commands For Killing401386
Node: Numeric Arguments404419
Node: Commands For Completion405558
Node: Keyboard Macros409749
Node: Miscellaneous Commands410437
Node: Readline vi Mode416475
Node: Programmable Completion417382
Node: Programmable Completion Builtins425162
Node: A Programmable Completion Example436282
Node: Using History Interactively441530
Node: Bash History Facilities442214
Node: Bash History Builtins445219
Node: History Interaction450243
Node: Event Designators453863
Node: Word Designators455217
Node: Modifiers456977
Node: Installing Bash458785
Node: Basic Installation459922
Node: Compilers and Options463644
Node: Compiling For Multiple Architectures464385
Node: Installation Names466077
Node: Specifying the System Type468186
Node: Sharing Defaults468903
Node: Operation Controls469576
Node: Optional Features470534
Node: Reporting Bugs481753
Node: Major Differences From The Bourne Shell483087
Node: GNU Free Documentation License499936
Node: Indexes525113
Node: Builtin Index525567
Node: Reserved Word Index532668
Node: Variable Index535116
Node: Function Index552250
Node: Concept Index566034
Node: Top889
Node: Introduction2801
Node: What is Bash?3017
Node: What is a shell?4131
Node: Definitions6669
Node: Basic Shell Features9620
Node: Shell Syntax10839
Node: Shell Operation11865
Node: Quoting13158
Node: Escape Character14462
Node: Single Quotes14947
Node: Double Quotes15295
Node: ANSI-C Quoting16573
Node: Locale Translation17885
Node: Creating Internationalized Scripts19196
Node: Comments23313
Node: Shell Commands23931
Node: Reserved Words24869
Node: Simple Commands25625
Node: Pipelines26279
Node: Lists29265
Node: Compound Commands31060
Node: Looping Constructs32072
Node: Conditional Constructs34567
Node: Command Grouping49055
Node: Coprocesses50533
Node: GNU Parallel53196
Node: Shell Functions54113
Node: Shell Parameters61998
Node: Positional Parameters66386
Node: Special Parameters67288
Node: Shell Expansions70502
Node: Brace Expansion72590
Node: Tilde Expansion75324
Node: Shell Parameter Expansion77945
Node: Command Substitution96347
Node: Arithmetic Expansion99811
Node: Process Substitution100779
Node: Word Splitting101899
Node: Filename Expansion103947
Node: Pattern Matching106880
Node: Quote Removal111882
Node: Redirections112177
Node: Executing Commands121870
Node: Simple Command Expansion122540
Node: Command Search and Execution124650
Node: Command Execution Environment127037
Node: Environment130072
Node: Exit Status131735
Node: Signals133519
Node: Shell Scripts136968
Node: Shell Builtin Commands139995
Node: Bourne Shell Builtins142033
Node: Bash Builtins165169
Node: Modifying Shell Behavior197168
Node: The Set Builtin197513
Node: The Shopt Builtin208457
Node: Special Builtins224464
Node: Shell Variables225443
Node: Bourne Shell Variables225880
Node: Bash Variables227984
Node: Bash Features262941
Node: Invoking Bash263954
Node: Bash Startup Files269967
Node: Interactive Shells275098
Node: What is an Interactive Shell?275509
Node: Is this Shell Interactive?276158
Node: Interactive Shell Behavior276973
Node: Bash Conditional Expressions280602
Node: Shell Arithmetic285244
Node: Aliases288205
Node: Arrays291099
Node: The Directory Stack297662
Node: Directory Stack Builtins298446
Node: Controlling the Prompt302706
Node: The Restricted Shell305671
Node: Bash POSIX Mode308281
Node: Shell Compatibility Mode324424
Node: Job Control332668
Node: Job Control Basics333128
Node: Job Control Builtins338130
Node: Job Control Variables343925
Node: Command Line Editing345081
Node: Introduction and Notation346752
Node: Readline Interaction348375
Node: Readline Bare Essentials349566
Node: Readline Movement Commands351355
Node: Readline Killing Commands352315
Node: Readline Arguments354236
Node: Searching355280
Node: Readline Init File357466
Node: Readline Init File Syntax358727
Node: Conditional Init Constructs382752
Node: Sample Init File386948
Node: Bindable Readline Commands390072
Node: Commands For Moving391276
Node: Commands For History393327
Node: Commands For Text398321
Node: Commands For Killing402299
Node: Numeric Arguments405003
Node: Commands For Completion406142
Node: Keyboard Macros410333
Node: Miscellaneous Commands411021
Node: Readline vi Mode417059
Node: Programmable Completion417966
Node: Programmable Completion Builtins425746
Node: A Programmable Completion Example436866
Node: Using History Interactively442114
Node: Bash History Facilities442798
Node: Bash History Builtins445803
Node: History Interaction450827
Node: Event Designators454447
Node: Word Designators455801
Node: Modifiers457561
Node: Installing Bash459369
Node: Basic Installation460506
Node: Compilers and Options464228
Node: Compiling For Multiple Architectures464969
Node: Installation Names466661
Node: Specifying the System Type468770
Node: Sharing Defaults469487
Node: Operation Controls470160
Node: Optional Features471118
Node: Reporting Bugs482337
Node: Major Differences From The Bourne Shell483671
Node: GNU Free Documentation License500520
Node: Indexes525697
Node: Builtin Index526151
Node: Reserved Word Index533252
Node: Variable Index535700
Node: Function Index552834
Node: Concept Index566555

End Tag Table