commit bash-20110415 snapshot

This commit is contained in:
Chet Ramey
2011-12-29 13:06:34 -05:00
parent af32e54dd7
commit f6da9f8595
36 changed files with 5132 additions and 4847 deletions
+214 -210
View File
@@ -2,9 +2,9 @@ This is bashref.info, produced by makeinfo version 4.13 from
/Users/chet/src/bash/src/doc/bashref.texi.
This text is a brief description of the features that are present in
the Bash shell (version 4.2, 28 December 2010).
the Bash shell (version 4.2, 11 April 2011).
This is Edition 4.2, last updated 28 December 2010, of `The GNU Bash
This is Edition 4.2, last updated 11 April 2011, of `The GNU Bash
Reference Manual', for `Bash', Version 4.2.
Copyright (C) 1988-2011 Free Software Foundation, Inc.
@@ -38,9 +38,9 @@ Bash Features
*************
This text is a brief description of the features that are present in
the Bash shell (version 4.2, 28 December 2010).
the Bash shell (version 4.2, 11 April 2011).
This is Edition 4.2, last updated 28 December 2010, of `The GNU Bash
This is Edition 4.2, last updated 11 April 2011, of `The GNU Bash
Reference Manual', for `Bash', Version 4.2.
Bash contains features that appear in other popular shells, and some
@@ -1356,7 +1356,7 @@ Brace expansion is a mechanism by which arbitrary strings may be
generated. This mechanism is similar to FILENAME EXPANSION (*note
Filename Expansion::), but the file names generated need not exist.
Patterns to be brace expanded take the form of an optional PREAMBLE,
followed by either a series of comma-separated strings or a seqeunce
followed by either a series of comma-separated strings or a sequence
expression between a pair of braces, followed by an optional POSTSCRIPT.
The preamble is prefixed to each string contained within the braces, and
the postscript is then appended to each resulting string, expanding left
@@ -2022,6 +2022,7 @@ error:
Of the two forms, the first is preferred. This is semantically
equivalent to
>WORD 2>&1
(see Duplicating File Descriptors below).
3.6.5 Appending Standard Output and Standard Error
--------------------------------------------------
@@ -2034,6 +2035,7 @@ file whose name is the expansion of WORD.
&>>WORD
This is semantically equivalent to
>>WORD 2>&1
(see Duplicating File Descriptors below).
3.6.6 Here Documents
--------------------
@@ -4330,8 +4332,9 @@ Variables::).
`${BASH_SOURCE[$i+1]}'
`BASH_SUBSHELL'
Incremented by one each time a subshell or subshell environment is
spawned. The initial value is 0.
Incremented by one within each subshell or subshell environment
when the shell begins executing in that environment. The initial
value is 0.
`BASH_VERSINFO'
A readonly array variable (*note Arrays::) whose members hold
@@ -5535,10 +5538,7 @@ assigned to using the syntax
name[SUBSCRIPT]=VALUE
The SUBSCRIPT is treated as an arithmetic expression that must evaluate
to a number. If SUBSCRIPT evaluates to a number less than zero, it is
used as an offset from one greater than the array's maximum index (so a
subcript of -1 refers to the last element of the array). To explicitly
declare an array, use
to a number. To explicitly declare an array, use
declare -a NAME
The syntax
declare -a NAME[SUBSCRIPT]
@@ -5582,7 +5582,11 @@ expansion of the special parameters `@' and `*'.
`${#name['SUBSCRIPT`]}' expands to the length of `${name['SUBSCRIPT`]}'.
If SUBSCRIPT is `@' or `*', the expansion is the number of elements in
the array. Referencing an array variable without a subscript is
equivalent to referencing with a subscript of 0.
equivalent to referencing with a subscript of 0. If the SUBSCRIPT used
to reference an element of an indexed array evaluates to a number less
than zero, it is used as an offset from one greater than the array's
maximum index (so a subcript of -1 refers to the last element of the
array).
An array variable is considered set if a subscript has been assigned
a value. The null string is a valid value.
@@ -10053,9 +10057,9 @@ D.3 Parameter and Variable Index
* BASH_REMATCH: Bash Variables. (line 86)
* BASH_SOURCE: Bash Variables. (line 94)
* BASH_SUBSHELL: Bash Variables. (line 101)
* BASH_VERSINFO: Bash Variables. (line 105)
* BASH_VERSION: Bash Variables. (line 129)
* BASH_XTRACEFD: Bash Variables. (line 132)
* BASH_VERSINFO: Bash Variables. (line 106)
* BASH_VERSION: Bash Variables. (line 130)
* BASH_XTRACEFD: Bash Variables. (line 133)
* BASHOPTS: Bash Variables. (line 16)
* BASHPID: Bash Variables. (line 25)
* bell-style: Readline Init File Syntax.
@@ -10064,16 +10068,16 @@ D.3 Parameter and Variable Index
(line 45)
* CDPATH: Bourne Shell Variables.
(line 9)
* COLUMNS: Bash Variables. (line 143)
* COLUMNS: Bash Variables. (line 144)
* comment-begin: Readline Init File Syntax.
(line 50)
* COMP_CWORD: Bash Variables. (line 148)
* COMP_KEY: Bash Variables. (line 177)
* COMP_LINE: Bash Variables. (line 154)
* COMP_POINT: Bash Variables. (line 159)
* COMP_TYPE: Bash Variables. (line 167)
* COMP_WORDBREAKS: Bash Variables. (line 181)
* COMP_WORDS: Bash Variables. (line 187)
* COMP_CWORD: Bash Variables. (line 149)
* COMP_KEY: Bash Variables. (line 178)
* COMP_LINE: Bash Variables. (line 155)
* COMP_POINT: Bash Variables. (line 160)
* COMP_TYPE: Bash Variables. (line 168)
* COMP_WORDBREAKS: Bash Variables. (line 182)
* COMP_WORDS: Bash Variables. (line 188)
* completion-display-width: Readline Init File Syntax.
(line 55)
* completion-ignore-case: Readline Init File Syntax.
@@ -10084,73 +10088,73 @@ D.3 Parameter and Variable Index
(line 73)
* completion-query-items: Readline Init File Syntax.
(line 80)
* COMPREPLY: Bash Variables. (line 195)
* COMPREPLY: Bash Variables. (line 196)
* convert-meta: Readline Init File Syntax.
(line 90)
* COPROC: Bash Variables. (line 200)
* DIRSTACK: Bash Variables. (line 204)
* COPROC: Bash Variables. (line 201)
* DIRSTACK: Bash Variables. (line 205)
* disable-completion: Readline Init File Syntax.
(line 96)
* editing-mode: Readline Init File Syntax.
(line 101)
* EMACS: Bash Variables. (line 214)
* EMACS: Bash Variables. (line 215)
* enable-keypad: Readline Init File Syntax.
(line 112)
* ENV: Bash Variables. (line 219)
* EUID: Bash Variables. (line 223)
* ENV: Bash Variables. (line 220)
* EUID: Bash Variables. (line 224)
* expand-tilde: Readline Init File Syntax.
(line 123)
* FCEDIT: Bash Variables. (line 227)
* FIGNORE: Bash Variables. (line 231)
* FUNCNAME: Bash Variables. (line 237)
* FUNCNEST: Bash Variables. (line 255)
* GLOBIGNORE: Bash Variables. (line 260)
* GROUPS: Bash Variables. (line 266)
* histchars: Bash Variables. (line 272)
* HISTCMD: Bash Variables. (line 287)
* HISTCONTROL: Bash Variables. (line 292)
* HISTFILE: Bash Variables. (line 308)
* HISTFILESIZE: Bash Variables. (line 312)
* HISTIGNORE: Bash Variables. (line 320)
* FCEDIT: Bash Variables. (line 228)
* FIGNORE: Bash Variables. (line 232)
* FUNCNAME: Bash Variables. (line 238)
* FUNCNEST: Bash Variables. (line 256)
* GLOBIGNORE: Bash Variables. (line 261)
* GROUPS: Bash Variables. (line 267)
* histchars: Bash Variables. (line 273)
* HISTCMD: Bash Variables. (line 288)
* HISTCONTROL: Bash Variables. (line 293)
* HISTFILE: Bash Variables. (line 309)
* HISTFILESIZE: Bash Variables. (line 313)
* HISTIGNORE: Bash Variables. (line 321)
* history-preserve-point: Readline Init File Syntax.
(line 127)
* history-size: Readline Init File Syntax.
(line 133)
* HISTSIZE: Bash Variables. (line 339)
* HISTTIMEFORMAT: Bash Variables. (line 343)
* HISTSIZE: Bash Variables. (line 340)
* HISTTIMEFORMAT: Bash Variables. (line 344)
* HOME: Bourne Shell Variables.
(line 13)
* horizontal-scroll-mode: Readline Init File Syntax.
(line 138)
* HOSTFILE: Bash Variables. (line 352)
* HOSTNAME: Bash Variables. (line 363)
* HOSTTYPE: Bash Variables. (line 366)
* HOSTFILE: Bash Variables. (line 353)
* HOSTNAME: Bash Variables. (line 364)
* HOSTTYPE: Bash Variables. (line 367)
* IFS: Bourne Shell Variables.
(line 18)
* IGNOREEOF: Bash Variables. (line 369)
* IGNOREEOF: Bash Variables. (line 370)
* input-meta: Readline Init File Syntax.
(line 145)
* INPUTRC: Bash Variables. (line 379)
* INPUTRC: Bash Variables. (line 380)
* isearch-terminators: Readline Init File Syntax.
(line 152)
* keymap: Readline Init File Syntax.
(line 159)
* LANG: Bash Variables. (line 383)
* LC_ALL: Bash Variables. (line 387)
* LC_COLLATE: Bash Variables. (line 391)
* LC_CTYPE: Bash Variables. (line 398)
* LANG: Bash Variables. (line 384)
* LC_ALL: Bash Variables. (line 388)
* LC_COLLATE: Bash Variables. (line 392)
* LC_CTYPE: Bash Variables. (line 399)
* LC_MESSAGES <1>: Locale Translation. (line 11)
* LC_MESSAGES: Bash Variables. (line 403)
* LC_NUMERIC: Bash Variables. (line 407)
* LINENO: Bash Variables. (line 411)
* LINES: Bash Variables. (line 415)
* MACHTYPE: Bash Variables. (line 420)
* LC_MESSAGES: Bash Variables. (line 404)
* LC_NUMERIC: Bash Variables. (line 408)
* LINENO: Bash Variables. (line 412)
* LINES: Bash Variables. (line 416)
* MACHTYPE: Bash Variables. (line 421)
* MAIL: Bourne Shell Variables.
(line 22)
* MAILCHECK: Bash Variables. (line 424)
* MAILCHECK: Bash Variables. (line 425)
* MAILPATH: Bourne Shell Variables.
(line 27)
* MAPFILE: Bash Variables. (line 432)
* MAPFILE: Bash Variables. (line 433)
* mark-modified-lines: Readline Init File Syntax.
(line 172)
* mark-symlinked-directories: Readline Init File Syntax.
@@ -10161,41 +10165,41 @@ D.3 Parameter and Variable Index
(line 189)
* meta-flag: Readline Init File Syntax.
(line 145)
* OLDPWD: Bash Variables. (line 436)
* OLDPWD: Bash Variables. (line 437)
* OPTARG: Bourne Shell Variables.
(line 34)
* OPTERR: Bash Variables. (line 439)
* OPTERR: Bash Variables. (line 440)
* OPTIND: Bourne Shell Variables.
(line 38)
* OSTYPE: Bash Variables. (line 443)
* OSTYPE: Bash Variables. (line 444)
* output-meta: Readline Init File Syntax.
(line 194)
* page-completions: Readline Init File Syntax.
(line 199)
* PATH: Bourne Shell Variables.
(line 42)
* PIPESTATUS: Bash Variables. (line 446)
* POSIXLY_CORRECT: Bash Variables. (line 451)
* PPID: Bash Variables. (line 460)
* PROMPT_COMMAND: Bash Variables. (line 464)
* PROMPT_DIRTRIM: Bash Variables. (line 468)
* PIPESTATUS: Bash Variables. (line 447)
* POSIXLY_CORRECT: Bash Variables. (line 452)
* PPID: Bash Variables. (line 461)
* PROMPT_COMMAND: Bash Variables. (line 465)
* PROMPT_DIRTRIM: Bash Variables. (line 469)
* PS1: Bourne Shell Variables.
(line 48)
* PS2: Bourne Shell Variables.
(line 53)
* PS3: Bash Variables. (line 474)
* PS4: Bash Variables. (line 479)
* PWD: Bash Variables. (line 485)
* RANDOM: Bash Variables. (line 488)
* READLINE_LINE: Bash Variables. (line 493)
* READLINE_POINT: Bash Variables. (line 497)
* REPLY: Bash Variables. (line 501)
* PS3: Bash Variables. (line 475)
* PS4: Bash Variables. (line 480)
* PWD: Bash Variables. (line 486)
* RANDOM: Bash Variables. (line 489)
* READLINE_LINE: Bash Variables. (line 494)
* READLINE_POINT: Bash Variables. (line 498)
* REPLY: Bash Variables. (line 502)
* revert-all-at-newline: Readline Init File Syntax.
(line 209)
* SECONDS: Bash Variables. (line 504)
* SHELL: Bash Variables. (line 510)
* SHELLOPTS: Bash Variables. (line 515)
* SHLVL: Bash Variables. (line 524)
* SECONDS: Bash Variables. (line 505)
* SHELL: Bash Variables. (line 511)
* SHELLOPTS: Bash Variables. (line 516)
* SHLVL: Bash Variables. (line 525)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 215)
* show-all-if-unmodified: Readline Init File Syntax.
@@ -10204,10 +10208,10 @@ D.3 Parameter and Variable Index
(line 230)
* TEXTDOMAIN: Locale Translation. (line 11)
* TEXTDOMAINDIR: Locale Translation. (line 11)
* TIMEFORMAT: Bash Variables. (line 529)
* TMOUT: Bash Variables. (line 567)
* TMPDIR: Bash Variables. (line 579)
* UID: Bash Variables. (line 583)
* TIMEFORMAT: Bash Variables. (line 530)
* TMOUT: Bash Variables. (line 568)
* TMPDIR: Bash Variables. (line 580)
* UID: Bash Variables. (line 584)
* visible-stats: Readline Init File Syntax.
(line 243)
@@ -10478,133 +10482,133 @@ D.5 Concept Index

Tag Table:
Node: Top1346
Node: Introduction3185
Node: What is Bash?3413
Node: What is a shell?4526
Node: Definitions7066
Node: Basic Shell Features9984
Node: Shell Syntax11203
Node: Shell Operation12233
Node: Quoting13527
Node: Escape Character14830
Node: Single Quotes15315
Node: Double Quotes15663
Node: ANSI-C Quoting16788
Node: Locale Translation18032
Node: Comments18928
Node: Shell Commands19546
Node: Simple Commands20418
Node: Pipelines21049
Node: Lists23743
Node: Compound Commands25472
Node: Looping Constructs26276
Node: Conditional Constructs28735
Node: Command Grouping36880
Node: Coprocesses38359
Node: GNU Parallel40024
Node: Shell Functions42492
Node: Shell Parameters47436
Node: Positional Parameters49852
Node: Special Parameters50752
Node: Shell Expansions53716
Node: Brace Expansion55641
Node: Tilde Expansion58396
Node: Shell Parameter Expansion60747
Node: Command Substitution69882
Node: Arithmetic Expansion71215
Node: Process Substitution72065
Node: Word Splitting73115
Node: Filename Expansion74738
Node: Pattern Matching76877
Node: Quote Removal80516
Node: Redirections80811
Node: Executing Commands89434
Node: Simple Command Expansion90104
Node: Command Search and Execution92034
Node: Command Execution Environment94371
Node: Environment97357
Node: Exit Status99017
Node: Signals100638
Node: Shell Scripts102606
Node: Shell Builtin Commands105124
Node: Bourne Shell Builtins107152
Node: Bash Builtins125246
Node: Modifying Shell Behavior151455
Node: The Set Builtin151800
Node: The Shopt Builtin161334
Node: Special Builtins173508
Node: Shell Variables174487
Node: Bourne Shell Variables174927
Node: Bash Variables176954
Node: Bash Features201863
Node: Invoking Bash202746
Node: Bash Startup Files208510
Node: Interactive Shells213531
Node: What is an Interactive Shell?213941
Node: Is this Shell Interactive?214590
Node: Interactive Shell Behavior215405
Node: Bash Conditional Expressions218685
Node: Shell Arithmetic222474
Node: Aliases225233
Node: Arrays227805
Node: The Directory Stack231974
Node: Directory Stack Builtins232688
Node: Printing a Prompt235580
Node: The Restricted Shell238332
Node: Bash POSIX Mode240164
Node: Job Control248825
Node: Job Control Basics249285
Node: Job Control Builtins254002
Node: Job Control Variables258366
Node: Command Line Editing259524
Node: Introduction and Notation261091
Node: Readline Interaction262713
Node: Readline Bare Essentials263904
Node: Readline Movement Commands265693
Node: Readline Killing Commands266658
Node: Readline Arguments268578
Node: Searching269622
Node: Readline Init File271808
Node: Readline Init File Syntax272955
Node: Conditional Init Constructs288297
Node: Sample Init File290830
Node: Bindable Readline Commands293947
Node: Commands For Moving295154
Node: Commands For History296298
Node: Commands For Text299733
Node: Commands For Killing302406
Node: Numeric Arguments304863
Node: Commands For Completion306002
Node: Keyboard Macros310194
Node: Miscellaneous Commands310765
Node: Readline vi Mode316571
Node: Programmable Completion317478
Node: Programmable Completion Builtins324688
Node: Using History Interactively333824
Node: Bash History Facilities334508
Node: Bash History Builtins337422
Node: History Interaction341279
Node: Event Designators343984
Node: Word Designators345206
Node: Modifiers346845
Node: Installing Bash348249
Node: Basic Installation349386
Node: Compilers and Options352078
Node: Compiling For Multiple Architectures352819
Node: Installation Names354483
Node: Specifying the System Type355301
Node: Sharing Defaults356017
Node: Operation Controls356690
Node: Optional Features357648
Node: Reporting Bugs367216
Node: Major Differences From The Bourne Shell368417
Node: GNU Free Documentation License385104
Node: Indexes410300
Node: Builtin Index410754
Node: Reserved Word Index417581
Node: Variable Index420029
Node: Function Index433124
Node: Concept Index440133
Node: Top1340
Node: Introduction3173
Node: What is Bash?3401
Node: What is a shell?4514
Node: Definitions7054
Node: Basic Shell Features9972
Node: Shell Syntax11191
Node: Shell Operation12221
Node: Quoting13515
Node: Escape Character14818
Node: Single Quotes15303
Node: Double Quotes15651
Node: ANSI-C Quoting16776
Node: Locale Translation18020
Node: Comments18916
Node: Shell Commands19534
Node: Simple Commands20406
Node: Pipelines21037
Node: Lists23731
Node: Compound Commands25460
Node: Looping Constructs26264
Node: Conditional Constructs28723
Node: Command Grouping36868
Node: Coprocesses38347
Node: GNU Parallel40012
Node: Shell Functions42480
Node: Shell Parameters47424
Node: Positional Parameters49840
Node: Special Parameters50740
Node: Shell Expansions53704
Node: Brace Expansion55629
Node: Tilde Expansion58384
Node: Shell Parameter Expansion60735
Node: Command Substitution69870
Node: Arithmetic Expansion71203
Node: Process Substitution72053
Node: Word Splitting73103
Node: Filename Expansion74726
Node: Pattern Matching76865
Node: Quote Removal80504
Node: Redirections80799
Node: Executing Commands89512
Node: Simple Command Expansion90182
Node: Command Search and Execution92112
Node: Command Execution Environment94449
Node: Environment97435
Node: Exit Status99095
Node: Signals100716
Node: Shell Scripts102684
Node: Shell Builtin Commands105202
Node: Bourne Shell Builtins107230
Node: Bash Builtins125324
Node: Modifying Shell Behavior151533
Node: The Set Builtin151878
Node: The Shopt Builtin161412
Node: Special Builtins173586
Node: Shell Variables174565
Node: Bourne Shell Variables175005
Node: Bash Variables177032
Node: Bash Features201987
Node: Invoking Bash202870
Node: Bash Startup Files208634
Node: Interactive Shells213655
Node: What is an Interactive Shell?214065
Node: Is this Shell Interactive?214714
Node: Interactive Shell Behavior215529
Node: Bash Conditional Expressions218809
Node: Shell Arithmetic222598
Node: Aliases225357
Node: Arrays227929
Node: The Directory Stack232151
Node: Directory Stack Builtins232865
Node: Printing a Prompt235757
Node: The Restricted Shell238509
Node: Bash POSIX Mode240341
Node: Job Control249002
Node: Job Control Basics249462
Node: Job Control Builtins254179
Node: Job Control Variables258543
Node: Command Line Editing259701
Node: Introduction and Notation261268
Node: Readline Interaction262890
Node: Readline Bare Essentials264081
Node: Readline Movement Commands265870
Node: Readline Killing Commands266835
Node: Readline Arguments268755
Node: Searching269799
Node: Readline Init File271985
Node: Readline Init File Syntax273132
Node: Conditional Init Constructs288474
Node: Sample Init File291007
Node: Bindable Readline Commands294124
Node: Commands For Moving295331
Node: Commands For History296475
Node: Commands For Text299910
Node: Commands For Killing302583
Node: Numeric Arguments305040
Node: Commands For Completion306179
Node: Keyboard Macros310371
Node: Miscellaneous Commands310942
Node: Readline vi Mode316748
Node: Programmable Completion317655
Node: Programmable Completion Builtins324865
Node: Using History Interactively334001
Node: Bash History Facilities334685
Node: Bash History Builtins337599
Node: History Interaction341456
Node: Event Designators344161
Node: Word Designators345383
Node: Modifiers347022
Node: Installing Bash348426
Node: Basic Installation349563
Node: Compilers and Options352255
Node: Compiling For Multiple Architectures352996
Node: Installation Names354660
Node: Specifying the System Type355478
Node: Sharing Defaults356194
Node: Operation Controls356867
Node: Optional Features357825
Node: Reporting Bugs367393
Node: Major Differences From The Bourne Shell368594
Node: GNU Free Documentation License385281
Node: Indexes410477
Node: Builtin Index410931
Node: Reserved Word Index417758
Node: Variable Index420206
Node: Function Index433301
Node: Concept Index440310

End Tag Table