new BASH_MONOSECONDS, BASH_TRAPSIG variables; make checkwinsize work in subshells of interactive shells; fix for declare -f and function names containing `='

This commit is contained in:
Chet Ramey
2023-06-20 10:10:11 -04:00
parent b91488b51c
commit fc29a02404
24 changed files with 10412 additions and 10148 deletions
+174 -159
View File
@@ -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, 15 June 2023).
Bash shell (version 5.3, 16 June 2023).
This is Edition 5.3, last updated 15 June 2023, of 'The GNU Bash
This is Edition 5.3, last updated 16 June 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, 15 June 2023). The Bash home page is
Bash shell (version 5.3, 16 June 2023). The Bash home page is
<http://www.gnu.org/software/bash/>.
This is Edition 5.3, last updated 15 June 2023, of 'The GNU Bash
This is Edition 5.3, last updated 16 June 2023, of 'The GNU Bash
Reference Manual', for 'Bash', Version 5.3.
Bash contains features that appear in other popular shells, and some
@@ -5406,6 +5406,13 @@ Variables::).
A colon-separated list of directories in which the shell looks for
dynamically loadable builtins specified by the 'enable' command.
'BASH_MONOSECONDS'
Each time this variable is referenced, it expands to the value
returned by the system's monotonic clock, if one is available. If
there is no monotonic clock, this is equivalent to 'EPOCHSECONDS'.
If 'BASH_MONOSECONDS' is unset, it loses its special properties,
even if it is subsequently reset.
'BASH_REMATCH'
An array variable whose members are assigned by the '=~' binary
operator to the '[[' conditional command (*note Conditional
@@ -5427,6 +5434,12 @@ Variables::).
value is 0. If 'BASH_SUBSHELL' is unset, it loses its special
properties, even if it is subsequently reset.
'BASH_TRAPSIG'
Set to the signal number corresponding to the trap action being
executed during its execution. See the description of 'trap'
(*note Bourne Shell Builtins::) for information about signal
numbers and trap execution.
'BASH_VERSINFO'
A readonly array variable (*note Arrays::) whose members hold
version information for this instance of Bash. The values assigned
@@ -12193,12 +12206,14 @@ D.3 Parameter and Variable Index
* BASH_EXECUTION_STRING: Bash Variables. (line 122)
* BASH_LINENO: Bash Variables. (line 125)
* BASH_LOADABLES_PATH: Bash Variables. (line 133)
* BASH_REMATCH: Bash Variables. (line 137)
* BASH_SOURCE: Bash Variables. (line 145)
* BASH_SUBSHELL: Bash Variables. (line 152)
* BASH_VERSINFO: Bash Variables. (line 158)
* BASH_VERSION: Bash Variables. (line 181)
* BASH_XTRACEFD: Bash Variables. (line 184)
* BASH_MONOSECONDS: Bash Variables. (line 137)
* BASH_REMATCH: Bash Variables. (line 144)
* BASH_SOURCE: Bash Variables. (line 152)
* BASH_SUBSHELL: Bash Variables. (line 159)
* BASH_TRAPSIG: Bash Variables. (line 165)
* BASH_VERSINFO: Bash Variables. (line 171)
* BASH_VERSION: Bash Variables. (line 194)
* BASH_XTRACEFD: Bash Variables. (line 197)
* bell-style: Readline Init File Syntax.
(line 64)
* bind-tty-special-chars: Readline Init File Syntax.
@@ -12207,12 +12222,12 @@ D.3 Parameter and Variable Index
(line 76)
* CDPATH: Bourne Shell Variables.
(line 9)
* CHILD_MAX: Bash Variables. (line 195)
* CHILD_MAX: Bash Variables. (line 208)
* colored-completion-prefix: Readline Init File Syntax.
(line 81)
* colored-stats: Readline Init File Syntax.
(line 91)
* COLUMNS: Bash Variables. (line 202)
* COLUMNS: Bash Variables. (line 215)
* comment-begin: Readline Init File Syntax.
(line 97)
* completion-display-width: Readline Init File Syntax.
@@ -12225,25 +12240,25 @@ D.3 Parameter and Variable Index
(line 120)
* completion-query-items: Readline Init File Syntax.
(line 127)
* COMPREPLY: Bash Variables. (line 254)
* COMP_CWORD: Bash Variables. (line 208)
* COMP_KEY: Bash Variables. (line 237)
* COMP_LINE: Bash Variables. (line 214)
* COMP_POINT: Bash Variables. (line 219)
* COMP_TYPE: Bash Variables. (line 227)
* COMP_WORDBREAKS: Bash Variables. (line 241)
* COMP_WORDS: Bash Variables. (line 247)
* COMPREPLY: Bash Variables. (line 267)
* COMP_CWORD: Bash Variables. (line 221)
* COMP_KEY: Bash Variables. (line 250)
* COMP_LINE: Bash Variables. (line 227)
* COMP_POINT: Bash Variables. (line 232)
* COMP_TYPE: Bash Variables. (line 240)
* COMP_WORDBREAKS: Bash Variables. (line 254)
* COMP_WORDS: Bash Variables. (line 260)
* convert-meta: Readline Init File Syntax.
(line 138)
* COPROC: Bash Variables. (line 260)
* DIRSTACK: Bash Variables. (line 264)
* COPROC: Bash Variables. (line 273)
* DIRSTACK: Bash Variables. (line 277)
* disable-completion: Readline Init File Syntax.
(line 148)
* echo-control-characters: Readline Init File Syntax.
(line 153)
* editing-mode: Readline Init File Syntax.
(line 158)
* EMACS: Bash Variables. (line 274)
* EMACS: Bash Variables. (line 287)
* emacs-mode-string: Readline Init File Syntax.
(line 164)
* enable-active-region: Readline Init File Syntax.
@@ -12252,70 +12267,70 @@ D.3 Parameter and Variable Index
(line 187)
* enable-keypad: Readline Init File Syntax.
(line 196)
* ENV: Bash Variables. (line 279)
* EPOCHREALTIME: Bash Variables. (line 284)
* EPOCHSECONDS: Bash Variables. (line 292)
* EUID: Bash Variables. (line 299)
* EXECIGNORE: Bash Variables. (line 303)
* ENV: Bash Variables. (line 292)
* EPOCHREALTIME: Bash Variables. (line 297)
* EPOCHSECONDS: Bash Variables. (line 305)
* EUID: Bash Variables. (line 312)
* EXECIGNORE: Bash Variables. (line 316)
* expand-tilde: Readline Init File Syntax.
(line 207)
* FCEDIT: Bash Variables. (line 316)
* FIGNORE: Bash Variables. (line 320)
* FUNCNAME: Bash Variables. (line 326)
* FUNCNEST: Bash Variables. (line 343)
* GLOBIGNORE: Bash Variables. (line 348)
* GLOBSORT: Bash Variables. (line 355)
* GROUPS: Bash Variables. (line 381)
* histchars: Bash Variables. (line 387)
* HISTCMD: Bash Variables. (line 402)
* HISTCONTROL: Bash Variables. (line 408)
* HISTFILE: Bash Variables. (line 424)
* HISTFILESIZE: Bash Variables. (line 428)
* HISTIGNORE: Bash Variables. (line 439)
* FCEDIT: Bash Variables. (line 329)
* FIGNORE: Bash Variables. (line 333)
* FUNCNAME: Bash Variables. (line 339)
* FUNCNEST: Bash Variables. (line 356)
* GLOBIGNORE: Bash Variables. (line 361)
* GLOBSORT: Bash Variables. (line 368)
* GROUPS: Bash Variables. (line 394)
* histchars: Bash Variables. (line 400)
* HISTCMD: Bash Variables. (line 415)
* HISTCONTROL: Bash Variables. (line 421)
* HISTFILE: Bash Variables. (line 437)
* HISTFILESIZE: Bash Variables. (line 441)
* HISTIGNORE: Bash Variables. (line 452)
* history-preserve-point: Readline Init File Syntax.
(line 211)
* history-size: Readline Init File Syntax.
(line 217)
* HISTSIZE: Bash Variables. (line 459)
* HISTTIMEFORMAT: Bash Variables. (line 466)
* HISTSIZE: Bash Variables. (line 472)
* HISTTIMEFORMAT: Bash Variables. (line 479)
* HOME: Bourne Shell Variables.
(line 13)
* horizontal-scroll-mode: Readline Init File Syntax.
(line 226)
* HOSTFILE: Bash Variables. (line 474)
* HOSTNAME: Bash Variables. (line 485)
* HOSTTYPE: Bash Variables. (line 488)
* HOSTFILE: Bash Variables. (line 487)
* HOSTNAME: Bash Variables. (line 498)
* HOSTTYPE: Bash Variables. (line 501)
* IFS: Bourne Shell Variables.
(line 18)
* IGNOREEOF: Bash Variables. (line 491)
* IGNOREEOF: Bash Variables. (line 504)
* input-meta: Readline Init File Syntax.
(line 235)
* INPUTRC: Bash Variables. (line 501)
* INSIDE_EMACS: Bash Variables. (line 505)
* INPUTRC: Bash Variables. (line 514)
* INSIDE_EMACS: Bash Variables. (line 518)
* isearch-terminators: Readline Init File Syntax.
(line 245)
* keymap: Readline Init File Syntax.
(line 252)
* LANG: Creating Internationalized Scripts.
(line 51)
* LANG <1>: Bash Variables. (line 511)
* LC_ALL: Bash Variables. (line 515)
* LC_COLLATE: Bash Variables. (line 519)
* LC_CTYPE: Bash Variables. (line 526)
* LANG <1>: Bash Variables. (line 524)
* LC_ALL: Bash Variables. (line 528)
* LC_COLLATE: Bash Variables. (line 532)
* LC_CTYPE: Bash Variables. (line 539)
* LC_MESSAGES: Creating Internationalized Scripts.
(line 51)
* LC_MESSAGES <1>: Bash Variables. (line 531)
* LC_NUMERIC: Bash Variables. (line 535)
* LC_TIME: Bash Variables. (line 539)
* LINENO: Bash Variables. (line 543)
* LINES: Bash Variables. (line 548)
* MACHTYPE: Bash Variables. (line 554)
* LC_MESSAGES <1>: Bash Variables. (line 544)
* LC_NUMERIC: Bash Variables. (line 548)
* LC_TIME: Bash Variables. (line 552)
* LINENO: Bash Variables. (line 556)
* LINES: Bash Variables. (line 561)
* MACHTYPE: Bash Variables. (line 567)
* MAIL: Bourne Shell Variables.
(line 22)
* MAILCHECK: Bash Variables. (line 558)
* MAILCHECK: Bash Variables. (line 571)
* MAILPATH: Bourne Shell Variables.
(line 27)
* MAPFILE: Bash Variables. (line 566)
* MAPFILE: Bash Variables. (line 579)
* mark-modified-lines: Readline Init File Syntax.
(line 282)
* mark-symlinked-directories: Readline Init File Syntax.
@@ -12326,46 +12341,46 @@ D.3 Parameter and Variable Index
(line 299)
* meta-flag: Readline Init File Syntax.
(line 235)
* OLDPWD: Bash Variables. (line 570)
* OLDPWD: Bash Variables. (line 583)
* OPTARG: Bourne Shell Variables.
(line 34)
* OPTERR: Bash Variables. (line 573)
* OPTERR: Bash Variables. (line 586)
* OPTIND: Bourne Shell Variables.
(line 38)
* OSTYPE: Bash Variables. (line 577)
* OSTYPE: Bash Variables. (line 590)
* output-meta: Readline Init File Syntax.
(line 304)
* page-completions: Readline Init File Syntax.
(line 312)
* PATH: Bourne Shell Variables.
(line 42)
* PIPESTATUS: Bash Variables. (line 580)
* POSIXLY_CORRECT: Bash Variables. (line 585)
* PPID: Bash Variables. (line 595)
* PROMPT_COMMAND: Bash Variables. (line 599)
* PROMPT_DIRTRIM: Bash Variables. (line 605)
* PS0: Bash Variables. (line 611)
* PIPESTATUS: Bash Variables. (line 593)
* POSIXLY_CORRECT: Bash Variables. (line 598)
* PPID: Bash Variables. (line 608)
* PROMPT_COMMAND: Bash Variables. (line 612)
* PROMPT_DIRTRIM: Bash Variables. (line 618)
* PS0: Bash Variables. (line 624)
* PS1: Bourne Shell Variables.
(line 48)
* PS2: Bourne Shell Variables.
(line 53)
* PS3: Bash Variables. (line 616)
* PS4: Bash Variables. (line 621)
* PWD: Bash Variables. (line 629)
* RANDOM: Bash Variables. (line 632)
* READLINE_ARGUMENT: Bash Variables. (line 638)
* READLINE_LINE: Bash Variables. (line 642)
* READLINE_MARK: Bash Variables. (line 646)
* READLINE_POINT: Bash Variables. (line 652)
* REPLY: Bash Variables. (line 656)
* PS3: Bash Variables. (line 629)
* PS4: Bash Variables. (line 634)
* PWD: Bash Variables. (line 642)
* RANDOM: Bash Variables. (line 645)
* READLINE_ARGUMENT: Bash Variables. (line 651)
* READLINE_LINE: Bash Variables. (line 655)
* READLINE_MARK: Bash Variables. (line 659)
* READLINE_POINT: Bash Variables. (line 665)
* REPLY: Bash Variables. (line 669)
* revert-all-at-newline: Readline Init File Syntax.
(line 322)
* search-ignore-case: Readline Init File Syntax.
(line 329)
* SECONDS: Bash Variables. (line 659)
* SHELL: Bash Variables. (line 668)
* SHELLOPTS: Bash Variables. (line 673)
* SHLVL: Bash Variables. (line 682)
* SECONDS: Bash Variables. (line 672)
* SHELL: Bash Variables. (line 681)
* SHELLOPTS: Bash Variables. (line 686)
* SHLVL: Bash Variables. (line 695)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 334)
* show-all-if-unmodified: Readline Init File Syntax.
@@ -12374,15 +12389,15 @@ D.3 Parameter and Variable Index
(line 349)
* skip-completed-text: Readline Init File Syntax.
(line 355)
* SRANDOM: Bash Variables. (line 687)
* SRANDOM: Bash Variables. (line 700)
* TEXTDOMAIN: Creating Internationalized Scripts.
(line 51)
* TEXTDOMAINDIR: Creating Internationalized Scripts.
(line 51)
* TIMEFORMAT: Bash Variables. (line 696)
* TMOUT: Bash Variables. (line 734)
* TMPDIR: Bash Variables. (line 746)
* UID: Bash Variables. (line 750)
* TIMEFORMAT: Bash Variables. (line 709)
* TMOUT: Bash Variables. (line 747)
* TMPDIR: Bash Variables. (line 759)
* UID: Bash Variables. (line 763)
* vi-cmd-mode-string: Readline Init File Syntax.
(line 368)
* vi-ins-mode-string: Readline Init File Syntax.
@@ -12834,77 +12849,77 @@ Node: Special Builtins223181
Node: Shell Variables224157
Node: Bourne Shell Variables224591
Node: Bash Variables226692
Node: Bash Features260752
Node: Invoking Bash261762
Node: Bash Startup Files267772
Node: Interactive Shells272900
Node: What is an Interactive Shell?273308
Node: Is this Shell Interactive?273954
Node: Interactive Shell Behavior274766
Node: Bash Conditional Expressions278392
Node: Shell Arithmetic283031
Node: Aliases285989
Node: Arrays288880
Node: The Directory Stack295440
Node: Directory Stack Builtins296221
Node: Controlling the Prompt300478
Node: The Restricted Shell303440
Node: Bash POSIX Mode306047
Node: Shell Compatibility Mode321837
Node: Job Control330078
Node: Job Control Basics330535
Node: Job Control Builtins335534
Node: Job Control Variables341326
Node: Command Line Editing342479
Node: Introduction and Notation344147
Node: Readline Interaction345767
Node: Readline Bare Essentials346955
Node: Readline Movement Commands348741
Node: Readline Killing Commands349698
Node: Readline Arguments351616
Node: Searching352657
Node: Readline Init File354840
Node: Readline Init File Syntax356098
Node: Conditional Init Constructs379886
Node: Sample Init File384079
Node: Bindable Readline Commands387200
Node: Commands For Moving388401
Node: Commands For History390449
Node: Commands For Text395440
Node: Commands For Killing399086
Node: Numeric Arguments402116
Node: Commands For Completion403252
Node: Keyboard Macros407440
Node: Miscellaneous Commands408125
Node: Readline vi Mode414160
Node: Programmable Completion415064
Node: Programmable Completion Builtins422841
Node: A Programmable Completion Example433958
Node: Using History Interactively439203
Node: Bash History Facilities439884
Node: Bash History Builtins442886
Node: History Interaction447907
Node: Event Designators451524
Node: Word Designators452875
Node: Modifiers454632
Node: Installing Bash456437
Node: Basic Installation457571
Node: Compilers and Options461290
Node: Compiling For Multiple Architectures462028
Node: Installation Names463717
Node: Specifying the System Type465823
Node: Sharing Defaults466537
Node: Operation Controls467207
Node: Optional Features468162
Node: Reporting Bugs479378
Node: Major Differences From The Bourne Shell480709
Node: GNU Free Documentation License497555
Node: Indexes522729
Node: Builtin Index523180
Node: Reserved Word Index530278
Node: Variable Index532723
Node: Function Index549708
Node: Concept Index563489
Node: Bash Features261344
Node: Invoking Bash262354
Node: Bash Startup Files268364
Node: Interactive Shells273492
Node: What is an Interactive Shell?273900
Node: Is this Shell Interactive?274546
Node: Interactive Shell Behavior275358
Node: Bash Conditional Expressions278984
Node: Shell Arithmetic283623
Node: Aliases286581
Node: Arrays289472
Node: The Directory Stack296032
Node: Directory Stack Builtins296813
Node: Controlling the Prompt301070
Node: The Restricted Shell304032
Node: Bash POSIX Mode306639
Node: Shell Compatibility Mode322429
Node: Job Control330670
Node: Job Control Basics331127
Node: Job Control Builtins336126
Node: Job Control Variables341918
Node: Command Line Editing343071
Node: Introduction and Notation344739
Node: Readline Interaction346359
Node: Readline Bare Essentials347547
Node: Readline Movement Commands349333
Node: Readline Killing Commands350290
Node: Readline Arguments352208
Node: Searching353249
Node: Readline Init File355432
Node: Readline Init File Syntax356690
Node: Conditional Init Constructs380478
Node: Sample Init File384671
Node: Bindable Readline Commands387792
Node: Commands For Moving388993
Node: Commands For History391041
Node: Commands For Text396032
Node: Commands For Killing399678
Node: Numeric Arguments402708
Node: Commands For Completion403844
Node: Keyboard Macros408032
Node: Miscellaneous Commands408717
Node: Readline vi Mode414752
Node: Programmable Completion415656
Node: Programmable Completion Builtins423433
Node: A Programmable Completion Example434550
Node: Using History Interactively439795
Node: Bash History Facilities440476
Node: Bash History Builtins443478
Node: History Interaction448499
Node: Event Designators452116
Node: Word Designators453467
Node: Modifiers455224
Node: Installing Bash457029
Node: Basic Installation458163
Node: Compilers and Options461882
Node: Compiling For Multiple Architectures462620
Node: Installation Names464309
Node: Specifying the System Type466415
Node: Sharing Defaults467129
Node: Operation Controls467799
Node: Optional Features468754
Node: Reporting Bugs479970
Node: Major Differences From The Bourne Shell481301
Node: GNU Free Documentation License498147
Node: Indexes523321
Node: Builtin Index523772
Node: Reserved Word Index530870
Node: Variable Index533315
Node: Function Index550446
Node: Concept Index564227

End Tag Table