commit bash-20160513 snapshot

doc/bashref.info

@@ -1,10 +1,10 @@
-This is bashref.info, produced by makeinfo version 6.0 from
+This is bashref.info, produced by makeinfo version 6.1 from
 bashref.texi.
 
 This text is a brief description of the features that are present in the
-Bash shell (version 4.4, 28 February 2016).
+Bash shell (version 4.4, 27 April 2016).
 
-   This is Edition 4.4, last updated 28 February 2016, of 'The GNU Bash
+   This is Edition 4.4, last updated 27 April 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, 28 February 2016).  The Bash home page is
+Bash shell (version 4.4, 27 April 2016).  The Bash home page is
 <http://www.gnu.org/software/bash/>.
 
-   This is Edition 4.4, last updated 28 February 2016, of 'The GNU Bash
+   This is Edition 4.4, last updated 27 April 2016, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 4.4.
 
    Bash contains features that appear in other popular shells, and some
@@ -798,6 +798,7 @@ File: bashref.info,  Node: Conditional Constructs,  Next: Command Grouping,  Pre
           esac
           echo " legs."
 
+
      If the ';;' operator is used, no subsequent matches are attempted
      after the first pattern match.  Using ';&' in place of ';;' causes
      execution to continue with the COMMAND-LIST associated with the
@@ -1280,7 +1281,7 @@ pairs in an associative array.  When applied to a string-valued
 variable, VALUE is expanded and appended to the variable's value.
 
    A variable can be assigned the NAMEREF attribute using the '-n'
-option to the \fBdeclare\fP or \fBlocal\fP builtin commands (*note Bash
+option to the 'declare' or 'local' builtin commands (*note Bash
 Builtins::) to create a NAMEREF, or a reference to another variable.
 This allows variables to be manipulated indirectly.  Whenever the
 nameref variable is referenced, assigned to, unset, or has its
@@ -4390,7 +4391,10 @@ This builtin allows you to change additional shell optional behavior.
           interactive shells.
 
      'extdebug'
-          If set, behavior intended for use by debuggers is enabled:
+          If set at shell invocation, arrange to execute the debugger
+          profile before the shell starts, identical to the '--debugger'
+          option.  If set after invocation, behavior intended for use by
+          debuggers is enabled:
 
             1. The '-F' option to the 'declare' builtin (*note Bash
                Builtins::) displays the source file name and line number
@@ -6557,6 +6561,9 @@ startup files.
      'read', the trap handler executes and 'read' returns an exit status
      greater than 128.
 
+  54. Bash removes an exited background process's status from the list
+     of such statuses after the 'wait' builtin is used to obtain it.
+
    There is other POSIX behavior that Bash does not implement by default
 even when in POSIX mode.  Specifically:
 
@@ -10714,9 +10721,9 @@ D.2 Index of Shell Reserved Words
 
 * !:                                     Pipelines.           (line   9)
 * [[:                                    Conditional Constructs.
-                                                              (line 120)
+                                                              (line 121)
 * ]]:                                    Conditional Constructs.
-                                                              (line 120)
+                                                              (line 121)
 * {:                                     Command Grouping.    (line  21)
 * }:                                     Command Grouping.    (line  21)
 * case:                                  Conditional Constructs.
@@ -10738,7 +10745,7 @@ D.2 Index of Shell Reserved Words
 * in:                                    Conditional Constructs.
                                                               (line  28)
 * select:                                Conditional Constructs.
-                                                              (line  78)
+                                                              (line  79)
 * then:                                  Conditional Constructs.
                                                               (line   7)
 * time:                                  Pipelines.           (line   9)
@@ -11028,8 +11035,7 @@ D.4 Function Index
                                                               (line  43)
 * delete-horizontal-space ():            Commands For Killing.
                                                               (line  46)
-* digit-argument ('M-0', 'M-1', ... 'M--'): Numeric Arguments.
-                                                              (line   6)
+* digit-argument (M-0, M-1, ... M--):    Numeric Arguments.   (line   6)
 * display-shell-version (C-x C-v):       Miscellaneous Commands.
                                                               (line 109)
 * do-uppercase-version (M-a, M-b, M-X, ...): Miscellaneous Commands.
@@ -11328,134 +11334,134 @@ D.5 Concept Index
 
 
 Tag Table:
-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
+Node: Top891
+Node: Introduction2805
+Node: What is Bash?3021
+Node: What is a shell?4135
+Node: Definitions6673
+Node: Basic Shell Features9624
+Node: Shell Syntax10843
+Node: Shell Operation11869
+Node: Quoting13162
+Node: Escape Character14462
+Node: Single Quotes14947
+Node: Double Quotes15295
+Node: ANSI-C Quoting16573
+Node: Locale Translation17826
+Node: Comments18722
+Node: Shell Commands19340
+Node: Simple Commands20212
+Node: Pipelines20843
+Node: Lists23586
+Node: Compound Commands25315
+Node: Looping Constructs26318
+Node: Conditional Constructs28781
+Node: Command Grouping39703
+Node: Coprocesses41182
+Node: GNU Parallel43014
+Node: Shell Functions46987
+Node: Shell Parameters52193
+Node: Positional Parameters56587
+Node: Special Parameters57487
+Node: Shell Expansions60824
+Node: Brace Expansion62761
+Node: Tilde Expansion65542
+Node: Shell Parameter Expansion67890
+Node: Command Substitution82022
+Node: Arithmetic Expansion83377
+Node: Process Substitution84309
+Node: Word Splitting85429
+Node: Filename Expansion87373
+Node: Pattern Matching89657
+Node: Quote Removal93355
+Node: Redirections93650
+Node: Executing Commands102893
+Node: Simple Command Expansion103563
+Node: Command Search and Execution105493
+Node: Command Execution Environment107829
+Node: Environment110813
+Node: Exit Status112472
+Node: Signals114142
+Node: Shell Scripts116109
+Node: Shell Builtin Commands118624
+Node: Bourne Shell Builtins120658
+Node: Bash Builtins141258
+Node: Modifying Shell Behavior169888
+Node: The Set Builtin170233
+Node: The Shopt Builtin180646
+Node: Special Builtins196445
+Node: Shell Variables197424
+Node: Bourne Shell Variables197861
+Node: Bash Variables199892
+Node: Bash Features228272
+Node: Invoking Bash229171
+Node: Bash Startup Files235120
+Node: Interactive Shells240223
+Node: What is an Interactive Shell?240633
+Node: Is this Shell Interactive?241282
+Node: Interactive Shell Behavior242097
+Node: Bash Conditional Expressions245472
+Node: Shell Arithmetic249473
+Node: Aliases252290
+Node: Arrays254838
+Node: The Directory Stack259922
+Node: Directory Stack Builtins260706
+Node: Controlling the Prompt263674
+Node: The Restricted Shell266420
+Node: Bash POSIX Mode268245
+Node: Job Control278298
+Node: Job Control Basics278758
+Node: Job Control Builtins283477
+Node: Job Control Variables288007
+Node: Command Line Editing289163
+Node: Introduction and Notation290834
+Node: Readline Interaction292457
+Node: Readline Bare Essentials293648
+Node: Readline Movement Commands295431
+Node: Readline Killing Commands296391
+Node: Readline Arguments298309
+Node: Searching299353
+Node: Readline Init File301539
+Node: Readline Init File Syntax302686
+Node: Conditional Init Constructs322873
+Node: Sample Init File325398
+Node: Bindable Readline Commands328515
+Node: Commands For Moving329719
+Node: Commands For History330862
+Node: Commands For Text335151
+Node: Commands For Killing338540
+Node: Numeric Arguments341021
+Node: Commands For Completion342160
+Node: Keyboard Macros346351
+Node: Miscellaneous Commands347038
+Node: Readline vi Mode352842
+Node: Programmable Completion353749
+Node: Programmable Completion Builtins361210
+Node: A Programmable Completion Example371096
+Node: Using History Interactively376348
+Node: Bash History Facilities377032
+Node: Bash History Builtins380033
+Node: History Interaction384030
+Node: Event Designators386994
+Node: Word Designators388213
+Node: Modifiers389850
+Node: Installing Bash391252
+Node: Basic Installation392389
+Node: Compilers and Options395080
+Node: Compiling For Multiple Architectures395821
+Node: Installation Names397484
+Node: Specifying the System Type398302
+Node: Sharing Defaults399018
+Node: Operation Controls399691
+Node: Optional Features400649
+Node: Reporting Bugs410906
+Node: Major Differences From The Bourne Shell412100
+Node: GNU Free Documentation License428952
+Node: Indexes454129
+Node: Builtin Index454583
+Node: Reserved Word Index461410
+Node: Variable Index463858
+Node: Function Index479317
+Node: Concept Index492474
 
 End Tag Table