commit bash-20100520 snapshot

This commit is contained in:
Chet Ramey
2011-12-12 21:59:12 -05:00
parent cdb599a168
commit eb0b2ad86b
43 changed files with 10828 additions and 9327 deletions
+231 -210
View File
@@ -2,12 +2,12 @@ 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, 15 January 2010).
the Bash shell (version 4.1, 17 April 2010).
This is Edition 4.1, last updated 15 January 2010, of `The GNU Bash
This is Edition 4.1, last updated 17 April 2010, of `The GNU Bash
Reference Manual', for `Bash', Version 4.1.
Copyright (C) 1988-2009 Free Software Foundation, Inc.
Copyright (C) 1988-2010 Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@@ -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, 15 January 2010).
the Bash shell (version 4.1, 17 April 2010).
This is Edition 4.1, last updated 15 January 2010, of `The GNU Bash
This is Edition 4.1, last updated 17 April 2010, of `The GNU Bash
Reference Manual', for `Bash', Version 4.1.
Bash contains features that appear in other popular shells, and some
@@ -2571,18 +2571,19 @@ standard.
`hash'
hash [-r] [-p FILENAME] [-dt] [NAME]
Remember the full pathnames of commands specified as NAME
arguments, so they need not be searched for on subsequent
invocations. The commands are found by searching through the
directories listed in `$PATH'. The `-p' option inhibits the path
search, and FILENAME is used as the location of NAME. The `-r'
option causes the shell to forget all remembered locations. The
`-d' option causes the shell to forget the remembered location of
each NAME. If the `-t' option is supplied, the full pathname to
which each NAME corresponds is printed. If multiple NAME
arguments are supplied with `-t' the NAME is printed before the
hashed full pathname. The `-l' option causes output to be
displayed in a format that may be reused as input. If no
Each time `hash' is invoked, it remembers the full pathnames of the
commands specified as NAME arguments, so they need not be searched
for on subsequent invocations. The commands are found by
searching through the directories listed in `$PATH'. Any
previously-remembered pathname is discarded. The `-p' option
inhibits the path search, and FILENAME is used as the location of
NAME. The `-r' option causes the shell to forget all remembered
locations. The `-d' option causes the shell to forget the
remembered location of each NAME. If the `-t' option is supplied,
the full pathname to which each NAME corresponds is printed. If
multiple NAME arguments are supplied with `-t' the NAME is printed
before the hashed full pathname. The `-l' option causes output to
be displayed in a format that may be reused as input. If no
arguments are given, or if only `-l' is supplied, information
about remembered commands is printed. The return status is zero
unless a NAME is not found or an invalid option is supplied.
@@ -3185,6 +3186,11 @@ POSIX standard.
and `%q' causes `printf' to output the corresponding ARGUMENT in a
format that can be reused as shell input.
Arguments to non-string format specifiers are treated as C
language constants, except that a leading plus or minus sign is
allowed, and if the leading character is a single or double quote,
the value is the ASCII value of the following character.
The `-v' option causes the output to be assigned to the variable
VAR rather than being printed to the standard output.
@@ -3386,7 +3392,8 @@ POSIX standard.
The maximum number of processes available to a single user.
`-v'
The maximum amount of virtual memory available to the process.
The maximum amount of virtual memory available to the shell,
and, on some systems, to its children.
`-x'
The maximum number of file locks.
@@ -4684,17 +4691,17 @@ File: bashref.info, Node: Invoking Bash, Next: Bash Startup Files, Up: Bash F
bash [long-opt] [-abefhkmnptuvxdBCDHP] [-o OPTION] [-O SHOPT_OPTION] -c STRING [ARGUMENT ...]
bash [long-opt] -s [-abefhkmnptuvxdBCDHP] [-o OPTION] [-O SHOPT_OPTION] [ARGUMENT ...]
In addition to the single-character shell command-line options
(*note The Set Builtin::), there are several multi-character options
that you can use. These options must appear on the command line before
the single-character options to be recognized.
All of the single-character options used with the `set' builtin
(*note The Set Builtin::) can be used as options when the shell is
invoked. In addition, there are several multi-character options that
you can use. These options must appear on the command line before the
single-character options to be recognized.
`--debugger'
Arrange for the debugger profile to be executed before the shell
starts. Turns on extended debugging mode (see *note The Shopt
Builtin:: for a description of the `extdebug' option to the `shopt'
builtin) and shell function tracing (see *note The Set Builtin::
for a description of the `-o functrace' option).
builtin).
`--dump-po-strings'
A list of all double-quoted strings preceded by `$' is printed on
@@ -5280,13 +5287,13 @@ its integer attribute turned on to be used in an expression.
Constants with a leading 0 are interpreted as octal numbers. A
leading `0x' or `0X' denotes hexadecimal. Otherwise, numbers take the
form [BASE`#']N, where BASE is a decimal number between 2 and 64
representing the arithmetic base, and N is a number in that base. If
BASE`#' is omitted, then base 10 is used. The digits greater than 9
are represented by the lowercase letters, the uppercase letters, `@',
and `_', in that order. If BASE is less than or equal to 36, lowercase
and uppercase letters may be used interchangeably to represent numbers
between 10 and 35.
form [BASE`#']N, where the optional BASE is a decimal number between 2
and 64 representing the arithmetic base, and N is a number in that
base. If BASE`#' is omitted, then base 10 is used. The digits greater
than 9 are represented by the lowercase letters, the uppercase letters,
`@', and `_', in that order. If BASE is less than or equal to 36,
lowercase and uppercase letters may be used interchangeably to
represent numbers between 10 and 35.
Operators are evaluated in order of precedence. Sub-expressions in
parentheses are evaluated first and may override the precedence rules
@@ -6488,6 +6495,13 @@ Variable Settings
`insert-comment' command is executed. The default value is
`"#"'.
`completion-display-width'
The number of screen columns used to display possible matches
when performing completion. The value is ignored if it is
less than 0 or greater than the terminal screen width. A
value of 0 will cause matches to be displayed one per line.
The default value is -1.
`completion-ignore-case'
If set to `on', Readline performs filename matching and
completion in a case-insensitive fashion. The default value
@@ -6605,9 +6619,9 @@ Variable Settings
`match-hidden-files'
This variable, when set to `on', causes Readline to match
files whose names begin with a `.' (hidden files) when
performing filename completion, unless the leading `.' is
supplied by the user in the filename to be completed. This
variable is `on' by default.
performing filename completion. If set to `off', the leading
`.' must be supplied by the user in the filename to be
completed. This variable is `on' by default.
`output-meta'
If set to `on', Readline will display characters with the
@@ -7279,7 +7293,11 @@ File: bashref.info, Node: Commands For Completion, Next: Keyboard Macros, Pre
completion is attempted.
`possible-completions (M-?)'
List the possible completions of the text before point.
List the possible completions of the text before point. When
displaying completions, Readline sets the number of columns used
for display to the value of `completion-display-width', the value
of the environment variable `COLUMNS', or the screen width, in
that order.
`insert-completions (M-*)'
Insert all completions of the text before point that would have
@@ -7535,8 +7553,7 @@ File: bashref.info, Node: Readline vi Mode, Next: Programmable Completion, Pr
While the Readline library does not have a full set of `vi' editing
functions, it does contain enough to allow simple editing of the line.
The Readline `vi' mode behaves as specified in the POSIX 1003.2
standard.
The Readline `vi' mode behaves as specified in the POSIX standard.
In order to switch interactively between `emacs' and `vi' editing
modes, use the `set -o emacs' and `set -o vi' commands (*note The Set
@@ -7667,7 +7684,7 @@ exit status of 124. If a shell function returns 124, and changes the
compspec associated with the command on which completion is being
attempted (supplied as the first argument when the function is
executed), programmable completion restarts from the beginning, with an
attempt to find a compspec for that command. This allows a set of
attempt to find a new compspec for that command. This allows a set of
completions to be built dynamically as completion is attempted, rather
than being loaded all at once.
@@ -9672,7 +9689,7 @@ D.1 Index of Shell Builtin Commands
* :: Bourne Shell Builtins.
(line 11)
* [: Bourne Shell Builtins.
(line 213)
(line 214)
* alias: Bash Builtins. (line 11)
* bg: Job Control Builtins.
(line 7)
@@ -9732,34 +9749,34 @@ D.1 Index of Shell Builtin Commands
* pushd: Directory Stack Builtins.
(line 58)
* pwd: Bourne Shell Builtins.
(line 163)
* read: Bash Builtins. (line 413)
* readarray: Bash Builtins. (line 493)
(line 164)
* read: Bash Builtins. (line 418)
* readarray: Bash Builtins. (line 498)
* readonly: Bourne Shell Builtins.
(line 172)
(line 173)
* return: Bourne Shell Builtins.
(line 188)
(line 189)
* set: The Set Builtin. (line 11)
* shift: Bourne Shell Builtins.
(line 201)
(line 202)
* shopt: The Shopt Builtin. (line 9)
* source: Bash Builtins. (line 501)
* source: Bash Builtins. (line 506)
* suspend: Job Control Builtins.
(line 94)
* test: Bourne Shell Builtins.
(line 213)
(line 214)
* times: Bourne Shell Builtins.
(line 281)
(line 282)
* trap: Bourne Shell Builtins.
(line 286)
* type: Bash Builtins. (line 505)
* typeset: Bash Builtins. (line 536)
* ulimit: Bash Builtins. (line 542)
(line 287)
* type: Bash Builtins. (line 510)
* typeset: Bash Builtins. (line 541)
* ulimit: Bash Builtins. (line 547)
* umask: Bourne Shell Builtins.
(line 332)
* unalias: Bash Builtins. (line 630)
(line 333)
* unalias: Bash Builtins. (line 636)
* unset: Bourne Shell Builtins.
(line 349)
(line 350)
* wait: Job Control Builtins.
(line 73)
@@ -9858,26 +9875,30 @@ D.3 Parameter and Variable Index
* COMP_TYPE: Bash Variables. (line 165)
* COMP_WORDBREAKS: Bash Variables. (line 179)
* COMP_WORDS: Bash Variables. (line 185)
* completion-display-width: Readline Init File Syntax.
(line 55)
* completion-ignore-case: Readline Init File Syntax.
(line 62)
* completion-prefix-display-length: Readline Init File Syntax.
(line 60)
* completion-query-items: Readline Init File Syntax.
(line 67)
* completion-query-items: Readline Init File Syntax.
(line 74)
* COMPREPLY: Bash Variables. (line 193)
* convert-meta: Readline Init File Syntax.
(line 77)
(line 84)
* COPROC: Bash Variables. (line 198)
* DIRSTACK: Bash Variables. (line 202)
* disable-completion: Readline Init File Syntax.
(line 83)
(line 90)
* editing-mode: Readline Init File Syntax.
(line 88)
(line 95)
* EMACS: Bash Variables. (line 212)
* enable-keypad: Readline Init File Syntax.
(line 99)
(line 106)
* ENV: Bash Variables. (line 217)
* EUID: Bash Variables. (line 221)
* expand-tilde: Readline Init File Syntax.
(line 110)
(line 117)
* FCEDIT: Bash Variables. (line 225)
* FIGNORE: Bash Variables. (line 229)
* FUNCNAME: Bash Variables. (line 235)
@@ -9890,15 +9911,15 @@ D.3 Parameter and Variable Index
* HISTFILESIZE: Bash Variables. (line 296)
* HISTIGNORE: Bash Variables. (line 304)
* history-preserve-point: Readline Init File Syntax.
(line 114)
(line 121)
* history-size: Readline Init File Syntax.
(line 120)
(line 127)
* 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)
(line 132)
* HOSTFILE: Bash Variables. (line 336)
* HOSTNAME: Bash Variables. (line 347)
* HOSTTYPE: Bash Variables. (line 350)
@@ -9906,12 +9927,12 @@ D.3 Parameter and Variable Index
(line 18)
* IGNOREEOF: Bash Variables. (line 353)
* input-meta: Readline Init File Syntax.
(line 132)
(line 139)
* INPUTRC: Bash Variables. (line 363)
* isearch-terminators: Readline Init File Syntax.
(line 139)
* keymap: Readline Init File Syntax.
(line 146)
* keymap: Readline Init File Syntax.
(line 153)
* LANG: Bash Variables. (line 367)
* LC_ALL: Bash Variables. (line 371)
* LC_COLLATE: Bash Variables. (line 375)
@@ -9929,13 +9950,13 @@ D.3 Parameter and Variable Index
(line 27)
* MAPFILE: Bash Variables. (line 416)
* mark-modified-lines: Readline Init File Syntax.
(line 159)
(line 166)
* mark-symlinked-directories: Readline Init File Syntax.
(line 164)
(line 171)
* match-hidden-files: Readline Init File Syntax.
(line 169)
(line 176)
* meta-flag: Readline Init File Syntax.
(line 132)
(line 139)
* OLDPWD: Bash Variables. (line 420)
* OPTARG: Bourne Shell Variables.
(line 34)
@@ -9944,9 +9965,9 @@ D.3 Parameter and Variable Index
(line 38)
* OSTYPE: Bash Variables. (line 427)
* output-meta: Readline Init File Syntax.
(line 176)
(line 183)
* page-completions: Readline Init File Syntax.
(line 181)
(line 188)
* PATH: Bourne Shell Variables.
(line 42)
* PIPESTATUS: Bash Variables. (line 430)
@@ -9966,17 +9987,17 @@ D.3 Parameter and Variable Index
* READLINE_POINT: Bash Variables. (line 481)
* REPLY: Bash Variables. (line 485)
* revert-all-at-newline: Readline Init File Syntax.
(line 191)
(line 198)
* 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)
(line 204)
* show-all-if-unmodified: Readline Init File Syntax.
(line 203)
(line 210)
* skip-completed-text: Readline Init File Syntax.
(line 212)
(line 219)
* TEXTDOMAIN: Locale Translation. (line 11)
* TEXTDOMAINDIR: Locale Translation. (line 11)
* TIMEFORMAT: Bash Variables. (line 513)
@@ -9984,7 +10005,7 @@ D.3 Parameter and Variable Index
* TMPDIR: Bash Variables. (line 563)
* UID: Bash Variables. (line 567)
* visible-stats: Readline Init File Syntax.
(line 225)
(line 232)

File: bashref.info, Node: Function Index, Next: Concept Index, Prev: Variable Index, Up: Indexes
@@ -10019,7 +10040,7 @@ D.4 Function Index
* copy-region-as-kill (): Commands For Killing. (line 54)
* delete-char (C-d): Commands For Text. (line 6)
* delete-char-or-list (): Commands For Completion.
(line 39)
(line 43)
* delete-horizontal-space (): Commands For Killing. (line 46)
* digit-argument (M-0, M-1, ... M--): Numeric Arguments. (line 6)
* do-uppercase-version (M-a, M-b, M-X, ...): Miscellaneous Commands.
@@ -10045,15 +10066,15 @@ D.4 Function Index
* insert-comment (M-#): Miscellaneous Commands.
(line 60)
* insert-completions (M-*): Commands For Completion.
(line 18)
(line 22)
* kill-line (C-k): Commands For Killing. (line 6)
* kill-region (): Commands For Killing. (line 50)
* kill-whole-line (): Commands For Killing. (line 15)
* kill-word (M-d): Commands For Killing. (line 19)
* menu-complete (): Commands For Completion.
(line 22)
(line 26)
* menu-complete-backward (): Commands For Completion.
(line 34)
(line 38)
* next-history (C-n): Commands For History. (line 17)
* non-incremental-forward-search-history (M-n): Commands For History.
(line 41)
@@ -10253,132 +10274,132 @@ D.5 Concept Index

Tag Table:
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
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 Translation17761
Node: Comments18657
Node: Shell Commands19275
Node: Simple Commands20099
Node: Pipelines20730
Node: Lists22986
Node: Compound Commands24715
Node: Looping Constructs25519
Node: Conditional Constructs27974
Node: Command Grouping36087
Node: Coprocesses37566
Node: Shell Functions39210
Node: Shell Parameters43764
Node: Positional Parameters46180
Node: Special Parameters47080
Node: Shell Expansions50044
Node: Brace Expansion51969
Node: Tilde Expansion54724
Node: Shell Parameter Expansion57075
Node: Command Substitution65976
Node: Arithmetic Expansion67309
Node: Process Substitution68159
Node: Word Splitting69209
Node: Filename Expansion70832
Node: Pattern Matching72971
Node: Quote Removal76610
Node: Redirections76905
Node: Executing Commands85430
Node: Simple Command Expansion86100
Node: Command Search and Execution88030
Node: Command Execution Environment90367
Node: Environment93353
Node: Exit Status95013
Node: Signals96634
Node: Shell Scripts98602
Node: Shell Builtin Commands101120
Node: Bourne Shell Builtins103148
Node: Bash Builtins120616
Node: Modifying Shell Behavior145759
Node: The Set Builtin146104
Node: The Shopt Builtin155628
Node: Special Builtins166962
Node: Shell Variables167941
Node: Bourne Shell Variables168381
Node: Bash Variables170362
Node: Bash Features194495
Node: Invoking Bash195378
Node: Bash Startup Files201142
Node: Interactive Shells206154
Node: What is an Interactive Shell?206564
Node: Is this Shell Interactive?207213
Node: Interactive Shell Behavior208028
Node: Bash Conditional Expressions211308
Node: Shell Arithmetic214957
Node: Aliases217716
Node: Arrays220288
Node: The Directory Stack224246
Node: Directory Stack Builtins224960
Node: Printing a Prompt227852
Node: The Restricted Shell230604
Node: Bash POSIX Mode232436
Node: Job Control240493
Node: Job Control Basics240953
Node: Job Control Builtins245670
Node: Job Control Variables250034
Node: Command Line Editing251192
Node: Introduction and Notation252759
Node: Readline Interaction254381
Node: Readline Bare Essentials255572
Node: Readline Movement Commands257361
Node: Readline Killing Commands258326
Node: Readline Arguments260246
Node: Searching261290
Node: Readline Init File263476
Node: Readline Init File Syntax264623
Node: Conditional Init Constructs279472
Node: Sample Init File282005
Node: Bindable Readline Commands285122
Node: Commands For Moving286329
Node: Commands For History287473
Node: Commands For Text290628
Node: Commands For Killing293301
Node: Numeric Arguments295752
Node: Commands For Completion296891
Node: Keyboard Macros301083
Node: Miscellaneous Commands301654
Node: Readline vi Mode307460
Node: Programmable Completion308367
Node: Programmable Completion Builtins315577
Node: Using History Interactively324713
Node: Bash History Facilities325397
Node: Bash History Builtins328311
Node: History Interaction332168
Node: Event Designators334873
Node: Word Designators335888
Node: Modifiers337527
Node: Installing Bash338931
Node: Basic Installation340068
Node: Compilers and Options342760
Node: Compiling For Multiple Architectures343501
Node: Installation Names345165
Node: Specifying the System Type345983
Node: Sharing Defaults346699
Node: Operation Controls347372
Node: Optional Features348330
Node: Reporting Bugs357889
Node: Major Differences From The Bourne Shell359090
Node: GNU Free Documentation License375777
Node: Indexes400973
Node: Builtin Index401427
Node: Reserved Word Index408254
Node: Variable Index410702
Node: Function Index423442
Node: Concept Index430451

End Tag Table