commit bash-20111028 snapshot

doc/bashref.info

@@ -2,10 +2,10 @@ 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.2, 25 September 2011).
+the Bash shell (version 4.2, 24 October 2011).
 
-   This is Edition 4.2, last updated 25 September 2011, of `The GNU
-Bash Reference Manual', for `Bash', Version 4.2.
+   This is Edition 4.2, last updated 24 October 2011, of `The GNU Bash
+Reference Manual', for `Bash', Version 4.2.
 
    Copyright (C) 1988-2011 Free Software Foundation, Inc.
 
@@ -38,10 +38,10 @@ Bash Features
 *************
 
 This text is a brief description of the features that are present in
-the Bash shell (version 4.2, 25 September 2011).
+the Bash shell (version 4.2, 24 October 2011).
 
-   This is Edition 4.2, last updated 25 September 2011, of `The GNU
-Bash Reference Manual', for `Bash', Version 4.2.
+   This is Edition 4.2, last updated 24 October 2011, of `The GNU Bash
+Reference Manual', for `Bash', Version 4.2.
 
    Bash contains features that appear in other popular shells, and some
 features that only appear in Bash.  Some of the shells that Bash has
@@ -2034,7 +2034,9 @@ error:
    Of the two forms, the first is preferred.  This is semantically
 equivalent to
      >WORD 2>&1
-   (see Duplicating File Descriptors below).
+   When using the second form, WORD may not expand to a number or `-'.
+If it does, other redirection operators apply (see Duplicating File
+Descriptors below) for compatibility reasons.
 
 3.6.5 Appending Standard Output and Standard Error
 --------------------------------------------------
@@ -2105,8 +2107,9 @@ the standard input (file descriptor 0) is used.
    is used similarly to duplicate output file descriptors.  If N is not
 specified, the standard output (file descriptor 1) is used.  If the
 digits in WORD do not specify a file descriptor open for output, a
-redirection error occurs.  As a special case, if N is omitted, and WORD
-does not expand to one or more digits, the standard output and standard
+redirection error occurs.  If WORD evaluates to `-', file descriptor N
+is closed.  As a special case, if N is omitted, and WORD does not
+expand to one or more digits or `-', the standard output and standard
 error are redirected as described previously.
 
 3.6.9 Moving File Descriptors
@@ -2750,11 +2753,12 @@ standard.
      also be used to terminate execution of a script being executed
      with the `.' (`source') builtin, returning either N or the exit
      status of the last command executed within the script as the exit
-     status of the script.  Any command associated with the `RETURN'
-     trap is executed before execution resumes after the function or
-     script.  The return status is non-zero if `return' is used outside
-     a function and not during the execution of a script by `.' or
-     `source'.
+     status of the script.  If N is supplied, the return value is its
+     least significant 8 bits.  Any command associated with the
+     `RETURN' trap is executed before execution resumes after the
+     function or script.  The return status is non-zero if `return' is
+     supplied a non-numeric argument or is used outside a function and
+     not during the execution of a script by `.' or `source'.
 
 `shift'
           shift [N]
@@ -10013,7 +10017,7 @@ D.1 Index of Shell Builtin Commands
 * ::                                     Bourne Shell Builtins.
                                                               (line  11)
 * [:                                     Bourne Shell Builtins.
-                                                              (line 240)
+                                                              (line 241)
 * alias:                                 Bash Builtins.       (line  11)
 * bg:                                    Job Control Builtins.
                                                               (line   7)
@@ -10082,25 +10086,25 @@ D.1 Index of Shell Builtin Commands
                                                               (line 212)
 * set:                                   The Set Builtin.     (line  11)
 * shift:                                 Bourne Shell Builtins.
-                                                              (line 227)
+                                                              (line 228)
 * shopt:                                 The Shopt Builtin.   (line   9)
 * source:                                Bash Builtins.       (line 550)
 * suspend:                               Job Control Builtins.
                                                               (line  99)
 * test:                                  Bourne Shell Builtins.
-                                                              (line 240)
+                                                              (line 241)
 * times:                                 Bourne Shell Builtins.
-                                                              (line 316)
+                                                              (line 317)
 * trap:                                  Bourne Shell Builtins.
-                                                              (line 322)
+                                                              (line 323)
 * type:                                  Bash Builtins.       (line 555)
 * typeset:                               Bash Builtins.       (line 587)
 * ulimit:                                Bash Builtins.       (line 593)
 * umask:                                 Bourne Shell Builtins.
-                                                              (line 369)
+                                                              (line 370)
 * unalias:                               Bash Builtins.       (line 684)
 * unset:                                 Bourne Shell Builtins.
-                                                              (line 387)
+                                                              (line 388)
 * wait:                                  Job Control Builtins.
                                                               (line  76)
 
@@ -10606,133 +10610,133 @@ D.5 Concept Index
 
 
 Tag Table:
-Node: Top1348
-Node: Introduction3190
-Node: What is Bash?3418
-Node: What is a shell?4531
-Node: Definitions7070
-Node: Basic Shell Features9988
-Node: Shell Syntax11207
-Node: Shell Operation12237
-Node: Quoting13531
-Node: Escape Character14834
-Node: Single Quotes15319
-Node: Double Quotes15667
-Node: ANSI-C Quoting16792
-Node: Locale Translation18036
-Node: Comments18932
-Node: Shell Commands19550
-Node: Simple Commands20422
-Node: Pipelines21053
-Node: Lists23752
-Node: Compound Commands25481
-Node: Looping Constructs26487
-Node: Conditional Constructs28950
-Node: Command Grouping37095
-Node: Coprocesses38574
-Node: GNU Parallel40248
-Node: Shell Functions42716
-Node: Shell Parameters47800
-Node: Positional Parameters50405
-Node: Special Parameters51305
-Node: Shell Expansions54269
-Node: Brace Expansion56195
-Node: Tilde Expansion58949
-Node: Shell Parameter Expansion61298
-Node: Command Substitution70432
-Node: Arithmetic Expansion71765
-Node: Process Substitution72615
-Node: Word Splitting73665
-Node: Filename Expansion75288
-Node: Pattern Matching77453
-Node: Quote Removal81153
-Node: Redirections81448
-Node: Executing Commands90285
-Node: Simple Command Expansion90955
-Node: Command Search and Execution92885
-Node: Command Execution Environment95222
-Node: Environment98208
-Node: Exit Status99867
-Node: Signals101489
-Node: Shell Scripts103457
-Node: Shell Builtin Commands105975
-Node: Bourne Shell Builtins108003
-Node: Bash Builtins126676
-Node: Modifying Shell Behavior153054
-Node: The Set Builtin153399
-Node: The Shopt Builtin163147
-Node: Special Builtins176848
-Node: Shell Variables177827
-Node: Bourne Shell Variables178267
-Node: Bash Variables180298
-Node: Bash Features205299
-Node: Invoking Bash206198
-Node: Bash Startup Files211960
-Node: Interactive Shells216979
-Node: What is an Interactive Shell?217389
-Node: Is this Shell Interactive?218038
-Node: Interactive Shell Behavior218853
-Node: Bash Conditional Expressions222133
-Node: Shell Arithmetic225921
-Node: Aliases228680
-Node: Arrays231236
-Node: The Directory Stack235444
-Node: Directory Stack Builtins236163
-Node: Controlling the Prompt239119
-Node: The Restricted Shell241891
-Node: Bash POSIX Mode243728
-Node: Job Control252876
-Node: Job Control Basics253336
-Node: Job Control Builtins258055
-Node: Job Control Variables262407
-Node: Command Line Editing263565
-Node: Introduction and Notation265132
-Node: Readline Interaction266754
-Node: Readline Bare Essentials267945
-Node: Readline Movement Commands269734
-Node: Readline Killing Commands270699
-Node: Readline Arguments272619
-Node: Searching273663
-Node: Readline Init File275849
-Node: Readline Init File Syntax276996
-Node: Conditional Init Constructs292338
-Node: Sample Init File294871
-Node: Bindable Readline Commands297988
-Node: Commands For Moving299195
-Node: Commands For History300339
-Node: Commands For Text304524
-Node: Commands For Killing307197
-Node: Numeric Arguments309654
-Node: Commands For Completion310793
-Node: Keyboard Macros314985
-Node: Miscellaneous Commands315556
-Node: Readline vi Mode321362
-Node: Programmable Completion322269
-Node: Programmable Completion Builtins329479
-Node: Using History Interactively338615
-Node: Bash History Facilities339299
-Node: Bash History Builtins342213
-Node: History Interaction346141
-Node: Event Designators348846
-Node: Word Designators350068
-Node: Modifiers351707
-Node: Installing Bash353111
-Node: Basic Installation354248
-Node: Compilers and Options356940
-Node: Compiling For Multiple Architectures357681
-Node: Installation Names359345
-Node: Specifying the System Type360163
-Node: Sharing Defaults360879
-Node: Operation Controls361552
-Node: Optional Features362510
-Node: Reporting Bugs372082
-Node: Major Differences From The Bourne Shell373283
-Node: GNU Free Documentation License389975
-Node: Indexes415171
-Node: Builtin Index415625
-Node: Reserved Word Index422452
-Node: Variable Index424900
-Node: Function Index437995
-Node: Concept Index445150
+Node: Top1344
+Node: Introduction3182
+Node: What is Bash?3410
+Node: What is a shell?4523
+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 Translation18028
+Node: Comments18924
+Node: Shell Commands19542
+Node: Simple Commands20414
+Node: Pipelines21045
+Node: Lists23744
+Node: Compound Commands25473
+Node: Looping Constructs26479
+Node: Conditional Constructs28942
+Node: Command Grouping37087
+Node: Coprocesses38566
+Node: GNU Parallel40240
+Node: Shell Functions42708
+Node: Shell Parameters47792
+Node: Positional Parameters50397
+Node: Special Parameters51297
+Node: Shell Expansions54261
+Node: Brace Expansion56187
+Node: Tilde Expansion58941
+Node: Shell Parameter Expansion61290
+Node: Command Substitution70424
+Node: Arithmetic Expansion71757
+Node: Process Substitution72607
+Node: Word Splitting73657
+Node: Filename Expansion75280
+Node: Pattern Matching77445
+Node: Quote Removal81145
+Node: Redirections81440
+Node: Executing Commands90480
+Node: Simple Command Expansion91150
+Node: Command Search and Execution93080
+Node: Command Execution Environment95417
+Node: Environment98403
+Node: Exit Status100062
+Node: Signals101684
+Node: Shell Scripts103652
+Node: Shell Builtin Commands106170
+Node: Bourne Shell Builtins108198
+Node: Bash Builtins126983
+Node: Modifying Shell Behavior153361
+Node: The Set Builtin153706
+Node: The Shopt Builtin163454
+Node: Special Builtins177155
+Node: Shell Variables178134
+Node: Bourne Shell Variables178574
+Node: Bash Variables180605
+Node: Bash Features205606
+Node: Invoking Bash206505
+Node: Bash Startup Files212267
+Node: Interactive Shells217286
+Node: What is an Interactive Shell?217696
+Node: Is this Shell Interactive?218345
+Node: Interactive Shell Behavior219160
+Node: Bash Conditional Expressions222440
+Node: Shell Arithmetic226228
+Node: Aliases228987
+Node: Arrays231543
+Node: The Directory Stack235751
+Node: Directory Stack Builtins236470
+Node: Controlling the Prompt239426
+Node: The Restricted Shell242198
+Node: Bash POSIX Mode244035
+Node: Job Control253183
+Node: Job Control Basics253643
+Node: Job Control Builtins258362
+Node: Job Control Variables262714
+Node: Command Line Editing263872
+Node: Introduction and Notation265439
+Node: Readline Interaction267061
+Node: Readline Bare Essentials268252
+Node: Readline Movement Commands270041
+Node: Readline Killing Commands271006
+Node: Readline Arguments272926
+Node: Searching273970
+Node: Readline Init File276156
+Node: Readline Init File Syntax277303
+Node: Conditional Init Constructs292645
+Node: Sample Init File295178
+Node: Bindable Readline Commands298295
+Node: Commands For Moving299502
+Node: Commands For History300646
+Node: Commands For Text304831
+Node: Commands For Killing307504
+Node: Numeric Arguments309961
+Node: Commands For Completion311100
+Node: Keyboard Macros315292
+Node: Miscellaneous Commands315863
+Node: Readline vi Mode321669
+Node: Programmable Completion322576
+Node: Programmable Completion Builtins329786
+Node: Using History Interactively338922
+Node: Bash History Facilities339606
+Node: Bash History Builtins342520
+Node: History Interaction346448
+Node: Event Designators349153
+Node: Word Designators350375
+Node: Modifiers352014
+Node: Installing Bash353418
+Node: Basic Installation354555
+Node: Compilers and Options357247
+Node: Compiling For Multiple Architectures357988
+Node: Installation Names359652
+Node: Specifying the System Type360470
+Node: Sharing Defaults361186
+Node: Operation Controls361859
+Node: Optional Features362817
+Node: Reporting Bugs372389
+Node: Major Differences From The Bourne Shell373590
+Node: GNU Free Documentation License390282
+Node: Indexes415478
+Node: Builtin Index415932
+Node: Reserved Word Index422759
+Node: Variable Index425207
+Node: Function Index438302
+Node: Concept Index445457
 
 End Tag Table