commit bash-20100701 snapshot

doc/bashref.info

@@ -1,10 +1,10 @@
 This is bashref.info, produced by makeinfo version 4.13 from
-/usr/homes/chet/src/bash/src/doc/bashref.texi.
+/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.1, 30 May 2010).
+the Bash shell (version 4.1, 12 June 2010).
 
-   This is Edition 4.1, last updated 30 May 2010, of `The GNU Bash
+   This is Edition 4.1, last updated 12 June 2010, of `The GNU Bash
 Reference Manual', for `Bash', Version 4.1.
 
    Copyright (C) 1988-2010 Free Software Foundation, Inc.
@@ -38,9 +38,9 @@ Bash Features
 *************
 
 This text is a brief description of the features that are present in
-the Bash shell (version 4.1, 30 May 2010).
+the Bash shell (version 4.1, 12 June 2010).
 
-   This is Edition 4.1, last updated 30 May 2010, of `The GNU Bash
+   This is Edition 4.1, last updated 12 June 2010, of `The GNU Bash
 Reference Manual', for `Bash', Version 4.1.
 
    Bash contains features that appear in other popular shells, and some
@@ -1531,16 +1531,19 @@ omitted, the operator tests only for existence.
      OFFSET.  LENGTH and OFFSET are arithmetic expressions (*note Shell
      Arithmetic::).  This is referred to as Substring Expansion.
 
-     LENGTH must evaluate to a number greater than or equal to zero.
      If OFFSET evaluates to a number less than zero, the value is used
-     as an offset from the end of the value of PARAMETER.  If PARAMETER
-     is `@', the result is LENGTH positional parameters beginning at
-     OFFSET.  If PARAMETER is an indexed array name subscripted by `@'
-     or `*', the result is the LENGTH members of the array beginning
-     with `${PARAMETER[OFFSET]}'.  A negative OFFSET is taken relative
-     to one greater than the maximum index of the specified array.
-     Substring expansion applied to an associative array produces
-     undefined results.
+     as an offset from the end of the value of PARAMETER.  If LENGTH
+     evaluates to a number less than zero, and PARAMETER is not `@' and
+     not an indexed or associative array, it is interpreted as an
+     offset from the end of the value of PARAMETER rather than a number
+     of characters, and the expansion is the characters between the two
+     offsets.  If PARAMETER is `@', the result is LENGTH positional
+     parameters beginning at OFFSET.  If PARAMETER is an indexed array
+     name subscripted by `@' or `*', the result is the LENGTH members
+     of the array beginning with `${PARAMETER[OFFSET]}'.  A negative
+     OFFSET is taken relative to one greater than the maximum index of
+     the specified array.  Substring expansion applied to an
+     associative array produces undefined results.
 
      Note that a negative offset must be separated from the colon by at
      least one space to avoid being confused with the `:-' expansion.
@@ -3914,6 +3917,14 @@ This builtin allows you to change additional shell optional behavior.
           conditional command's < and > operators and the effect of
           interrupting a command list.
 
+    `compat41'
+          If set, Bash, when in posix mode, treats a single quote in a
+          double-quoted parameter expansion as a special character.
+          The single quotes must match (an even number) and the
+          characters between the single quotes are considered quoted.
+          This is the behavior of POSIX mode through version 4.1.  The
+          default Bash behavior remains as in previous versions.
+
     `dirspell'
           If set, Bash attempts spelling correction on directory names
           during word completion if the directory name initially
@@ -5488,8 +5499,10 @@ assigned to using the syntax
      name[SUBSCRIPT]=VALUE
 
 The SUBSCRIPT is treated as an arithmetic expression that must evaluate
-to a number greater than or equal to zero.  To explicitly declare an
-array, use
+to a number.  If SUBSCRIPT evaluates to a number less than zero, it is
+used as an offset from one greater than the array's maximum index (so a
+subcript of -1 refers to the last element of the array).  To explicitly
+declare an array, use
      declare -a NAME
    The syntax
      declare -a NAME[SUBSCRIPT]
@@ -10416,7 +10429,7 @@ D.5 Concept Index
 
 
 Tag Table:
-Node: Top1340
+Node: Top1338
 Node: Introduction3169
 Node: What is Bash?3397
 Node: What is a shell?4510
@@ -10449,100 +10462,100 @@ Node: Shell Expansions53319
 Node: Brace Expansion55244
 Node: Tilde Expansion57999
 Node: Shell Parameter Expansion60350
-Node: Command Substitution69251
-Node: Arithmetic Expansion70584
-Node: Process Substitution71434
-Node: Word Splitting72484
-Node: Filename Expansion74107
-Node: Pattern Matching76246
-Node: Quote Removal79885
-Node: Redirections80180
-Node: Executing Commands88705
-Node: Simple Command Expansion89375
-Node: Command Search and Execution91305
-Node: Command Execution Environment93642
-Node: Environment96628
-Node: Exit Status98288
-Node: Signals99909
-Node: Shell Scripts101877
-Node: Shell Builtin Commands104395
-Node: Bourne Shell Builtins106423
-Node: Bash Builtins124101
-Node: Modifying Shell Behavior150306
-Node: The Set Builtin150651
-Node: The Shopt Builtin160175
-Node: Special Builtins171509
-Node: Shell Variables172488
-Node: Bourne Shell Variables172928
-Node: Bash Variables174909
-Node: Bash Features199247
-Node: Invoking Bash200130
-Node: Bash Startup Files205894
-Node: Interactive Shells210906
-Node: What is an Interactive Shell?211316
-Node: Is this Shell Interactive?211965
-Node: Interactive Shell Behavior212780
-Node: Bash Conditional Expressions216060
-Node: Shell Arithmetic219808
-Node: Aliases222567
-Node: Arrays225139
-Node: The Directory Stack229097
-Node: Directory Stack Builtins229811
-Node: Printing a Prompt232703
-Node: The Restricted Shell235455
-Node: Bash POSIX Mode237287
-Node: Job Control246113
-Node: Job Control Basics246573
-Node: Job Control Builtins251290
-Node: Job Control Variables255654
-Node: Command Line Editing256812
-Node: Introduction and Notation258379
-Node: Readline Interaction260001
-Node: Readline Bare Essentials261192
-Node: Readline Movement Commands262981
-Node: Readline Killing Commands263946
-Node: Readline Arguments265866
-Node: Searching266910
-Node: Readline Init File269096
-Node: Readline Init File Syntax270243
-Node: Conditional Init Constructs285347
-Node: Sample Init File287880
-Node: Bindable Readline Commands290997
-Node: Commands For Moving292204
-Node: Commands For History293348
-Node: Commands For Text296503
-Node: Commands For Killing299176
-Node: Numeric Arguments301627
-Node: Commands For Completion302766
-Node: Keyboard Macros306958
-Node: Miscellaneous Commands307529
-Node: Readline vi Mode313335
-Node: Programmable Completion314242
-Node: Programmable Completion Builtins321452
-Node: Using History Interactively330588
-Node: Bash History Facilities331272
-Node: Bash History Builtins334186
-Node: History Interaction338043
-Node: Event Designators340748
-Node: Word Designators341763
-Node: Modifiers343402
-Node: Installing Bash344806
-Node: Basic Installation345943
-Node: Compilers and Options348635
-Node: Compiling For Multiple Architectures349376
-Node: Installation Names351040
-Node: Specifying the System Type351858
-Node: Sharing Defaults352574
-Node: Operation Controls353247
-Node: Optional Features354205
-Node: Reporting Bugs363764
-Node: Major Differences From The Bourne Shell364965
-Node: GNU Free Documentation License381652
-Node: Indexes406848
-Node: Builtin Index407302
-Node: Reserved Word Index414129
-Node: Variable Index416577
-Node: Function Index429531
-Node: Concept Index436540
+Node: Command Substitution69485
+Node: Arithmetic Expansion70818
+Node: Process Substitution71668
+Node: Word Splitting72718
+Node: Filename Expansion74341
+Node: Pattern Matching76480
+Node: Quote Removal80119
+Node: Redirections80414
+Node: Executing Commands88939
+Node: Simple Command Expansion89609
+Node: Command Search and Execution91539
+Node: Command Execution Environment93876
+Node: Environment96862
+Node: Exit Status98522
+Node: Signals100143
+Node: Shell Scripts102111
+Node: Shell Builtin Commands104629
+Node: Bourne Shell Builtins106657
+Node: Bash Builtins124335
+Node: Modifying Shell Behavior150540
+Node: The Set Builtin150885
+Node: The Shopt Builtin160409
+Node: Special Builtins172168
+Node: Shell Variables173147
+Node: Bourne Shell Variables173587
+Node: Bash Variables175568
+Node: Bash Features199906
+Node: Invoking Bash200789
+Node: Bash Startup Files206553
+Node: Interactive Shells211565
+Node: What is an Interactive Shell?211975
+Node: Is this Shell Interactive?212624
+Node: Interactive Shell Behavior213439
+Node: Bash Conditional Expressions216719
+Node: Shell Arithmetic220467
+Node: Aliases223226
+Node: Arrays225798
+Node: The Directory Stack229913
+Node: Directory Stack Builtins230627
+Node: Printing a Prompt233519
+Node: The Restricted Shell236271
+Node: Bash POSIX Mode238103
+Node: Job Control246929
+Node: Job Control Basics247389
+Node: Job Control Builtins252106
+Node: Job Control Variables256470
+Node: Command Line Editing257628
+Node: Introduction and Notation259195
+Node: Readline Interaction260817
+Node: Readline Bare Essentials262008
+Node: Readline Movement Commands263797
+Node: Readline Killing Commands264762
+Node: Readline Arguments266682
+Node: Searching267726
+Node: Readline Init File269912
+Node: Readline Init File Syntax271059
+Node: Conditional Init Constructs286163
+Node: Sample Init File288696
+Node: Bindable Readline Commands291813
+Node: Commands For Moving293020
+Node: Commands For History294164
+Node: Commands For Text297319
+Node: Commands For Killing299992
+Node: Numeric Arguments302443
+Node: Commands For Completion303582
+Node: Keyboard Macros307774
+Node: Miscellaneous Commands308345
+Node: Readline vi Mode314151
+Node: Programmable Completion315058
+Node: Programmable Completion Builtins322268
+Node: Using History Interactively331404
+Node: Bash History Facilities332088
+Node: Bash History Builtins335002
+Node: History Interaction338859
+Node: Event Designators341564
+Node: Word Designators342579
+Node: Modifiers344218
+Node: Installing Bash345622
+Node: Basic Installation346759
+Node: Compilers and Options349451
+Node: Compiling For Multiple Architectures350192
+Node: Installation Names351856
+Node: Specifying the System Type352674
+Node: Sharing Defaults353390
+Node: Operation Controls354063
+Node: Optional Features355021
+Node: Reporting Bugs364580
+Node: Major Differences From The Bourne Shell365781
+Node: GNU Free Documentation License382468
+Node: Indexes407664
+Node: Builtin Index408118
+Node: Reserved Word Index414945
+Node: Variable Index417393
+Node: Function Index430347
+Node: Concept Index437356
 
 End Tag Table