commit bash-20160212 snapshot

doc/bashref.info

@@ -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, 25 January 2016).
+Bash shell (version 4.4, 8 February 2016).
 
-   This is Edition 4.4, last updated 25 January 2016, of 'The GNU Bash
+   This is Edition 4.4, last updated 8 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, 25 January 2016).  The Bash home page is
+Bash shell (version 4.4, 8 February 2016).  The Bash home page is
 <http://www.gnu.org/software/bash/>.
 
-   This is Edition 4.4, last updated 25 January 2016, of 'The GNU Bash
+   This is Edition 4.4, last updated 8 February 2016, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 4.4.
 
    Bash contains features that appear in other popular shells, and some
@@ -174,8 +174,8 @@ These definitions are used throughout the remainder of this manual.
 
 'control operator'
      A 'token' that performs a control function.  It is a 'newline' or
-     one of the following: '||', '&&', '&', ';', ';;', '|', '|&', '(',
-     or ')'.
+     one of the following: '||', '&&', '&', ';', ';;', ';&', ';;&', '|',
+     '|&', '(', or ')'.
 
 'exit status'
      The value returned by a command to its caller.  The value is
@@ -3675,22 +3675,24 @@ standard.
               [-N NCHARS] [-p PROMPT] [-t TIMEOUT] [-u FD] [NAME ...]
 
      One line is read from the standard input, or from the file
-     descriptor FD supplied as an argument to the '-u' option, and the
+     descriptor FD supplied as an argument to the '-u' option, split
+     into words as described above in *note Word Splitting::, and the
      first word is assigned to the first NAME, the second word to the
-     second NAME, and so on, with leftover words and their intervening
-     separators assigned to the last NAME.  If there are fewer words
-     read from the input stream than names, the remaining names are
-     assigned empty values.  The characters in the value of the 'IFS'
-     variable are used to split the line into words using the same rules
-     the shell uses for expansion (described above in *note Word
-     Splitting::).  The backslash character '\' may be used to remove
-     any special meaning for the next character read and for line
-     continuation.  If no names are supplied, the line read is assigned
-     to the variable 'REPLY'.  The exit status is zero, unless
-     end-of-file is encountered, 'read' times out (in which case the
-     status is greater than 128), a variable assignment error (such as
-     assigning to a readonly variable) occurs, or an invalid file
-     descriptor is supplied as the argument to '-u'.
+     second NAME, and so on.  If there are more words than names, the
+     remaining words and their intervening delimiters are assigned to
+     the last NAME.  If there are fewer words read from the input stream
+     than names, the remaining names are assigned empty values.  The
+     characters in the value of the 'IFS' variable are used to split the
+     line into words using the same rules the shell uses for expansion
+     (described above in *note Word Splitting::).  The backslash
+     character '\' may be used to remove any special meaning for the
+     next character read and for line continuation.  If no names are
+     supplied, the line read is assigned to the variable 'REPLY'.  The
+     exit status is zero, unless end-of-file is encountered, 'read'
+     times out (in which case the status is greater than 128), a
+     variable assignment error (such as assigning to a readonly
+     variable) occurs, or an invalid file descriptor is supplied as the
+     argument to '-u'.
 
      Options, if supplied, have the following meanings:
 
@@ -10664,7 +10666,7 @@ D.1 Index of Shell Builtin Commands
 * pwd:                                   Bourne Shell Builtins.
                                                               (line 205)
 * read:                                  Bash Builtins.       (line 458)
-* readarray:                             Bash Builtins.       (line 548)
+* readarray:                             Bash Builtins.       (line 550)
 * readonly:                              Bourne Shell Builtins.
                                                               (line 215)
 * return:                                Bourne Shell Builtins.
@@ -10673,7 +10675,7 @@ D.1 Index of Shell Builtin Commands
 * shift:                                 Bourne Shell Builtins.
                                                               (line 255)
 * shopt:                                 The Shopt Builtin.   (line   9)
-* source:                                Bash Builtins.       (line 557)
+* source:                                Bash Builtins.       (line 559)
 * suspend:                               Job Control Builtins.
                                                               (line 101)
 * test:                                  Bourne Shell Builtins.
@@ -10682,12 +10684,12 @@ D.1 Index of Shell Builtin Commands
                                                               (line 343)
 * trap:                                  Bourne Shell Builtins.
                                                               (line 349)
-* type:                                  Bash Builtins.       (line 562)
-* typeset:                               Bash Builtins.       (line 594)
-* ulimit:                                Bash Builtins.       (line 600)
+* type:                                  Bash Builtins.       (line 564)
+* typeset:                               Bash Builtins.       (line 596)
+* ulimit:                                Bash Builtins.       (line 602)
 * umask:                                 Bourne Shell Builtins.
                                                               (line 398)
-* unalias:                               Bash Builtins.       (line 699)
+* unalias:                               Bash Builtins.       (line 701)
 * unset:                                 Bourne Shell Builtins.
                                                               (line 416)
 * wait:                                  Job Control Builtins.
@@ -11323,129 +11325,129 @@ Node: Introduction2813
 Node: What is Bash?3029
 Node: What is a shell?4143
 Node: Definitions6681
-Node: Basic Shell Features9619
-Node: Shell Syntax10838
-Node: Shell Operation11864
-Node: Quoting13157
-Node: Escape Character14457
-Node: Single Quotes14942
-Node: Double Quotes15290
-Node: ANSI-C Quoting16568
-Node: Locale Translation17821
-Node: Comments18717
-Node: Shell Commands19335
-Node: Simple Commands20207
-Node: Pipelines20838
-Node: Lists23581
-Node: Compound Commands25310
-Node: Looping Constructs26313
-Node: Conditional Constructs28776
-Node: Command Grouping39697
-Node: Coprocesses41176
-Node: GNU Parallel43008
-Node: Shell Functions46981
-Node: Shell Parameters52187
-Node: Positional Parameters56589
-Node: Special Parameters57489
-Node: Shell Expansions60826
-Node: Brace Expansion62763
-Node: Tilde Expansion65544
-Node: Shell Parameter Expansion67892
-Node: Command Substitution82024
-Node: Arithmetic Expansion83379
-Node: Process Substitution84311
-Node: Word Splitting85431
-Node: Filename Expansion87375
-Node: Pattern Matching89659
-Node: Quote Removal93357
-Node: Redirections93652
-Node: Executing Commands102901
-Node: Simple Command Expansion103571
-Node: Command Search and Execution105501
-Node: Command Execution Environment107837
-Node: Environment110821
-Node: Exit Status112480
-Node: Signals114150
-Node: Shell Scripts116117
-Node: Shell Builtin Commands118632
-Node: Bourne Shell Builtins120666
-Node: Bash Builtins141268
-Node: Modifying Shell Behavior169784
-Node: The Set Builtin170129
-Node: The Shopt Builtin180542
-Node: Special Builtins196162
-Node: Shell Variables197141
-Node: Bourne Shell Variables197578
-Node: Bash Variables199609
-Node: Bash Features227873
-Node: Invoking Bash228772
-Node: Bash Startup Files234721
-Node: Interactive Shells239824
-Node: What is an Interactive Shell?240234
-Node: Is this Shell Interactive?240883
-Node: Interactive Shell Behavior241698
-Node: Bash Conditional Expressions245073
-Node: Shell Arithmetic249074
-Node: Aliases251851
-Node: Arrays254399
-Node: The Directory Stack259483
-Node: Directory Stack Builtins260267
-Node: Controlling the Prompt263235
-Node: The Restricted Shell265981
-Node: Bash POSIX Mode267806
-Node: Job Control277718
-Node: Job Control Basics278178
-Node: Job Control Builtins282897
-Node: Job Control Variables287427
-Node: Command Line Editing288583
-Node: Introduction and Notation290254
-Node: Readline Interaction291877
-Node: Readline Bare Essentials293068
-Node: Readline Movement Commands294851
-Node: Readline Killing Commands295811
-Node: Readline Arguments297729
-Node: Searching298773
-Node: Readline Init File300959
-Node: Readline Init File Syntax302106
-Node: Conditional Init Constructs321870
-Node: Sample Init File324395
-Node: Bindable Readline Commands327512
-Node: Commands For Moving328716
-Node: Commands For History329859
-Node: Commands For Text334148
-Node: Commands For Killing337537
-Node: Numeric Arguments340018
-Node: Commands For Completion341157
-Node: Keyboard Macros345348
-Node: Miscellaneous Commands346035
-Node: Readline vi Mode351839
-Node: Programmable Completion352746
-Node: Programmable Completion Builtins360207
-Node: A Programmable Completion Example370093
-Node: Using History Interactively375345
-Node: Bash History Facilities376029
-Node: Bash History Builtins379030
-Node: History Interaction383027
-Node: Event Designators385991
-Node: Word Designators387210
-Node: Modifiers388847
-Node: Installing Bash390249
-Node: Basic Installation391386
-Node: Compilers and Options394077
-Node: Compiling For Multiple Architectures394818
-Node: Installation Names396481
-Node: Specifying the System Type397299
-Node: Sharing Defaults398015
-Node: Operation Controls398688
-Node: Optional Features399646
-Node: Reporting Bugs409903
-Node: Major Differences From The Bourne Shell411097
-Node: GNU Free Documentation License427949
-Node: Indexes453126
-Node: Builtin Index453580
-Node: Reserved Word Index460407
-Node: Variable Index462855
-Node: Function Index478314
-Node: Concept Index491534
+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
 
 End Tag Table