commit bash-20160401 snapshot

This commit is contained in:
Chet Ramey
2016-04-07 11:40:23 -04:00
parent b78207dd0c
commit b729dac1c8
28 changed files with 7103 additions and 6761 deletions
+253 -245
View File
@@ -2,9 +2,9 @@ This is bashref.info, produced by makeinfo version 6.0 from
bashref.texi.
This text is a brief description of the features that are present in the
Bash shell (version 4.4, 8 February 2016).
Bash shell (version 4.4, 28 February 2016).
This is Edition 4.4, last updated 8 February 2016, of 'The GNU Bash
This is Edition 4.4, last updated 28 February 2016, of 'The GNU Bash
Reference Manual', for 'Bash', Version 4.4.
Copyright (C) 1988-2016 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 4.4, 8 February 2016). The Bash home page is
Bash shell (version 4.4, 28 February 2016). The Bash home page is
<http://www.gnu.org/software/bash/>.
This is Edition 4.4, last updated 8 February 2016, of 'The GNU Bash
This is Edition 4.4, last updated 28 February 2016, of 'The GNU Bash
Reference Manual', for 'Bash', Version 4.4.
Bash contains features that appear in other popular shells, and some
@@ -2317,13 +2317,13 @@ command.
DELIMITER
No parameter and variable expansion, command substitution, arithmetic
expansion, or filename expansion is performed on WORD. If any
characters in WORD are quoted, the DELIMITER is the result of quote
removal on WORD, and the lines in the here-document are not expanded.
If WORD is unquoted, all lines of the here-document are subjected to
parameter expansion, command substitution, and arithmetic expansion, the
character sequence '\newline' is ignored, and '\' must be used to quote
the characters '\', '$', and '`'.
expansion, or filename expansion is performed on WORD. If any part of
WORD is quoted, the DELIMITER is the result of quote removal on WORD,
and the lines in the here-document are not expanded. If WORD is
unquoted, all lines of the here-document are subjected to parameter
expansion, command substitution, and arithmetic expansion, the character
sequence '\newline' is ignored, and '\' must be used to quote the
characters '\', '$', and '`'.
If the redirection operator is '<<-', then all leading tab characters
are stripped from input lines and the line containing DELIMITER. This
@@ -3053,7 +3053,7 @@ standard.
'['
test EXPR
Evaluate a conditional express ion EXPR and return a status of 0
Evaluate a conditional expression EXPR and return a status of 0
(true) or 1 (false). Each operator and operand must be a separate
argument. Expressions are composed of the primaries described
below in *note Bash Conditional Expressions::. 'test' does not
@@ -3203,7 +3203,7 @@ standard.
Remove each variable or function NAME. If the '-v' option is
given, each NAME refers to a shell variable and that variable is
remvoved. If the '-f' option is given, the NAMEs refer to shell
removed. If the '-f' option is given, the NAMEs refer to shell
functions, and the function definition is removed. If the '-n'
option is supplied, and NAME is a variable with the NAMEREF
attribute, NAME will be unset rather than the variable it
@@ -4927,14 +4927,16 @@ Variables::).
'EXECIGNORE'
A colon-separated list of shell patterns (*note Pattern Matching::)
defining the list of filenames to be ignored by command search.
Files whose full pathnames match one of these patterns are not
considered executable files for the purposes of completion and
command execution. This does not affect the behavior of the '[',
'test', and '[[' commands. Use this variable to ignore shared
library files that have the executable bit set, but are not
executable files. The pattern matching honors the setting of the
'extglob' shell option.
defining the list of filenames to be ignored by command search
using 'PATH'. Files whose full pathnames match one of these
patterns are not considered executable files for the purposes of
completion and command execution via 'PATH' lookup. This does not
affect the behavior of the '[', 'test', and '[[' commands. Full
pathnames in the command hash table are not subject to
'EXECIGNORE'. Use this variable to ignore shared library files
that have the executable bit set, but are not executable files.
The pattern matching honors the setting of the 'extglob' shell
option.
'FCEDIT'
The editor used as a default by the '-e' option to the 'fc' builtin
@@ -5877,8 +5879,8 @@ File: bashref.info, Node: Shell Arithmetic, Next: Aliases, Prev: Bash Conditi
====================
The shell allows arithmetic expressions to be evaluated, as one of the
shell expansions or by the 'let' and the '-i' option to the 'declare'
builtins.
shell expansions or by using the '((' compound command, the 'let'
builtin, or the '-i' option to the 'declare' builtin.
Evaluation is done in fixed-width integers with no check for
overflow, though division by 0 is trapped and flagged as an error. The
@@ -7225,13 +7227,20 @@ Variable Settings
If set to 'on', Readline will convert characters with the
eighth bit set to an ASCII key sequence by stripping the
eighth bit and prefixing an <ESC> character, converting them
to a meta-prefixed key sequence. The default value is 'on'.
to a meta-prefixed key sequence. The default value is 'on',
but will be set to 'off' if the locale is one that contains
eight-bit characters.
'disable-completion'
If set to 'On', Readline will inhibit word completion.
Completion characters will be inserted into the line as if
they had been mapped to 'self-insert'. The default is 'off'.
'echo-control-characters'
When set to 'on', on operating systems that indicate they
support it, readline echoes a character corresponding to a
signal generated from the keyboard. The default is 'on'.
'editing-mode'
The 'editing-mode' variable controls which default set of key
bindings is used. By default, Readline starts up in Emacs
@@ -7248,11 +7257,6 @@ Variable Settings
embed a terminal control sequence into the mode string. The
default is '@'.
'echo-control-characters'
When set to 'on', on operating systems that indicate they
support it, readline echoes a character corresponding to a
signal generated from the keyboard. The default is 'on'.
'enable-bracketed-paste'
When set to 'On', Readline will configure the terminal in a
way that will enable it to insert each paste into the editing
@@ -7287,7 +7291,9 @@ Variable Settings
list. If set to zero, any existing history entries are
deleted and no new entries are saved. If set to a value less
than zero, the number of history entries is not limited. By
default, the number of history entries is not limited.
default, the number of history entries is not limited. If an
attempt is made to set HISTORY-SIZE to a non-numeric value,
the maximum number of history entries will be set to 500.
'horizontal-scroll-mode'
This variable can be set to either 'on' or 'off'. Setting it
@@ -7300,8 +7306,9 @@ Variable Settings
If set to 'on', Readline will enable eight-bit input (it will
not clear the eighth bit in the characters it reads),
regardless of what the terminal claims it can support. The
default value is 'off'. The name 'meta-flag' is a synonym for
this variable.
default value is 'off', but Readline will set it to 'on' if
the locale contains eight-bit characters. The name
'meta-flag' is a synonym for this variable.
'isearch-terminators'
The string of characters that should terminate an incremental
@@ -7365,7 +7372,8 @@ Variable Settings
'output-meta'
If set to 'on', Readline will display characters with the
eighth bit set directly rather than as a meta-prefixed escape
sequence. The default is 'off'.
sequence. The default is 'off', but Readline will set it to
'on' if the locale contains eight-bit characters.
'page-completions'
If set to 'on', Readline uses an internal 'more'-like pager to
@@ -10824,141 +10832,141 @@ D.3 Parameter and Variable Index
* COPROC: Bash Variables. (line 231)
* DIRSTACK: Bash Variables. (line 235)
* disable-completion: Readline Init File Syntax.
(line 114)
(line 116)
* echo-control-characters: Readline Init File Syntax.
(line 135)
(line 121)
* editing-mode: Readline Init File Syntax.
(line 119)
(line 126)
* EMACS: Bash Variables. (line 245)
* emacs-mode-string: Readline Init File Syntax.
(line 125)
(line 132)
* enable-bracketed-paste: Readline Init File Syntax.
(line 140)
(line 142)
* enable-keypad: Readline Init File Syntax.
(line 148)
(line 150)
* ENV: Bash Variables. (line 250)
* EUID: Bash Variables. (line 254)
* EXECIGNORE: Bash Variables. (line 258)
* expand-tilde: Readline Init File Syntax.
(line 159)
* FCEDIT: Bash Variables. (line 269)
* FIGNORE: Bash Variables. (line 273)
* FUNCNAME: Bash Variables. (line 279)
* FUNCNEST: Bash Variables. (line 296)
* GLOBIGNORE: Bash Variables. (line 301)
* GROUPS: Bash Variables. (line 308)
* histchars: Bash Variables. (line 314)
* HISTCMD: Bash Variables. (line 329)
* HISTCONTROL: Bash Variables. (line 334)
* HISTFILE: Bash Variables. (line 350)
* HISTFILESIZE: Bash Variables. (line 354)
* HISTIGNORE: Bash Variables. (line 365)
(line 161)
* FCEDIT: Bash Variables. (line 271)
* FIGNORE: Bash Variables. (line 275)
* FUNCNAME: Bash Variables. (line 281)
* FUNCNEST: Bash Variables. (line 298)
* GLOBIGNORE: Bash Variables. (line 303)
* GROUPS: Bash Variables. (line 310)
* histchars: Bash Variables. (line 316)
* HISTCMD: Bash Variables. (line 331)
* HISTCONTROL: Bash Variables. (line 336)
* HISTFILE: Bash Variables. (line 352)
* HISTFILESIZE: Bash Variables. (line 356)
* HISTIGNORE: Bash Variables. (line 367)
* history-preserve-point: Readline Init File Syntax.
(line 163)
(line 165)
* history-size: Readline Init File Syntax.
(line 169)
* HISTSIZE: Bash Variables. (line 385)
* HISTTIMEFORMAT: Bash Variables. (line 392)
(line 171)
* HISTSIZE: Bash Variables. (line 387)
* HISTTIMEFORMAT: Bash Variables. (line 394)
* HOME: Bourne Shell Variables.
(line 13)
* horizontal-scroll-mode: Readline Init File Syntax.
(line 176)
* HOSTFILE: Bash Variables. (line 400)
* HOSTNAME: Bash Variables. (line 411)
* HOSTTYPE: Bash Variables. (line 414)
(line 180)
* HOSTFILE: Bash Variables. (line 402)
* HOSTNAME: Bash Variables. (line 413)
* HOSTTYPE: Bash Variables. (line 416)
* IFS: Bourne Shell Variables.
(line 18)
* IGNOREEOF: Bash Variables. (line 417)
* IGNOREEOF: Bash Variables. (line 419)
* input-meta: Readline Init File Syntax.
(line 183)
* INPUTRC: Bash Variables. (line 427)
(line 187)
* INPUTRC: Bash Variables. (line 429)
* isearch-terminators: Readline Init File Syntax.
(line 190)
(line 195)
* keymap: Readline Init File Syntax.
(line 197)
* LANG: Bash Variables. (line 431)
* LC_ALL: Bash Variables. (line 435)
* LC_COLLATE: Bash Variables. (line 439)
* LC_CTYPE: Bash Variables. (line 446)
(line 202)
* LANG: Bash Variables. (line 433)
* LC_ALL: Bash Variables. (line 437)
* LC_COLLATE: Bash Variables. (line 441)
* LC_CTYPE: Bash Variables. (line 448)
* LC_MESSAGES: Locale Translation. (line 11)
* LC_MESSAGES <1>: Bash Variables. (line 451)
* LC_NUMERIC: Bash Variables. (line 455)
* LC_TIME: Bash Variables. (line 459)
* LINENO: Bash Variables. (line 463)
* LINES: Bash Variables. (line 467)
* MACHTYPE: Bash Variables. (line 473)
* LC_MESSAGES <1>: Bash Variables. (line 453)
* LC_NUMERIC: Bash Variables. (line 457)
* LC_TIME: Bash Variables. (line 461)
* LINENO: Bash Variables. (line 465)
* LINES: Bash Variables. (line 469)
* MACHTYPE: Bash Variables. (line 475)
* MAIL: Bourne Shell Variables.
(line 22)
* MAILCHECK: Bash Variables. (line 477)
* MAILCHECK: Bash Variables. (line 479)
* MAILPATH: Bourne Shell Variables.
(line 27)
* MAPFILE: Bash Variables. (line 485)
* MAPFILE: Bash Variables. (line 487)
* mark-modified-lines: Readline Init File Syntax.
(line 227)
* mark-symlinked-directories: Readline Init File Syntax.
(line 232)
* match-hidden-files: Readline Init File Syntax.
* mark-symlinked-directories: Readline Init File Syntax.
(line 237)
* match-hidden-files: Readline Init File Syntax.
(line 242)
* menu-complete-display-prefix: Readline Init File Syntax.
(line 244)
(line 249)
* meta-flag: Readline Init File Syntax.
(line 183)
* OLDPWD: Bash Variables. (line 489)
(line 187)
* OLDPWD: Bash Variables. (line 491)
* OPTARG: Bourne Shell Variables.
(line 34)
* OPTERR: Bash Variables. (line 492)
* OPTERR: Bash Variables. (line 494)
* OPTIND: Bourne Shell Variables.
(line 38)
* OSTYPE: Bash Variables. (line 496)
* OSTYPE: Bash Variables. (line 498)
* output-meta: Readline Init File Syntax.
(line 249)
* page-completions: Readline Init File Syntax.
(line 254)
* page-completions: Readline Init File Syntax.
(line 260)
* PATH: Bourne Shell Variables.
(line 42)
* PIPESTATUS: Bash Variables. (line 499)
* POSIXLY_CORRECT: Bash Variables. (line 504)
* PPID: Bash Variables. (line 513)
* PROMPT_COMMAND: Bash Variables. (line 517)
* PROMPT_DIRTRIM: Bash Variables. (line 521)
* PS0: Bash Variables. (line 527)
* PIPESTATUS: Bash Variables. (line 501)
* POSIXLY_CORRECT: Bash Variables. (line 506)
* PPID: Bash Variables. (line 515)
* PROMPT_COMMAND: Bash Variables. (line 519)
* PROMPT_DIRTRIM: Bash Variables. (line 523)
* PS0: Bash Variables. (line 529)
* PS1: Bourne Shell Variables.
(line 48)
* PS2: Bourne Shell Variables.
(line 53)
* PS3: Bash Variables. (line 532)
* PS4: Bash Variables. (line 537)
* PWD: Bash Variables. (line 543)
* RANDOM: Bash Variables. (line 546)
* READLINE_LINE: Bash Variables. (line 551)
* READLINE_POINT: Bash Variables. (line 555)
* REPLY: Bash Variables. (line 559)
* PS3: Bash Variables. (line 534)
* PS4: Bash Variables. (line 539)
* PWD: Bash Variables. (line 545)
* RANDOM: Bash Variables. (line 548)
* READLINE_LINE: Bash Variables. (line 553)
* READLINE_POINT: Bash Variables. (line 557)
* REPLY: Bash Variables. (line 561)
* revert-all-at-newline: Readline Init File Syntax.
(line 264)
* SECONDS: Bash Variables. (line 562)
* SHELL: Bash Variables. (line 568)
* SHELLOPTS: Bash Variables. (line 573)
* SHLVL: Bash Variables. (line 582)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 270)
* show-all-if-unmodified: Readline Init File Syntax.
* SECONDS: Bash Variables. (line 564)
* SHELL: Bash Variables. (line 570)
* SHELLOPTS: Bash Variables. (line 575)
* SHLVL: Bash Variables. (line 584)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 276)
* show-all-if-unmodified: Readline Init File Syntax.
(line 282)
* show-mode-in-prompt: Readline Init File Syntax.
(line 285)
* skip-completed-text: Readline Init File Syntax.
(line 291)
* skip-completed-text: Readline Init File Syntax.
(line 297)
* TEXTDOMAIN: Locale Translation. (line 11)
* TEXTDOMAINDIR: Locale Translation. (line 11)
* TIMEFORMAT: Bash Variables. (line 587)
* TMOUT: Bash Variables. (line 625)
* TMPDIR: Bash Variables. (line 637)
* UID: Bash Variables. (line 641)
* TIMEFORMAT: Bash Variables. (line 589)
* TMOUT: Bash Variables. (line 627)
* TMPDIR: Bash Variables. (line 639)
* UID: Bash Variables. (line 643)
* vi-cmd-mode-string: Readline Init File Syntax.
(line 304)
(line 310)
* vi-ins-mode-string: Readline Init File Syntax.
(line 314)
(line 320)
* visible-stats: Readline Init File Syntax.
(line 324)
(line 330)

File: bashref.info, Node: Function Index, Next: Concept Index, Prev: Variable Index, Up: Indexes
@@ -11320,134 +11328,134 @@ D.5 Concept Index

Tag Table:
Node: Top895
Node: Introduction2813
Node: What is Bash?3029
Node: What is a shell?4143
Node: Definitions6681
Node: Basic Shell Features9632
Node: Shell Syntax10851
Node: Shell Operation11877
Node: Quoting13170
Node: Escape Character14470
Node: Single Quotes14955
Node: Double Quotes15303
Node: ANSI-C Quoting16581
Node: Locale Translation17834
Node: Comments18730
Node: Shell Commands19348
Node: Simple Commands20220
Node: Pipelines20851
Node: Lists23594
Node: Compound Commands25323
Node: Looping Constructs26326
Node: Conditional Constructs28789
Node: Command Grouping39710
Node: Coprocesses41189
Node: GNU Parallel43021
Node: Shell Functions46994
Node: Shell Parameters52200
Node: Positional Parameters56602
Node: Special Parameters57502
Node: Shell Expansions60839
Node: Brace Expansion62776
Node: Tilde Expansion65557
Node: Shell Parameter Expansion67905
Node: Command Substitution82037
Node: Arithmetic Expansion83392
Node: Process Substitution84324
Node: Word Splitting85444
Node: Filename Expansion87388
Node: Pattern Matching89672
Node: Quote Removal93370
Node: Redirections93665
Node: Executing Commands102914
Node: Simple Command Expansion103584
Node: Command Search and Execution105514
Node: Command Execution Environment107850
Node: Environment110834
Node: Exit Status112493
Node: Signals114163
Node: Shell Scripts116130
Node: Shell Builtin Commands118645
Node: Bourne Shell Builtins120679
Node: Bash Builtins141281
Node: Modifying Shell Behavior169911
Node: The Set Builtin170256
Node: The Shopt Builtin180669
Node: Special Builtins196289
Node: Shell Variables197268
Node: Bourne Shell Variables197705
Node: Bash Variables199736
Node: Bash Features228000
Node: Invoking Bash228899
Node: Bash Startup Files234848
Node: Interactive Shells239951
Node: What is an Interactive Shell?240361
Node: Is this Shell Interactive?241010
Node: Interactive Shell Behavior241825
Node: Bash Conditional Expressions245200
Node: Shell Arithmetic249201
Node: Aliases251978
Node: Arrays254526
Node: The Directory Stack259610
Node: Directory Stack Builtins260394
Node: Controlling the Prompt263362
Node: The Restricted Shell266108
Node: Bash POSIX Mode267933
Node: Job Control277845
Node: Job Control Basics278305
Node: Job Control Builtins283024
Node: Job Control Variables287554
Node: Command Line Editing288710
Node: Introduction and Notation290381
Node: Readline Interaction292004
Node: Readline Bare Essentials293195
Node: Readline Movement Commands294978
Node: Readline Killing Commands295938
Node: Readline Arguments297856
Node: Searching298900
Node: Readline Init File301086
Node: Readline Init File Syntax302233
Node: Conditional Init Constructs321997
Node: Sample Init File324522
Node: Bindable Readline Commands327639
Node: Commands For Moving328843
Node: Commands For History329986
Node: Commands For Text334275
Node: Commands For Killing337664
Node: Numeric Arguments340145
Node: Commands For Completion341284
Node: Keyboard Macros345475
Node: Miscellaneous Commands346162
Node: Readline vi Mode351966
Node: Programmable Completion352873
Node: Programmable Completion Builtins360334
Node: A Programmable Completion Example370220
Node: Using History Interactively375472
Node: Bash History Facilities376156
Node: Bash History Builtins379157
Node: History Interaction383154
Node: Event Designators386118
Node: Word Designators387337
Node: Modifiers388974
Node: Installing Bash390376
Node: Basic Installation391513
Node: Compilers and Options394204
Node: Compiling For Multiple Architectures394945
Node: Installation Names396608
Node: Specifying the System Type397426
Node: Sharing Defaults398142
Node: Operation Controls398815
Node: Optional Features399773
Node: Reporting Bugs410030
Node: Major Differences From The Bourne Shell411224
Node: GNU Free Documentation License428076
Node: Indexes453253
Node: Builtin Index453707
Node: Reserved Word Index460534
Node: Variable Index462982
Node: Function Index478441
Node: Concept Index491661
Node: Top897
Node: Introduction2817
Node: What is Bash?3033
Node: What is a shell?4147
Node: Definitions6685
Node: Basic Shell Features9636
Node: Shell Syntax10855
Node: Shell Operation11881
Node: Quoting13174
Node: Escape Character14474
Node: Single Quotes14959
Node: Double Quotes15307
Node: ANSI-C Quoting16585
Node: Locale Translation17838
Node: Comments18734
Node: Shell Commands19352
Node: Simple Commands20224
Node: Pipelines20855
Node: Lists23598
Node: Compound Commands25327
Node: Looping Constructs26330
Node: Conditional Constructs28793
Node: Command Grouping39714
Node: Coprocesses41193
Node: GNU Parallel43025
Node: Shell Functions46998
Node: Shell Parameters52204
Node: Positional Parameters56606
Node: Special Parameters57506
Node: Shell Expansions60843
Node: Brace Expansion62780
Node: Tilde Expansion65561
Node: Shell Parameter Expansion67909
Node: Command Substitution82041
Node: Arithmetic Expansion83396
Node: Process Substitution84328
Node: Word Splitting85448
Node: Filename Expansion87392
Node: Pattern Matching89676
Node: Quote Removal93374
Node: Redirections93669
Node: Executing Commands102912
Node: Simple Command Expansion103582
Node: Command Search and Execution105512
Node: Command Execution Environment107848
Node: Environment110832
Node: Exit Status112491
Node: Signals114161
Node: Shell Scripts116128
Node: Shell Builtin Commands118643
Node: Bourne Shell Builtins120677
Node: Bash Builtins141277
Node: Modifying Shell Behavior169907
Node: The Set Builtin170252
Node: The Shopt Builtin180665
Node: Special Builtins196285
Node: Shell Variables197264
Node: Bourne Shell Variables197701
Node: Bash Variables199732
Node: Bash Features228112
Node: Invoking Bash229011
Node: Bash Startup Files234960
Node: Interactive Shells240063
Node: What is an Interactive Shell?240473
Node: Is this Shell Interactive?241122
Node: Interactive Shell Behavior241937
Node: Bash Conditional Expressions245312
Node: Shell Arithmetic249313
Node: Aliases252130
Node: Arrays254678
Node: The Directory Stack259762
Node: Directory Stack Builtins260546
Node: Controlling the Prompt263514
Node: The Restricted Shell266260
Node: Bash POSIX Mode268085
Node: Job Control277997
Node: Job Control Basics278457
Node: Job Control Builtins283176
Node: Job Control Variables287706
Node: Command Line Editing288862
Node: Introduction and Notation290533
Node: Readline Interaction292156
Node: Readline Bare Essentials293347
Node: Readline Movement Commands295130
Node: Readline Killing Commands296090
Node: Readline Arguments298008
Node: Searching299052
Node: Readline Init File301238
Node: Readline Init File Syntax302385
Node: Conditional Init Constructs322572
Node: Sample Init File325097
Node: Bindable Readline Commands328214
Node: Commands For Moving329418
Node: Commands For History330561
Node: Commands For Text334850
Node: Commands For Killing338239
Node: Numeric Arguments340720
Node: Commands For Completion341859
Node: Keyboard Macros346050
Node: Miscellaneous Commands346737
Node: Readline vi Mode352541
Node: Programmable Completion353448
Node: Programmable Completion Builtins360909
Node: A Programmable Completion Example370795
Node: Using History Interactively376047
Node: Bash History Facilities376731
Node: Bash History Builtins379732
Node: History Interaction383729
Node: Event Designators386693
Node: Word Designators387912
Node: Modifiers389549
Node: Installing Bash390951
Node: Basic Installation392088
Node: Compilers and Options394779
Node: Compiling For Multiple Architectures395520
Node: Installation Names397183
Node: Specifying the System Type398001
Node: Sharing Defaults398717
Node: Operation Controls399390
Node: Optional Features400348
Node: Reporting Bugs410605
Node: Major Differences From The Bourne Shell411799
Node: GNU Free Documentation License428651
Node: Indexes453828
Node: Builtin Index454282
Node: Reserved Word Index461109
Node: Variable Index463557
Node: Function Index479016
Node: Concept Index492236

End Tag Table