commit bash-20150410 snapshot

doc/bashref.info

@@ -2,9 +2,9 @@ This is bashref.info, produced by makeinfo version 5.2 from
 bashref.texi.
 
 This text is a brief description of the features that are present in the
-Bash shell (version 4.4, 19 January 2015).
+Bash shell (version 4.4, 6 April 2015).
 
-   This is Edition 4.4, last updated 19 January 2015, of 'The GNU Bash
+   This is Edition 4.4, last updated 6 April 2015, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 4.4.
 
    Copyright (C) 1988-2014 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, 19 January 2015).  The Bash home page is
+Bash shell (version 4.4, 6 April 2015).  The Bash home page is
 <http://www.gnu.org/software/bash/>.
 
-   This is Edition 4.4, last updated 19 January 2015, of 'The GNU Bash
+   This is Edition 4.4, last updated 6 April 2015, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 4.4.
 
    Bash contains features that appear in other popular shells, and some
@@ -3585,7 +3585,7 @@ standard.
      '-s'
           Discard the first COUNT lines read.
      '-t'
-          Remove a trailing newline from each line read.
+          Remove a trailing DELIM (default newline) from each line read.
      '-u'
           Read lines from file descriptor FD instead of the standard
           input.
@@ -3707,7 +3707,10 @@ standard.
           than waiting for a complete line of input, unless EOF is
           encountered or 'read' times out.  Delimiter characters
           encountered in the input are not treated specially and do not
-          cause 'read' to return until NCHARS characters are read.
+          cause 'read' to return until NCHARS characters are read.  The
+          result is not split on the characters in 'IFS'; the intent is
+          that the variable is assigned exactly the characters read
+          (with the exception of backslash; see the '-r' option below).
 
      '-p PROMPT'
           Display PROMPT, without a trailing newline, before attempting
@@ -5435,8 +5438,9 @@ commands from the first one that exists and is readable.  The
 '--noprofile' option may be used when the shell is started to inhibit
 this behavior.
 
-   When a login shell exits, Bash reads and executes commands from the
-file '~/.bash_logout', if it exists.
+   When an interactive login shell exits, or a non-interactive login
+shell executes the 'exit' builtin command, Bash reads and executes
+commands from the file '~/.bash_logout', if it exists.
 
 Invoked as an interactive non-login shell
 .........................................
@@ -7085,7 +7089,7 @@ Variable Settings
 
      'blink-matching-paren'
           If set to 'on', Readline attempts to briefly move the cursor
-          to an opening parenthesis when a closing parenthsis is
+          to an opening parenthesis when a closing parenthesis is
           inserted.  The default is 'off'.
 
      'colored-completion-prefix'
@@ -10579,7 +10583,7 @@ D.1 Index of Shell Builtin Commands
 * pwd:                                   Bourne Shell Builtins.
                                                               (line 200)
 * read:                                  Bash Builtins.       (line 458)
-* readarray:                             Bash Builtins.       (line 545)
+* readarray:                             Bash Builtins.       (line 548)
 * readonly:                              Bourne Shell Builtins.
                                                               (line 210)
 * return:                                Bourne Shell Builtins.
@@ -10588,7 +10592,7 @@ D.1 Index of Shell Builtin Commands
 * shift:                                 Bourne Shell Builtins.
                                                               (line 250)
 * shopt:                                 The Shopt Builtin.   (line   9)
-* source:                                Bash Builtins.       (line 554)
+* source:                                Bash Builtins.       (line 557)
 * suspend:                               Job Control Builtins.
                                                               (line 100)
 * test:                                  Bourne Shell Builtins.
@@ -10597,12 +10601,12 @@ D.1 Index of Shell Builtin Commands
                                                               (line 338)
 * trap:                                  Bourne Shell Builtins.
                                                               (line 344)
-* type:                                  Bash Builtins.       (line 559)
-* typeset:                               Bash Builtins.       (line 591)
-* ulimit:                                Bash Builtins.       (line 597)
+* type:                                  Bash Builtins.       (line 562)
+* typeset:                               Bash Builtins.       (line 594)
+* ulimit:                                Bash Builtins.       (line 600)
 * umask:                                 Bourne Shell Builtins.
                                                               (line 393)
-* unalias:                               Bash Builtins.       (line 694)
+* unalias:                               Bash Builtins.       (line 697)
 * unset:                                 Bourne Shell Builtins.
                                                               (line 411)
 * wait:                                  Job Control Builtins.
@@ -11229,134 +11233,134 @@ D.5 Concept Index
 
 
 Tag Table:
-Node: Top895
-Node: Introduction2813
-Node: What is Bash?3029
-Node: What is a shell?4143
-Node: Definitions6681
-Node: Basic Shell Features9600
-Node: Shell Syntax10819
-Node: Shell Operation11845
-Node: Quoting13138
-Node: Escape Character14438
-Node: Single Quotes14923
-Node: Double Quotes15271
-Node: ANSI-C Quoting16396
-Node: Locale Translation17625
-Node: Comments18521
-Node: Shell Commands19139
-Node: Simple Commands20011
-Node: Pipelines20642
-Node: Lists23385
-Node: Compound Commands25114
-Node: Looping Constructs26117
-Node: Conditional Constructs28580
-Node: Command Grouping39501
-Node: Coprocesses40980
-Node: GNU Parallel42812
-Node: Shell Functions46785
-Node: Shell Parameters51991
-Node: Positional Parameters56393
-Node: Special Parameters57293
-Node: Shell Expansions60630
-Node: Brace Expansion62567
-Node: Tilde Expansion65348
-Node: Shell Parameter Expansion67696
-Node: Command Substitution81803
-Node: Arithmetic Expansion83133
-Node: Process Substitution84065
-Node: Word Splitting85109
-Node: Filename Expansion86757
-Node: Pattern Matching89041
-Node: Quote Removal92739
-Node: Redirections93034
-Node: Executing Commands102257
-Node: Simple Command Expansion102927
-Node: Command Search and Execution104857
-Node: Command Execution Environment107193
-Node: Environment110177
-Node: Exit Status111836
-Node: Signals113506
-Node: Shell Scripts115473
-Node: Shell Builtin Commands117988
-Node: Bourne Shell Builtins120012
-Node: Bash Builtins140254
-Node: Modifying Shell Behavior168514
-Node: The Set Builtin168859
-Node: The Shopt Builtin179272
-Node: Special Builtins193901
-Node: Shell Variables194880
-Node: Bourne Shell Variables195317
-Node: Bash Variables197348
-Node: Bash Features224220
-Node: Invoking Bash225119
-Node: Bash Startup Files231068
-Node: Interactive Shells236088
-Node: What is an Interactive Shell?236498
-Node: Is this Shell Interactive?237147
-Node: Interactive Shell Behavior237962
-Node: Bash Conditional Expressions241261
-Node: Shell Arithmetic245262
-Node: Aliases248039
-Node: Arrays250587
-Node: The Directory Stack255671
-Node: Directory Stack Builtins256388
-Node: Controlling the Prompt259347
-Node: The Restricted Shell262093
-Node: Bash POSIX Mode263918
-Node: Job Control273512
-Node: Job Control Basics273972
-Node: Job Control Builtins278691
-Node: Job Control Variables283162
-Node: Command Line Editing284318
-Node: Introduction and Notation285989
-Node: Readline Interaction287612
-Node: Readline Bare Essentials288803
-Node: Readline Movement Commands290586
-Node: Readline Killing Commands291546
-Node: Readline Arguments293464
-Node: Searching294508
-Node: Readline Init File296694
-Node: Readline Init File Syntax297841
-Node: Conditional Init Constructs317565
-Node: Sample Init File320090
-Node: Bindable Readline Commands323207
-Node: Commands For Moving324411
-Node: Commands For History325554
-Node: Commands For Text329843
-Node: Commands For Killing333232
-Node: Numeric Arguments335713
-Node: Commands For Completion336852
-Node: Keyboard Macros341043
-Node: Miscellaneous Commands341730
-Node: Readline vi Mode347534
-Node: Programmable Completion348441
-Node: Programmable Completion Builtins355902
-Node: A Programmable Completion Example365788
-Node: Using History Interactively371040
-Node: Bash History Facilities371724
-Node: Bash History Builtins374723
-Node: History Interaction378654
-Node: Event Designators381360
-Node: Word Designators382579
-Node: Modifiers384216
-Node: Installing Bash385618
-Node: Basic Installation386755
-Node: Compilers and Options389446
-Node: Compiling For Multiple Architectures390187
-Node: Installation Names391850
-Node: Specifying the System Type392668
-Node: Sharing Defaults393384
-Node: Operation Controls394057
-Node: Optional Features395015
-Node: Reporting Bugs405272
-Node: Major Differences From The Bourne Shell406466
-Node: GNU Free Documentation License423318
-Node: Indexes448495
-Node: Builtin Index448949
-Node: Reserved Word Index455776
-Node: Variable Index458224
-Node: Function Index473391
-Node: Concept Index486611
+Node: Top889
+Node: Introduction2801
+Node: What is Bash?3017
+Node: What is a shell?4131
+Node: Definitions6669
+Node: Basic Shell Features9588
+Node: Shell Syntax10807
+Node: Shell Operation11833
+Node: Quoting13126
+Node: Escape Character14426
+Node: Single Quotes14911
+Node: Double Quotes15259
+Node: ANSI-C Quoting16384
+Node: Locale Translation17613
+Node: Comments18509
+Node: Shell Commands19127
+Node: Simple Commands19999
+Node: Pipelines20630
+Node: Lists23373
+Node: Compound Commands25102
+Node: Looping Constructs26105
+Node: Conditional Constructs28568
+Node: Command Grouping39489
+Node: Coprocesses40968
+Node: GNU Parallel42800
+Node: Shell Functions46773
+Node: Shell Parameters51979
+Node: Positional Parameters56381
+Node: Special Parameters57281
+Node: Shell Expansions60618
+Node: Brace Expansion62555
+Node: Tilde Expansion65336
+Node: Shell Parameter Expansion67684
+Node: Command Substitution81791
+Node: Arithmetic Expansion83121
+Node: Process Substitution84053
+Node: Word Splitting85097
+Node: Filename Expansion86745
+Node: Pattern Matching89029
+Node: Quote Removal92727
+Node: Redirections93022
+Node: Executing Commands102245
+Node: Simple Command Expansion102915
+Node: Command Search and Execution104845
+Node: Command Execution Environment107181
+Node: Environment110165
+Node: Exit Status111824
+Node: Signals113494
+Node: Shell Scripts115461
+Node: Shell Builtin Commands117976
+Node: Bourne Shell Builtins120000
+Node: Bash Builtins140242
+Node: Modifying Shell Behavior168735
+Node: The Set Builtin169080
+Node: The Shopt Builtin179493
+Node: Special Builtins194122
+Node: Shell Variables195101
+Node: Bourne Shell Variables195538
+Node: Bash Variables197569
+Node: Bash Features224441
+Node: Invoking Bash225340
+Node: Bash Startup Files231289
+Node: Interactive Shells236392
+Node: What is an Interactive Shell?236802
+Node: Is this Shell Interactive?237451
+Node: Interactive Shell Behavior238266
+Node: Bash Conditional Expressions241565
+Node: Shell Arithmetic245566
+Node: Aliases248343
+Node: Arrays250891
+Node: The Directory Stack255975
+Node: Directory Stack Builtins256692
+Node: Controlling the Prompt259651
+Node: The Restricted Shell262397
+Node: Bash POSIX Mode264222
+Node: Job Control273816
+Node: Job Control Basics274276
+Node: Job Control Builtins278995
+Node: Job Control Variables283466
+Node: Command Line Editing284622
+Node: Introduction and Notation286293
+Node: Readline Interaction287916
+Node: Readline Bare Essentials289107
+Node: Readline Movement Commands290890
+Node: Readline Killing Commands291850
+Node: Readline Arguments293768
+Node: Searching294812
+Node: Readline Init File296998
+Node: Readline Init File Syntax298145
+Node: Conditional Init Constructs317870
+Node: Sample Init File320395
+Node: Bindable Readline Commands323512
+Node: Commands For Moving324716
+Node: Commands For History325859
+Node: Commands For Text330148
+Node: Commands For Killing333537
+Node: Numeric Arguments336018
+Node: Commands For Completion337157
+Node: Keyboard Macros341348
+Node: Miscellaneous Commands342035
+Node: Readline vi Mode347839
+Node: Programmable Completion348746
+Node: Programmable Completion Builtins356207
+Node: A Programmable Completion Example366093
+Node: Using History Interactively371345
+Node: Bash History Facilities372029
+Node: Bash History Builtins375028
+Node: History Interaction378959
+Node: Event Designators381665
+Node: Word Designators382884
+Node: Modifiers384521
+Node: Installing Bash385923
+Node: Basic Installation387060
+Node: Compilers and Options389751
+Node: Compiling For Multiple Architectures390492
+Node: Installation Names392155
+Node: Specifying the System Type392973
+Node: Sharing Defaults393689
+Node: Operation Controls394362
+Node: Optional Features395320
+Node: Reporting Bugs405577
+Node: Major Differences From The Bourne Shell406771
+Node: GNU Free Documentation License423623
+Node: Indexes448800
+Node: Builtin Index449254
+Node: Reserved Word Index456081
+Node: Variable Index458529
+Node: Function Index473696
+Node: Concept Index486916
 
 End Tag Table