commit bash-20100115 snapshot

This commit is contained in:
Chet Ramey
2011-12-12 21:52:41 -05:00
parent 1665e22a82
commit 5cdaaf76ec
31 changed files with 11109 additions and 8737 deletions
+246 -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.1, 23 December 2009).
the Bash shell (version 4.1, 15 January 2010).
This is Edition 4.1, last updated 23 December 2009, of `The GNU Bash
This is Edition 4.1, last updated 15 January 2010, of `The GNU Bash
Reference Manual', for `Bash', Version 4.1.
Copyright (C) 1988-2009 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.1, 23 December 2009).
the Bash shell (version 4.1, 15 January 2010).
This is Edition 4.1, last updated 23 December 2009, of `The GNU Bash
This is Edition 4.1, last updated 15 January 2010, of `The GNU Bash
Reference Manual', for `Bash', Version 4.1.
Bash contains features that appear in other popular shells, and some
@@ -3787,6 +3787,17 @@ This builtin allows you to change additional shell optional behavior.
respect to quoted arguments to the conditional command's =~
operator.
`compat32'
If set, Bash changes its behavior to that of version 3.2 with
respect to locale-specific string comparison when using the
conditional command's < and > operators.
`compat40'
If set, Bash changes its behavior to that of version 4.0 with
respect to locale-specific string comparison when using the
conditional command's < and > operators and the effect of
interrupting a command list.
`dirspell'
If set, Bash attempts spelling correction on directory names
during word completion if the directory name initially
@@ -3833,7 +3844,7 @@ This builtin allows you to change additional shell optional behavior.
6. Error tracing is enabled: command substitution, shell
functions, and subshells invoked with `( COMMAND )'
inherit the `ERROR' trap.
inherit the `ERR' trap.
`extglob'
If set, the extended pattern matching features described above
@@ -4264,6 +4275,10 @@ Variables::).
generated by a shell function invoked by the programmable
completion facility (*note Programmable Completion::).
`COPROC'
An array variable created to hold the file descriptors for output
from and input to an unnamed coprocess (*note Coprocesses::).
`DIRSTACK'
An array variable containing the current contents of the directory
stack. Directories appear in the stack in the order they are
@@ -4279,6 +4294,10 @@ Variables::).
starts with value `t', it assumes that the shell is running in an
emacs shell buffer and disables line editing.
`ENV'
Similar to `BASH_ENV'; used when the shell is invoked in POSIX
Mode (*note Bash POSIX Mode::).
`EUID'
The numeric effective user id of the current user. This variable
is readonly.
@@ -4474,6 +4493,10 @@ Variables::).
variable is unset, or set to a value that is not a number greater
than or equal to zero, the shell disables mail checking.
`MAPFILE'
An array variable created to hold the text read by the `mapfile'
builtin when no variable name is supplied.
`OLDPWD'
The previous working directory as set by the `cd' builtin.
@@ -4531,6 +4554,14 @@ Variables::).
and 32767 is generated. Assigning a value to this variable seeds
the random number generator.
`READLINE_LINE'
The contents of the Readline line buffer, for use with `bind -x'
(*note Bash Builtins::).
`READLINE_POINT'
The position of the insertion point in the Readline line buffer,
for use with `bind -x' (*note Bash Builtins::).
`REPLY'
The default variable for the `read' builtin.
@@ -5105,20 +5136,23 @@ link itself.
`-x FILE'
True if FILE exists and is executable.
`-O FILE'
True if FILE exists and is owned by the effective user id.
`-G FILE'
True if FILE exists and is owned by the effective group id.
`-L FILE'
True if FILE exists and is a symbolic link.
`-N FILE'
True if FILE exists and has been modified since it was last read.
`-O FILE'
True if FILE exists and is owned by the effective user id.
`-S FILE'
True if FILE exists and is a socket.
`-N FILE'
True if FILE exists and has been modified since it was last read.
`FILE1 -ef FILE2'
True if FILE1 and FILE2 refer to the same device and inode numbers.
`FILE1 -nt FILE2'
True if FILE1 is newer (according to modification date) than
@@ -5128,9 +5162,6 @@ link itself.
True if FILE1 is older than FILE2, or if FILE2 exists and FILE1
does not.
`FILE1 -ef FILE2'
True if FILE1 and FILE2 refer to the same device and inode numbers.
`-o OPTNAME'
True if shell option OPTNAME is enabled. The list of options
appears in the description of the `-o' option to the `set' builtin
@@ -7825,16 +7856,6 @@ completion facilities.
Names of all shell variables. May also be specified as
`-v'.
`-G GLOBPAT'
The filename expansion pattern GLOBPAT is expanded to generate
the possible completions.
`-W WORDLIST'
The WORDLIST is split using the characters in the `IFS'
special variable as delimiters, and each resultant word is
expanded. The possible completions are the members of the
resultant list which match the word being completed.
`-C COMMAND'
COMMAND is executed in a subshell environment, and its output
is used as the possible completions.
@@ -7844,13 +7865,9 @@ completion facilities.
environment. When it finishes, the possible completions are
retrieved from the value of the `COMPREPLY' array variable.
`-X FILTERPAT'
FILTERPAT is a pattern as used for filename expansion. It is
applied to the list of possible completions generated by the
preceding options and arguments, and each completion matching
FILTERPAT is removed from the list. A leading `!' in
FILTERPAT negates the pattern; in this case, any completion
not matching FILTERPAT is removed.
`-G GLOBPAT'
The filename expansion pattern GLOBPAT is expanded to generate
the possible completions.
`-P PREFIX'
PREFIX is added at the beginning of each possible completion
@@ -7860,6 +7877,20 @@ completion facilities.
SUFFIX is appended to each possible completion after all
other options have been applied.
`-W WORDLIST'
The WORDLIST is split using the characters in the `IFS'
special variable as delimiters, and each resultant word is
expanded. The possible completions are the members of the
resultant list which match the word being completed.
`-X FILTERPAT'
FILTERPAT is a pattern as used for filename expansion. It is
applied to the list of possible completions generated by the
preceding options and arguments, and each completion matching
FILTERPAT is removed from the list. A leading `!' in
FILTERPAT negates the pattern; in this case, any completion
not matching FILTERPAT is removed.
The return value is true unless an invalid option is supplied, an
option other than `-p' or `-r' is supplied without a NAME
argument, an attempt is made to remove a completion specification
@@ -7869,7 +7900,7 @@ completion facilities.
`compopt'
`compopt' [-o OPTION] [-DE] [+o OPTION] [NAME]
Modify completion options for each NAME according to the OPTIONs,
or for the currently-execution completion if no NAMEs are supplied.
or for the currently-executing completion if no NAMEs are supplied.
If no OPTIONs are given, display the completion options for each
NAME or the current completion. The possible values of OPTION are
those valid for the `complete' builtin described above. The `-D'
@@ -9834,66 +9865,69 @@ D.3 Parameter and Variable Index
* COMPREPLY: Bash Variables. (line 193)
* convert-meta: Readline Init File Syntax.
(line 77)
* DIRSTACK: Bash Variables. (line 198)
* COPROC: Bash Variables. (line 198)
* DIRSTACK: Bash Variables. (line 202)
* disable-completion: Readline Init File Syntax.
(line 83)
* editing-mode: Readline Init File Syntax.
(line 88)
* EMACS: Bash Variables. (line 208)
* EMACS: Bash Variables. (line 212)
* enable-keypad: Readline Init File Syntax.
(line 99)
* EUID: Bash Variables. (line 213)
* ENV: Bash Variables. (line 217)
* EUID: Bash Variables. (line 221)
* expand-tilde: Readline Init File Syntax.
(line 110)
* FCEDIT: Bash Variables. (line 217)
* FIGNORE: Bash Variables. (line 221)
* FUNCNAME: Bash Variables. (line 227)
* GLOBIGNORE: Bash Variables. (line 236)
* GROUPS: Bash Variables. (line 242)
* histchars: Bash Variables. (line 248)
* HISTCMD: Bash Variables. (line 263)
* HISTCONTROL: Bash Variables. (line 268)
* HISTFILE: Bash Variables. (line 284)
* HISTFILESIZE: Bash Variables. (line 288)
* HISTIGNORE: Bash Variables. (line 296)
* FCEDIT: Bash Variables. (line 225)
* FIGNORE: Bash Variables. (line 229)
* FUNCNAME: Bash Variables. (line 235)
* GLOBIGNORE: Bash Variables. (line 244)
* GROUPS: Bash Variables. (line 250)
* histchars: Bash Variables. (line 256)
* HISTCMD: Bash Variables. (line 271)
* HISTCONTROL: Bash Variables. (line 276)
* HISTFILE: Bash Variables. (line 292)
* HISTFILESIZE: Bash Variables. (line 296)
* HISTIGNORE: Bash Variables. (line 304)
* history-preserve-point: Readline Init File Syntax.
(line 114)
* history-size: Readline Init File Syntax.
(line 120)
* HISTSIZE: Bash Variables. (line 315)
* HISTTIMEFORMAT: Bash Variables. (line 319)
* HISTSIZE: Bash Variables. (line 323)
* HISTTIMEFORMAT: Bash Variables. (line 327)
* HOME: Bourne Shell Variables.
(line 13)
* horizontal-scroll-mode: Readline Init File Syntax.
(line 125)
* HOSTFILE: Bash Variables. (line 328)
* HOSTNAME: Bash Variables. (line 339)
* HOSTTYPE: Bash Variables. (line 342)
* HOSTFILE: Bash Variables. (line 336)
* HOSTNAME: Bash Variables. (line 347)
* HOSTTYPE: Bash Variables. (line 350)
* IFS: Bourne Shell Variables.
(line 18)
* IGNOREEOF: Bash Variables. (line 345)
* IGNOREEOF: Bash Variables. (line 353)
* input-meta: Readline Init File Syntax.
(line 132)
* INPUTRC: Bash Variables. (line 355)
* INPUTRC: Bash Variables. (line 363)
* isearch-terminators: Readline Init File Syntax.
(line 139)
* keymap: Readline Init File Syntax.
(line 146)
* LANG: Bash Variables. (line 359)
* LC_ALL: Bash Variables. (line 363)
* LC_COLLATE: Bash Variables. (line 367)
* LC_CTYPE: Bash Variables. (line 374)
* LANG: Bash Variables. (line 367)
* LC_ALL: Bash Variables. (line 371)
* LC_COLLATE: Bash Variables. (line 375)
* LC_CTYPE: Bash Variables. (line 382)
* LC_MESSAGES <1>: Locale Translation. (line 11)
* LC_MESSAGES: Bash Variables. (line 379)
* LC_NUMERIC: Bash Variables. (line 383)
* LINENO: Bash Variables. (line 387)
* LINES: Bash Variables. (line 391)
* MACHTYPE: Bash Variables. (line 396)
* LC_MESSAGES: Bash Variables. (line 387)
* LC_NUMERIC: Bash Variables. (line 391)
* LINENO: Bash Variables. (line 395)
* LINES: Bash Variables. (line 399)
* MACHTYPE: Bash Variables. (line 404)
* MAIL: Bourne Shell Variables.
(line 22)
* MAILCHECK: Bash Variables. (line 400)
* MAILCHECK: Bash Variables. (line 408)
* MAILPATH: Bourne Shell Variables.
(line 27)
* MAPFILE: Bash Variables. (line 416)
* mark-modified-lines: Readline Init File Syntax.
(line 159)
* mark-symlinked-directories: Readline Init File Syntax.
@@ -9902,39 +9936,41 @@ D.3 Parameter and Variable Index
(line 169)
* meta-flag: Readline Init File Syntax.
(line 132)
* OLDPWD: Bash Variables. (line 408)
* OLDPWD: Bash Variables. (line 420)
* OPTARG: Bourne Shell Variables.
(line 34)
* OPTERR: Bash Variables. (line 411)
* OPTERR: Bash Variables. (line 423)
* OPTIND: Bourne Shell Variables.
(line 38)
* OSTYPE: Bash Variables. (line 415)
* OSTYPE: Bash Variables. (line 427)
* output-meta: Readline Init File Syntax.
(line 176)
* page-completions: Readline Init File Syntax.
(line 181)
* PATH: Bourne Shell Variables.
(line 42)
* PIPESTATUS: Bash Variables. (line 418)
* POSIXLY_CORRECT: Bash Variables. (line 423)
* PPID: Bash Variables. (line 432)
* PROMPT_COMMAND: Bash Variables. (line 436)
* PROMPT_DIRTRIM: Bash Variables. (line 440)
* PIPESTATUS: Bash Variables. (line 430)
* POSIXLY_CORRECT: Bash Variables. (line 435)
* PPID: Bash Variables. (line 444)
* PROMPT_COMMAND: Bash Variables. (line 448)
* PROMPT_DIRTRIM: Bash Variables. (line 452)
* PS1: Bourne Shell Variables.
(line 48)
* PS2: Bourne Shell Variables.
(line 53)
* PS3: Bash Variables. (line 446)
* PS4: Bash Variables. (line 451)
* PWD: Bash Variables. (line 457)
* RANDOM: Bash Variables. (line 460)
* REPLY: Bash Variables. (line 465)
* PS3: Bash Variables. (line 458)
* PS4: Bash Variables. (line 463)
* PWD: Bash Variables. (line 469)
* RANDOM: Bash Variables. (line 472)
* READLINE_LINE: Bash Variables. (line 477)
* READLINE_POINT: Bash Variables. (line 481)
* REPLY: Bash Variables. (line 485)
* revert-all-at-newline: Readline Init File Syntax.
(line 191)
* SECONDS: Bash Variables. (line 468)
* SHELL: Bash Variables. (line 474)
* SHELLOPTS: Bash Variables. (line 479)
* SHLVL: Bash Variables. (line 488)
* SECONDS: Bash Variables. (line 488)
* SHELL: Bash Variables. (line 494)
* SHELLOPTS: Bash Variables. (line 499)
* SHLVL: Bash Variables. (line 508)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 197)
* show-all-if-unmodified: Readline Init File Syntax.
@@ -9943,10 +9979,10 @@ D.3 Parameter and Variable Index
(line 212)
* TEXTDOMAIN: Locale Translation. (line 11)
* TEXTDOMAINDIR: Locale Translation. (line 11)
* TIMEFORMAT: Bash Variables. (line 493)
* TMOUT: Bash Variables. (line 531)
* TMPDIR: Bash Variables. (line 543)
* UID: Bash Variables. (line 547)
* TIMEFORMAT: Bash Variables. (line 513)
* TMOUT: Bash Variables. (line 551)
* TMPDIR: Bash Variables. (line 563)
* UID: Bash Variables. (line 567)
* visible-stats: Readline Init File Syntax.
(line 225)
@@ -10217,132 +10253,132 @@ 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 Translation17773
Node: Comments18669
Node: Shell Commands19287
Node: Simple Commands20111
Node: Pipelines20742
Node: Lists22998
Node: Compound Commands24727
Node: Looping Constructs25531
Node: Conditional Constructs27986
Node: Command Grouping36099
Node: Coprocesses37578
Node: Shell Functions39222
Node: Shell Parameters43776
Node: Positional Parameters46192
Node: Special Parameters47092
Node: Shell Expansions50056
Node: Brace Expansion51981
Node: Tilde Expansion54736
Node: Shell Parameter Expansion57087
Node: Command Substitution65988
Node: Arithmetic Expansion67321
Node: Process Substitution68171
Node: Word Splitting69221
Node: Filename Expansion70844
Node: Pattern Matching72983
Node: Quote Removal76622
Node: Redirections76917
Node: Executing Commands85442
Node: Simple Command Expansion86112
Node: Command Search and Execution88042
Node: Command Execution Environment90379
Node: Environment93365
Node: Exit Status95025
Node: Signals96646
Node: Shell Scripts98614
Node: Shell Builtin Commands101132
Node: Bourne Shell Builtins103160
Node: Bash Builtins120536
Node: Modifying Shell Behavior145364
Node: The Set Builtin145709
Node: The Shopt Builtin155233
Node: Special Builtins166095
Node: Shell Variables167074
Node: Bourne Shell Variables167514
Node: Bash Variables169495
Node: Bash Features192981
Node: Invoking Bash193864
Node: Bash Startup Files199673
Node: Interactive Shells204685
Node: What is an Interactive Shell?205095
Node: Is this Shell Interactive?205744
Node: Interactive Shell Behavior206559
Node: Bash Conditional Expressions209839
Node: Shell Arithmetic213488
Node: Aliases216234
Node: Arrays218806
Node: The Directory Stack222764
Node: Directory Stack Builtins223478
Node: Printing a Prompt226370
Node: The Restricted Shell229122
Node: Bash POSIX Mode230954
Node: Job Control239011
Node: Job Control Basics239471
Node: Job Control Builtins244188
Node: Job Control Variables248552
Node: Command Line Editing249710
Node: Introduction and Notation251277
Node: Readline Interaction252899
Node: Readline Bare Essentials254090
Node: Readline Movement Commands255879
Node: Readline Killing Commands256844
Node: Readline Arguments258764
Node: Searching259808
Node: Readline Init File261994
Node: Readline Init File Syntax263141
Node: Conditional Init Constructs277628
Node: Sample Init File280161
Node: Bindable Readline Commands283278
Node: Commands For Moving284485
Node: Commands For History285629
Node: Commands For Text288784
Node: Commands For Killing291457
Node: Numeric Arguments293908
Node: Commands For Completion295047
Node: Keyboard Macros299007
Node: Miscellaneous Commands299578
Node: Readline vi Mode305384
Node: Programmable Completion306298
Node: Programmable Completion Builtins313504
Node: Using History Interactively322640
Node: Bash History Facilities323324
Node: Bash History Builtins326238
Node: History Interaction330095
Node: Event Designators332800
Node: Word Designators333815
Node: Modifiers335454
Node: Installing Bash336858
Node: Basic Installation337995
Node: Compilers and Options340687
Node: Compiling For Multiple Architectures341428
Node: Installation Names343092
Node: Specifying the System Type343910
Node: Sharing Defaults344626
Node: Operation Controls345299
Node: Optional Features346257
Node: Reporting Bugs355816
Node: Major Differences From The Bourne Shell357017
Node: GNU Free Documentation License373704
Node: Indexes398900
Node: Builtin Index399354
Node: Reserved Word Index406181
Node: Variable Index408629
Node: Function Index420722
Node: Concept Index427731
Node: Top1344
Node: Introduction3181
Node: What is Bash?3409
Node: What is a shell?4522
Node: Definitions7062
Node: Basic Shell Features9980
Node: Shell Syntax11199
Node: Shell Operation12229
Node: Quoting13523
Node: Escape Character14826
Node: Single Quotes15311
Node: Double Quotes15659
Node: ANSI-C Quoting16784
Node: Locale Translation17769
Node: Comments18665
Node: Shell Commands19283
Node: Simple Commands20107
Node: Pipelines20738
Node: Lists22994
Node: Compound Commands24723
Node: Looping Constructs25527
Node: Conditional Constructs27982
Node: Command Grouping36095
Node: Coprocesses37574
Node: Shell Functions39218
Node: Shell Parameters43772
Node: Positional Parameters46188
Node: Special Parameters47088
Node: Shell Expansions50052
Node: Brace Expansion51977
Node: Tilde Expansion54732
Node: Shell Parameter Expansion57083
Node: Command Substitution65984
Node: Arithmetic Expansion67317
Node: Process Substitution68167
Node: Word Splitting69217
Node: Filename Expansion70840
Node: Pattern Matching72979
Node: Quote Removal76618
Node: Redirections76913
Node: Executing Commands85438
Node: Simple Command Expansion86108
Node: Command Search and Execution88038
Node: Command Execution Environment90375
Node: Environment93361
Node: Exit Status95021
Node: Signals96642
Node: Shell Scripts98610
Node: Shell Builtin Commands101128
Node: Bourne Shell Builtins103156
Node: Bash Builtins120532
Node: Modifying Shell Behavior145360
Node: The Set Builtin145705
Node: The Shopt Builtin155229
Node: Special Builtins166563
Node: Shell Variables167542
Node: Bourne Shell Variables167982
Node: Bash Variables169963
Node: Bash Features194096
Node: Invoking Bash194979
Node: Bash Startup Files200788
Node: Interactive Shells205800
Node: What is an Interactive Shell?206210
Node: Is this Shell Interactive?206859
Node: Interactive Shell Behavior207674
Node: Bash Conditional Expressions210954
Node: Shell Arithmetic214603
Node: Aliases217349
Node: Arrays219921
Node: The Directory Stack223879
Node: Directory Stack Builtins224593
Node: Printing a Prompt227485
Node: The Restricted Shell230237
Node: Bash POSIX Mode232069
Node: Job Control240126
Node: Job Control Basics240586
Node: Job Control Builtins245303
Node: Job Control Variables249667
Node: Command Line Editing250825
Node: Introduction and Notation252392
Node: Readline Interaction254014
Node: Readline Bare Essentials255205
Node: Readline Movement Commands256994
Node: Readline Killing Commands257959
Node: Readline Arguments259879
Node: Searching260923
Node: Readline Init File263109
Node: Readline Init File Syntax264256
Node: Conditional Init Constructs278743
Node: Sample Init File281276
Node: Bindable Readline Commands284393
Node: Commands For Moving285600
Node: Commands For History286744
Node: Commands For Text289899
Node: Commands For Killing292572
Node: Numeric Arguments295023
Node: Commands For Completion296162
Node: Keyboard Macros300122
Node: Miscellaneous Commands300693
Node: Readline vi Mode306499
Node: Programmable Completion307413
Node: Programmable Completion Builtins314619
Node: Using History Interactively323755
Node: Bash History Facilities324439
Node: Bash History Builtins327353
Node: History Interaction331210
Node: Event Designators333915
Node: Word Designators334930
Node: Modifiers336569
Node: Installing Bash337973
Node: Basic Installation339110
Node: Compilers and Options341802
Node: Compiling For Multiple Architectures342543
Node: Installation Names344207
Node: Specifying the System Type345025
Node: Sharing Defaults345741
Node: Operation Controls346414
Node: Optional Features347372
Node: Reporting Bugs356931
Node: Major Differences From The Bourne Shell358132
Node: GNU Free Documentation License374819
Node: Indexes400015
Node: Builtin Index400469
Node: Reserved Word Index407296
Node: Variable Index409744
Node: Function Index422202
Node: Concept Index429211

End Tag Table