mirror of
https://https.git.savannah.gnu.org/git/bash.git
synced 2026-07-12 14:40:50 +02:00
more documentation updates; fix two issues when displaying readline completions; fix another use-after-free error with readline undo lists
This commit is contained in:
Chet Ramey
+141
-135
@@ -2,9 +2,9 @@ This is bashref.info, produced by makeinfo version 7.1 from
|
||||
bashref.texi.
|
||||
|
||||
This text is a brief description of the features that are present in the
|
||||
Bash shell (version 5.3, 29 November 2024).
|
||||
Bash shell (version 5.3, 12 December 2024).
|
||||
|
||||
This is Edition 5.3, last updated 29 November 2024, of ‘The GNU Bash
|
||||
This is Edition 5.3, last updated 12 December 2024, of ‘The GNU Bash
|
||||
Reference Manual’, for ‘Bash’, Version 5.3.
|
||||
|
||||
Copyright © 1988-2024 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, 29 November 2024). The Bash home page is
|
||||
Bash shell (version 5.3, 12 December 2024). The Bash home page is
|
||||
<http://www.gnu.org/software/bash/>.
|
||||
|
||||
This is Edition 5.3, last updated 29 November 2024, of ‘The GNU Bash
|
||||
This is Edition 5.3, last updated 12 December 2024, of ‘The GNU Bash
|
||||
Reference Manual’, for ‘Bash’, Version 5.3.
|
||||
|
||||
Bash contains features that appear in other popular shells, and some
|
||||
@@ -6201,9 +6201,13 @@ Variables::).
|
||||
|
||||
‘PIPESTATUS’
|
||||
An array variable (*note Arrays::) containing a list of exit status
|
||||
values from the processes in the most-recently-executed foreground
|
||||
values from the commands in the most-recently-executed foreground
|
||||
pipeline, which may consist of only a simple command (*note Shell
|
||||
Commands::).
|
||||
Commands::). Bash sets ‘PIPESTATUS’ after executing multi-element
|
||||
pipelines, timed and negated pipelines, simple commands, subshells
|
||||
created with the ‘(’ operator, the ‘[[’ and ‘((’ compound commands,
|
||||
and after error conditions that result in the shell aborting
|
||||
command execution.
|
||||
|
||||
‘POSIXLY_CORRECT’
|
||||
If this variable is in the environment when Bash starts, the shell
|
||||
@@ -8826,7 +8830,9 @@ Variable Settings
|
||||
list of possible completions that is displayed without
|
||||
modification. When set to a value greater than zero, Readline
|
||||
replaces common prefixes longer than this value with an
|
||||
ellipsis when displaying possible completions.
|
||||
ellipsis when displaying possible completions. If a
|
||||
completion begins with a period, and Readline is completing
|
||||
filenames, it uses three underscores instead of an ellipsis.
|
||||
|
||||
‘completion-query-items’
|
||||
The number of possible completions that determines when the
|
||||
@@ -12954,40 +12960,40 @@ D.3 Parameter and Variable Index
|
||||
* completion-prefix-display-length: Readline Init File Syntax.
|
||||
(line 122)
|
||||
* completion-query-items: Readline Init File Syntax.
|
||||
(line 129)
|
||||
(line 131)
|
||||
* COMPREPLY: Bash Variables. (line 277)
|
||||
* convert-meta: Readline Init File Syntax.
|
||||
(line 140)
|
||||
(line 142)
|
||||
* COPROC: Bash Variables. (line 283)
|
||||
* DIRSTACK: Bash Variables. (line 287)
|
||||
* disable-completion: Readline Init File Syntax.
|
||||
(line 152)
|
||||
(line 154)
|
||||
* echo-control-characters: Readline Init File Syntax.
|
||||
(line 157)
|
||||
(line 159)
|
||||
* editing-mode: Readline Init File Syntax.
|
||||
(line 162)
|
||||
(line 164)
|
||||
* EMACS: Bash Variables. (line 297)
|
||||
* emacs-mode-string: Readline Init File Syntax.
|
||||
(line 168)
|
||||
(line 170)
|
||||
* enable-active-region The: Readline Init File Syntax.
|
||||
(line 178)
|
||||
(line 180)
|
||||
* enable-bracketed-paste: Readline Init File Syntax.
|
||||
(line 191)
|
||||
(line 193)
|
||||
* enable-keypad: Readline Init File Syntax.
|
||||
(line 200)
|
||||
(line 202)
|
||||
* enable-meta-key: Readline Init File Syntax.
|
||||
(line 205)
|
||||
(line 207)
|
||||
* ENV: Bash Variables. (line 302)
|
||||
* EPOCHREALTIME: Bash Variables. (line 307)
|
||||
* EPOCHSECONDS: Bash Variables. (line 315)
|
||||
* EUID: Bash Variables. (line 322)
|
||||
* EXECIGNORE: Bash Variables. (line 326)
|
||||
* expand-tilde: Readline Init File Syntax.
|
||||
(line 215)
|
||||
(line 217)
|
||||
* FCEDIT: Bash Variables. (line 338)
|
||||
* FIGNORE: Bash Variables. (line 341)
|
||||
* force-meta-prefix: Readline Init File Syntax.
|
||||
(line 219)
|
||||
(line 221)
|
||||
* FUNCNAME: Bash Variables. (line 347)
|
||||
* FUNCNEST: Bash Variables. (line 364)
|
||||
* GLOBIGNORE: Bash Variables. (line 369)
|
||||
@@ -13000,15 +13006,15 @@ D.3 Parameter and Variable Index
|
||||
* HISTFILESIZE: Bash Variables. (line 465)
|
||||
* HISTIGNORE: Bash Variables. (line 476)
|
||||
* history-preserve-point: Readline Init File Syntax.
|
||||
(line 232)
|
||||
(line 234)
|
||||
* history-size: Readline Init File Syntax.
|
||||
(line 238)
|
||||
(line 240)
|
||||
* HISTSIZE: Bash Variables. (line 500)
|
||||
* HISTTIMEFORMAT: Bash Variables. (line 507)
|
||||
* HOME: Bourne Shell Variables.
|
||||
(line 13)
|
||||
* horizontal-scroll-mode: Readline Init File Syntax.
|
||||
(line 248)
|
||||
(line 250)
|
||||
* HOSTFILE: Bash Variables. (line 516)
|
||||
* HOSTNAME: Bash Variables. (line 527)
|
||||
* HOSTTYPE: Bash Variables. (line 530)
|
||||
@@ -13016,13 +13022,13 @@ D.3 Parameter and Variable Index
|
||||
(line 18)
|
||||
* IGNOREEOF: Bash Variables. (line 533)
|
||||
* input-meta: Readline Init File Syntax.
|
||||
(line 256)
|
||||
(line 258)
|
||||
* INPUTRC: Bash Variables. (line 542)
|
||||
* INSIDE_EMACS: Bash Variables. (line 546)
|
||||
* isearch-terminators: Readline Init File Syntax.
|
||||
(line 267)
|
||||
(line 269)
|
||||
* keymap: Readline Init File Syntax.
|
||||
(line 274)
|
||||
(line 276)
|
||||
* LANG: Creating Internationalized Scripts.
|
||||
(line 51)
|
||||
* LANG <1>: Bash Variables. (line 552)
|
||||
@@ -13044,15 +13050,15 @@ D.3 Parameter and Variable Index
|
||||
(line 29)
|
||||
* MAPFILE: Bash Variables. (line 609)
|
||||
* mark-modified-lines: Readline Init File Syntax.
|
||||
(line 304)
|
||||
(line 306)
|
||||
* mark-symlinked-directories: Readline Init File Syntax.
|
||||
(line 309)
|
||||
(line 311)
|
||||
* match-hidden-files: Readline Init File Syntax.
|
||||
(line 314)
|
||||
(line 316)
|
||||
* menu-complete-display-prefix: Readline Init File Syntax.
|
||||
(line 321)
|
||||
(line 323)
|
||||
* meta-flag: Readline Init File Syntax.
|
||||
(line 256)
|
||||
(line 258)
|
||||
* OLDPWD: Bash Variables. (line 613)
|
||||
* OPTARG: Bourne Shell Variables.
|
||||
(line 36)
|
||||
@@ -13061,61 +13067,61 @@ D.3 Parameter and Variable Index
|
||||
(line 40)
|
||||
* OSTYPE: Bash Variables. (line 621)
|
||||
* output-meta: Readline Init File Syntax.
|
||||
(line 326)
|
||||
(line 328)
|
||||
* page-completions: Readline Init File Syntax.
|
||||
(line 335)
|
||||
(line 337)
|
||||
* PATH: Bourne Shell Variables.
|
||||
(line 44)
|
||||
* PIPESTATUS: Bash Variables. (line 624)
|
||||
* POSIXLY_CORRECT: Bash Variables. (line 630)
|
||||
* PPID: Bash Variables. (line 640)
|
||||
* PROMPT_COMMAND: Bash Variables. (line 644)
|
||||
* PROMPT_DIRTRIM: Bash Variables. (line 650)
|
||||
* PS0: Bash Variables. (line 656)
|
||||
* POSIXLY_CORRECT: Bash Variables. (line 634)
|
||||
* PPID: Bash Variables. (line 644)
|
||||
* PROMPT_COMMAND: Bash Variables. (line 648)
|
||||
* PROMPT_DIRTRIM: Bash Variables. (line 654)
|
||||
* PS0: Bash Variables. (line 660)
|
||||
* PS1: Bourne Shell Variables.
|
||||
(line 53)
|
||||
* PS2: Bourne Shell Variables.
|
||||
(line 58)
|
||||
* PS3: Bash Variables. (line 661)
|
||||
* PS4: Bash Variables. (line 666)
|
||||
* PWD: Bash Variables. (line 674)
|
||||
* RANDOM: Bash Variables. (line 677)
|
||||
* READLINE_ARGUMENT: Bash Variables. (line 685)
|
||||
* READLINE_LINE: Bash Variables. (line 689)
|
||||
* READLINE_MARK: Bash Variables. (line 693)
|
||||
* READLINE_POINT: Bash Variables. (line 699)
|
||||
* REPLY: Bash Variables. (line 703)
|
||||
* PS3: Bash Variables. (line 665)
|
||||
* PS4: Bash Variables. (line 670)
|
||||
* PWD: Bash Variables. (line 678)
|
||||
* RANDOM: Bash Variables. (line 681)
|
||||
* READLINE_ARGUMENT: Bash Variables. (line 689)
|
||||
* READLINE_LINE: Bash Variables. (line 693)
|
||||
* READLINE_MARK: Bash Variables. (line 697)
|
||||
* READLINE_POINT: Bash Variables. (line 703)
|
||||
* REPLY: Bash Variables. (line 707)
|
||||
* revert-all-at-newline: Readline Init File Syntax.
|
||||
(line 348)
|
||||
(line 350)
|
||||
* search-ignore-case: Readline Init File Syntax.
|
||||
(line 355)
|
||||
* SECONDS: Bash Variables. (line 707)
|
||||
* SHELL: Bash Variables. (line 717)
|
||||
* SHELLOPTS: Bash Variables. (line 722)
|
||||
* SHLVL: Bash Variables. (line 731)
|
||||
(line 357)
|
||||
* SECONDS: Bash Variables. (line 711)
|
||||
* SHELL: Bash Variables. (line 721)
|
||||
* SHELLOPTS: Bash Variables. (line 726)
|
||||
* SHLVL: Bash Variables. (line 735)
|
||||
* show-all-if-ambiguous: Readline Init File Syntax.
|
||||
(line 360)
|
||||
(line 362)
|
||||
* show-all-if-unmodified: Readline Init File Syntax.
|
||||
(line 366)
|
||||
(line 368)
|
||||
* show-mode-in-prompt: Readline Init File Syntax.
|
||||
(line 375)
|
||||
(line 377)
|
||||
* skip-completed-text: Readline Init File Syntax.
|
||||
(line 381)
|
||||
* SRANDOM: Bash Variables. (line 736)
|
||||
(line 383)
|
||||
* SRANDOM: Bash Variables. (line 740)
|
||||
* TEXTDOMAIN: Creating Internationalized Scripts.
|
||||
(line 51)
|
||||
* TEXTDOMAINDIR: Creating Internationalized Scripts.
|
||||
(line 51)
|
||||
* TIMEFORMAT: Bash Variables. (line 745)
|
||||
* TMOUT: Bash Variables. (line 784)
|
||||
* TMPDIR: Bash Variables. (line 796)
|
||||
* UID: Bash Variables. (line 800)
|
||||
* TIMEFORMAT: Bash Variables. (line 749)
|
||||
* TMOUT: Bash Variables. (line 788)
|
||||
* TMPDIR: Bash Variables. (line 800)
|
||||
* UID: Bash Variables. (line 804)
|
||||
* vi-cmd-mode-string: Readline Init File Syntax.
|
||||
(line 394)
|
||||
(line 396)
|
||||
* vi-ins-mode-string: Readline Init File Syntax.
|
||||
(line 405)
|
||||
(line 407)
|
||||
* visible-stats: Readline Init File Syntax.
|
||||
(line 416)
|
||||
(line 418)
|
||||
|
||||
|
||||
File: bashref.info, Node: Function Index, Next: Concept Index, Prev: Variable Index, Up: Indexes
|
||||
@@ -13565,77 +13571,77 @@ Node: Special Builtins244596
|
||||
Node: Shell Variables245588
|
||||
Node: Bourne Shell Variables246025
|
||||
Node: Bash Variables248536
|
||||
Node: Bash Features286930
|
||||
Node: Invoking Bash287947
|
||||
Node: Bash Startup Files294376
|
||||
Node: Interactive Shells299621
|
||||
Node: What is an Interactive Shell?300032
|
||||
Node: Is this Shell Interactive?300697
|
||||
Node: Interactive Shell Behavior301524
|
||||
Node: Bash Conditional Expressions305288
|
||||
Node: Shell Arithmetic310502
|
||||
Node: Aliases313834
|
||||
Node: Arrays316971
|
||||
Node: The Directory Stack324058
|
||||
Node: Directory Stack Builtins324858
|
||||
Node: Controlling the Prompt329306
|
||||
Node: The Restricted Shell332194
|
||||
Node: Bash POSIX Mode335079
|
||||
Node: Shell Compatibility Mode353144
|
||||
Node: Job Control362154
|
||||
Node: Job Control Basics362614
|
||||
Node: Job Control Builtins368895
|
||||
Node: Job Control Variables375580
|
||||
Node: Command Line Editing376814
|
||||
Node: Introduction and Notation378520
|
||||
Node: Readline Interaction380875
|
||||
Node: Readline Bare Essentials382066
|
||||
Node: Readline Movement Commands383877
|
||||
Node: Readline Killing Commands384876
|
||||
Node: Readline Arguments386902
|
||||
Node: Searching387962
|
||||
Node: Readline Init File390208
|
||||
Node: Readline Init File Syntax391514
|
||||
Node: Conditional Init Constructs418200
|
||||
Node: Sample Init File422588
|
||||
Node: Bindable Readline Commands425712
|
||||
Node: Commands For Moving427253
|
||||
Node: Commands For History429624
|
||||
Node: Commands For Text435017
|
||||
Node: Commands For Killing439145
|
||||
Node: Numeric Arguments441936
|
||||
Node: Commands For Completion443091
|
||||
Node: Keyboard Macros448790
|
||||
Node: Miscellaneous Commands449494
|
||||
Node: Readline vi Mode456057
|
||||
Node: Programmable Completion457037
|
||||
Node: Programmable Completion Builtins465777
|
||||
Node: A Programmable Completion Example477517
|
||||
Node: Using History Interactively482865
|
||||
Node: Bash History Facilities483549
|
||||
Node: Bash History Builtins487287
|
||||
Node: History Interaction493761
|
||||
Node: Event Designators498714
|
||||
Node: Word Designators500295
|
||||
Node: Modifiers502602
|
||||
Node: Installing Bash504542
|
||||
Node: Basic Installation505661
|
||||
Node: Compilers and Options509540
|
||||
Node: Compiling For Multiple Architectures510293
|
||||
Node: Installation Names512049
|
||||
Node: Specifying the System Type514286
|
||||
Node: Sharing Defaults515035
|
||||
Node: Operation Controls515752
|
||||
Node: Optional Features516774
|
||||
Node: Reporting Bugs529157
|
||||
Node: Major Differences From The Bourne Shell530518
|
||||
Node: GNU Free Documentation License551941
|
||||
Node: Indexes577121
|
||||
Node: Builtin Index577575
|
||||
Node: Reserved Word Index584676
|
||||
Node: Variable Index587124
|
||||
Node: Function Index604540
|
||||
Node: Concept Index618538
|
||||
Node: Bash Features287234
|
||||
Node: Invoking Bash288251
|
||||
Node: Bash Startup Files294680
|
||||
Node: Interactive Shells299925
|
||||
Node: What is an Interactive Shell?300336
|
||||
Node: Is this Shell Interactive?301001
|
||||
Node: Interactive Shell Behavior301828
|
||||
Node: Bash Conditional Expressions305592
|
||||
Node: Shell Arithmetic310806
|
||||
Node: Aliases314138
|
||||
Node: Arrays317275
|
||||
Node: The Directory Stack324362
|
||||
Node: Directory Stack Builtins325162
|
||||
Node: Controlling the Prompt329610
|
||||
Node: The Restricted Shell332498
|
||||
Node: Bash POSIX Mode335383
|
||||
Node: Shell Compatibility Mode353448
|
||||
Node: Job Control362458
|
||||
Node: Job Control Basics362918
|
||||
Node: Job Control Builtins369199
|
||||
Node: Job Control Variables375884
|
||||
Node: Command Line Editing377118
|
||||
Node: Introduction and Notation378824
|
||||
Node: Readline Interaction381179
|
||||
Node: Readline Bare Essentials382370
|
||||
Node: Readline Movement Commands384181
|
||||
Node: Readline Killing Commands385180
|
||||
Node: Readline Arguments387206
|
||||
Node: Searching388266
|
||||
Node: Readline Init File390512
|
||||
Node: Readline Init File Syntax391818
|
||||
Node: Conditional Init Constructs418651
|
||||
Node: Sample Init File423039
|
||||
Node: Bindable Readline Commands426163
|
||||
Node: Commands For Moving427704
|
||||
Node: Commands For History430075
|
||||
Node: Commands For Text435468
|
||||
Node: Commands For Killing439596
|
||||
Node: Numeric Arguments442387
|
||||
Node: Commands For Completion443542
|
||||
Node: Keyboard Macros449241
|
||||
Node: Miscellaneous Commands449945
|
||||
Node: Readline vi Mode456508
|
||||
Node: Programmable Completion457488
|
||||
Node: Programmable Completion Builtins466228
|
||||
Node: A Programmable Completion Example477968
|
||||
Node: Using History Interactively483316
|
||||
Node: Bash History Facilities484000
|
||||
Node: Bash History Builtins487738
|
||||
Node: History Interaction494212
|
||||
Node: Event Designators499165
|
||||
Node: Word Designators500746
|
||||
Node: Modifiers503053
|
||||
Node: Installing Bash504993
|
||||
Node: Basic Installation506112
|
||||
Node: Compilers and Options509991
|
||||
Node: Compiling For Multiple Architectures510744
|
||||
Node: Installation Names512500
|
||||
Node: Specifying the System Type514737
|
||||
Node: Sharing Defaults515486
|
||||
Node: Operation Controls516203
|
||||
Node: Optional Features517225
|
||||
Node: Reporting Bugs529608
|
||||
Node: Major Differences From The Bourne Shell530969
|
||||
Node: GNU Free Documentation License552392
|
||||
Node: Indexes577572
|
||||
Node: Builtin Index578026
|
||||
Node: Reserved Word Index585127
|
||||
Node: Variable Index587575
|
||||
Node: Function Index604991
|
||||
Node: Concept Index618989
|
||||
|
||||
End Tag Table
|
||||
|
||||
|
||||
Reference in New Issue
Block a user