commit bash-20071011 snapshot

doc/bashref.info

@@ -2,10 +2,10 @@ This is bashref.info, produced by makeinfo version 4.8 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 3.2, 1 May 2007).
+the Bash shell (version 3.2, 14 September 2007).
 
-   This is Edition 3.2, last updated 1 May 2007, of `The GNU Bash
-Reference Manual', for `Bash', Version 3.2.
+   This is Edition 3.2, last updated 14 September 2007, of `The GNU
+Bash Reference Manual', for `Bash', Version 3.2.
 
    Copyright (C) 1988-2005 Free Software Foundation, Inc.
 
@@ -37,10 +37,10 @@ Bash Features
 *************
 
 This text is a brief description of the features that are present in
-the Bash shell (version 3.2, 1 May 2007).
+the Bash shell (version 3.2, 14 September 2007).
 
-   This is Edition 3.2, last updated 1 May 2007, of `The GNU Bash
-Reference Manual', for `Bash', Version 3.2.
+   This is Edition 3.2, last updated 14 September 2007, of `The GNU
+Bash Reference Manual', for `Bash', Version 3.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
@@ -183,7 +183,7 @@ These definitions are used throughout the remainder of this manual.
      rather than by an executable program somewhere in the file system.
 
 `control operator'
-     A `word' that performs a control function.  It is a `newline' or
+     A `token' that performs a control function.  It is a `newline' or
      one of the following: `||', `&&', `&', `;', `;;', `|', `(', or `)'.
 
 `exit status'
@@ -850,12 +850,14 @@ File: bashref.info,  Node: Conditional Constructs,  Next: Command Grouping,  Pre
      expression's return value is 2.  If the shell option `nocasematch'
      (see the description of `shopt' in *Note The Shopt Builtin::) is
      enabled, the match is performed without regard to the case of
-     alphabetic characters.  Substrings matched by parenthesized
-     subexpressions within the regular expression are saved in the
-     array variable `BASH_REMATCH'.  The element of `BASH_REMATCH' with
-     index 0 is the portion of the string matching the entire regular
-     expression.  The element of `BASH_REMATCH' with index N is the
-     portion of the string matching the Nth parenthesized subexpression.
+     alphabetic characters.  Any part of the pattern may be quoted to
+     force it to be matched as a string.  Substrings matched by
+     parenthesized subexpressions within the regular expression are
+     saved in the array variable `BASH_REMATCH'.  The element of
+     `BASH_REMATCH' with index 0 is the portion of the string matching
+     the entire regular expression.  The element of `BASH_REMATCH' with
+     index N is the portion of the string matching the Nth
+     parenthesized subexpression.
 
      Expressions may be combined using the following operators, listed
      in decreasing order of precedence:
@@ -3123,8 +3125,10 @@ POSIX standard.
      If LIMIT is given, it is the new value of the specified resource;
      the special LIMIT values `hard', `soft', and `unlimited' stand for
      the current hard limit, the current soft limit, and no limit,
-     respectively.  Otherwise, the current value of the soft limit for
-     the specified resource is printed, unless the `-H' option is
+     respectively.  A hard limit cannot be increased by a non-root user
+     once it is set; a soft limit may be increased up to the value of
+     the hard limit.  Otherwise, the current value of the soft limit
+     for the specified resource is printed, unless the `-H' option is
      supplied.  When setting new limits, if neither `-H' nor `-S' is
      supplied, both the hard and soft limits are set.  If no option is
      given, then `-f' is assumed.  Values are in 1024-byte increments,
@@ -3193,8 +3197,11 @@ parameters, or to display the names and values of shell variables.
           a `while' or `until' keyword, part of the test in an `if'
           statement, part of a `&&' or `||' list, any command in a
           pipeline but the last, or if the command's return status is
-          being inverted using `!'.  A trap on `ERR', if set, is
-          executed before the shell exits.
+          being inverted using `!'.  Failing simple commands that are
+          part of shell functions or command lists enclosed in braces
+          or parentheses satisfying the above conditions do not cause
+          the shell to exit.  A trap on `ERR', if set, is executed
+          before the shell exits.
 
     `-f'
           Disable file name generation (globbing).
@@ -9141,7 +9148,7 @@ D.1 Index of Shell Builtin Commands
 * ulimit:                                Bash Builtins.       (line 430)
 * umask:                                 Bourne Shell Builtins.
                                                               (line 326)
-* unalias:                               Bash Builtins.       (line 508)
+* unalias:                               Bash Builtins.       (line 510)
 * unset:                                 Bourne Shell Builtins.
                                                               (line 343)
 * wait:                                  Job Control Builtins.
@@ -9616,132 +9623,132 @@ D.5 Concept Index
 
 
 Tag Table:
-Node: Top1345
-Node: Introduction3143
-Node: What is Bash?3371
-Node: What is a shell?4484
-Node: Definitions7024
-Node: Basic Shell Features9792
-Node: Shell Syntax11011
-Node: Shell Operation12041
-Node: Quoting13335
-Node: Escape Character14638
-Node: Single Quotes15123
-Node: Double Quotes15471
-Node: ANSI-C Quoting16596
-Node: Locale Translation17552
-Node: Comments18448
-Node: Shell Commands19066
-Node: Simple Commands19832
-Node: Pipelines20463
-Node: Lists22338
-Node: Compound Commands23969
-Node: Looping Constructs24753
-Node: Conditional Constructs27200
-Node: Command Grouping34672
-Node: Shell Functions36151
-Node: Shell Parameters40612
-Node: Positional Parameters42942
-Node: Special Parameters43842
-Node: Shell Expansions46806
-Node: Brace Expansion48731
-Node: Tilde Expansion51057
-Node: Shell Parameter Expansion53408
-Node: Command Substitution61108
-Node: Arithmetic Expansion62441
-Node: Process Substitution63291
-Node: Word Splitting64341
-Node: Filename Expansion65964
-Node: Pattern Matching68104
-Node: Quote Removal71422
-Node: Redirections71717
-Node: Executing Commands79447
-Node: Simple Command Expansion80117
-Node: Command Search and Execution82047
-Node: Command Execution Environment84053
-Node: Environment86852
-Node: Exit Status88512
-Node: Signals89716
-Node: Shell Scripts91684
-Node: Shell Builtin Commands94202
-Node: Bourne Shell Builtins95879
-Node: Bash Builtins113087
-Node: Modifying Shell Behavior133075
-Node: The Set Builtin133420
-Node: The Shopt Builtin142042
-Node: Special Builtins152272
-Node: Shell Variables153251
-Node: Bourne Shell Variables153691
-Node: Bash Variables155672
-Node: Bash Features176967
-Node: Invoking Bash177850
-Node: Bash Startup Files183659
-Node: Interactive Shells188518
-Node: What is an Interactive Shell?188928
-Node: Is this Shell Interactive?189577
-Node: Interactive Shell Behavior190392
-Node: Bash Conditional Expressions193672
-Node: Shell Arithmetic197251
-Node: Aliases199997
-Node: Arrays202569
-Node: The Directory Stack205918
-Node: Directory Stack Builtins206632
-Node: Printing a Prompt209524
-Node: The Restricted Shell212238
-Node: Bash POSIX Mode214070
-Node: Job Control221829
-Node: Job Control Basics222296
-Node: Job Control Builtins226805
-Node: Job Control Variables231132
-Node: Command Line Editing232290
-Node: Introduction and Notation233289
-Node: Readline Interaction234911
-Node: Readline Bare Essentials236102
-Node: Readline Movement Commands237891
-Node: Readline Killing Commands238856
-Node: Readline Arguments240776
-Node: Searching241820
-Node: Readline Init File244006
-Node: Readline Init File Syntax245153
-Node: Conditional Init Constructs257528
-Node: Sample Init File260061
-Node: Bindable Readline Commands263178
-Node: Commands For Moving264385
-Node: Commands For History265246
-Node: Commands For Text268401
-Node: Commands For Killing271074
-Node: Numeric Arguments273216
-Node: Commands For Completion274355
-Node: Keyboard Macros277948
-Node: Miscellaneous Commands278519
-Node: Readline vi Mode283830
-Node: Programmable Completion284744
-Node: Programmable Completion Builtins290562
-Node: Using History Interactively298158
-Node: Bash History Facilities298838
-Node: Bash History Builtins301752
-Node: History Interaction305609
-Node: Event Designators308314
-Node: Word Designators309329
-Node: Modifiers310968
-Node: Installing Bash312372
-Node: Basic Installation313502
-Node: Compilers and Options316194
-Node: Compiling For Multiple Architectures316935
-Node: Installation Names318599
-Node: Specifying the System Type319417
-Node: Sharing Defaults320133
-Node: Operation Controls320806
-Node: Optional Features321764
-Node: Reporting Bugs330695
-Node: Major Differences From The Bourne Shell331889
-Node: Copying This Manual348558
-Node: GNU Free Documentation License348828
-Node: Indexes371234
-Node: Builtin Index371677
-Node: Reserved Word Index378210
-Node: Variable Index380658
-Node: Function Index391822
-Node: Concept Index398554
+Node: Top1359
+Node: Introduction3171
+Node: What is Bash?3399
+Node: What is a shell?4512
+Node: Definitions7052
+Node: Basic Shell Features9821
+Node: Shell Syntax11040
+Node: Shell Operation12070
+Node: Quoting13364
+Node: Escape Character14667
+Node: Single Quotes15152
+Node: Double Quotes15500
+Node: ANSI-C Quoting16625
+Node: Locale Translation17581
+Node: Comments18477
+Node: Shell Commands19095
+Node: Simple Commands19861
+Node: Pipelines20492
+Node: Lists22367
+Node: Compound Commands23998
+Node: Looping Constructs24782
+Node: Conditional Constructs27229
+Node: Command Grouping34789
+Node: Shell Functions36268
+Node: Shell Parameters40729
+Node: Positional Parameters43059
+Node: Special Parameters43959
+Node: Shell Expansions46923
+Node: Brace Expansion48848
+Node: Tilde Expansion51174
+Node: Shell Parameter Expansion53525
+Node: Command Substitution61225
+Node: Arithmetic Expansion62558
+Node: Process Substitution63408
+Node: Word Splitting64458
+Node: Filename Expansion66081
+Node: Pattern Matching68221
+Node: Quote Removal71539
+Node: Redirections71834
+Node: Executing Commands79564
+Node: Simple Command Expansion80234
+Node: Command Search and Execution82164
+Node: Command Execution Environment84170
+Node: Environment86969
+Node: Exit Status88629
+Node: Signals89833
+Node: Shell Scripts91801
+Node: Shell Builtin Commands94319
+Node: Bourne Shell Builtins95996
+Node: Bash Builtins113204
+Node: Modifying Shell Behavior133336
+Node: The Set Builtin133681
+Node: The Shopt Builtin142506
+Node: Special Builtins152736
+Node: Shell Variables153715
+Node: Bourne Shell Variables154155
+Node: Bash Variables156136
+Node: Bash Features177431
+Node: Invoking Bash178314
+Node: Bash Startup Files184123
+Node: Interactive Shells188982
+Node: What is an Interactive Shell?189392
+Node: Is this Shell Interactive?190041
+Node: Interactive Shell Behavior190856
+Node: Bash Conditional Expressions194136
+Node: Shell Arithmetic197715
+Node: Aliases200461
+Node: Arrays203033
+Node: The Directory Stack206382
+Node: Directory Stack Builtins207096
+Node: Printing a Prompt209988
+Node: The Restricted Shell212702
+Node: Bash POSIX Mode214534
+Node: Job Control222293
+Node: Job Control Basics222760
+Node: Job Control Builtins227269
+Node: Job Control Variables231596
+Node: Command Line Editing232754
+Node: Introduction and Notation233753
+Node: Readline Interaction235375
+Node: Readline Bare Essentials236566
+Node: Readline Movement Commands238355
+Node: Readline Killing Commands239320
+Node: Readline Arguments241240
+Node: Searching242284
+Node: Readline Init File244470
+Node: Readline Init File Syntax245617
+Node: Conditional Init Constructs257992
+Node: Sample Init File260525
+Node: Bindable Readline Commands263642
+Node: Commands For Moving264849
+Node: Commands For History265710
+Node: Commands For Text268865
+Node: Commands For Killing271538
+Node: Numeric Arguments273680
+Node: Commands For Completion274819
+Node: Keyboard Macros278412
+Node: Miscellaneous Commands278983
+Node: Readline vi Mode284294
+Node: Programmable Completion285208
+Node: Programmable Completion Builtins291026
+Node: Using History Interactively298622
+Node: Bash History Facilities299302
+Node: Bash History Builtins302216
+Node: History Interaction306073
+Node: Event Designators308778
+Node: Word Designators309793
+Node: Modifiers311432
+Node: Installing Bash312836
+Node: Basic Installation313966
+Node: Compilers and Options316658
+Node: Compiling For Multiple Architectures317399
+Node: Installation Names319063
+Node: Specifying the System Type319881
+Node: Sharing Defaults320597
+Node: Operation Controls321270
+Node: Optional Features322228
+Node: Reporting Bugs331159
+Node: Major Differences From The Bourne Shell332353
+Node: Copying This Manual349022
+Node: GNU Free Documentation License349292
+Node: Indexes371698
+Node: Builtin Index372141
+Node: Reserved Word Index378674
+Node: Variable Index381122
+Node: Function Index392286
+Node: Concept Index399018
 
 End Tag Table